Built-in Voice Wake-up

Overview

Built on top of the T5 chip/module, Wukong AI Hardware Development Framework supports built-in voice wake-up algorithms, allowing users to wake devices using specific wake words. The default wake word is “Hey, Tuya”.

If you want to define a personalized wake word, you can contact your Tuya account manager, submit customization requirements, and communicate specific project details and plans.

Hardware design requirements

The built-in voice wake-up algorithm requires hardware support. Design an audio loopback circuit to feed the speaker’s output into the acoustic echo cancellation (AEC) algorithm, thereby ensuring reliable wake word detection during active audio playback.

Regarding the audio loopback circuit, you can refer to the following hardware solutions:

• T5AI-Box Voice Solution
• T5AI-Bubble Voice Solution

Software design requirements

The built-in voice wake-up algorithm currently operates exclusively within the Tuya voice subsystem and has not yet been opened to the public. You only need to set the trigger_mode of TY_AI_TOY_CFG_DEFAULT to TY_AI_TRIGGER_MODE_WAKEUP or TY_AI_TRIGGER_MODE_FREE to automatically support this functionality. You do not need to worry about its principle and how to use it.

// Define interaction types
typedef enum {
    TY_AI_TRIGGER_MODE_HOLD,        // Press and hold to trigger
    TY_AI_TRIGGER_MODE_ONE_SHOT,    // Press to trigger,  turn-based dialogue mode‌
    TY_AI_TRIGGER_MODE_WAKEUP,      // Keyword wakeup mode
    TY_AI_TRIGGER_MODE_FREE,        // Keyword wakeup and free dialogue mode
} TY_AI_TRIGGER_MODE_E;

// Set the working mode to keyword wake-up mode
#define TY_AI_TOY_CFG_DEFAULT { \
    .audio_trigger_pin = TUYA_GPIO_NUM_12, \
    .spk_en_pin = TUYA_GPIO_NUM_28, \
    .led_pin = TUYA_GPIO_NUM_1, \
    .trigger_mode = TY_AI_TRIGGER_MODE_WAKEUP, \
    .audio_cfg = TY_AI_AUDIO_CFG_DEF \
}

Support and help

If you have any problems with TuyaOS development, you can post your questions in the Tuya Developer Forum.