配置说明

本文档指导开发者根据自身需求对 tuyaos_demo_wukong_ai 项目进行配置，涵盖板型选择、功能开关、AI 模式、UI、音频等配置项。

配置入口与流程

进入配置界面

make app_menuconfig APP_NAME=tuyaos_demo_wukong_ai

在 Tuya Wind IDE 中，可通过菜单或点击鼠标右键并在 工程 下选择 配置 进入。

配置生效流程

┌─────────────────┐     ┌──────────────────────┐     ┌─────────────────┐
│ 1. 进入 menuconfig │ ──► │ 2. 选择/修改配置项   │ ──► │ 3. 保存退出      │
└─────────────────┘     └──────────────────────┘     └─────────────────┘
                                                              │
                                                              ▼
┌─────────────────┐     ┌──────────────────────┐     ┌─────────────────┐
│ 6. 编译固件      │ ◄── │ 5. 编译工程          │ ◄── │ 4. 生成配置文件  │
└─────────────────┘     └──────────────────────┘     └─────────────────┘

make app_config APP_NAME=tuyaos_demo_wukong_ai

按需选型指南

按功能需求选择

按 AI 对话模式选择

板型选定后，会 自动启用 部分 AI 模式（由板型 select 决定）。下表为各板型默认启用的模式：

TUYA_AI_CHAT_DEFAULT_MODE

上电默认进入的对话模式（0 – 5 对应 hold/oneshot/wakeup/free/translate/p2p）。

如何修改板型支持的对话模式?

在 build/APPconfig 中，于对应板型的 config 块下添加或删除 select ENABLE_AI_MODE_xxx。

例如为某板型增加 WAKEUP 模式，添加 select ENABLE_AI_MODE_WAKEUP；删除某模式则去掉对应 select 行。P2P 模式需先开启 ENABLE_TUYA_CAMERA，再在子项中开启 ENABLE_AI_MODE_P2P。修改后执行 make app_config 生成配置。

如何修改默认对话模式?

在 menuconfig 中找到 TUYA_AI_CHAT_DEFAULT_MODE，将数值改为 0 – 5 中所需模式，保存后执行 make app_config 生成配置。

配置项详解

摄像头（ENABLE_TUYA_CAMERA）

• 可见条件：T5AI_BOARD、T5AI_BOARD_EYES、T5AI_BOARD_ROBOT、T5AI_BOARD_DESKTOP
• 子项：ENABLE_AI_MODE_P2P，启用 P2P 视频通话模式。

UI（ENABLE_TUYA_UI）

AI 对话默认模式（TUYA_AI_CHAT_DEFAULT_MODE）

如何修改默认模式？

若当前默认模式不满足需求，可按以下方式修改：

• 通过 menuconfig（推荐）：

  • 执行 make app_menuconfig APP_NAME=tuyaos_demo_wukong_ai。
  • 找到 TUYA_AI_CHAT_DEFAULT_MODE，将数值改为 0 – 5 中所需模式。
  • 保存退出后，执行 make app_config APP_NAME=tuyaos_demo_wukong_ai 生成配置。

• 运行时切换：

  • 用户可通过 UI 设置切换对话模式，切换结果会保存到 KV 存储。
  • 下次上电会优先使用 KV 中保存的模式；若该模式未启用，则使用 TUYA_AI_CHAT_DEFAULT_MODE。

• 约束说明：

  • 所选默认模式必须是 当前板型已启用的模式，具体请参考 版型及模式。
  • 若板型未启用该模式，系统会 Fallback 到下一个已启用的模式。
  • 例如：WUKONG_BOARD_UBUNTU 仅启用 HOLD，即使设为 3（free）也会实际使用 HOLD。

AI 播放器解码（AI Player Decoder Options）

常见配置组合示例

最小配置（纯语音，无屏）

BOARD_TYPE        = T5AI_BOARD（或 EVB）
ENABLE_TUYA_UI    = n
ENABLE_TUYA_CAMERA = n

标准开发板（语音 + 屏 + 摄像头）

BOARD_TYPE         = T5AI_BOARD
ENABLE_TUYA_UI     = y
ENABLE_TUYA_CAMERA = y
ENABLE_AI_MODE_P2P = n（按需开启）

Ubuntu 模拟

BOARD_TYPE = WUKONG_BOARD_UBUNTU

便携评估板（小屏 + 电池）

BOARD_TYPE = T5AI_BOARD_EVB
ENABLE_TUYA_UI = y

配置后检查

1. 确认配置已生成：检查 include/tuya_app_config.h 或 build/tuya_app.config 中是否有对应宏定义。
2. 确认板级文件：local.mk 会根据 CONFIG_T5AI_BOARD 等选择 src/boards/xxx/ 下的板级实现。
3. 重新编译：配置变更后，务必执行 make app_config 再编译。

新增 BOARD_TYPE 指导

在 choice 中新增 config

在 build/APPconfig 的 choice 块中新增 config，并设置 select 关联：

        config MY_CUSTOM_BOARD
            bool "MY_CUSTOM_BOARD"
            select TUYA_MODULE_T5
            select USING_BOARD_AUDIO_INPUT
            select USING_BOARD_AUDIO_OUTPUT
            select ENABLE_AI_MODE_HOLD
            select ENABLE_AI_MODE_ONESHOT
            select ENABLE_AI_MODE_WAKEUP
            select ENABLE_AI_MODE_FREE

• 音频：板载麦克风/喇叭用 USING_BOARD_AUDIO_INPUT/OUTPUT，UART 外接用 USING_UART_AUDIO_INPUT/OUTPUT。
• 显示：有 SPI 屏时加 select LCD_SPI_DISPLAY，需引脚重映射时加 select SPI0_REMAP_PIN。
• AI 模式：按需 select ENABLE_AI_MODE_xxx。

摄像头可见条件（可选）

若新板型支持摄像头，在 ENABLE_TUYA_CAMERA 的 if 条件中加入新板型：

if (T5AI_BOARD || T5AI_BOARD_EYES || ... || MY_CUSTOM_BOARD)