LILYGO® T-Zigbee / T-ZigbeePA Development Board User Manual

1. Pengenalan

The LILYGO® T-Zigbee is an advanced Internet of Things (IoT) development board featuring a dual-MCU design. It integrates both the TLSR8258 ultra-low power chip and the ESP32-C3 chip, offering comprehensive wireless connectivity options including BLE 5 Mesh, Zigbee, RF4CE, Thread 6LoWPAN, HomeKit, ANT 2.4GHz proprietary standard, WiFi, and Bluetooth. This board is designed for versatile IoT applications requiring robust communication and efficient power management.

The T-ZigbeePA version, introduced from July 30, 2022, enhances the original T-Zigbee by adding a Power Amplifier (PA) chip and incorporating a stronger signal antenna for improved range and reliability.

Imej: Selesaiview of the LILYGO T-Zigbee Development Board, showing front, back, and highlighted chip components.

2. Spesifikasi

The LILYGO T-Zigbee and T-ZigbeePA boards are equipped with the following key components and features:

Image: Detailed specifications and working mode switch diagram for T-Zigbee.

2.1. Main Control Units (MCUs)

• MCU 1: TLSR8258
  • Ultra-low power MCU supporting Zigbee and BLE5.
  • Wireless: Support BLE 5 Mesh, Zigbee, RF4CE, Thread 6LoWPAN, HomeKit, ANT 2.4GHz proprietary standard.
  • Features: PGA, AMIC, DMIC, 6-channel PWM function.
  • Programmable LED: Red LED (PD04), Green LED (PA00).
• MCU 2: ESP32-C3
  • Equipped with RISC-V processor SoC.
  • Wireless: Support 2.4 GHz Wi-Fi and Bluetooth 5 (LE).
  • Performance: Main frequency 160 MHz, built-in 400 KB SRAM, 384 KB ROM.
  • Programmable buttons: IO02, Blue LED (IO03).

2.2. Spesifikasi Am

2.3. T-ZigbeePA Specifics

• Includes a Power Amplifier (PA) chip.
• Equipped with a stronger signal antenna.
• Output Power: +22.5dBm PA (as indicated in pinmap for T-Zigbee PA).

Image: Comparison of antenna designs for T-Zigbee and T-ZigbeePA, highlighting the PA chip and enhanced antenna on the PA version.

3. Kandungan Pakej

The standard package for the LILYGO T-Zigbee and T-ZigbeePA boards typically includes the following items:

3.1. T-Zigbee Version

Image: Contents of the T-Zigbee V1.1 package, including the board, pin headers, and a 2-pin cable.

• 1 x T-Zigbee V1.1 Development Board
• 2 x PH2.54 Pin (1*21 Pin) headers
• 1 x Ultra-Thin 1.25mm 2p cable

3.2. T-ZigbeePA Version

Image: Contents of the T-ZigbeePA package, including the board, pin headers, a 2-pin cable, and the T-U2T Downloader.

• 1 x T-ZigbeePA Development Board
• 2 x PH2.54 Pin (1*21 Pin) headers
• 1 x Ultra-Thin 1.25mm 2p cable
• 1 x T-U2T Downloader (may be included with some bundles)

4. Persediaan dan Penggunaan Awal

4.1. Rajah Pinout

Refer to the pinout diagram for connecting peripherals and understanding the board's layout.

Image: Detailed pinout map for LILYGO T-Zigbee, showing ESP32-C3 and TLSR8258 pins, DIP switch settings, and UART pins.

4.2. Working Mode Switch (DIP Switch)

The board features a DIP switch to select the working mode for the TLSR8258 and ESP32-C3 MCUs. The switch settings determine which MCU is active or how they interact.

• TLSR8258 Work Mode: Toggle the DIP switch as shown in the specifications diagram to enable the TLSR8258.
• ESP32C3 Work Mode: Toggle the DIP switch as shown in the specifications diagram to enable the ESP32-C3.

Ensure the correct mode is selected based on your application requirements.

4.3. Programming and Firmware Upload

The LILYGO T-Zigbee board does not include an onboard USB to serial chip. Therefore, an external T-U2T automatic downloader is required to upload programs to the board.

Image: Explanation of the necessity for the T-U2T downloader for program uploads.

1. Connect the T-U2T downloader to your computer's USB port.
2. Connect the T-U2T downloader to the LILYGO T-Zigbee board's programming interface.
3. Use your preferred development environment (e.g., Arduino IDE, PlatformIO) to compile and upload your firmware.

Image: LILYGO T-Zigbee board connected to the T-U2T downloader, ready for programming.

5. Arahan Operasi

5.1. Memberi Kuasa kepada Lembaga

The board can be powered via the USB-C port. Ensure a stable 5V power supply is used.

5.2. Developing with Dual MCUs

The dual MCU architecture allows for flexible development:

• Operasi Bebas: Each MCU (TLSR8258 and ESP32-C3) can be programmed and operated independently by selecting the appropriate mode via the DIP switch.
• Cooperative Operation: The MCUs can communicate with each other (e.g., via UART) to combine their functionalities, such as using the ESP32-C3 for Wi-Fi connectivity and the TLSR8258 for Zigbee communication. Refer to the pinout diagram for inter-MCU communication pins.

5.3. Software Development Resources

For detailed programming guides, examples, and libraries, please visit the official LILYGO GitHub repository:

https://github.com/Xinyuan-LilyGO/T-ZigBee

5.4. Cthample Permohonan

Image: LILYGO T-Zigbee board connected to a mobile device displaying an IoT application interface, showing temperature, humidity, and pressure readings.

The board can be used for various IoT applications, including smart home control (e.g., Mi Home integration), environmental monitoring (temperature, humidity, pressure), and custom sensor networks.

6. Penyelenggaraan

• Storan: Store the development board in a dry, anti-static environment when not in use.
• Pembersihan: Gunakan kain lembut dan kering untuk membersihkan papan. Elakkan menggunakan cecair atau bahan kimia yang keras.
• Pengendalian: Handle the board by its edges to avoid touching sensitive components, especially when powered.
• Kemas kini Firmware: Regularly check the official GitHub repository for firmware updates and security patches to ensure optimal performance and security.

7. Penyelesaian masalah

7.1. Board Not Powering On

• Ensure the USB-C cable is securely connected to both the board and a reliable 5V power source.
• Check the cable for damage. Try a different USB-C cable and power adapter.

7.2. Firmware Upload Issues

• Verify that the T-U2T downloader is correctly connected to both the computer and the development board.
• Ensure the correct COM port is selected in your development environment.
• Check that the necessary drivers for the T-U2T downloader are installed on your computer.
• Confirm that the DIP switch is set to the correct programming mode for the target MCU.

7.3. Wireless Connectivity Problems (WiFi/Bluetooth/Zigbee)

• Check your code for correct initialization and configuration of the wireless modules.
• Ensure the antenna is properly connected (if external) or that the onboard antenna is not obstructed.
• For Zigbee, verify that the TLSR8258 is in the correct working mode via the DIP switch.
• For T-ZigbeePA, ensure the PA chip is correctly enabled and configured in your firmware for enhanced range.
• Test in an environment with minimal interference.

7.4. MCU Communication Issues

• If using both MCUs, verify the communication lines (e.g., UART TX/RX) are correctly wired and configured in the firmware for both MCUs.
• Check the baud rates and communication protocols in your code.

8. Petua Pengguna

• MicroPython/Zigbee2MQTT: While the board is highly versatile, specific support for MicroPython or direct compatibility with Zigbee2MQTT may require custom firmware or community-developed libraries. Always check the official LILYGO GitHub repository and community forums for the latest information and examples.
• Integrasi Pembantu Rumah: For integration with Home Assistant via Zigbee, consult the LILYGO GitHub documentation or relevant Home Assistant community resources for setup guides and compatible firmware.
• Not a Flight Controller: This board is designed as a general-purpose IoT development board. While powerful, it is not intended or optimized for use as a flight controller for quadcopters without significant custom development and safety considerations.
• Ingatan: The ESP32-C3 features 400 KB SRAM and 384 KB ROM. Plan your application's memory usage accordingly.

9. Waranti dan Sokongan

For technical support, documentation, and community resources, please refer to the official LILYGO GitHub repository:

https://github.com/Xinyuan-LilyGO/T-ZigBee

LILYGO® is committed to open-source development and encourages community sharing and contributions.

For inquiries regarding product customization or bulk orders, please contact LILYGO® customer service directly.