// Build and compile TuyaOpen projects, select build configurations, edit Kconfig options, clean artifacts, and run Linux ELF binaries. Use when the user mentions compiling, building, tos.py build, config choice, menuconfig, Kconfig, build error, or running a project. 项目编译、构建、编译配置、清理编译、编译错误、menuconfig、Kconfig。
>-
Automated build-flash-monitor-analyze development loop for TuyaOpen devices. Covers log analysis, error patterns, CLI testing, and iterative debugging. Use when the user mentions dev loop, automated testing, log analysis, debug cycle, iterative development, or CI loop. 开发闭环、自动化测试、日志分析、调试循环、迭代开发。
Set up and activate the TuyaOpen development environment, install system dependencies, and initialize tos.py. Use when the user mentions environment setup, activating the SDK, installing dependencies, export.sh, or when tos.py is not found. 环境搭建、环境初始化、激活开发环境、安装依赖。
Agent-friendly non-blocking serial log capture for TuyaOpen devices. Runs tos.py monitor in the background, writes logs to file, and lets the agent tail or stop it at any time. Use when the agent needs to capture device logs without blocking, run a debug session, or monitor UART output during a build-flash-analyze loop. 后台串口日志、非阻塞监控、设备日志捕获、agent日志分析。
Add new board (BSP) support to TuyaOpen, including board directory structure, Kconfig, drivers, and config files. Use when the user mentions adding a board, new board, BSP, board support, hardware adaptation, or tos.py new board. 添加开发板、板级适配、新增BSP、硬件适配。
Configure device authorization credentials (UUID, AuthKey, PID) and network provisioning for TuyaOpen devices. Use when the user mentions device auth, authorization, UUID, AuthKey, tuya_config.h, provisioning, pairing, or cloud connection. 设备授权、授权码、配网、UUID、AuthKey、云连接。
| name | tuyaopen/build |
| description | Build and compile TuyaOpen projects, select build configurations, edit Kconfig options, clean artifacts, and run Linux ELF binaries. Use when the user mentions compiling, building, tos.py build, config choice, menuconfig, Kconfig, build error, or running a project. 项目编译、构建、编译配置、清理编译、编译错误、menuconfig、Kconfig。 |
| license | Apache-2.0 |
| compatibility | ["TuyaOpen environment activated (export.sh / export.ps1 / export.bat)","cmake >= 3.28, ninja >= 1.6"] |
Docs: https://tuyaopen.ai/docs/quick-start/project-compilation
SDK root: All paths and commands in this skill are relative to the TuyaOpen SDK root (
$OPEN_SDK_ROOTon Linux/macOS/PowerShell,%OPEN_SDK_ROOT%on Windows CMD). Activate the environment first — see skilltuyaopen/env-setup.
Buildable projects live in two directories:
apps/ — application projects (e.g. apps/tuya_cloud/switch_demo, apps/tuya.ai/your_chat_bot)examples/ — example projects (e.g. examples/get-started/sample_project, examples/peripherals/gpio)Navigate into the target project before building:
cd apps/tuya_cloud/switch_demo
tos.py config choice # interactive — list and pick
tos.py config choice -c TUYA_T5AI_EVB # non-interactive — select by name (Agent / CI)
tos.py config choice -d # interactive — board default configs only
tos.py config choice -d -c TUYA_T5AI_EVB # non-interactive — from board defaults
All variants trigger a full clean. The selected config is written to app_default.config.
Config lookup priority: project config/ dir > boards/ global configs.
-c flag (non-interactive, preferred for Agent / CI):
Matches config by filename — .config extension is optional (TUYA_T5AI_EVB and TUYA_T5AI_EVB.config are equivalent).
If the name is not found, the command exits with an error and prints the available config names.
tos.py config menu # terminal-based Kconfig editor; resolves depends on/select automatically
tos.py config save # interactive (requires TTY) — save current config as named preset
Menuconfig keys: arrows or h/j/k/l; ? for help; write to app_default.config on exit.
Edit app_default.config in the project directory. The file uses Kconfig defconfig format — only specify values that differ from defaults:
CONFIG_PROJECT_VERSION="1.0.1"
CONFIG_BOARD_CHOICE_T5AI=y
CONFIG_BOARD_CHOICE_TUYA_T5AI_CORE=y
CONFIG_ENABLE_LIBLVGL=y
CONFIG_ENABLE_MBEDTLS_SSL_MAX_CONTENT_LEN=4096
# CONFIG_ENABLE_COMP_AI_DISPLAY is not set
Key points:
CONFIG_BOARD_CHOICE_<PLATFORM>=y selects the platform (e.g. T5AI, ESP32, LINUX).CONFIG_BOARD_CHOICE_<BOARD>=y selects the specific board under that platform (e.g. TUYA_T5AI_CORE, DNESP32S3, UBUNTU). Both platform and board are required.CHIP_CHOICE and PLATFORM_CHOICE are auto-set by the board's Kconfig — do not set them manually.CONFIG_X=y to enable, # CONFIG_X is not set to disable.CONFIG_X="value". Integer options: CONFIG_X=1234.Common platform + board config pairs:
| Target | app_default.config lines |
|---|---|
| LINUX / Ubuntu (native x86/x64) | CONFIG_BOARD_CHOICE_LINUX=yCONFIG_BOARD_CHOICE_UBUNTU=y |
| LINUX / Raspberry Pi | CONFIG_BOARD_CHOICE_LINUX=yCONFIG_BOARD_CHOICE_RASPBERRY_PI=y |
| T5AI EVB | CONFIG_BOARD_CHOICE_T5AI=yCONFIG_BOARD_CHOICE_TUYA_T5AI_EVB=y |
| T5AI Core | CONFIG_BOARD_CHOICE_T5AI=yCONFIG_BOARD_CHOICE_TUYA_T5AI_CORE=y |
| ESP32-S3 | CONFIG_BOARD_CHOICE_ESP32=yCONFIG_BOARD_CHOICE_ESP32_S3=y |
Understanding how config flows into the build (all paths relative to the project directory):
app_default.config (your edits — defconfig format)
↓ tos.py build
.build/cache/using.config (fully expanded .config with all defaults resolved)
↓ conf2cmake.py
.build/cache/using.cmake (CMake variables: set(CONFIG_X "y"))
↓ conf2h.py
.build/cache/include/tuya_kconfig.h (C macros: #define CONFIG_X 1)
If a build fails due to config issues, check .build/cache/using.config to see the fully resolved config (with all defaults filled in).
Detailed select / depends on / if mechanisms and agent strategy: references/KCONFIG_GUIDE.md.
tos.py build # standard build
tos.py build -v # verbose (shows full compiler commands)
Agent / CI: Before the first build in a non-interactive session, prevent platform-update prompts:
mkdir -p .cache && touch .cache/.dont_prompt_update_platformCreate this file once after activating the environment. Without it,
tos.py buildmay hang waiting for ay/n/dprompt when the platform commit has changed.
tos.py dev bac # build-all-configs: for each config in the project, full-clean then build
Each config triggers a full clean before building, so this can take a long time. Useful for verifying all board variants compile cleanly.
tos.py clean # ninja clean
tos.py clean -f # full clean — deletes .build/ entirely
config choice and config menu also trigger a full clean automatically.
Paths below are relative to the project directory (where you ran
tos.py build), not the SDK root.
LINUX platform produces a native ELF binary. Build output is copied to dist/:
./dist/<project_name>_<version>/<project_name>_<version>.elf
A copy also exists at .build/bin/ during the build. The dist/ path is the canonical output location printed at the end of a successful build.
Example (for a project named hello_world_linux version 1.0.0):
./dist/hello_world_linux_1.0.0/hello_world_linux_1.0.0.elf
| Symptom | Cause | Fix |
|---|---|---|
| Slow build on Windows | MSPCManagerService interference | Kill the process; add project dir to Windows Security exclusions |
| Toolchain download fails | Network issue | Retry tos.py build; check platform/ directory |
| Build fails after config change | Incompatible options | tos.py clean -f then re-select: tos.py config choice -c <name> (non-interactive) or tos.py config choice (interactive) |
No rule to make target | Stale build cache | tos.py clean -f && tos.py build |
Build hangs with y/n/d prompt (Agent/CI) | Platform commit mismatch, missing suppress file | Run mkdir -p .cache && touch .cache/.dont_prompt_update_platform before building, or tos.py update first |
| Config option silently ignored | Missing depends on prerequisite | Check .build/cache/using.config to verify; grep Kconfig files for dependency chain |
FATAL_ERROR ... using.config | No config selected yet | Run tos.py config choice -c <name> (non-interactive) or tos.py config choice (interactive) |
Build succeeds but ELF not in dist/ | Platform linker did not produce expected binary name | Check .build/bin/ for the raw output; verify project name matches directory name |