快速开始

本指南带你从全新的 Arduino IDE 开始，完成一次 T5 示例烧录：安装 IDE、添加涂鸦开发板管理器、选择开发板，并通过手机 App 完成设备配网。

下载 Arduino IDE

安装最新版本的 Arduino IDE，可前往 Arduino 官网根据所用操作系统下载。本项目的所有编译烧录测试均在 Arduino IDE 2 上完成。

安装开发板管理器

复制下方任一开发板管理器地址。

GitHub 地址：

https://github.com/tuya/arduino-tuyaopen/releases/download/global/package_tuya_open_index.json

Gitee 地址：

https://gitee.com/tuya-open/arduino-tuyaopen/releases/download/global/package_tuya_open_index_cn.json

启动 Arduino IDE 2，依次点击文件 -> 首选项，打开首选项窗口。

Arduino IDE 首选项窗口
在 其他开发板管理器地址 中输入上述开发板管理器地址。

其他开发板管理器地址输入框
打开左侧的 开发板管理器 面板，搜索 Tuya Open 并安装最新版本。安装成功后即可选择 TUYA 系列开发板。

开发板管理器面板已安装 Tuya Open

设备硬件选择

推荐使用 T5AI-Board Devkit 与 T5AI-Core Devkit 进行开发。

T5AI-Board Devkit：提供丰富的外设扩展，包括 LCD 屏幕、摄像头、麦克风、扬声器、SD 卡等。
T5AI-Core Devkit：高集成度语音核心开发板，适用于低功耗与便携场景下的 AIoT 语音交互应用开发。

使用 App 配网

涂鸦的 AIoT 设备统一使用 智能生活 APP 进行配网。App 下载及具体配网步骤请参考设备配网文档。

云服务与 AIoT 能力

涂鸦所有 AIoT 能力都与设备的 PID 绑定。示例代码中提供的默认 PID 支持当前示例所涉及的 AIoT 能力。如需扩展更多能力（角色管理、设备自控、设备被控、数据库、触发器、智能体、MCP 服务器），请参考创建新产品文档进行配置。

提示

建议先使用默认 PID 配置，熟悉设备功能后再添加更多 AI 能力。

#define TUYA_PRODUCT_ID     "xxxxxxxxxxxxxxxx"

示例介绍

Arduino-TuyaOpen 提供 AI Agent、WiFi、BLE、IoT、音视频、摄像头、UART/I2C/SPI 等丰富的外设示例，以及最新的 AI 能力，方便快速上手开发。

快速体验：AIcomponents/examples/YourChatBot 是一个完整的聊天机器人示例，参考应用开发文档可快速体验所有 AI 能力。
逐步学习：AI API 开发文档提供了由浅入深的 AI 示例，涵盖文本、音频、MCP、Skill 等。各外设库目录下也提供了对应的硬件示例（串口、I2C、麦克风、扬声器、摄像头、屏幕、SD 卡等）。

示例代码目录结构如下：

AIcomponents        // AI 组件
└─examples
    ├─00_IoT_SimpleExample
    ├─01_AI_TextChat
    ├─02_AI_AudioChat
    ├─03_AI_AudioSave
    ├─04_AI_Mcp
    ├─05_AI_Skill
    ├─06_AI_TuyaUI
    └─YourChatBot
Audio               // 音频
└─examples
    ├─Audio2SDcard
    ├─AudioRecorder
    └─AudioSpeaker
BLE                 // BLE
└─examples
    └─ble_server
Camera              // 摄像头
└─examples
    ├─Camera2Display
    └─Camera2SDcard
Display             // 显示
└─examples
    ├─DisplayFill
    ├─DisplayPicture
    └─LVGLdemo
DNSServer           // DNS 服务器
└─examples
    └─CaptivePortal
FSDemo              // 文件系统演示
└─examples
    ├─LittleFSDemo
    └─SDCardDemo
HTTPClient          // HTTP 客户端
└─examples
    ├─BasicHttpClient
    └─BasicHttpsClient
Log                 // 日志
└─examples
    └─logOutput
MQTTClient          // MQTT 客户端
└─examples
    ├─mqtt_auth
    ├─mqtt_basic
    └─mqtt_publish_in_callback
Peripherals         // 外设
└─examples
    └─Button
SPI                 // SPI
└─examples
    └─spiDemo
Ticker              // 定时器
└─examples
    ├─Blinker
    └─TickerParameter
TuyaIoT             // IoT
└─examples
    ├─dpType
    ├─quickStart
    └─weatherGet
WiFi                // WiFi
└─examples
    ├─SimpleWiFiServer
    ├─WiFiAccessPoint
    ├─WiFiClient
    ├─WiFiClientBasic
    ├─WiFiClientConnect
    ├─WiFiClientEvents
    ├─WiFiClientStaticIP
    ├─WiFiMulti
    ├─WiFiScan
    ├─WiFiScanDualAntenna
    ├─WiFiTelnetToSerial
    └─WiFiUDPClient
Wire                // I2C
└─examples
    └─masterWriter

下载 Arduino IDE​

安装开发板管理器​

设备硬件选择​

使用 App 配网​

云服务与 AIoT 能力​

示例介绍​

相关文档​