Last Updated on : 2020-09-28 12:29:03download
Zigbee general solution is one of the major MCU connection solutions. You can quickly complete MCU connection to Zigbee general connection protocol of Tuya module, and implement device networking. Tuya provides the complete development services from modules, apps to cloud services. Compared to other communication module solutions, Zigbee module requires the gateway, supports ad hoc networks, and features low power. This topic describes the MCU development process through Tuya Zigbee general solution.
Log in to the IoT console and create a product. Select the desired product, and select Zigbee for net pairing mode. After finishing creation, you select the functions, panel, module, and firmware based on your product, and download the MCU development documents accordingly.
The platform recommends the common module models when you create a product. TYZS3 and TYZS5 are the most frequently selected Zigbee modules for Zigbee general solution.
Two kinds of firmware are available for Tuya Zigbee modules, electrical firmware and ELV (extra-low voltage) firmware. Electrical firmware suits products that require uninterruptible power supply. ELV firmware suits battery-powered products that require low power consumption.
After selecting the module and firmware, you can purchase the module sample online. The hardware engineer will proceed with the board layout design. See the documentation related to hardware development in the documentation center.
Datasheet: TYZS5 Module Datasheet
Schematic diagram of the minimum module: TYZS5 Module & MCU serial communication instructions
When receiving the module, it is suggested that, before start coding, you run the provided module debugging assistant, and connect the Zigbee module in MCU simulation mode to check if the module can work properly. Meanwhile, you can get familiar with the protocol interaction process, which will help you to proceed with development debugging.
In MCU simulation mode, the debugging assistant simulates the MCU to automatically respond to the module with the correct protocol data. After you configure network through the mobile phone, you can test DP data reporting and sending. The procedure of operating the assistant and module network configuration is as follows. Before operation, you need to learn about the operation instruction of Tuya module debugging assistant. For beginners, see Module Debugging Assistant Instruction.
Based on the schematic diagram of the minimum system, you build the peripheral circuit of the module, and jump the wire directly in case of simple testing.
Open the debugging assistant in the development documents, and import the debugging file. Select the Zigbee general protocol and MCU simulation mode.
Connect the module serial port to the computer through USB-to-TTL adapter, and select the corresponding serial port and Baud in the assistant. After you open the serial port and click Start, you will see the initial protocol interaction between the module and the host.
Note: If the module does not send data after power on, check if the peripheral circuit of the module is correct.
Click Configure Module, and the module enters network configuration mode. Configure network on the app according to the status. See the app operation instruction for network configuration operation.
Note: Before configure a sub-device, you need to configure the network of the gateway on Tuya Smart app or Smart Life app. Then, the Zigbee sub-device can be added. For more information, see the documentation Zigbee Network Configuration Description.
During hardware debugging, you will see a sequence of serial port protocol interaction data between the module and MCU. To understand this data, refer to the protocol documentation in the development documents. The protocol consists of basic protocol and function protocol. The basic protocol is product neutral and shared by the modules. It consists of module initial command and certain extension function command. The function protocol works to report and send commands based on the basic protocol, and specifies the DP data format. The basic protocol is updated in real time in the documentation center. See Tuya Zigbee module UART communication protocol.
There are two methods to connect the MCU to Tuya module protocol, migrating MCU SDK or connecting the protocol by yourself.
If the MCU resource is limited, or migrating MCU SDK is inapplicable, you can connect the protocol by yourself.
If the MCU resource is sufficient, it is recommended to directly migrate MCU SDK, which facilitates the development process. MCU SDK in the development documents is the protocol application code in C language, and it can be directly imported to the MCU project. MCU SDK requirements for MCU hardware resources: 4 KB Flash, about 100 bytes of RAM. RAM is related to DP data length. For example, OTA function takes more than 260 bytes. 9-level nested function is adopted. If you do not have adequate resources, you can implement the connection protocol. The functions in the SDK package can act as references.
MCU SDK migration tutorial: MCU SDK Migration
After migrating MCU SDK, you can use the module debugging assistant in module simulation mode to verify the MCU code. The operation is similar with MCU simulation mode. In the module simulation mode, the assistant automatically sends the initial data flow to verify whether the MCU response is correct, and send prompts for data error. After the initial interaction, you can test other extension functions.
Note: The module simulation mode only verifies the MCU serial port protocol, and does not support networking. After finishing test, connect the MCU to the actual module and proceed with joint network configuration debugging.
After the assistant verifies the code, connect the MCU to the module and configure network on the app. You will enter function joint debugging. Joint debugging is used to test whether the DPs reporting and sending works properly. The links of useful tools adopted in the debugging are as follows:
Online support center: Tuya provides online services. If the documentation cannot solve your problems, raise your questions online and our technical team will help you troubleshoot problems.