设备升级模块头文件, 提供设备获取固件信息的能力更多...

#include <stdint.h>

结构体
struct	aiot_ota_msg_t
	OTA消息的结构体更多...

类型定义
typedef void(*	ota_msg_callback_t) (void device, const aiot_ota_msg_t msg, void *userdata)
	设备OTA消息回调函数原型，用户定义后, 可通过 aiot_device_ota_set_callback 配置更多...

枚举
enum	aiot_ota_digest_type_t { AIOT_OTA_DIGEST_MD5, AIOT_OTA_DIGEST_SHA256, AIOT_OTA_DIGEST_MAX }
	OTA过程中使用的digest方法类型, 分为MD5和SHA256两种更多...

函数
int32_t	aiot_device_ota_set_callback (void device, ota_msg_callback_t callback, void userdata)
	设置OTA消息回调函数更多...

int32_t	aiot_device_ota_report_version (void device, char module, char *version)
	设备版本信息上报更多...

int32_t	aiot_device_ota_report_state (void device, char module, int32_t state)
	设备升级状态上报更多...

int32_t	aiot_device_ota_request_firmware (void device, char module)
	设备端主动向云端查询升级固件更多...

aiot_ota_msg_t *	aiot_ota_msg_clone (const aiot_ota_msg_t *msg)
	拷贝ota消息，用于异步执行ota操作更多...

void	aiot_ota_msg_free (aiot_ota_msg_t *msg)
	释放ota消息资源更多...

详细描述

设备升级模块头文件, 提供设备获取固件信息的能力

日期: 2022-01-20

版权所有: Copyright (C) 2020-2025 Alibaba Group Holding Limited

类型定义说明

typedef void(* ota_msg_callback_t) (void *device, const aiot_ota_msg_t *msg, void *userdata)

设备OTA消息回调函数原型，用户定义后, 可通过 aiot_device_ota_set_callback 配置

参数

[in]	device	设备句柄
[in]	msg	接收到的消息数据结构参考 aiot_ota_msg_t
[in]	userdata	用户设置的上下文，可通过 aiot_device_ota_set_callback 配置

枚举类型说明

enum aiot_ota_digest_type_t

OTA过程中使用的digest方法类型, 分为MD5和SHA256两种

枚举值
AIOT_OTA_DIGEST_MD5	收到的OTA固件的digest方法为MD5
AIOT_OTA_DIGEST_SHA256	收到的OTA固件的digest方法为SHA256
AIOT_OTA_DIGEST_MAX

函数说明

int32_t aiot_device_ota_set_callback	(	void *	device,
		ota_msg_callback_t	callback,
		void *	userdata
	)

设置OTA消息回调函数

参数

[in]	device	设备句柄
[in]	callback	回调函数
[in]	userdata	执行回调函数后的上下文指针

返回: int32_t

返回值

STATE_SUCCESS	参数配置成功
STATE_USER_INPUT_NULL_POINTER	入参为空
others	参考aiot_state_api.h

int32_t aiot_device_ota_report_version	(	void *	device,
		char *	module,
		char *	version
	)

设备版本信息上报

参数

[in]	device	设备句柄
[in]	module	模块版本信息上报时，参数为模块名设备版本上报时，参数置为NULL；
[in]	version	版本号

返回: int32_t

返回值

STATE_SUCCESS	参数配置成功
STATE_USER_INPUT_NULL_POINTER	入参为空
others	参考aiot_state_api.h

int32_t aiot_device_ota_report_state	(	void *	device,
		char *	module,
		int32_t	state
	)

设备升级状态上报

参数

[in]	device	设备句柄
[in]	module	模块版本状态上报时，参数为模块名设备版本状态上报时，参数置为NULL；
[in]	state	取值：0～100，升级进度取值：-1，升级失败取值：-2，下载失败取值：-3，校验失败取值：-4，烧写失败

返回: int32_t

返回值

STATE_SUCCESS	参数配置成功
STATE_USER_INPUT_NULL_POINTER	入参为空
others	参考aiot_state_api.h

int32_t aiot_device_ota_request_firmware	(	void *	device,
		char *	module
	)

设备端主动向云端查询升级固件

参数

[in]	device	设备句柄
[in]	module	请求模块版本时，参数为模块名请求设备版本时，参数置为NULL；

返回: int32_t

返回值

STATE_SUCCESS	参数配置成功
STATE_USER_INPUT_NULL_POINTER	入参为空
others	参考aiot_state_api.h

aiot_ota_msg_t* aiot_ota_msg_clone ( const aiot_ota_msg_t * msg )

拷贝ota消息，用于异步执行ota操作

参数

[in] msg 源消息

返回: aiot_ota_msg_t*

返回值

非NULL	消息句柄
NULL	初始化失败, 一般是内存分配失败导致

void aiot_ota_msg_free ( aiot_ota_msg_t * msg )

释放ota消息资源

参数

[in] msg 待删除的消息

返回: void

结构体

类型定义

枚举

函数

详细描述

类型定义说明

枚举类型说明

函数说明