开发产品

在涂鸦 IoT 开发平台上开发产品开发主要包含对产品功能模型的定义、面板的选择和定制、嵌入式固件开发以及产测测试。

第一步 功能定义

产品功能由三部分组合完成，包括标准功能、自定义功能及云功能。

产品功能是涂鸦 IoT 开发平台对智能硬件设备功能的抽象表示，用于描述实际硬件产品功能及其参数。确定了产品功能后，涂鸦 IoT 开发平台会基于智能硬件设备的产品功能生成云端控制对接模型，便于硬件开发者理解产品功能及其数据交互方式。

功能点数据类型

功能点数据类型包含布尔型、数值型、枚举型、故障型、字符型、RAW 型，详细信息请参考 数据类型。

标准功能点

加湿器产品确定后，相应的功能点需要抽象成不同的DP点，以实现数据传输和控制，针对加湿器品类，以公版产品定义为例，加湿器功能与DP的对应关系如下：

DP ID	功能点	标识符	数据传输类型	功能点类型	功能点属性
1	总开关	switch	可下发可上报	布尔型
2	喷雾开关	switch_spray	可下发可上报	布尔型
3	喷雾量	spray_volume	可下发可上报	枚举型	枚举值large, middle, small
4	喷雾模式	spray_mode	可下发可上报	枚举型	枚举值auto, health, baby, sleep, humidity, work, manual
5	灯光	switch_led	可下发可上报	布尔型
6	灯光模式	work_mode	可下发可上报	枚举型	枚举值white, colour, colourful1
7	彩光值	colour_data	可下发可上报	字符型
8	声音	sound	可下发可上报	布尔型
9	温度设置	temp_set	可下发可上报	数值型	数值范围：0-50, 间距：1, 倍数：0, 单位：℃
10	当前温度	temp_current	只上报	数值型	数值范围：0-50, 间距：1, 倍数：0, 单位：℃
11	温度设置（℉）	temp_set_f	可下发可上报	数值型	数值范围：0-100, 间距：1, 倍数：0, 单位：℉
12	当前温度（℉）	temp_current_f	只上报	数值型	数值范围：0-100, 间距：1, 倍数：0, 单位：℉
13	湿度设置	humidity_set	可下发可上报	数值型	数值范围：0-100, 间距：1, 倍数：0, 单位：%
14	当前湿度	humidity_current	只上报	数值型	数值范围：0-100, 间距：1, 倍数：0, 单位：%
15	亮度值	bright_value	可下发可上报	数值型	数值范围：10-1000, 间距：1, 倍数：0, 单位：
16	睡眠	sleep	可下发可上报	布尔型
17	当前水位	level_current	只上报	数值型	数值范围：1-5, 间距：1, 倍数：0, 单位：level
18	温标切换	temp_unit_convert	可下发可上报	枚举型	枚举值c, f
19	倒计时	countdown_set	可下发可上报	枚举型	枚举值cancel, 1h, 2h, 3h, 4h, 5h, 6h, 7h, 8h, 9h, 10h, 11h, 12h
20	倒计时剩余时间	countdown_left	只上报	数值型	数值范围：0-360, 间距：1, 倍数：0, 单位：min
21	除菌	sterilization	可下发可上报	布尔型
22	故障告警	fault	只上报	故障型	故障值lack_water
23	喷雾档位	level	可下发可上报	枚举型	枚举值level_1, level_2, level_3, level_4, level_5, level_6, level_7, level_8, level_9, level_10
24	工作模式	mode	可下发可上报	枚举型	枚举值natural_evaporation, heating_evaporation, ultrasonic_evaporation
25	负离子	anion	可下发可上报	布尔型
26	加热	heat	可下发可上报	布尔型
27	香薰	fragrance	可下发可上报	布尔型
28	滤芯复位	filter_reset	可下发可上报	布尔型
29	童锁开关	child_lock	可下发可上报	布尔型
30	eCO2	eco2	只上报	数值型	数值范围：350-2000, 间距：1, 倍数：0, 单位：ppm
31	TVOC	tvoc	只上报	数值型	数值范围：0-2000, 间距：1, 倍数：0, 单位：ppm
32	PM2.5	pm25	只上报	数值型	数值范围：0-1000, 间距：1, 倍数：0, 单位：
33	滤网寿命	filter_life	只上报	数值型	数值范围：0-100, 间距：1, 倍数：0, 单位：%
34	背光亮度	backlight_enum	可下发可上报	枚举型	枚举值closed, level_1, level_2, level_3
35	等离子	plasma	可下发可上报	布尔型
36	背光开关	switch_backlight	可下发可上报	布尔型

自定义功能

如果你的产品功能不在标准功能中，你可以添加自定义功能，详情请参考 产品智能化 - 自定义功能。

高级功能

目前支持的高级功能包括云定时和网页跳转功能，详情请参考 产品智能化 - 云功能。

• 云定时：包括设定开关时间及周循环，无需硬件嵌入式开发。
• 离线提醒：设备离线可在 App 上进行消息推送。
• 网页跳转：主要可用于设置产品购买的微商城、产品使用说明等各种页面。

第二步 配置面板

在定义完产品功能后，可以为其配置一款 App 面板。面板是展示在用户手机 App 上的控制智能产品界面，详细的面板配置以及面板开发教程请参考 配置 App 界面 和 面板开发。

第三步 硬件设计

硬件开发主要包括硬件的设计和嵌入式开发，电工产品我们提供了部分产品的免开发方式，无需编码只需要调整好配置文件参数即可生成固件，免开发方案满足不了您的业务需求时此外您还可以通过 MCU SDK 或者 TuyaOS 的方式进行自定义开发。

硬件设计参考

通用设计

序号	设计类型
1	电源设计
2	电工产品合规设计

模组选型

WBR3 模组
WBR3 是由涂鸦智能开发的一款低功耗嵌入式 Wi-Fi 加蓝牙模组。它由一个高集成度的无线射频芯片W701-VA2-CG构成，内置了 Wi-Fi 网络协议栈和丰富的库函数。
WBR3 包含低功耗的 KM4 MCU，WLAN MAC，1T1R WLAN，最高主频 100MHz，内置 256K SRAM ，芯片内置 2Mbyte flash 和丰富的外设资源。
WBR3 是一个 RTOS 平台，集成了所有 Wi-Fi MAC 以及 TCP/IP 协议的函数库。用户可以基于这些开发满足自己需求的嵌入式 Wi-Fi 产品。
内置低功耗 KM4 MCU，可以兼作应用处理器
优势

• 瑞昱芯片:是世界著名的半导体集成电路设计公司，单因占全球70%份额的网络IC销售，产品线横跨网络通信、电脑周边、多媒体、消费电子、数位影像技术等领域，研发技术与世界先进产业主流并驾齐驱
• 稳定性更强
  射频性能好，可以支撑更稳定长时工作的家电产品，时刻保持流畅状态内存容量更大，支撑更多数据运转
• 资源更丰富
  针对家用大电、小电有丰富的外设资源，可以满足音视频、触控按键、语音控制灯等多种外接设备

WBR3 模组规格
主频 100MHz
工作电压：3V-3.6V
外设：9×GPIOs, 1×UART, 1×Log_Tx
Wi-Fi/蓝牙连通性
802.11 B/G/N20
通道 1-14@2.4GHz(CH1-11 for US/CA, CH1-13 for EU/CN)
支持 WEP/WPA/WPA2/WPA2 PSK（AES） 安全模式
支持 Bluetooth 4.2 Low Energy
802.11b 模式下 +20dBm 的输出功率
支持 SmartConfig 功能，包括 Android 和 iOS 设备
板载 PCB Onboard 天线
通过 CE、FCC 认证
工作温度：-20℃ to 85℃

序号	通讯方式	开关路数	供电类型	控制类型	支持模组	硬件设计参考文件
1	Wi-Fi+蓝牙	1-4 路、更多路开关	零火线、单火线	单控、双控	推荐 WB3S	Wi-Fi+BLE 2 路零火双控开关
2	Wi-Fi	1-4 路、更多路开关	零火线、单火线	单控、双控	推荐 WR3、TYWE3S	基于 E3S 的 3 路触摸开关的原理图(反激式) Wi-Fi 1 路零火双控开关
3	蓝牙 Mesh(SIG)	1-4 路、更多路开关	零火线、单火线	单控、双控	推荐 BT3L	/
4	蓝牙 BLE	1-4 路、更多路开关	零火线、单火线	单控、双控	推荐 BT3L	/
5	Zigbee	1-4 路、更多路开关	零火线、单火线	单控、双控	推荐 ZS3L、TYZS3	Zigbee1-4 路零火开关 Zigbee 1-3 路单火可控硅开关 Zigbee 1-3 路单火磁保持开关 Zigbee 1 路单火双控开关

第四步 嵌入式开发

嵌入式开发根据开发方式可以分为 MCU SDK 和 TuyaOS 两种开发方式，需要您完成设备的接入以及业务代码的开发。

MCU SDK

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

MCU SDK 方案上手流程可参考 MCU 低代码开发。

其中，开关产品涉及到的通信协议包含 Zigbee，Wi-Fi+蓝牙，蓝牙 Mesh，可参考以下文档进行开发：

• Wi-Fi 通用方案
• 蓝牙通用方案
• 蓝牙 Mesh 通用方案
• Zigbee 通用方案

TuyaOS

TuyaOS 是一种基于 RTOS、Linux、Non-OS 等设计的应用于物联网（IoT）领域面向全连接、全场景的分布式跨平台操作系统。

通过 TuyaOS 内核（Kernel）标准的制订及设计，让您能够从不同的芯片平台、系统及连接协议等糟糕的碎片化开发体验中得到解放，专注于自身业务的发展，并且一次开发、多端可用、安全稳定加快产品上市。

TuyaOS 整体架构采用分层、可插拔组件的方式设计，可根据芯片资源状况自由裁剪，生成符合资源需求的开发框架。通过涂鸦独有的 DP 协议及自研高效的 RPC 通信机制，使得所有采用 TuyaOS 开发的不同通信协议的产品之间，能够互联互通。

其中，空气净化器产品涉及到的开发方案包含：

• Wi-Fi 设备接入开发指南
• 蓝牙设备接入开发指南
• 蓝牙 Mesh 设备接入开发指南
• Zigbee 设备接入开发指南

第五步 产品配置

产品配置项包含固件升级、产品语音能力、多语言管理、设备消息推送、配网信息、场景联动设置、快捷开关配置、产品知识维护、产品说明书。这些功能配置项都可以通过全球部署的云服务为终端消费者提供更好的个性化的产品体验，并且能够实时更新生效，无需重新更换硬件出货。

其中多语言管理、配网信息、产品语音能力和场景联动设置是您需要特别注意的，要根据您的产品销售区域、配网方式和功能特点进行精细化地管理。

您可以参考下方链接，依次详细了解每一项的配置操作：

• 固件升级

• 产品语音能力

• 多语言管理

• 设备消息推送

• 配网信息

• 场景联动设置

• 快捷开关设置

• 产品知识维护

• 产品说明书

第六步 烧录授权

固件开发完成后，需要将固件和授权码烧录到设备内，才可以连接云服务。涂鸦提供多种烧录授权方式供您使用，您可在不同的开发阶段选择合适的烧录授权方式。

• Wi-Fi 设备烧录授权
• 蓝牙设备烧录授权
• Zigbee 设备烧录授权

第七步 产品测试

在涂鸦 IoT 平台上发布产品前，必须提交测试报告，或者您可以通过自行下载并执行用例、涂鸦云测 App 或者 涂鸦测试服务来完成产品测试。

自行下载测试用例

对于部分品类，您可以在 测试服务 页面自行下载用例并提交测试报告。

云测 App

为了开发者能快速找出设备问题所在，云测 App 以功能模块为维度，提供多种执行测试模式，可以对设备硬件状态和交互链路进行一体化测试。

详细测试操作请参考 云测 App。

涂鸦测试服务

涂鸦测试服务请参考 测试服务。

第八步 产品发布

当提交产品测试报告后，您可以直接在平台产品开发流程中发布产品。

后续步骤

产品认证

产品要取得销售许可，需要进行一系列的认证。涂鸦结合多年智能产品落地经验，提供一系列硬件产品认证支持服务，您可以根据自己的产品类型和认证需求选择合适的方案。详细认证方式请参考 产品认证。