개발 환경 설정
필요한 툴체인을 설치하고 저장소를 복제한 뒤 tos.py를 활성화하세요. 이후 구성, 빌드와 플래시에서 같은 명령을 사용합니다.
완료 후 상태
컴퓨터에 사용할 수 있는 TuyaOpen 코드가 있고 터미널에서 tos.py 명령을 활성화한 상태입니다.
tos.py是配置、编译、烧录、监听 TuyaOpen 项目的唯一命令行工具。- 激活会在仓库内创建 Python 虚拟环境（
.venv），不会影响系统 Python。 - 每次打开新终端都需要重新激活
tos.py。
준비물
시작하기 전에 다음을 준비하세요.
- 一块 TuyaOpen 兼容的开发板或模组。
- 一根 USB 数据线（仅充电线不可用）。
- 一台运行 Windows、macOS 或 Linux 的电脑。
툴체인 설치
TuyaOpen은 git, Python 3, make, cmake와 ninja를 사용합니다. 운영체제를 선택하면 명령이 바뀝니다.
TuyaOpen 복제
GitHub 또는 Gitee에서 저장소를 복제하세요. 중국 본토에서는 Gitee가 더 빠를 수 있습니다.
项目路径中不要包含中文、空格或特殊字符；Windows 下不要将项目放在 C 盘。
# 使用 GitHub
git clone https://github.com/tuya/TuyaOpen.git
# 或使用 Gitee
git clone https://gitee.com/tuya-open/TuyaOpen.git
# 进入项目
cd TuyaOpen若克隆较慢，可先调大 git 的 HTTP 缓冲：git config --global http.postBuffer 524288000。
tos.py 활성화
TuyaOpen 디렉터리에서 운영체제에 맞는 활성화 스크립트를 실행하세요.
每次重新打开终端都需要再次运行激活命令。
성공 여부 확인
tos.py version과 tos.py check를 실행해 설치된 도구와 SDK 서브모듈을 확인하세요.
❯ 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 submodules...
[INFO]: Download submodules successfully.version输出当前 tag-commit（如v1.3.0）。若显示[Unknown version]，说明仓库无 tag，常见于 fork。check确认 git ≥ 2.0.0、cmake ≥ 3.28.0、make ≥ 3.0.0、ninja ≥ 1.6.0，随后执行git submodule update --init。- 当日工作结束后，运行
deactivate（Linux/Mac）或exit（Windows）退出虚拟环境。
문제 해결
通常是缺少 python3-venv。安装后重试：sudo apt-get install python3-venv。若仍失败，删除 ./.venv 目录后重新激活。
将对应工具升级到所示最低版本（git 2.0.0、cmake 3.28.0、make 3.0.0、ninja 1.6.0）以上，再运行 tos.py check。
在仓库根目录手动执行 git submodule update --init，再重新运行 tos.py check。
这是终端模拟器兼容性问题。使用 cmd 或 PowerShell，或以 h j k l（左/下/上/右）导航。