MCU SDK 开发

更新时间:2024-06-24 06:00:02下载pdf

本文介绍涂鸦 MCU 对接方案的开发流程,适用于快速入门。文章以介绍开发流程为主,从方案选型开始,将开发流程串联起来,您可根据实际需要查看对应文档。具体通讯协议的开发教程,可参考对应协议方案的开发概述。

简介

MCU 对接方案是对接涂鸦平台最常用的方案之一,主要用于带有 MCU 主控的产品实现智能化。涂鸦提供硬件模组、App 软件和云服务,您只需要关注产品本身功能的研发,配合使用涂鸦 MCU SDK、公版 App 及公版面板,一站式完成产品智能化,开发高效便捷。

方案选择

MCU 对接方案通信原理图如下:

MCU SDK 开发
  • 硬件方案:关于硬件方案的选择,主要关注通讯方式和模组选择。

    • 通常,烧录了通用固件的模组被称为通用模组。目前涂鸦通用模组支持的通信类型包括 Wi-Fi、蓝牙、Zigbee、NB-IoT 和 GPRS 等。
    • 对接前,首先要根据实际需求选择模组通讯方式。具体模组型号的选择,在 涂鸦开发者平台 创建产品后会有常用模组推荐。
  • App 方案:常用 App 方案,一般选择公版 App 或 OEM App。

    • 公版 App 智能生活 可直接免费下载使用,各大应用商店均可直接下载。
    • 如果您想拥有自己品牌的 App,涂鸦也提供 OEM App 服务,在线即可完成创建。更多详情,参考 OEM App
  • 云服务方案:涂鸦致力于为全球客户提供安全、稳定、快速的云服务,通过涂鸦模组连接云端,您无需投入研发。如果有云对接需求,也可以使用 OpenAPI 快速进行原生应用开发。更多详情,参考 云开发

产品创建

选定方案后,您需要在 涂鸦开发者平台 创建产品,下载 MCU 开发资料包。

开发者平台是涂鸦提供的 IoT 一站式开发平台,从产品创建到成品量产,所有环节均可在线完成。平台操作分四个主要步骤:

第一步:创建产品

创建产品的详细步骤可参考 选品类创建产品。创建产品时,要注意免开发方案和自定义开发方案的选择,MCU 对接的产品都是自定义开发方案。通讯类型的选择决定着协议和模组推荐。

MCU SDK 开发

第二步:功能定义

功能选择步骤可参考 产品功能

涂鸦将产品功能的抽象叫做 DP(功能点),涂鸦为所有产品提供了标准功能。您可以根据自己产品实际需求,选择对应的功能。若标准功能无法满足需求,您也可自定义功能。

MCU SDK 开发

第三步:选择面板

设备的 App 控制界面,通常称为面板。涂鸦提供近百种品类的公版面板供客户免费选择。公版面板支持个性化修改。更多详情,参考 配置 App 界面

MCU SDK 开发

第四步:下载开发资料包

根据产品和通讯方案的选择,开发者平台会推荐常用模组,您可直接在线下单购买。您也可以根据实际情况,选择更换模组。模组的规格书,参考 云模组规格书

MCU SDK 开发

资料下载区可一键下载 MCU 开发包,开发资料包含:

  • MCU SDK:根据开发者平台控制台定义的产品功能,自动生成的基于 C 语言的 MCU 代码。通讯及协议解析架构已写好,可直接添加到原有 MCU 工程中,快速完成 MCU 程序开发。

  • 产品串口通讯协议:根据功能选择,自动生成的涂鸦模组串口通讯协议。

  • 涂鸦串口调试助手:集成了涂鸦模组通讯协议的串口调试工具,用于 MCU 通用对接方案的开发调试。

  • 功能点调试文件:配合助手使用的调试文件,包含产品 PID、设备功能等信息。

    MCU SDK 开发

开发调试

产品创建完成后,在平台可购买模组样品,下载软件开发资料包,进入开发调试环节。针对不同的协议,文档中心提供相应的开发指导说明。根据下载的开发包中协议,参考以下文档:

硬件调试

拿到模组样品后,可搭建模组最小系统配合使用涂鸦上位机,配网体验操作过程,了解协议数据交互流程。硬件调试常用资料,参考以下文档:

软件调试

软件代码开发,若 MCU 资源充足,建议移植 MCU SDK。只需要调通串口底层驱动,协议对接部分无需开发,将极大缩减软件开发周期。不同 SDK 包对 MCU 硬件资源需求不同。以 Wi-Fi MCU SDK 为例,硬件资源需要:

  • Flash 扇区的大小 4K 字节。
  • RAM 大小与 DP 数据长度相关,RAM 为 100 字节左右。
  • 如果配置了 OTA 功能,RAM 需大于 260 字节。函数嵌套级数 9 级。

若资源不足,您可自行对接协议,SDK 包中的函数依然可以作为参考。更多有关软件调试的详情,参考 MCU SDK 移植教程

功能联调

功能联调时,经常需要查看后台数据判断问题,开发者平台运营中心可以满足您的需求。更多详情,参考 设备日志服务

涂鸦提供在线化的支持服务。如果文档资料未能解决您的问题,可直接在线提问。专业技术团队将为您答疑。关于支持中心介绍,参考 涂鸦支持中心使用教程