Tuyaopen/onchip Kws

TuyaOpen On-Chip KWS (wake word)

Works on the mic stream

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).

On-chip — no Kconfig, no TDD

• Platform-provided. Do NOT write CONFIG_ENABLE_KWS. No app_default.config change.
• No board_register_hardware(). Call tkl_kws_* directly. Single engine (no pins) — record as onchip:kws in used-peripherals.json if wanted.

Platform spec — supported wake words

.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.

Register callback + enable

#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();
}

API Reference

Troubleshooting

Reference

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).