扫地机对接开发流程

准备工作

在涂鸦开发者平台，注册开发者账号，开启产品智能化。

为了使用日志查询、权限分享等相关功能，请开通企业版权限。

开发者平台链接：https://platform.tuya.com。

流程概述

• 产品定义：在开发者平台定义产品的具体功能，核心是数据传输内容及格式；

• 界面配置：根据产品特点，选择和配置个性化的UI，核心是风格、颜色、图标等；

• 硬件选型：根据产品PCB的特点及要求，选择适配的WiFi通讯模组；

• MCU开发：对MCU控制程序进行适配开发，核心是配网、数据交互、地图传输等；

• APP构建：构建具有厂商特点的APP，核心是LOGO、欢迎页、设备页等；

• 运营管理：配置APP界面多国语言、申请开通智能音箱、设备OTA升级等核心操作；

具体操作

产品定义

新建产品

在涂鸦开发者平台创建产品，选择【小家电】-【扫地机器人】，点击“创建产品”即可开始创建产品。

相关说明：

• 产品名称：实际设备的默认名，将显示在APP中设备页；

• 通讯类型：硬件连接涂鸦 IoT PaaS的方式，目前支持Wifi方式；

功能定义

如何定义DP

涂鸦平台将设备与云端传输的数据，抽象成不同类型的DP，在定义DP时，可根据机器功能，分类成不同的DP点，用于控制和显示。

为满足不同开发需求，涂鸦平台提供标准化功能和自定义功能：

• 标准功能：针对常规扫地机功能的标准化，与开发者平台提供的APP面板相对应，用于快速开发；
• 自定义功能：自定义扫地机的附加功能项，用于扩展机器功能；

标准化功能

标准功能涵盖清扫开关、清扫状态等功能点。同时，枚举型功能允许用户新增类型，如清扫模式，工作状态，错误码等，新增后，APP设备控制页会同步更新。

自定义功能

对于机器的扩展功能，可在“自定义功能”中进行新增，新增后，在APP的设备控制界面的设置页中会生成相应的控制项。

开发者平台提供布尔、数值、枚举、字符、故障、raw等数据类型，支持上下行。

详细介绍参考：https://docs.tuya.com/cn/product/function.html。

界面配置

产品定义后，可以选择不同风格的面板（设备控制页），作为扫地机的交互页面。在开发者平台，提供公版面板、自定义面板、自由配置面板，以及开发调试面板，供用户选择。

公版面板：样式与交互固定，与【标准功能】对应，支持背景、颜色等内容的配置，用于产品量产。

自由配置面板：支持自由设置页面控件及样式，用于自定义产品；

调试面板：以开关选项方式显示机器端数据，用于开发阶段调试；

模组选型

扫地机电控，主板通过云模组，与涂鸦 IoT PaaS和APP进行通讯连接。在产品新建后，选择适用的云模组，并根据主板、云模组的接口电路及产品要求，完成硬件电路的开发。

目前，惯导型扫地机产品可供选用的是WR3 WIFI模组，模组详细说明，请参考：https://docs.tuya.com/cn/hardware/WiFi-module/wifi-wr3-module.html。

MCU开发

MCU程序开发

云模组通过串口通讯方式与MCU对接，MCU端根据【产品定义】步骤中定义的功能DP，实现机器数据与云端的交互。MCU开发过程主要涉及协议的解析、数据的上报与接收、地图数据的上报等。

MCU开发，有两种方式可选择：

• 串口协议方式

MCU根据串口协议，自行组包和解包，实现数据的上报和执行；

• SDK方式

移植开发者平台封装好的SDK接口文件，MCU直接调用相关函数，实现数据的上报和执行。
开发详情，请参考：https://docs.tuya.com/cn/product/mcu-dev.html。

机器功能调试

在产品开发的验证和调试阶段，为了验证技术方案、或APP面板的功能，可采用开发者平台提供的调试助手及调试面板，实现APP端和机器端的数据通讯，辅助开发过程的开发调试。

仿真助手

涂鸦 IoT PaaS仿真助手，PC机与云模组通过串口连接，模拟MCU收发机器功能DP数据，可在APP端实时体验交互效果。

适用于在MCU程序开发前，对所定义的产品功能进行验证，以及调试过中数据有效性的验证。

仿真助手使用详情，请参考：https://docs.tuya.com/cn/mcu/cloud_debug_assistant.html。

面板调试

在设备配网功能调试完成后，可以通过APP对扫地机进行配网，在APP上对扫地机进行相关操作，验证指令收发，APP显示、机器执行等是否正确。

同时，MCU在开发前期，可以借助调试面板功能，单独调试某个DP的逻辑是否正确。

调试面板只保留数据收发操作，不含交互逻辑，可以在【界面配置】环节选择，适用于开发过程的调试。

日志查询

开通调试过程中，会遇到DP数据收发过程查询的需求。开发者平台提供日志查询功能，可以查看扫地机MCU与APP间的数据通讯情况，适用于异常情况下，排查各端的操作情况。

【说明】日志查询功能，需要开通“企业版”账户权限，并在运营平台操作。

APP构建

当机器功能开发完成后，将涉及自有品牌APP的构建。涂鸦平台提供在线OEM APP的功能。

在IoT的【APP工作台】，可配置APP名称、LOG、配网文案、产品图标等信息，生成具备厂商标识信息和个性化的OEM APP。

详细操作请参考：https://developer.tuya.com/cn/docs/iot/app-development/oem-app/app-autobuilding/appautobuilding

相关配置

多语言配置

当产品目标市场是海外区域时，需要将APP界面的语言调整成相应区域的语种，目前可支持大部分国家和地区。

在开发者平台“拓展功能”的“多语言配置”，可对设置功能点进行多语言编辑，完成编辑后。当手机调整系统语言后，APP界面语言也随之调整。

OTA升级

为了满足机器功能升级，平台支持MCU OTA功能。

在开发者平台“拓展功能”的“固件升级”，可以自定义上传MCU固件，固件版本、升级信息等都支持自定义管理。