Skip to main content

72H Adventure X Event

· 8 min read
Tuya
Tuya
All maintainers of TuyaOpen
Edward Lai
Edward Lai
Maintainer of TuyaOpen

This guide is a dedicated document for the contest, designed to provide comprehensive event guidance for participants.

Important Resources

TuyaOpen vs TuyaOS

TuyaOpen is open-source based on the industry-leading TuyaOS architecture, verified by 1.3 million developers worldwide. TuyaOpen provides clearly defined APIs for developing C/C++ applications supporting multiple MCUs, deeply simplifying complex development processes such as peripheral connections, cloud connections, and security. This framework can significantly improve development efficiency and help you quickly build AI + IoT smart products.

Contestants can choose according to their needs. If you have requirements for video AI capability integration or commercialization scenarios, TuyaOS is recommended; for other scenarios or needs, the more open ecosystem of TuyaOpen is recommended.

Main Differences Comparison

FeatureTuyaOpenTuyaOS
Target UsersOpen-source developersCommercial cooperation developers
Source Code AccessFully open-source, source code accessibleCommercial code partially open-source, supports secondary development
Code DownloadGitHub, Gitee free open-source downloadVSCode plugin WindIDE + email authorization to obtain code
Development EnvironmentLinux, Windows, MacLinux only, other platforms require virtual machines
Tuya Cloud AI Components✅✅ Latest and fastest
Tuya Voice AI ASR Capability✅✅
Tuya Video AI Capability❌ Not currently supported✅
Tuya Cloud Large Model Customization Capability (LLM/Prompt/Workflow/RAG)✅✅
Source Code Customization CapabilityHigh source code customizationAPI-level customization, linked libraries, richer commercial functional components
Chip SupportTuya T Series / ESP Series (see support list)Tuya T Series
Development LanguageC/C++C/C++
Documentation SupportTuyaOpen Official WebsiteTuya Developer Official Website
Contribute Source Code or Secondary Open Source✅Follow Copyright License
Hardware EcosystemContinuously adding chips, development boards, and peripheral driversAdopt recommended selection solutions

Embedded Software Development

TuyaOpen Section

Documentation

Example Overview

Making good use of example code can reduce development costs and avoid "reinventing the wheel".

  • your chat bot: Click to Go

    • T5/ESP32 cross-platform support example
    • Voice ASR + Tuya Cloud Large Model
    • Connect AI Prompt/Agent capabilities
    • Emotion perception interaction capability
    • Module components: Screen + Mic + Speaker + Wi-Fi + Button

  • your chat bot: Click to Go

    • T5/ESP32 cross-platform support example
    • Voice ASR + Tuya Cloud Large Model
    • Connect AI Prompt/Agent capabilities
    • Emotion perception interaction capability
    • Multiple wake modes
    • App control robot interaction
    • Emotion recognition -> action capability
    • Module components: Screen + Mic + Speaker + Wi-Fi + Button + Servo

  • Switch Demo: Click to Go

    • Basic native example demonstrating device as IoT LED light can connect to Tuya Cloud, controlled by Tuya Cloud Service/App
    • DP message event handling
    • Basic network configuration, hardware authentication process

  • Basic Component Demo: Click to Go

    • Bluetooth/Wi-Fi
    • SPI I2C ADC basic interface protocol Demo
    • Protocol Demo
    • Screen rendering framework LVGL examples etc....

TuyaOS Section

Tuya Wind IDE is a one-stop integrated development environment for developers using TuyaOS EasyGo. You can Click to Go.

AI Infrastructure Tuya Wukong AI Embedded Device End

Tuya Cloud Platform, Zero-Code Cloud AI Development

Hardware Development Boards

Development Boards

Tuya T5AI Board Development Board

T5-AI Board Pinout

Tuya Hardware Resources

  • To avoid resource abuse, priority support is given to teams with clear ideas for receiving/using resources. It is also recommended that your team bring your own familiar tools.
  • Development boards must use the contest-specified T5. Other peripheral devices/hardware and product forms are encouraged to be brought by participants.

For the quantity of hardware resources available on-site, please refer to the following:

Development Boards

Peripheral Accessories

  • Speakers (3020, 4 ohm, 3 watt): 20
  • Display Screens (1.54 inch, ST7789): 10
  • Battery Packs (2000 mAh): 10
  • Servos (MG90S): 40
  • Sensor Kits (gesture, touch, light-sensitive, air, temperature/humidity, ultrasonic, etc., more than 10 types): 4
  • Dupont wires/data cables: several

Tools

  • Zhengdian Atom HP15 Smart Heating Platform: 2 units
  • Zhengdian Atom DM40 Digital Multimeter: 2 units
  • Zhengdian Atom T80/T80P Smart Soldering Iron: 2 units
  • Zhengdian Atom Logic Analyzer: 2 units
  • Adjustable DC Power Supply (Max 60V/5A): 1 unit
  • Heat Gun: 1 unit
  • Hot Glue Gun: 1 unit
  • Screwdriver Set: 1 set
  • 3D Printer (Bambu Lab P1S+AMS): 5 units

Tuya Technical Support 🛠️📋

There will be Tuya technical teachers and Digua Robot teachers at the event site, who will provide appropriate technical support during the event.

If there are more complex issues, or if you don't receive timely support at the event site on the day of the event, you can organize the questions and raise Issues on Github 📝, Tuya will arrange personnel support as soon as possible.

Issue Link: https://github.com/tuya/TuyaOpen/issues

Issue Format

### Include `【52Event】` to help staff identify event issues
Issue Title: 【AdventureX Event】 (bug/question/hardware): {Clear and concise problem description}
Issue Content:
- Development Environment: Mac/Win/Linux 💻
- Chip Platform: T5/RDK 
- Problem Description: Clear and concise expression of the problem
- Problem Phenomenon: What patterns can be found, what methods have been tried to fix it?
- Expected Phenomenon: Expected resolution result
- Log Logs: Attaching logs helps staff analyze your problem

Frequently Asked Questions

  1. How to develop ESP32? tos.py tool can complete compilation and flashing steps. Select the correct board-level config configuration as ESPxxx.config for the code project, tos.py build and flash both support cross-platform.
  2. What's the difference between TuyaOS and TuyaOpen? This article has detailed introduction, please refer to the TuyaOpen vs TuyaOS section above. If you have requirements for video AI capability integration or commercialization scenarios, TuyaOS is recommended; for other scenarios or needs, the more open ecosystem of TuyaOpen is recommended.
  3. What is PID? Product-ID associated with cloud services for hardware. The number bound to cloud services.
  4. What is authorization code? Security authentication code for hardware to access cloud services, ensuring hardware security. UUID/Key is a set of authorization codes. Note that TuyaOS and TuyaOpen authorization codes cannot be mixed. Even though capabilities and service functions are similar, authorizations are incompatible.
  5. Can development be done on Windows system? Yes, the Master main branch can now be experienced.
  6. Can development be done on MacOS?
  • Yes, the Master main branch can now be experienced.
  • Beta feature, can develop in Mac x86/ARM environment, but there may be undiscovered issues. Linux and Windows are recommended first.
  1. MacOS M-series encounters lwip compilation error when compiling T5 projects. Mac gcc version differences, when using T5 chips, the following modifications are needed Issue Resolved