SeaHi

主题

00:00:00
SeaHi2026-01-312026-02-01涂鸦入门教程
1836
7.9m

TuyaOS 环境搭建 ​

概述 ​

TuyaOS 是 Tuya 公司开发的通用SDK，用于开发 Tuya 公司设计的模组。它提供了通用型的接口和功能，并兼容 Tuya 多款模组。
而Tuya Wind IDE 是面向基于 TuyaOS 的开发者提供的一站式集成开发环境。
它以 Visual Studio Code 插件形式发布，支持中英双语，通过 涂鸦开发者平台 账号登录。
Tuya Wind IDE 统一管理、分发及更新 TuyaOS EasyGo 相关开发资料，提供了不同主机、不同开发工具下一致的开发体验。

TuyaOS

涂鸦通用SDK

官方文档
Tuya Wind IDE

一站式集成开发环境

官方文档

笔记

  • TuyaOS 的只能在 Linux 环境下编译，不支持 Windows 环境。
  • 因为Tuya Wind IDE 是基于 Visual Studio Code 插件形式发布的，所以需要先安装 Visual Studio Code，再安装 Tuya Wind IDE 插件。
  • 安装完成后，需要在 涂鸦开发者平台 注册账号才能登录使用。
  • TuyaOS 的开发要在 Tuya Wind IDE 插件下进行

环境搭建流程 ​

安装 WSL2 环境 ​

安装 WSL2

安装 Windows下的 Linux 子系统

方便快捷

安装 Ubuntu 20.04 发行版 ​

安装Ubuntu 20.04

主流的 Linux 发行版

小白必看

安装 Visual Studio Code ​

安装VSCode

代码编辑工具

小白必看

安装 Tuya Wind IDE 插件 ​

  • 步骤1：Visual Studio Code 先连接到 WSL2 环境，可参考：连接 WSL
  • 步骤2：在 Visual Studio Code 中安装 Tuya Wind IDE 插件。

注册 Tuya 开发者账号 ​

点击下方连接注册 Tuya 开发者账号。

注册 Tuya 开发者账号

Tuya 开发者账号页面

Tuya 开发者平台

登录 Tuya Wind IDE ​

  • 步骤1：在 Visual Studio Code 中点击 Tuya Wind IDE 插件图标，打开 Tuya Wind IDE 登录页面。 alt text

  • 步骤2：在 Tuya Wind IDE 登录页面，输入之前注册的 Tuya 开发者账号邮箱和密码，点击登录。登录成功示例如下： alt text

开始 TuyaOS 开发 ​

1. 搜索开发包 ​

  • 在 Tuya Wind IDE 的资源中心中，开发模式 选项选择 TuyaOS OS 开发。

    alt text

  • 类型开发包 选项选择 Wi-Fi设备开发包

    alt text

  • 开发平台 选项选择 T2

    alt text

  • TuyaOS 版本 选项选择 3.8.4,点击 查询，查询到 3.8.4 版本的开发包，点击 创建 即可。

    alt text

  • 创建会自动转跳至 Tuya Wind IDE 插件下的 开发框架 页面并跟随以下弹窗，点击t弹窗的 完成按钮即可。

    alt text

2. T2_TuyaOS-3.8.4 文件说明 ​

SH
T2_TuyaOS-3.8.4/                    # 项目根目录
├── hardware/                       # 硬件相关文档
│   └── T2/                         # T2硬件平台
│       └── module_manual/          # 模块手册
├── pc/                             # PC端工具
│   └── tools/                      # 开发工具集
│       └── T2/                     # T2专用工具
└── software/                       # 软件核心代码
    └── TuyaOS/                     # TuyaOS操作系统
        ├── apps/                   # 示例应用程序
        ├── build/                  # 编译配置
        ├── docs/                   # 开发文档
        ├── include/                # 头文件
        ├── libs/                   # 库文件
        ├── scripts/                # 工具脚本
        └── vendor/                 # 原厂库

3. 编译例程 ​

TuyaOS 提供的 apps 文件夹中的历程如下：

SH
├── apps
    │   │   ├── tuyaos_demo_application_driver    #硬件驱动demo
    │   │   ├── tuyaos_demo_examples              #示例应用程序 
    │   │   ├── tuyaos_demo_quickstart            #快速入门demo
    │   │   └── tuyaos_demo_wifi_qr_activate      #WiFi二维码激活demo
方式一:鼠标右键快捷方式编译
  • 步骤1：在 apps 文件夹中，找到需要编译的历程文件夹，例如 tuyaos_demo_quickstart。
  • 步骤2：在历程文件夹中，点击 鼠标右键，选择 编译，即可编译该历程,例如:
方式二: build_app.sh 脚本编译
  • 步骤1：进入 T2_TuyaOS-3.8.4/software/TuyaOS 目录。
  • 步骤2：在项目根目录中，打开终端，使用 build_app.sh 脚本编译，例如编译 tuyaos_demo_quickstart 历程：
SH
./build_app.sh apps/tuyaos_demo_quickstart tuyaos_demo_quickstart 1.0.0
方式三: make 指令编译
  • 步骤1：进入 T2_TuyaOS-3.8.4/software/TuyaOS 目录。
  • 步骤2：在项目根目录中，打开终端，使用 make 指令编译，例如编译 tuyaos_demo_quickstart 历程：
SH
make

方式二和方式三的区别

  1. 方式二可以指定编译的例程、版本号等参数。方式三编译的例程只能是方式二中配置好的，不能自定义。
  2. 方式三 可以让用户自定义编译版本，方式三只能默认为 1.0.0。
  3. 命令行编译推荐使用方式二。

4. 下载固件 ​

笔记

  • 编译所生成的文件位于 apps/xxxx/output/<版本号> 目录下。
  • 正式的固件的文件名格式为 xxxx_QIO_<版本号>.bin，例如 tuyaos_demo_quickstart_QIO_1.0.0.bin。
  • 步骤1：把T2-U 开发板的拨码开关的 1和 2 拨到 ON 位置。
  • 步骤2：把T2-U 开发板的USB线插入电脑的USB接口，并映射到 WSL2 环境中。可参考：安装WSL2 的 "WSL2串口" 章节。
  • 步骤3：在例程中，apps/xxxx/output/<版本号> 目录下，找到编译生成的固件文件，例如 tuyaos_demo_quickstart_QIO_1.0.0.bin。
  • 步骤4：选中固件文件，点击 鼠标右键，选择 Flash App即可下载。
  • 示例：

5. 验证固件 ​

  • 步骤1：把T2-U 开发板的拨码开关的 3和 4 拨到 OFF 位置。
  • 步骤2：底部菜单栏选择 串行监视器 或 Serial Monitor，即可打开串口监视器。
  • 步骤3：在串口监视器中，端口选择 /dev/ttyACM1，波特率选择 115200，数据位为 8，无校验位，1 个停止位。
  • 步骤4：点击开始监视
  • 步骤5：复位 T2-U 开发板，即可看到开发板打印的信息。
  • 示例：

接口图

快捷导航 ​

编写第一个Tuya OS 应用

实现打印 "Hello, Tuya!"

第三步