涂鸦标准模组MCU SDK开发流程

Posted 2021-07-19 三明治开发社区

MCU SDK 是根据涂鸦 IoT 开发平台定义的产品功能，自动生成的 MCU 代码。目前主要支持的MCU有STM32、51单片机、Arduino。为了减少开发者使用涂鸦 Wi-Fi 通用串口协议的对接成本，MCU SDK 已搭建通讯及协议解析架构。将 MCU SDK 添加至自己的工程并配置相关信息后，既可以快速的完成 MCU 程序开发。在涂鸦 IoT 平台通过自定义产品功能自动生成MCU SDK代码。能够帮助开发者快速实现MCU程序的开发。
那么要完成 MCU 的开发就需要在 IoT平台通过自定义方案完成产品的创建。之前已经讲到了零代码开发流程指南 ，大体流程相似，都需要通过 IoT 平台创建产品来完成整个流程。

1.登录IoT工作台

登录涂鸦IoT工作台(未注册需先进行账号注册)。

2.产品创建

本文以涂鸦 WB3S 模组为例，其他产品操作流程类似。WB3S 是一款低功耗嵌入式 Wi-Fi 模组，并同时支持低功耗蓝牙连接。WB3S 还是一个 RTOS 平台，集成了所有 Wi-Fi MAC 以及 TCP/IP 协议的函数库。开发者可以基于这些开发满足自己需求的嵌入式 Wi-Fi 产品。WB3S详细参数见WB3S模组规格书。
        这里我们以照明类目中的 光源 为例。产品方案选择自定义方案，点击 “光源” 框后，通讯协议选择 WiFi+蓝牙，产品名称根据自己需求填写。

3.功能选择

点击创建产品之后会弹出功能选择界面，可以根据项目需要选择光源功能，在MCU SDK 开发中产品功能完全可以自己定义，没有必选功能。
下面介绍一下DP（[datapoint] 可理解为设备上发生的某种事件，如门锁开门，门铃告警）数据类型及其功能和DP格式说明
DP 类型主要有 6 种：
bool 型：
通常为开关类的 DP，例如开关、ECO 和屏显。
enum 型：
通常用作那些有多种状态的 DP，例如工作模式、风速和风摆位置。
value 型：
通常用作数值类型的 DP，例如设定温度值、当前温度值和电量。
fault 型：
通常用于故障的上报，数据常用 bitmap 格式显示。
string 型：
通常用作字符串类型的 DP。需要以字符串形式传输的 DP 可以使用此类型。部分不便于使用 bool、enum、value 或 fault 类型的 DP，也可用此类型。
raw 型：
通常用作需要透传但对数据格式无要求（明文或者加密）的数据。发送端和接收端对数据的格式、组包和解析方式需要统一。

开发者根据自定义的功能属性选择相应的DP类型。例如，在IoT平台创建了一个名为温度的DP点，它的dpid为1，初始温度为25℃，那么将它放在一个数组中就可以表示为

DP_BUF[] = {0x01, 0x02, 0x04, 0x00, 0x00, 0x00, 0x19}

buf[0]: DPID（1）
buf[1]: DP类型（value）
buf[2]: DP长度（4）
buf[3 - 6]: 具体DP值（温度值25），采用大端传输。

配置完毕之后直接单击确定进入下一步。

4.配置面板

下载涂鸦智能APP(微信扫码即可下载)。

IoT平台提供了很多手机 APP 界面，可根据个人喜好进行选择。面板选择完成之后在涂鸦 APP 我的 - 右上角扫描上图中的二维码可在APP 中添加相应的产品。

5.硬件调试

在模组选择页面选择 涂鸦标准模组MCU SDK开发 对应模组选择WB3S 。

固件选择 模块通用固件方案 然后将开发资料一键打包下载。

开发资料包含：

• MCU SDK ：根据 IoT 平台控制台定义的产品功能，自动生成的基于 C 语言的 MCU 代码。通讯及协议解析架构已写好，可直接添加到自己的 MCU 工程中，快速完成 MCU 程序开发。
• 产品串口通讯协议：根据功能选择，自动生成的涂鸦模组串口通讯协议。
• 涂鸦串口调试助手：集成了涂鸦模组通讯协议的串口调试工具，用于 MCU 通用对接方案的开发调试。串口模拟助手既可以模拟MCU 也可以模拟模组，在未收到模组之前，开发者可用调试助手模拟模组进行开发调试。
• 功能点调试文件：配合调试助手使用的调试文件，包含产品 PID、功能点等信息。

6.MCU SDK移植

熟悉了上述流程以及串口调试助手的使用，接下来才是重头戏。MCU 与模组之间建立通讯，完成数据交互需要进行MCU SDK移植。将下载好的开发资料包中的MCU SDK文件在自己的项目工程进行移植，具体移植步骤参考 MCU SDK移植。需要注意，移植时建议开启两个串口，串口1用于MCU与模组之间数据收发，串口2用于打印调试信息提高移植效率。详细视频教程点击链接查看。