42 lines
1.6 KiB
C
42 lines
1.6 KiB
C
#ifndef __CM_DEMO_ALIYUN_H__
|
||
#define __CM_DEMO_ALIYUN_H__
|
||
|
||
#include <stdint.h>
|
||
#include <stddef.h>
|
||
|
||
/*
|
||
* 使用此测试函数需自行在阿里云平台创建设备，并补充本文件中的设备的三元组、接入点、topic名称
|
||
*/
|
||
void cm_test_aliyun(unsigned char **cmd, int len);
|
||
|
||
/**
|
||
* @brief 阿里云OTA升级Demo
|
||
*
|
||
* @param void
|
||
*
|
||
* @return
|
||
* = 0 - 成功 \n
|
||
* < 0 - 失败
|
||
*
|
||
* @details 运行该用例需要配置实例的接入点mqtt_host以及设备的product_key,device_name,device_secret,配置与阿里云平台配置保持一致,另外:
|
||
* 1. 执行升级后模组会进行多次重启,且升级异常后无法还原至升级前的版本,请在FOTA升级前先使用单个模组调试,保证升级无异常后再进行大规模升级;
|
||
* 2. 执行升级后url有效期为24小时,且升级异常后无法还原至升级前的版本,模组必须在升级前保证模组的网络,电源,SIM流量剩余等,防止升级失败无法恢复;
|
||
* 3. 升级后需要客户自行版本管理并调用cm_aliyun_ota_version_report接口向阿里云平台上报版本号
|
||
*/
|
||
void cm_aliyun_ota_test(unsigned char **cmd, int len);
|
||
|
||
/**
|
||
* @brief 阿里云平台上报OTA版本号,用于OTA升级完成后向服务器上报升级后版本
|
||
*
|
||
* @param [in] ver : 待上报的设备版本号字符串
|
||
*
|
||
* @return
|
||
* = 0 - 成功 \n
|
||
* < 0 - 失败
|
||
*
|
||
* @details 用于OTA升级完成后向服务器上报升级后版本,上报完成后即可断开连接并释放资源
|
||
* 客户可以在初始化时版本管理过程中上报版本
|
||
*/
|
||
int cm_aliyun_ota_version_report(const char *ver);
|
||
|
||
#endif |