开发产品

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

第一步 功能定义

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

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

功能点数据类型

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

功能点详情说明

DP ID 1～6：开关（必选）

开关，支持 6 路。

数据类型	取值范围
布尔型	支持 6 路。 0：关 1：开

DP ID 7～12：倒计时（必选）

开关倒计时，支持 6 路。

数据类型	取值范围
数值型	Wi-Fi 和蓝牙通讯协议：0~24 小时 Zigbee 通讯协议：0~12 小时

DP ID 13：总开关（可选）

支持开关全开全关。

数据类型	取值范围
布尔型	0：关 1：开

DP ID 14：上电状态设置（可选）

开关断电上电状态设置，总控功能（不支持每路开关分控）。

数据类型	取值范围
枚举型	off：断电，指设备断电重新上电后，默认处于断电状态 on：通电，指设备断电重新上电后，默认处于通电状态开 memory：断电记忆，指设备断电重新上电后，通/断电状态与断电前保持一致

DP ID 15：指示灯状态设置（可选）

指示灯状态设置，总控功能（不支持每路开关分控。

数据类型	取值范围
枚举型	none：指示灯关闭，指默认指示灯关闭。 relay：指示灯指示开关状态，开关开则指示灯亮，开关关则指示灯灭。开关和指示灯状态同步 pos：指示灯指示设备位置，开关开则指示灯灭，开关关则指示灯亮。开关和指示灯状态相反，用于在黑暗环境下提示开关所在位置

DP ID 16：背光开关（可选）

背光开关，控制背光灯开启或关闭，总控功能（不支持每路开关分控）。

数据类型	取值范围
布尔型	0：关 1：开

DP ID 17：循环定时（可选）

循环定时，设置一段总的时间，在此时间段内可以设置开启时间段和关闭时间段，之后将以此时间循环开启和关闭。循环定时主要用于解放劳动力，用于循环浇灌、投食、灯光场景控制等。

• Wi-Fi 和 Wi-Fi+BLE 协议下为 string 类型 DP
• 蓝牙和 Zigbee 协议下为 raw 类型 DP

DP ID 18：随机定时（可选）

随机定时，设置一段总的时间，在此时间段内随机开启和关闭设备。随机定时主要用于防盗，当不在家时，通过随机控制室内开关灯来模拟人在家场景，达到防贼的目的。

• Wi-Fi 和 Wi-Fi+BLE 协议下为 string 类型 DP
• 蓝牙和 Zigbee 协议下为 raw 类型 DP

DP ID 19：点动开关（可选）

点动开关，设置一个时间段，执行每次开启设备后运行设置的时长后自动关闭的自动化场景，避免频繁设置倒计时。点动开关主要用于走廊、楼道等公共场合。如设置为点动模式(一分钟⾃动关闭)的墙壁开关连接了了⼀盏走廊灯，用户每次经过走廊的时候只需要开灯，一分钟后这个墙壁开关会自动把它关闭，不再需要专门设置倒计时或者手动关灯。

点动开关为 string 类型 DP。

DP ID 20～28：电量统计（可选）

电量统计功能，总控功能（不支持每路开关分别统计电量）。

DP ID 29～34：上电状态设置（可选）

开关 1～6 断电上电状态设置，分控功能（支持每路开关分控）。

数据类型	取值范围
枚举型	off：断电，指设备断电重新上电后，默认处于断电状态 on：通电，指设备断电重新上电后，默认处于通电状态开 memory：断电记忆，指设备断电重新上电后，通/断电状态与断电前保持一致

自定义功能

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

云功能

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

• 云定时功能：包括设定开关时间及周循环，无需硬件嵌入式开发。
• 网页跳转功能：主要可用于设置产品购买的微商城、产品使用说明等各种页面。

第二步 配置面板

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

第三步 硬件设计

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

硬件设计参考

通用设计

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

免开发方案

序号	通讯方式	开关路数	供电类型	控制类型	支持模组	硬件设计参考文件	数据规格书
1	Wi-Fi+蓝牙	1-4 路开关	零火线	单控	WB3S	WB3S 原理图	WB3S 模组规格书
2	Wi-Fi	1-4 路开关	零火线	单控	WR3、TYWE3S	WR3 原理图 TYWE3S 原理图	WR3 模组规格书 TYWE3S 模组规格书
3	蓝牙 Mesh(SIG)	1-4 路开关	零火线	单控	BT3L	BT3L 原理图	BT3L 模组规格书
4	Zigbee	1-4 路开关	零火线	单控	ZS3L、TYZS3	ZS3L 原理图 TYZS3 原理图	ZS3L 模组规格书 TYZS3 模组规格书
5	Zigbee	1-4 路开关	单火线	单控	ZS3L、TYZS3	ZS3L 原理图 TYZS3 原理图	ZS3L 模组规格书 TYZS3 模组规格书
6	Zigbee	1-2 路开关	单火线	双控	ZS3L	ZS3L 原理图	ZS3L 模组规格书

自定义开发方案

序号	通讯方式	开关路数	供电类型	控制类型	支持模组	硬件设计参考文件
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 设备烧录授权

第七步 产品测试

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

自行下载测试用例

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

云测 App

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

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

涂鸦测试服务

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

第八步 产品发布

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

后续步骤

产品认证

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