近年来，传统温控器由于受限于硬件及软件的交互方式，在实现一些复杂的功能，例如：编程、自定义模式，让用户很难在实际使用中得到很好的操作体验，于是纷纷选择了转向发展智能温控器，通过手机作为更加友好和易用的操作界面，可以能将这些很难被客户重视的功能，以更加友好的操作方式重新，比如可以通过App或者各种语音音箱实现控制，从而为客户带来节能、舒适和便利操作等价值。
本文为开发者对接温控器方案相关文档，提供开发者对接涂鸦温控器产品的方案，本方案主要介绍有关温控器产品方案，适用于温控器产品开发者快速入门，了解并快速接入涂鸦平台。
MCU对接方案是目前温控器对接涂鸦平台最常用的方案之一。主要用于带有MCU主控的温控器产品实现智能化，直接对接涂鸦模组串口协议即可实现联网。客户只需要关注产品本身的功能研发，联网智能化部分使用公版方案或者面板工作台，具体MCU方案通信原理图如下：
涂鸦联网模块：实现温控器产品配网，采用串口通信方式连接App和云端实现产品指令上传下发。
涂鸦云：全球部署云服务，为客户提供安全、稳定、快速的涂鸦云服务。
涂鸦App：
1）公版App：免费公版App，即刻使用，场景丰富，全球通用；
2）OEM App：一键生成自有品牌的独立App；
3）App SDK：多种方式快速定制开发自有App ;
语音服务：
1）三方语音服务：支持Alexa、Google Assistant、百度小度、腾讯叮当等语音服务；
2）涂鸦自研语音服务；
3）AVS语音模组接入，让你的温控器成为音箱；
4) 定制语音技能，让你的产品与众不同；
方案详情核心功能快速配网：支持EZ和AP两种配网方式,双模方案支持蓝牙自动发现设备；
常规功能：开关功能、工作模式、当前模式、童锁功能等；
温度调节：目标温度、温度上限、温度下限、当前温度、温度校准等；
周程序：支持纯云端定时（免开发）和本地协议执行等多种方式；
假日模式：支持设置假日度假时间和假日温度设置；
地理围栏：支持地理围栏功能，实现在家和离家模式;
传感器选择：支持内部传感器选择以及外部传感器设置；
电池电量：支持显示设备当前电量；
倒计时功能：支持设置设备倒计时运行;
故障告警：支持机器故障、告警、通知等消息推送；
设备分享：支持家庭管理、成员间设备分享；
OTA升级：支持提示/静默等方式的设备及模组升级；
多语言管理：支持多种语言的配置管理和切换；
针对温控器MCU对接方案，推荐使用WBR3联网模组: 概述： WBR3 是由涂鸦智能开发的一款低功耗嵌入式 Wi-Fi+BT 模块。它由一个高集成度的无线射频芯片 RTL8720CF 构成，内置了 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，可以兼作应用处理器 主频 100MHz - 工作电压：3V-3.6V - 外设：9×GPIOs, 1×UART, 1×Log_Tx - Wi-Fi/BT 连通性 1）802.11 B/G/N20 2）通道 1-14@2.4GHz(CH1-11 for US/CA, CH1-13 for EU/CN) 3）支持 WPA/WPA2 安全模式 4）支持Bluetooth 4.2 Low Energy 5）802.11b 模式下+20dBm 的输出功率 6）支持 SmartConfig 功能（包括 Android 和 iOS 设备） 7）板载 PCB Onboard 天线 8）通过 CE,FCC 认证 9）工作温度：-20℃ to 85℃
尺寸封装： WBR3 共有 2 排引脚（2×8），引脚间距为 2mm。 WBR3 尺寸大小：16±0.35 mm (W)×24±0.35 mm (L) ×2.9±0.15 mm (H)。WBR3尺寸图如下图所示：
开关温控、空调温控、地暖温控、新风温控、采暖温控、热泵温控、锅炉温控等各类温控产品
产品创建流程：
登陆平台请登录开发者平台:iot.tuya.com 。
若没有注册，请先注册。若已经注册，请直接登录。
为了使用日志查询、权限分享等相关功能，请升级为企业版账号。
创建步骤产品创建共分五步走：
STEP1：产品创建，在IoT平台定义产品具体功能，根据产品功能定义选择创建对应的DP点（功能点）。
STEP2：面板配置，涂鸦提供多种公版面板供客户免费选择，公版面板支持个性化修改，客户可根据品牌调性进行自定义修改颜色、图标等。
STEP3：硬件开发，根据产品特性及PCB的要求，选择合适的通讯模组，选择好后下载MCU开发包进行MCU开发调试。
STEP4：云端配置，多语言配置，固件升级配置，告警设置，配网信息设置等扩展功能配置中心。
STEP5：投产安排，产品开发完成，进入到投产阶段，试产阶段确定后，即可进入采购中心进行批量采购。
产品创建在涂鸦IoT平台创建产品，选择【小家电】-【温控器】，点击创建产品即可开始进行产品创建。
相关说明：
1.产品说明：实际设备名称（建议命名为：品牌+产品名），该名称将在App的设备页面显示。
2.通讯类型：产品硬件连接涂鸦云的方式，目前支持Wi-Fi+蓝牙、Wi-Fi、蓝牙、Zigbee和其他多种通讯方式。
产品定义定义产品功能，是产品开发的第一步。
涂鸦平台将设备与云端传输的数据，抽象成不同类型的DP，在定义DP时，可根据及其功能，分类成不同的DP点，用于控制和显示。
产品功能由三部分组合完成，包括标准功能、自定义功能及云功能。
标准功能：是指加湿器品类常规功能的标准化，与IoT平台提供的App面板相对应，用于快速开发。
自定义功能：可以自定义添加温控器附加的功能项，用于扩展设备的功能。
云功能：云功能支持包括云定时和网页跳转功能。
标准功能包含开关、模式切换、风速、目标温度，周程序等功能。
自定义功能对于设备的扩展功能，可在“自定义功能”中添加功能，新增功能后，App端设备控制面板的设置页面中会生产相应的控制项。
云功能目前支持的云功能包括云定时和网页跳转功能。
云定时功能，包括设定开关时间及周循环，无需硬件嵌入式开发。
网页跳转功能，主要可用于设置产品购买的微商城、产品使用说明等各种页面。
IoT平台提供布尔、数值、枚举、字符、故障、raw等数据类型，支持上下行。
面板配置App 控制面板提供不同类型的界面模板，包括通用温控器风格（面板工作台）、温控器公版、自定义模板、自由配置模板（0 代码 App 界面生成引擎）和开发调试模板。
产品创建过程中的 App 界面，可以选择 App 界面模版并进行编辑设置。
通用温控器风格（面板工作台）拥有更丰富的可视化组件，更强大的规则配置，无需编程即可快速DIY出好看又好用的App面板。
支持客户自行配置组件，完成个性化定制，客户可根据品牌调性和用户喜好调整组件风格和形态。
目前有通用风格面板可供使用，点击进入编辑选项可进入面板工作台，自行配置组件。
面板工作台左边为功能组件，右边为参数配置项。
具体面板DIY操作流程可参考：：面板工作台使用说明 。
样式与交互固定，与【标准功能】对应，支持背景、颜色等内容的配置，用于产品量产。
第一步，先选择温控器公版：
第二步，选择好公版模版后，如果对色调、UI样式及主题色等不满意，可编辑进行自定义修改：
第三步，公版模版选定，风格设置好后，可使用"涂鸦智能"或者“智能生活”App扫码体验。
支持自由设置页面控件及样式，用于自定义产品。
开发调试模版以开关选项方式显示设备端数据，用于开发阶段调试。
硬件开发模组选型配置温控器MCU通过模块，与涂鸦云和App进行通讯连接。产品创建好后，在硬件开发阶段，选择适用的模块，并根据主板、模块的接口电路及产品要求，完成硬件电路的开发。
第一步，首先创建对应通讯类型的产品，然后在第三步硬件开发过程中会推荐对应通讯类型的模组型号，先选择模块型号，具体可根据各自MCU规格及空间尺寸等因素参考模组规格书进行挑选。
第二步，选择好模块型号后，选择固件类型，选择“通用功能配置化方案“即可。
第三步，配置固件信息，请根据产品的配置信息去填充信息。
温控器产品创建完成后，在平台可购买模组样品，下载软件开发资料包，进入开发调试环节。
资料下载区可一键下载 MCU 开发包，开发资料包含：
MCU SDK ：根据 IoT 工作台定义的产品功能，自动生成的基于 C 语言的 MCU 代码。通讯及协议解析架构已写好，可直接添加到原有 MCU 工程中，快速完成 MCU 程序开发。
产品串口通讯协议：根据功能选择自动生成的涂鸦模组串口通讯协议。
涂鸦串口调试助手：集成了涂鸦模组通讯协议的串口调试工具，用于 MCU 通用对接方案的开发调试。
功能点调试文件：配合助手使用的调试文件，包含产品 PID、功能点等信息。
用户在拿到模组后，可先不必着急编写代码，建议使用涂鸦提供的模组调试助手（MCU 模拟模式）与 Wi-Fi 模组先连接跑通，在验证模组的同时，用户可熟悉协议交互流程，后边开发调试效率将极大提升。
涂鸦模组调试助手 - MCU 模拟模式，助手会模拟 MCU 自动回复模组正确的协议数据，用手机给模组配网后可测试 DP 数据的上报下发。下边简要介绍助手和模组配网实操的主要步骤，使用前需提前了解涂鸦模组调试助手的使用说明，初次使用助手的用户可提前阅读：涂鸦模组调试助手使用说明。
根据最小系统原理图，搭建模组外围电路，简单测试可直接飞线。
打开开发包中涂鸦模组调试助手，导入调试文件，协议选择 Wi-Fi 通用协议，MCU 模拟模式。
将模组串口通过 USB 转 TTL 工具接到电脑端，助手选择对应的串口及波特率，打开串口点击启动，将看到模组和上位机自动进行初始化流程协议交互。 注意： Wi-Fi 模组上电会不断发送心跳包，收到正确回复后，进行后续初始化协议的交互。若上电无数据发出，请检查模组外围电路是否正确。
点击重置模块，模组进入配网模式。模块支持两种配网模式 EZ 和 AP 模式，重置按钮会切换配网模式。根据状态提示，App 进行相应的配网操作，配网操作可阅读App使用说明。附两种模式的配网演示视频：
在硬件调试环节实操的过程中，用户看到模组与 MCU 有一系列的串口协议交互数据，这些数据的理解可参考开发包中协议文档。
协议主要分为两部分：基础协议和功能协议。基础协议和产品无关，是模组共有协议，包括模组初始化指令及部分扩展功能指令。功能协议部分主要基于基础协议的上报下发命令字，对 DP 数据内容格式做了详细说明。 基础协议完整内容，文档中心保持实时更新，可点击链接查看：Wi-Fi 模组通用串口协议。
MCU对接涂鸦模组协议，有两种途径：移植 MCU SDK 或自行对接协议。
自行对接协议
对于MCU资源有限或不适宜移植 MCU SDK 情况时，客户可以选择自行对接串口协议。串口协议的详细讲解可以参考：Wi-Fi模组通用协议解析
移植 MCU SDK
若 MCU 资源足够，一般建议用户直接移植 MCU SDK，开发高效便捷。开发包中 MCU SDK 是涂鸦提供的基于 C 语言的协议应用代码，可直接添加到 MCU 工程中。MCU SDK 对 MCU 硬件资源需求：Flash 4K 字节；RAM 与 DP 点数据长度有关，一百字节左右（如需 OTA 功能需大于 260 字节）；函数嵌套级数 9 级。若资源不足的用户，可自行对接协议，SDK 包中的函数依然可以作为参考。
MCU SDK 移植教程：MCU SDK 移植
协议验证移植 MCU SDK 代码开发完成后，可以使用涂鸦模组调试助手-模组模拟模式，验证 MCU 代码的正确性。使用方法与 MCU 模拟模式类似，模拟模组模式下，助手会自动发送初始化数据流，验证 MCU 回复是否正确，对于错误数据给予相应提示。初始化交互通过后，可手动点击测试其他拓展功能。
注意：涂鸦模组调试助手的模组模拟模式，没有联网功能，仅用来验证 MCU 串口协议收发正确性。测试完成，MCU 可接实际模组配网联调。
功能联调在使用助手验证完毕代码后，MCU可连接模组使用App配网，进入功能联调阶段。功能联调主要测试各DP点上报下发是否正确，在调试过程有一些常用工具链接如下：
后台日志查询入口：IoT 工作台-运营中心，根据设备 ID 可查询相关设备后台日志数据。
涂鸦在线支持入口：涂鸦提供在线化的支持服务，如问题文档资料无法解答，可直接在线提问，专业技术团队将为您答疑。
云端配置多语言管理温控器产品开发的第四步：云端配置-多语言管理中，您可以根据产品目标销售区域的语言，自行配置该产品在 App 界面文案的多语言，包括产品界面、App 信息、配网引导、告警文案、固件升级等功能点相应的多语种文案。
如果客户温控器是采用MCU通用固件对接形式，需要对已出货的设备进行固件升级的，可以在平台远程在线升级，无需烧录。此功能需要控制板支持固件升级。
需要创建新固件，然后填写相关内容，点击“确定”
支持选择固件类型：MCU固件还是SDK固件
支持选择 是否为关键版本（关键版本为不可跳过的升级版本）
选择升级方式App提醒升级: 即在用户在App端看到升级，可选择升级或不升级App静默升级: 即设备静默升级，App用户（设备的消费者）无感知App强制升级: 即App用户不可选择，只能升级才能使用App检测升级: 即App用户主动点击对应设备的面板，然后点击右上角，主动更新
添加升级文案
设备白名单测试，支持根据你的App账号来批量选择设备id，请先设置测试白名单 点击“测试白名单管理”，即可以设置几个app用户账号进行测试
支持选择设备所在区域，即中国区、美国区、欧洲区
新增白名单支持通过用户的App账号来添加，输入App账号并且验证通过后，该App账号下对应的这个pid（产品ID）的设备会添加至白名单
添加测试设备时，直接从白名单管理中选择设备id即可，选中设备id后，即推送固件到这几个设备上。
客户点击“全量发布”或“灰度发布”后，系统自动提交了一个发布申请， 涂鸦会审核您的发布和固件安全性，审核通过后会向您选择的发布范围进行消费者推送 ：
1）测试设备验证通过后，可进行OTA固件发布
2）支持三区发布
3）支持灰度发布和全量发布，支持设置发布时间 灰度发布中，支持选择地域（多选）、数量、版本号（多选）
4）确认发布后，对于未审核过的固件我们需要预留24小时去审核；已审核过的就不需要预留审核时间
投产安排如客户的温控器产品已经调试完成，就可以进入产品开发的第5步，在线下单购买试产和量产模块。
点击“投产安排”，在“开发中”点击“确认开发完成”按钮，弹框请确定是否开发完成，点击“开发完成，进入试产”，这样这款加湿器产品开发状态就会变更为试产状态。
在“试产中”中栏目点击“采购试产模块”，就会进入采购中心可以对模块进行批量采购了。
*博客内容为网友个人发布，仅代表博主个人观点，如有侵权请联系工作人员删除。
发布文章
