tos.py 명령어 레퍼런스

tos.py는 TuyaOpen 프로젝트의 구성, 빌드, 플래시와 로그 모니터링을 위한 CLI입니다. 명령을 용도별로 확인하세요.

고급레퍼런스CLI

tos.py란?

TuyaOpen을 활성화하면 tos.py가 PATH에 추가됩니다. 프로젝트 구성, 빌드 시스템, 플래시와 로그 모니터링을 하위 명령으로 제공합니다.

tos.py version

❯ tos.py version
[INFO]: v1.3.0-23-g6bcb5aa

查看当前 tag-commit。[Unknown version] 表示仓库无 tag（常见于 fork）。

tos.py check

❯ tos.py check
[INFO]: [git] (2.43.0 >= 2.0.0) is ok.
...

安装或拉取后使用 —— 校验 git/cmake/make/ninja 版本并执行 git submodule update --init。

以下命令用于选择或调整开发板配置。所选配置写入 app_default.config；choice 与 menu 均会先深度清理，因为可能切换工具链。

tos.py config choice

❯ tos.py config choice
1. T5AI.config
2. ESP32.config
...
Choice config file:

为当前项目选择已验证的开发板配置。

tos.py config menu

tos.py config menu   # 打开可视化 Kconfig 菜单

交互调整 Kconfig 选项，在菜单内保存。

tos.py config save

❯ tos.py config save
Input save config name:

将当前经 menu 调整的配置保存为项目 config/ 目录下的具名配置。

tos.py build [-v]

❯ tos.py build
...
[INFO]: ******* Build Success ********

将项目编译为 .build/bin 中可烧录的 bin。-v 输出详细日志。

tos.py clean [-f]

❯ tos.py clean -f
[INFO]: Fullclean success.

清理编译缓存。-f 在 ninja clean 后删除 .build 进行深度清理。

tos.py flash [-p PORT] [-b BAUD]

❯ tos.py flash
...
[INFO]: Flash write success.

将编译好的 bin 写入设备。省略 -p 可从列表选择串口。

tos.py monitor [-p PORT] [-b BAUD]

❯ tos.py monitor
[INFO]: Open Monitor. (Quit: Ctrl+c)

实时输出设备串口日志。按 Ctrl+C 再按回车退出；也可用于写入授权码。

tos.py update

tos.py update

在主仓库 git pull/git checkout 后使用 —— 按 platform/platform_config.yaml 切换依赖到指定 commit。

tos.py new [--framework base|arduino]

tos.py new  # 提示输入项目名，复制模板

从 tools/app_template/ 脚手架新建用户应用（base 或 arduino 框架）。

tos.py dev bac [-d DIST] [-o LOGDIR]

tos.py dev bac  # 编译 config/（或 boards/）中的每个配置

批量编译：遍历每个 .config，每次构建间深度清理，可选将 bin 拷贝到分发目录。

tos.py idf <idf.py 子命令> [--idf-flags=...]

tos.py idf menuconfig
tos.py idf fullclean

仅 ESP32。对 ESP32 平台执行 idf.py 命令，需选用 ESP32 配置。

다음 옵션은 모든 하위 명령에 적용됩니다.