App Start API

更新时间:2022-11-24 09:20:20

API 列表

函数名称 功能描述
pre_app_init_hook_register 应用预初始化
pre_device_init_hook_register 设备预初始化
app_init_hook_register 应用初始化
device_init_hook_register 设备初始化
user_main_entry_register 用户应用程序入口
mf_firmware_info_register 注册产测固件信息
tuya_iot_cat1_opencpu_dev_init 设备初始化函数
tuya_iot_cat1_get_sys_fw_ver 查询系统固件版本
tuya_iot_cat1_update_mcu_ver 更新 MCU 版本号到涂鸦 IoT 平台

API 说明

pre_app_init_hook_register

定义 说明
函数原型 VOID_T pre_app_init_hook_register(pre_app_init_hook hook)
功能说明 向系统注册 pre_app_init 勾子,系统初始化过程中,将调用该勾子
参数 hookpre_app_init 勾子
返回值

pre_device_init_hook_register

定义 说明
函数原型 VOID_T pre_device_init_hook_register(pre_device_init_hook hook)
功能说明 向系统注册 pre_device_init 勾子,系统初始化过程中,将调用该勾子
参数 hookpre_device_init 勾子
返回值

app_init_hook_register

定义 说明
函数原型 VOID_T app_init_hook_register(app_init_hook hook)
功能说明 向系统注册 app_init 勾子,系统初始化过程中,将调用该勾子
参数 hookapp_init 勾子
返回值

device_init_hook_register

定义 说明
函数原型 VOID_T device_init_hook_register(device_init_hook hook)
功能说明 向系统注册 device_init 勾子,系统初始化过程中,将调用该勾子
参数 hookdevice_init 勾子
返回值

user_main_entry_register

定义 说明
函数原型 VOID_T user_main_entry_register(user_main_entry_hook hook)
功能说明 向系统注册 user_main_entry 勾子,系统完成启动后,最后调用该勾子进入用户应用程序
参数 hookuser_main_entry 勾子
返回值

mf_firmware_info_register

定义 说明
函数原型 int mf_firmware_info_register(CHAR_T* fw_name, CHAR_T* fw_ver)
功能说明 注册产测固件信息
参数
  • fw_name:产测固件名称
  • fw_ver:产测固件版本号
返回值
  • 0:注册成功
  • -1:固件名非法,注册失败
  • -2:固件版本号非法,注册失败

tuya_iot_cat1_opencpu_dev_init

定义 说明
函数原型 OPERATE_RET tuya_iot_cat1_opencpu_dev_init(TY_IOT_CBS_S* cbs, CHAR_T* firmware_key,CHAR_T* product_id,CHAR_T* sys_fw_ver,CHAR_T* app_fw_ver,CHAR_T* mcu_ver)
功能说明 Cat1 设备初始化函数
参数
  • cbs:回调函数集
  • firmware_key:固件 KEY
  • product_id:产品 ID
  • sys_fw_ver:OpenCPU 基础固件版本号
  • app_fw_ver:OpenCPU 应用固件版本号
  • mcu_ver:MCU 固件版本号
返回值
  • 0:初始化成功
  • 其它:失败

tuya_iot_cat1_get_sys_fw_ver

定义 说明
函数原型 int tuya_iot_cat1_get_sys_fw_ver(CHAR_T version[32])
功能说明 查询系统固件版本号
参数 version[32]:版本号存储缓冲,32 字节
返回值
  • 0:成功
  • -1:失败

    tuya_iot_cat1_update_mcu_ver

    定义 说明
    函数原型 int tuya_iot_cat1_update_mcu_ver(CHAR_T version[11])
    功能说明 将新的 MCU 版本号更新到涂鸦 IoT 平台。MCU 升级成功后,用户调用该函数将新的 MCU 版本号发送至涂鸦 IoT 平台,使手机 App 能显示新的版本号。
    参数 version[11]:更新后的 MCU 版本号。版本号为字符串形式,以 ‘\0’ 结束,字符串的长度不超过 10 个字符。
    返回值
    • 0:更新成功
    • -1:版本号错误
    • -2:系统无MCU
    • -3:更新失败