快速入门

更新时间:2024-04-08 08:18:04下载pdf

本快速上手教程旨在介绍如何基于 MCU 协议接入方式快速进行产品开发。

产品创建

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

第一步:创建产品

创建产品的详细步骤可参考 选品类创建产品

  1. 标准类目 中选择需要开发产品的品类,并在 选择智能化方式 中选择 产品开发

    快速入门
  2. 选择产品方案 中选择 自定义方案,MCU 标准协议接入的产品都使用自定义方案。

    快速入门
  3. 完善产品信息 中,输入产品名称和产品型号(可选),选择通讯协议类型和功耗类型。

    • 通讯协议:根据创建的产品类型,可以选择 Wi-Fi、Wi-Fi & 蓝牙、蓝牙、蓝牙 Mesh、Zigbee、NB-IoT、Cat.1、Tuya Beacon 等通讯协议方式。

    • 功耗类型:普通产品默认选择标准功耗,传感、安防等产品可选择标准功耗或低功耗方案。

      快速入门

第二步:功能定义

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

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

快速入门

第三步:选择面板

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

快速入门

第四步:硬件开发

  1. 自定义开发包括 MCU SDK 和 TuyaOS 两种方式,MCU 通用协议接入选择 MCU SDK 方式。

    快速入门
  2. 选择接入硬件。平台会推荐常用模组,您可直接在线下单购买。您也可以根据实际情况选择更换模组。模组的规格书,请参考 云模组规格书

    快速入门

    选定模组后,单击 选择,平台会显示当前选择模式的固件信息,也可以通过 更换版本 选择其他固件版本。

    快速入门
  3. 下载开发资料。开发资料包括:

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

    • 快速入门指南:根据产品功能自动生成的串口协议指令。

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

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

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

      快速入门

开发调试

产品创建完成后,在平台可购买模组样品,下载软件开发资料,进入开发调试环节。

第一步:硬件调试

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

第二步:软件调试

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

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

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

第三步:功能联调

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

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