子设备功能


子设备上线


① 添加子设备信息到发送队列

iot_s32  sub_dev_add (  const     char              sub_id[32],
                        const     char              sub_name[32],
                        const     char              sub_version[5],
iot_u16                     sub_type    )
参数             说明
sub_id 自定义的子设备id,仅限字母数字组合。请自行维护唯一性,支持单个网关下唯一或产品维度下唯一(请根据实际需求填写)。
sub_name 子设备名称,仅限字母数字组合
sub_version 子设备固件版本,"xx.xx",0≤x≤9
sub_type 子设备类型,请与APP端自行约定
返回值 0 :成功
-1:失败


② 上线子设备,一次可同时上线多个子设备。
注:关于一次可以同时上线多少个子设备,代码中不做限制,但是和iot_start函数中的sendbuf_size参数大小有关。

iot_s32  iot_sub_dev_active ( SUB_OPT_TYPE_T opt_type,  iot_u32* data_seq )
参数             说明
opt_type 子设备上线操作类型。
SUB_OPT_BIND_ONLINE:执行绑定主设备+上线操作
SUB_OPT_ONLINE           :仅执行子设备上线操作
data_seq 传出参数,本条数据的序列号,如果需要确定数据何时上传成功,可记录此发送序列号,与收到的进行对比。
返回值 0 :成功;
-1:失败

子设备上/下线操作类型定义如下: ```c typedef enum SUB_OPT_TYPE { ​ SUB_OPT_BIND_ONLINE = 0, //执行绑定主设备+上线操作 ​ SUB_OPT_ONLINE = 1, //仅执行子设备上线操作 ​ SUB_OPT_OFFLINE = 0, //仅执行子设备下线操作 ​ SUB_OPT_UNBIND_OFFLINE = 1, //执行从主设备解绑+下线操作 }SUB_OPT_TYPE_T; ``` #### 子设备离线 --- >子设备离线时,调用此接口。 ```c iot_s32 iot_sub_dev_inactive ( const char sub_id[32], SUB_OPT_TYPE_T opt_type, iot_u32 * data_seq ) ```
参数             说明
sub_id 自定义的子设备id,仅限字母数字组合
opt_type 子设备下线操作类型。
SUB_OPT_OFFLINE                 : 仅执行子设备下线操作
SUB_OPT_UNBIND_OFFLINE : 执行从主设备解绑+下线操作
data_seq 传出参数,本条数据的序列号,如果需要确定数据何时上传成功,可记录此发送序列号,与收到的进行对比。
返回值 0 :成功;
-1:失败;
#### 子设备状态报告 > 当设备运行状态发生改变时,sdk自动调用此函数。当调用8.1节子设备上线、8.2节子设备下线后,此回调函数会被调用。当sdk收到子设备被动解绑通知(包括app解绑子设备,其他主设备绑定当前主设备下的子设备)时,此回调函数回避调用。回调函数中不可执行太多耗时代码。 ```c void iot_sub_status_cb( SUB_STATUS_T sub_status,iot_u32 timestamp, DATA_LIST_T * list , iot_u32 seq); ```
参数             说明
sub_status 子设备状态
timestamp 时间戳
list 子设备信息列表
seq 此发送序列号,与收到的进行对比。
返回值 0 :成功;
-1:失败;
typedef enum SUB_STATUS {
    SUB_STA_ONLINE                   = 0,  //子设备上线结果
    SUB_STA_BIND_ONLINE               = 1,  //子设备绑定上线结果
    SUB_STA_OFFLINE                   = 2,  //子设备下线结果
    SUB_STA_UNB_OFFLINE               = 3,  //子设备解绑下线结果
    SUB_STA_FORCED_UNBIND           = 4,  //子设备被强制解绑
}SUB_STATUS_T;
Copyright & copy qinglianyun all right reserved,powered by Gitbook该文件修订时间: 2021-04-22 18:53:48

results matching ""

    No results matching ""