环境搭建

概述

完成在不同系统（Linux、Windows、macOS）中的必要工具准备。

硬件准备

开始前，请准备以下资源：

• TuyaOpen 支持的开发板或模组
• USB 数据线
• 电脑（支持 Windows/Linux/macOS 系统）

环境准备

信息

推荐使用 Ubuntu24/22/20 的 LTS 版本。

安装必要的工具：

sudo apt-get install lcov cmake-curses-gui build-essential ninja-build wget git python3 python3-pip python3-venv libc6-i386 libsystemd-dev

下载并激活 TuyaOpen

下载 TuyaOpen 仓库：

# 使用 github
git clone https://github.com/tuya/TuyaOpen.git

# 或者使用 gitee
git clone https://gitee.com/tuya-open/TuyaOpen.git

cd TuyaOpen

激活 tos.py：

. ./export.sh

验证，使用命令 tos.py version 以及 tos.py check，会出现如下信息：

❯ tos.py version
[INFO]: Running tos.py ...
[INFO]: v1.3.0

❯ tos.py check
[INFO]: Running tos.py ...
[INFO]: [git] (2.43.0 >= 2.0.0) is ok.
[INFO]: [cmake] (4.0.2 >= 3.28.0) is ok.
[INFO]: [make] (4.3 >= 3.0.0) is ok.
[INFO]: [ninja] (1.11.1 >= 1.6.0) is ok.
[INFO]: Downloading submoudules ...
[INFO]: [do subprocess]: cd /home/huatuo/work/open/TuyaOpen && git submodule update --init
[INFO]: Download submoudules successfully.

若 check 命令失败：

# 工具校验不合格，请安装或升级对应工具

# submodules 下载失败，手动执行 git 命令
git submodule update --init

使用如下命令退出激活 tos.py：

deactivate

关于 tos.py 更详细的说明方法，可使用命令 tos.py --help 进行查看，或参考 tos.py 工具使用。

常见问题

tos.py 激活失败

• 如果激活失败，可能是因为没有安装 python3-venv，请安装后重新激活。

  sudo apt-get install python3-venv

• tos.py 激活时会自动创建 ./.venv 目录。如果激活失败，需要删除 ./.venv 目录，并重新激活。