SDK初始化
在目标平台上使用SDK进行开发前,需要对SDK进行移植。主要包括数据初始化、协议初始化、数据输入输出接口调用、数据轮询处理。
SDK目录结果如下,总共包含protocol、protocol_if、iot_interface三个模块。
-\sdk_c
-\protocol.c串口协议解析和分发,用户无需关心
-\protocol.h
-\protocol_if.c串口协议接口,用户无需关心
-\protocol_if.h
-\iot_interface.c用户接口,包含产品信息定义和回调函数
-\iot_interface.h用户接口,包含所有结构和接口的声明
protocol、protocol_if实现串口协议报文的解析和分发,用户无需做任何修改。
iot_interface实现用户接口。[.h]声明了所有用户接口,[.c]包含所有回调函数,需要用户自行实现。
初始化数据结构
PRODUCT_ID云平台生成,4字节的无符号整型数字,全网唯一产品ID
PRODUCT_KEY云平台生成,16字节的十六进制编码,全网唯一产品秘钥
MCU_VERmcu固件版本,"xx.xx",0≤x≤9
初始化SDK功能函数
◆ 协议初始化
voidprotocol_init(void)
说明:
该函数用于初始化接收队列和回调函数,请在串口接收启动前调用。
◆ 发送数据函数
voidtx_buf(constuint8_t*pBuf,
uint8_tLength)
说明:
此函数用于向模组发送数据,需要用户实现该函数的功能,SDK发送数据时会调用此函数。
参数 | 长度 | 说明 |
---|---|---|
pBuf | n | 待发送数据的指针 |
Length | 4 | 数据长度 |
◆ 接收数据函数
voidrx_byte(uint8_tByte)
说明:
此函数用于接收模组发送到MCU的数据,请在接收数据的接口中调用此函数,将收到的每个字节传入。
参数 | 长度 | 说明 |
---|---|---|
Byte | 1 | 收到的每个字节 |
Length | 4 | 数据长度 |
◆ 处理接收数据
voidrx_device_frame(void)
说明:
此函数用于对收到的数据进行解析处理,请在主循环函数中调用此接口。