1.4.2.2.5 MCU SDK

由于低配置且资源受限或者对网络流量有要求的设备不适合直接构造JSON数据和云端通信，因此选择通过二进制方式透传到云端，由云端运行转换脚本将透传的数据转换成自己可以理解的Alink格式的JSON数据。目前转换脚本通过JS开发，设备和脚本间数据协议格式支持标准和自定义的方式。使用标准协议开发的设备可以直接使用云端自动生成的脚本，如果协议自定义则需要开发者自行开发JS脚本。

针对上述提到的二进制的标准协议，我们提供了MCU SDK实现了协议的封装。此外，我们还会根据开发者的产品功能定义在MCU SDK中生成与之对应的代码和上报、接收处理逻辑。开发者使用MCU SDK开发就不用实现通讯协议和产品功能的定义，直接按照提供的API接口调用或添加自己的业务逻辑即可。
比如云端下发一个关灯（对应属性标识Switch）的请求，需要在开发者在特定的API内部实现Switch的处理，MCU SDK默认实现了对云端的回复；比如设备本地灯的开关状态变化，开发者的程序识别到后调用修改Switch属性的API后，MCU SDK会自动将变化上报到云端。这样开发者就只需要关注设备业务功能的开发即可。

获取方法

采用透传数据格式的设备，支持选择不同的硬件平台自动生成相应的MCU SDK，开发者可以按需下载。
初始状态下，MCU SDK显示未生成，开发者需要点击生成，选择相应的硬件平台。后续我们将陆续支持更多的硬件平台。

选择硬件平台进行生成：

生成后可以直接点击下载SDK。特别说明，如果产品功能定义有修改，需要重新生成sdk后再下载。

根据芯片生成的SDK说明

目前MCU SDK支持如下几种芯片型号生成对应开发工程，开发者可以直接基于此工程直接开发自己的应用。如果选择其他平台，我们只提供sdk和简单的示例demo，开发者可以在Linux进行编译运行。

STM8S207
开发IDE使用IAR for STM8（EWSTM8）。参考生成的SDK中的Readme.txt。
STM32L053R8
开发IDE使用Keil MDK5。参考生成的SDK中的Readme.txt。
其他平台
仅提供简单的示例。可以在Linux中编译运行。
（a）编译方法：进入sample目录，执行make。
（b）运行方法：./a.out。运行后支持输入的命令格式：set 属性名称=属性值。
比如修改设备的调光等级(对应属性标识LightAdjustLevel)可以执行set LightAdjustLevel=100。运行命令设置属性后会打印出生成的二进制数据，参考如下：

注意：如上命令目前只支持基本类型的属性上报数据生成，对于复杂类型的属性或者事件暂不支持。

目录结构说明

MCU SDK的目录结构如下图所示，包括了头文件目录inc和源代码目录src。

头文件

bonedevice_common.h
SDK共用的头文件，包括了类型定义、SDK全局对象定义以及公共的API。需要开发者关注。
bonedevice_platform.h
定义了需要开发者实现或者处理的函数。需要开发者关注。
bonedevice_protocol.h
定义了和云端通讯协议的使用的接口。开发者可以不用关注。
bonedevice_thing.h
包含了产品功能(属性、服务、事件)相关定义。需要开发者关注。
thing.h和thing.c会根据产品的 TSL自动生成。

源文件

bonedevice_common.c
SDK公共代码的实现。
bonedevice_protocol.c
和云端通信协议的定义及接口实现。
bonedevice_thing.c
产品功能相关的接口实现。
thing.h和thing.c会根据产品的TSL自动生成。

API说明

需要用户调用的接口

公共接口

/ SDK初始化函数 /
void boneSdkInit(void);

/ SDK运行函数，在while中调用 /
void boneSdkRun(void);

/ 接收串口的字节数据，在串口中断服务程序中调用 /
int32 boneRecvFromUart(int8 val);

/ 系统运行时间计算(定时1ms调用)，暂时可以不用实现 /
void boneSystimeInc(void);

产品功能相关接口

/ 属性值范围定义 /
#define  ATTR_XXX

/ 属性值的设置和获取，AttrName表示的是属性名称，实际的接口名称和属性标识对应，AttrVal表示的是属性的值， ValueType表示的是属性的类型 /
void boneSet_AttrName(AttrVal);
ValueType boneGet_AttrName(void);

/ 事件上报，EventName表示的是事件名称，实际的接口名称和事件标识对应，Params表示事件的输出参数 /
void boneEvntPost_EventName(Params);

注意：以上接口及参数定义的只是一个模版，具体的API要视自己定义的产品功能而定。以下是示例产品自动生成的API。
属性值范围定义：

属性值的设置和获取：

事件上报：

需要用户实现的接口

/ 串口发送协议数据 /
int32 boneUartSend(uint8*frame, uint16 length);

/ 时间记录到时钟芯片。如果不支持可以空实现 /
int32 boneWriteRtc(uint8*time, uint8 len);

/ 固件更新。如果不支持可以空实现 /
int32 boneFirewareUpdate(uint8*buf, uint32 length);

需要用户添加处理方法的接口

/ 处理因服务端修改的属性变化的情况 /
void boneHandleAttrChange(uint8 attrId);

/ 服务处理函数，如果没有服务可忽略。接口名称中的ServiceName表示的是服务名称，实际的接口名称和服务标识对应 */
int32 boneHandleSrv_ServiceName(Params);

示例产品上定义的服务的处理函数：