MCU docking solution is currently one of the most commonly used solutions for home appliance products docking with Tuya platform. It is mainly used for water heater products with MCU main control to realize intelligence, and it can be connected to the serial port protocol of Tuya module directly to realize networking. Customers only need to pay attention to the function research and development of the product itself. The networked intelligent part uses the public version or the panel workbench. The specific communication schematic diagram of the MCU solution is as follows:
System introduction
1. Tuya networking module: realize product distribution network, use serial communication to connect App and cloud, realize product instruction upload and issuance.
IoT module provides a variety of module options, supporting different requirements such as patch type and in-line type; has achieved cross-chip platform and cross-communication platform capabilities;
IoT adapter board module, provides a variety of adapter board module options, Support 3.3V, 5V, 12V and other different voltage level requirements; Plug and Play plug-and-play USB serial port adapter board docking method has been realized;
2. Tuya Cloud: a globally deployed IoT platform that connects all devices and apps , Carry out data precipitation, realize the intercommunication of smart devices, safe, stable and fast.
3. App unit: Provide various forms of APP to realize remote control of equipment.
Public version App: Free public version App, ready to use, rich in scenarios, universal, suitable for quick product docking;
OEM App: Based on the official template, through simple UI and personalized configuration one-click to generate independent App of own brand, satisfy Lightly personalized customization requirements;
Customized App: App version based on the public version architecture that fully meets the personalized needs of the brand for in-depth development;
App SDK, suitable for users’ self-developed apps;
4. Voice unit: Supports domestic and foreign mainstream voice platforms Into. -Foreign countries support Amazon Alexa, Google Assistant, Yandex Alice;
Domestic support for major mainstream speaker platforms such as Baidu
Xiaodu ; Tuya provides a Wi-Fi online voice module for domestic IoT control, with built-in "Xiaozhi Butler" wake-up words and noise reduction algorithms to achieve "Xiaozhi Butler Built-in" The voice access capability of Tuya and the IoT control capability of Powered by Tuya;
5. Data and operation and maintenance management platform: Tuya provides all developers with a very rich data statistics platform to help manufacturers provide better equipment experience optimization. With the help of Tuya's operating platform, when a consumer product has a problem, the product actively reports a fault code. After the platform analyzes, an alarm work order is automatically generated, and the customer service staff can deal with it in the first time, making the after-sales service easier. -Data center functions and instructions-Operation center usage guide
Program details
General functions
Fast network configuration: supports EZ and AP network distribution methods, and Bluetooth fast connection;
common functions: one-key switch, mode switching, temperature adjustment, child lock, timed appointment, temperature scale switching, etc.;
real-time status: working Status, current temperature, power consumption, water consumption, air consumption, remaining water, water flow, etc.;
equipment configuration: distribution network information, shortcut switches, alarm settings, etc.;
fault alarm: support for machine failure, alarm, notification and other news push;
Equipment sharing: support family management and equipment sharing among members;
group control: support the same type of equipment to form a group for group control;
intelligent scene automation: support intelligent scene trigger conditions, perform tasks, and set corresponding functions in the App intelligent scene ;
OTA upgrade: support device and module upgrades such as prompt/silence;
multi-language management: support configuration management and switching in multiple languages;
voice package management: support configuration management and switching of multiple voice packages;
extended function
cloud timing : Tuya Cloud provides cloud timing capabilities without local timing; supports weekly cycle settings;
energy consumption statistics: supports statistics and display of electricity consumption, gas consumption, water consumption, etc. in the dimensions of year, month, and day;
maintenance reminders for the whole machine: Accumulate the use time of the device after activation, and push messages when the maintenance time of the whole machine is reached;
security alarm: multi-channel message push, minor abnormalities, fault reporting; advanced danger warning, you can notify users in the form of message push or telephone, etc. To ensure safe use;
public version panel The
water heater currently has 6 control panels to choose from, the detailed UI is as follows:
Free development to build a smart water heater, water as you want, and a comfortable life. After the
customer selects the panel that matches the theme style, click Edit for secondary editing. For specific editing methods, please refer to: Panel DIY Operation Guide
Module selection For
the water heater MCU docking solution, the WBR3 networking module is recommended.
Overview: WBR3 is a low-power embedded Wi-Fi+BT module developed by Tuya Smart. It consists of a highly integrated radio frequency chip RTL8720CF, built-in Wi-Fi network protocol stack and rich library functions. WBR3 also contains low-power KM4 MCU, WLAN MAC, 1T1R WLAN, the highest frequency is 100MHz, built-in 256K SRAM, chip built-in 2Mbyte flash and abundant peripheral resources. WBR3 is an RTOS platform that integrates all Wi-Fi MAC and TCP/IP protocol function libraries. Users can develop embedded Wi-Fi products that meet their needs based on these.
Features:-Built-in low-power KM4 MCU, which can double as an application processor with a main frequency of 100MHz-Operating voltage: 3V-3.6V-Peripherals: 9×GPIOs, 1×UART, 1×Log_Tx-Wi-Fi/BT connectivity- 802.11 B/G/N20-Channel [email protected] (CH1-11 for US/CA, CH1-13 for EU/CN)-Support WPA/WPA2 security mode-Support Bluetooth 4.2 Low Energy-In 802.11b mode+ 20dBm output power-Support SmartConfig function (including Android and iOS devices)-Onboard PCB Onboard antenna-Pass CE, FCC certification-Working temperature: -20℃ to 85℃
Package size: WBR3 has 2 rows of pins (2×8) with a pin pitch of 2mm. WBR3 size: 16±0.35 mm (W)×24±0.35 mm (L)×2.9±0.15 mm (H). The size of WBR3 is shown below:
Free to develop and build smart water heaters, use water as you wish, and live a comfortable life. For
more module requirements, please contact the platform operation, the corresponding BD or the project manager for confirmation.
Applicable single product
electric water heater, gas water heater, solar water heater, air energy water heater, etc.
Log in to the platform
On the Tuya IoT platform, register a developer account to turn on product intelligence.
In order to use log query, permission sharing and other related functions, please activate the enterprise version permissions.
IoT platform link: Tuya IoT.
Process overview
Step1-Product creation: select the corresponding product category on the IoT platform, define the product name and model, and create the product;
Step2-Product definition: Define the specific functions of the product on the platform, the core is the content and format of data transmission;
Step3-Panel configuration: According to product characteristics, select and configure personalized UI, the core is style, color, icon, etc.;
Step4-Hardware development: According to the requirements of the main control of the product, select the suitable Wi-Fi communication module and develop the MCU program;
Step5-App construction: Build an App with vendor characteristics, the core is LOGO, welcome page, device page, etc.;
Step6-Cloud configuration: configure multi-language App interface, apply for smart speakers, device OTA upgrade and other core operations;
Click to learn about the IoT development platform to help you quickly complete product intelligence:
auth.tuya.com/register?from=http%3A%2F%2Fiot.tuya.com%2F&_source=e74d60a1928993e1892f7e5efbaa5467
The following is the detailed process of product creation:
Steps to create
Product creation Create a product
on the Tuya IoT platform, select [Home Appliance]-[Water Heater], and click "Create Product" to start creating the product.
Related instructions:
Product name: the default name of the actual device, which will be displayed on the device page in the App;
communication type: the way the hardware connects to Tuya Cloud, currently supports Wi-Fi, Wi-Fi&Bluetooth dual mode, NB mode;
product definition
How to define the DP
Tuya platform The data transmitted by the device and the cloud is abstracted into different types of DPs. When DP is defined, it can be classified into different DP points according to machine functions for control and display.
In order to meet different development needs, Tuya platform provides standardized and custom functions:
Standard function: refers to the common functions provided under this category. Tuya has standardized the common functions of water heater products, and customers can directly select them as needed;
custom function: customize the additional function items of the water heater to extend the equipment functions, if Your product function is not in the standard function, you can add custom functions; after
panel configuration
product definition, you can choose different styles of panels (device control page) as the interactive page of the water heater product. On the IoT platform, Tuya provides recommendation panels, free configuration panels, and development and debugging panels for customers to choose from.
Recommended panel: A panel with a complete UI design. Customers can choose the corresponding style according to their theme preferences. At the same time, this type of panel graffiti provides a wealth of visual components, and users can perform secondary editing based on the selected main panel, modify the layout, and color And product logic rules, etc.;
Free configuration panel: support free setting of page controls and styles for custom products;
Debug panel: display machine-side data with switch options for debugging in the development phase;
Hardware development
Module selection
Water heater electric control, the main board communicates with Tuya Cloud and App through the cloud module. After the product is newly built, select the applicable cloud module, and complete the development of the hardware circuit according to the interface circuit of the motherboard and the cloud module and the product requirements.
Steps: module selection-firmware selection-firmware information configuration
Free development to build a smart water heater, free water, comfortable life
Free development to build a smart water heater, free water, comfortable life
Free development to build a smart water heater, free water, comfortable life
Free development to build a smart water heater, free water, comfortable life
Free development to create a smart water heater, Use water as you want and live comfortably.
At present, WBR3 modules are commonly used in smart water heater products. For detailed module descriptions, please refer to: WBR3 specifications
MCU program development The
cloud module is connected to the MCU through serial communication, and the MCU end realizes the interaction between device data and the cloud according to the function DP defined in the [Product Definition] step. The MCU development process mainly involves protocol analysis, data reporting and reception, etc.
There are two options for MCU development:
1) Serial protocol mode
According to the serial port protocol, MCU groups and unpacks by itself to realize data reporting and execution;
2) SDK method
Migrate the SDK interface files encapsulated by the IoT platform, and the MCU directly calls related functions to implement data reporting and execution;
For development details, please refer to: Tuya Universal Wi-Fi SDK Instructions
Machine function debugging
During the verification and debugging stage of product development, in order to verify the technical solution or the function of the App panel, the debugging assistant and debugging panel provided by the IoT platform can be used to realize the data communication between the App side and the machine side and assist the development and debugging of the development process. .
1. Simulation Assistant Tuya Cloud Simulation Assistant, the PC and cloud module are connected through a serial port to simulate the MCU to send and receive DP data of the machine function, and the interactive effect can be experienced in real time on the App side.
It is suitable for verifying the defined product functions before MCU program development, and verifying the validity of data during debugging.
Free development to build a smart water heater, water as you like, and a comfortable life
. For details on the use of the simulation assistant, please refer to: Module debugging and use assistant instructions
2. Panel debugging
After the equipment network function debugging is completed, the water heater can be configured through the App, and the water heater can be operated on the App to verify whether the instructions are sent and received, the App display, and the machine execution are correct.
At the same time, in the early stage of development, MCU can use the debugging panel function to independently debug whether the logic of a certain DP is correct.
The debugging panel only retains data receiving and sending operations, without interactive logic, which can be selected in the [interface configuration] link, which is suitable for debugging in the development process.
3. Log query
During the commissioning process, you will encounter the need to query the DP data receiving and sending process. The IoT platform provides a log query function, which allows you to view the data communication between the water heater MCU and the App, and is suitable for troubleshooting the operation of each terminal under abnormal conditions.
Free to develop and build a smart water heater, use water as you wish, and live a comfortable life
[Explanation] The log query function requires the "Enterprise Edition" account permissions to be opened and operated on the operating platform.
App construction
When the machine function development is completed, it will involve the construction of its own brand App. Tuya platform provides the function of online OEM App.
In the [App Workbench] of IoT, you can configure information such as App name, LOG, distribution network copy, product icon, etc., to generate an OEM App with manufacturer identification information and personalized.
Free development to build a smart water heater, water as you like, and a comfortable life. For
detailed operations, please refer to: App Construction Guide
Cloud configuration
Multi-language configuration
When the target market of the product is an overseas region, the language of the App interface needs to be adjusted to the language of the corresponding region.
In the "multi-language configuration" of the "extended functions" of the IoT platform, multi-language editing of the set function points can be performed, and the editing is completed. When the phone adjusts the system language, the App interface language is also adjusted accordingly.
Free development to build a smart water heater, free water, comfortable life
Free development to build a smart water heater, free water, comfortable life
OTA upgrade
In order to meet the machine function upgrade, the platform supports MCU OTA function.
In the "Firmware Upgrade" of the "Extended Functions" of the IoT platform, you can customize the upload of MCU firmware. The firmware version, upgrade information, etc. all support custom management.
Free development to build a smart water heater, free water, comfortable life
Free development to build a smart water heater, free water, comfortable life
Alarm setting
Tuya provides different levels of alarm notification functions, customers can customize product alarm conditions, notify users or companies after triggering, real-time monitoring Product status to ensure the healthy operation of the product.
Free development to build a smart water heater, free water, comfortable life
Free development to build a smart water heater, free water, comfortable life
More cloud configuration functions, if you have any questions, please contact the platform operation, the corresponding BD and project manager.