系统函数

安全快速联网

初始化设备与云端交互的上下文环境，并与云端会建立长连接。当长连接断开时，会自动重连。注意，填写密钥时，需将官网的一串字符串转换成相应的十六进制编码，即在每个字节前增加0x作为开头。如字符串是5668，转换时应改为0x56，0x68。

    iot_s32 iot_start ( struct iot_context* ctx );

struct iot_context结构体的内容如下：

设置设备运行状态

此函数用于设置设备的运行状态，设置结果请见3.3节“设备运行状态报告”。

void iot_status_set( DEV_STATUS_T dev_status,  iot_u32 timeout );

设备运行状态报告

当设备运行状态发生改变时，sdk自动调用此函数。

void iot_status_cb( DEV_STATUS_T dev_status,  iot_u32timestamp );

注意！回调函数中不可执行太多耗时代码。

获取网络时间

iot_u32 iot_get_onlinetime( void );

解析时间

void iot_parse_timestamp ( iot_u32 timestamp, struct s_time* st );

时间结构体定义如下:

struct s_time {

    int     sec;        //秒

    int     min;        //分

    int     hour;       //时

    int     day;        //日

    int     mon;        //月

    int     year;       //年

    int     week;       //周

};

打印输出函数

此函数用于输出日志信息，需用户自行实现，可根据需要重定向到串口、屏幕、文件等位置。

void iot_print ( const char * str );

发送数据成功报告

发送数据成功后，sdk自动调用下面这个回调函数。当调用4.1.1节上传数据、4.2.1节透传自定义数据某个函数后，此回调函数会被调用。回调函数中不可执行太多耗时代码。

void iot_data_cb (     iot_u32  data_seq， DATA_LIST_T * data_list  );

数据列表结构体定义如下：

typedef struct data_list
{
    int                 count;               //列表信息个数
    DATA_INFO_T *       info;               //数据信息列表
}DATA_LIST_T;

数据列表结构体定义如下：

typedef struct data_info
{
    char            *       dev_id;         //设备id(主设备:NULL, 子设备:subid)
    DATA_INFO_TYPE_T    info_type;        //数据类型码
}DATA_INFO_T;

数据列表中信息类型结构体定义如下：

typedef enum DATA_INFO_TYPE {
    DATA_INFO_NULL           = 0,         //数据信息为空 
    DATA_INFO_NOT_ONLINE   = 16,        //子设备发送数据、透传数据、下线时，如果未上线，则返回此错误
    DATA_INFO_BIND_OTHER    = 17,        //子设备上线、下线时，如果已被其他主设备绑定，则返回此错误
    DATA_INFO_BIND_NONE     = 18,        //子设备上线、下线时，如果未被绑定，则返回此错误
}DATA_INFO_TYPE_T;

crc校验码计算

用户可使用该函数计算数据或文件的crc16校验码。

iot_u16     iot_crc16_calc(    iot_u8    * data, 
iot_u32     data_len,
iot_u16     pre_crc)