This program mainly introduces the water heater product program, which is suitable for water heater product developers to get started quickly, understand and quickly access the Tuya platform.
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 intelligent networking part uses the public version solution or the panel workbench. The specific MCU solution communication schematic diagram is as follows:
System introduction
1. Tuya networking module: realizes product distribution network, uses serial communication to connect to the App And the cloud, realize the uploading and issuing of product instructions.
IoT module provides a variety of module options, supporting different requirements such as patch type and in-line type; cross-chip platform and cross-communication platform capabilities have been realized;
IoT adapter board module provides a variety of adapter board module options, Supports different voltage levels such as 3.3V, 5V, 12V, etc.; Plug and Play plug-and-play USB serial port adapter board docking has been implemented;
2. Tuya Cloud: A globally deployed IoT platform that connects all devices and apps, performs data precipitation, and realizes smart device intercommunication, which is 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: Support 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 a built-in "Xiaozhi Manager" wake-up word and noise reduction algorithm to achieve "Xiaozhi Manager Built-in" The voice portal capability of Powered by Tuya and the IoT control capability of Powered by Tuya;
5. Data and operation and maintenance management platform: Tuya provides a very rich data statistics platform for all developers 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 proactively reports a fault code. After the platform analyzes, an alarm work order is automatically generated, and the customer service staff can deal with it immediately, making after-sales service easier. -Data center functions and instructions-Operation center usage guide
Program details
General functions
Fast distribution network: support EZ and AP two distribution methods, and Bluetooth fast connection;
common functions: one-key switch, mode switching, temperature adjustment, child lock, timing 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, device sharing between 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 equipment 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;
Extensions
cloud Timing: Graffiti cloud cloud provide timing capabilities, no local timing; support peripheral circulation setting;
energy consumption statistics: support for statistical and display electricity consumption, gas consumption, water consumption, etc. by year, month, day dimension;
the whole Machine maintenance reminder: Cumulative timing of the use time of the device after activation, and message push after reaching the maintenance time of the whole machine;
Security alarm: Multi-channel message push, minor abnormality, fault report; advanced danger warning, you can push message or phone, etc. Inform users in the form to ensure safe use;
Public version panel
There are currently 6 control panels to choose from for the water heater. The detailed UI is as follows:
Can smart water heaters be built without development? Remote control & mainstream speaker access After the
customer selects the panel that matches the theme style, you can 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 consumption KM4 MCU, WLAN MAC, 1T1R WLAN, the highest frequency is 100MHz, built-in 256K SRAM, the 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 clocked at 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-Under 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:
Can smart water heaters be built without development? Remote control & mainstream speaker access For
more module requirements, please contact the platform operation, corresponding BD or project manager for confirmation.
Applicable single product
electric water heater, gas water heater, solar water heater, air energy water heater, etc.
Click to learn about the IoT development platform to help you quickly complete product intelligence:
auth.tuya.com/?from=https%3A%2F%2Fiot.tuya.com%2F&_source=81b786df37f17f6d239349cb965e3568
The following is the detailed process of product creation:
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;
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 functions 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 recommended 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. 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
Electric water heater 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
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 side 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 will directly call related functions to implement data reporting and execution;
For development details, please refer to: Tuya Universal Wi-Fi SDK Instructions
Machine function debugging
In 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 and the machine, 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 the 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.
For details on using the simulation assistant, please refer to: Module debugging and using 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 for querying the DP data receiving and sending process. The IoT platform provides a log query function, which can check the data communication between the water heater MCU and the App, and is suitable for troubleshooting the operation of each end under abnormal conditions.
[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.
For detailed operations, please refer to: App Building 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.
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.
Alarm settings
Tuya provides different levels of alarm notification functions. Customers can customize product alarm conditions and notify users or companies after triggering to monitor product status in real time to ensure healthy product operation.
For more cloud configuration functions, if you have any questions, please contact the platform operation, the corresponding BD and the project manager.