网关 MCU 接入方案

本文介绍涂鸦网关通用方案 MCU 开发过程。开发流程主要包含创建产品、硬件调试、软件开发和功能调试。

创建产品

登录 涂鸦开发者平台，根据实际需求，选择网关产品。关于创建产品的具体步骤，参考 产品创建-平台实操。

目前，有 Wi-Fi（CR3L 模组方案）和 Wi-Fi+以太网（THP23-X-M 模组方案）两种方案可以选择。

• CR3L 方案里，下行协议类型只支持 蓝牙Mesh(SIG)_蓝牙_其他。

  

• THP23-X-M 方案里，下行协议类型支持 蓝牙Mesh(SIG)_Zigbee_蓝牙_其他，用户可以自行选择需要的协议类型。

  

产品创建完成后，根据产品实际需求，选择功能、面板、模组、固件，就可以下载 MCU 开发包。

创建子设备

创建产品时，选择非免开发的方案。如果能选到下图的协议，即为子设备的方案。

硬件调试

硬件选型

在创建产品选择模组时，平台会根据产品创建时选择的方案，自动生成对应的模组型号信息。

CR3L 模组方案：

THP23-X-M 模组方案：

选定模组和固件后，可在线购买模组样品。硬件工程师可以进入画板阶段，硬件开发相关资料均可在文档中心查看：

• CR3L 数据手册

• THP23-X-M 数据手册

配网验证

用户拿到模组后，可先不必着急编写代码，建议使用涂鸦提供的模组调试助手（MCU 模拟模式）与 CR3L 模组先连接和验证。在验证模组的同时，用户可熟悉协议交互流程，后续开发调试效率将极大提升。

涂鸦模组调试助手 - MCU 模拟模式，助手会模拟 MCU 自动回复模组正确的协议数据，用手机给模组配网后可测试 DP 数据的上报下发。下文简要介绍助手和模组配网实操的主要步骤，使用前，需提前了解 涂鸦模组调试助手使用说明。

1. 根据最小系统原理图，搭建模组外围电路，简单测试可直接飞线。

2. 设置设备能力，打开开发包中涂鸦模组调试助手，导入调试文件。协议选择 Wi-Fi 网关协议，MCU 模拟模式。

3. 将模组串口通过 USB 转 TTL 工具接到电脑端，助手选择对应的串口及波特率，打开串口单击 启动，将看到模组和上位机自动进行初始化流程协议交互。

   若上电无数据发出，检查模组外围电路是否正确。

4. 单击 RESET，模组进入配网模式。模组支持两种配网模式：蓝牙 和 AP 模式。根据状态提示，App 进行相应的配网操作，配网操作可阅读 App 使用说明。

   

软件开发

在硬件调试环节实操的过程中，可以看到模组与 MCU 有一系列的串口协议交互数据，这些数据的理解可参考开发包中协议文档。

协议主要分为两部分：基础协议和功能协议。

• 基础协议 和产品无关，是模组共有协议，包括模组初始化指令及部分扩展功能指令。基础协议完整内容，文档中心保持实时更新，可查看 涂鸦网关 MCU 对接通信协议。
• 功能协议 主要基于基础协议的上报下发命令字，对 DP 数据内容格式做了详细说明。

MCU 对接涂鸦模组协议，有两种途径：移植 MCU SDK 或自行对接协议。

途径 1：自行对接协议

对于 MCU 资源有限或不适宜移植 MCU SDK 时，可以选择自行对接串口协议。关于串口协议的详细介绍，参考 涂鸦网关 MCU 对接通信协议。

途径 2：移植 MCU SDK

• 若 MCU 资源足够，一般建议直接移植 MCU SDK，开发高效便捷。开发包中 MCU SDK 是涂鸦提供的基于 C 语言的协议应用代码，可直接添加到 MCU 工程中。MCU SDK 对 MCU 硬件资源需求：
  • Flash 4K 字节。
  • RAM 与 DP 数据长度有关，一百字节左右。如需 OTA 功能，需大于 260 字节。
  • 函数嵌套级数 9 级。
• 若资源不足的用户，可自行对接协议，SDK 包中的函数依然可以作为参考。

MCU SDK 移植教程，参考 涂鸦 Wi-Fi 网关 MCU SDK 说明。

功能调试

移植 MCU SDK 代码开发完成后，可以使用涂鸦模组调试助手-模组模拟模式，验证 MCU 代码的正确性。使用方法与 MCU 模拟模式类似，模拟模组模式下，助手会自动发送初始化数据流，验证 MCU 回复是否正确，对于错误数据给予相应提示。初始化交互通过后，可以手动单击测试其他拓展功能。

常用调试工具：

• 后台日志查询：访问开发者平台，选择 产品 > 设备日志。根据设备 ID，查询相关设备的后台日志数据。

• 涂鸦在线支持：涂鸦提供在线化的支持服务。如果文档资料无法解答您的问题，可直接在线提问，专业技术团队将为您答疑。