开发取暖器产品

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

第一步 功能定义

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

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

功能点数据类型

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

标准功能点

功能点名称	标识符	数据传输类型	功能点类型	是否必选	备注
开关	switch	可上报可下发	bool	否
目标温度	temp_set	可上报可下发	value	否	范围需根据取暖器功能设计调整
当前温度	temp_current	只上报	value	否	设备感知温度有变化时需上报，确保取暖器显示和APP面板显示值统一
工作模式	mode	可上报可下发	enum	否	可在标准枚举基础上增减
档位	level	可上报可下发	enum	否
ECO模式	eco	可上报可下发	bool	否
童锁	child_lock	可上报可下发	bool	否
摇头	shake	可上报可下发	bool	否
负离子	anion	可上报可下发	bool	否
灯光	light	可上报可下发	bool	否
倒计时	countdown	可上报可下发	enum	否	1、已设置倒计时开/关机，倒计时执行期间，倒计时剩余时间应每分钟更新一次（ n=n-1 ）； 2、倒计时剩余时间为0时, 取暖器执行相应的逻辑, 并关联上报倒计时为0； 3、倒计时执行期间，如人为提前开启/关闭取暖器，倒计时应自动结束, 关联上报倒计时、倒计时剩余时间为0； 4、可配置为只倒计时关机。
倒计时剩余时间	countdown_left	只上报	value	否
故障警告	fault	只上报	bitmap	否
工作状态	work_state	只上报	enum	否
当前功率	work_power	只上报	enum	否
周程序（六段式）	week_program_5	可上报可下发	raw	否	默认每天设置六段，可配置为1-6段定时，需MCU开发，168字节 备注1：配置请提工单或使用“涂鸦开发者”APP联系项目经理； 备注2：周程序对接协议详见《周程序详细说明》
周程序（模式 ）	week_program_6	可上报可下发	raw	否	7x24选择模式 设备定时，需MCU开发，168字节
周程序（自由式）	week_program_7	可上报可下发	raw	否	7x24选择温度 （可配置为开关 ，模式，模式+开关 ）纯云端定时； 备注：该功能与“云功能”中的 定时只能选择一个。
周程序（ 开关）	week_program_8	可上报可下发	raw	否	7x24选择开关 需MCU开发， 21字节
周程序（ 温度）	week_program_9	可上报可下发	raw	否	7x24选择温度 需MCU开发，168字节
温度切换	temp_unit_convert	可上报可下发	enum	否	默认使用哪种温标
目标温度F	temp_set_f	可上报可下发	value	否	配合温标切换使用
当前温度F	temp_current_f	可上报可下发	value	否	配合温标切换使用
云功能：定时	云功能	-	-	否	1、可当做周程序使用，默认为最多30条，配置后会将逻辑存在模块上，通过模块时钟控制设备的模块定时；（配置成功后断网也能使用） 2、定时中默认只有开关，可配置增加模式、温度； 3、可配置为纯云端定时，与周程序（自由式）week_program7只能选一个。

自定义功能

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

高级功能

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

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

第二步 配置面板

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

第三步 硬件设计

硬件开发主要包括硬件的设计和嵌入式开发，取暖器产品通常采用MCU SDK的开发方式

硬件设计参考

通用设计

序号	设计类型
1	硬件设计参考

模组选型

序号	通讯方式	支持模组	硬件设计参考文件
1	Wi-Fi+蓝牙	推荐 WBR3	WBR3硬件设计参考
2	蓝牙单点	推荐 BT7L	BT7L硬件设计参考
3	Zigbee	推荐 TLZS7	BT7L硬件设计参考
4	LTE	推荐 LZ201-CN	LZ201-CN 硬件设计参考

第四步 嵌入式开发

嵌入式开发根据开发方式可以分为 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。

涂鸦测试服务

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

第八步 产品发布

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

后续步骤

产品认证

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