菜单
On-chip Keyword Spotting / wake-word (KWS) for TuyaOpen via the tkl_kws API: register a callback that fires when a wake word is detected. KWS、唤醒词、语音唤醒、关键词识别、wake word、你好涂鸦、tkl_kws、离线唤醒。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | tuyaopen/onchip-kws |
| description | On-chip Keyword Spotting / wake-word (KWS) for TuyaOpen via the tkl_kws API: register a callback that fires when a wake word is detected. KWS、唤醒词、语音唤醒、关键词识别、wake word、你好涂鸦、tkl_kws、离线唤醒。 |
| when_to_use | Use when the user wants offline wake-word / keyword detection (e.g. "你好涂鸦") to trigger an action. Runs on the mic stream (see the audio peripheral skill). |
| id | onchip-kws |
| surfaces | ["embedded"] |
| tags | ["kws","wake-word","keyword","voice","audio","on-chip","tkl_kws"] |
KWS listens to microphone audio on-chip and calls you back when it hears a wake word. Set up audio input first (see the audio peripheral skill).
CONFIG_ENABLE_KWS. No app_default.config change.board_register_hardware(). Call tkl_kws_* directly. Single engine (no pins) —
record as onchip:kws in used-peripherals.json if wanted..tuyaopen/ide/platform.json → peripherals.kws.spec.wakeupWords lists the wake
words this board's model supports (e.g. TKL_KWS_WAKEUP_NIHAO_TUYA). The callback
receives a TKL_KWS_WAKEUP_WORD_E — branch on it; don't invent words not in the list.
#include "tal_api.h"
#include "tkl_kws.h"
/* Fires when a wake word is detected (model-dependent). */
static void app_kws_cb(TKL_KWS_WAKEUP_WORD_E word)
{
switch (word) {
case TKL_KWS_WAKEUP_NIHAO_TUYA: /* woken by "你好涂鸦" */ break;
default: break;
}
}
void app_kws_start(void)
{
tkl_kws_init();
tkl_kws_reg_wakeup_cb(app_kws_cb);
tkl_kws_enable(); /* start listening */
}
void app_kws_stop(void)
{
tkl_kws_disable();
}
| Function | Description |
|---|---|
tkl_kws_init() | Initialise the KWS engine |
tkl_kws_reg_wakeup_cb(cb) | Register void cb(TKL_KWS_WAKEUP_WORD_E) |
tkl_kws_enable() / tkl_kws_disable() | Start / stop listening |
tkl_kws_deinit() | Release the engine |
| Symptom | Likely cause | Fix |
|---|---|---|
| Callback never fires | Not enabled, or no mic audio | tkl_kws_enable(); ensure audio input is up |
| Wrong/no word matched | Word not in this model | Only handle words from spec.wakeupWords |
| Heavy CPU while idle | KWS left enabled always-on | Disable when not needed (tkl_kws_disable) |
SDK: src/ai_components/ai_mode/src/ai_mode_wakeup.c
(tkl_kws_reg_wakeup_cb + tkl_kws_enable/disable, callback receives the wake word).
End-to-end IoT product development orchestration for TuyaOpen projects. Guides from requirements gathering → Tuya Platform product/DP creation → complete embedded firmware generation. State-machine: detects project state and picks up from wherever development currently stands.
TDL audio codec usage for TuyaOpen: discover the audio device, capture microphone PCM frames via callback, play PCM back to the speaker, and set volume. 音频、麦克风、录音、播放、喇叭、扬声器、speaker、mic、声音、语音、codec。
TDL button input handling for TuyaOpen: create button, register event callbacks for single click, double click, long press, and multi-click. 按键、单击、双击、长按、多击、按键事件。
TDL camera control for TuyaOpen: find device, configure resolution/fps/format, open with frame callbacks for YUV422 and JPEG/H264 encoded output. 摄像头、相机、拍照、视频流、YUV、JPEG、H264、人脸识别、图像采集。
TDL display control for TuyaOpen: driver registration, open, brightness, and framebuffer flush via tdl_disp_* APIs. 显示屏、LCD、屏幕、显示、绘制、亮度、刷屏。
TDL thermal printer usage for TuyaOpen: discover the printer, print UTF-8 text (auto GBK conversion on ESC/POS), print 1-bit bitmaps, feed paper, and monitor paper/temperature status. 打印机、热敏打印、打印、小票、票据、出纸、ESC/POS、printer、DP48A。