L'électron rare
6129375916
ESP-NOW framework (slave/master), 4 puzzle firmwares (P1 son, P5 morse, P6 NFC, P7 coffre), NPC V3 adaptive, game coordinator, TTS V3 fallback chain, BLE audio control.
98 lines
3.1 KiB
C
98 lines
3.1 KiB
C
// tts_client.h - HTTP client for Piper TTS on Tower:8001 with SD fallback.
|
|
#pragma once
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define TTS_TOWER_IP "192.168.0.120"
|
|
#define TTS_TOWER_PORT 8001
|
|
#define TTS_API_PATH "/api/tts"
|
|
#define TTS_VOICE "tom-medium"
|
|
#define TTS_TIMEOUT_MS 2000
|
|
#define TTS_HEALTH_INTERVAL_MS 30000
|
|
#define TTS_MAX_TEXT_LEN 200
|
|
#define TTS_WAV_BUF_SIZE (64 * 1024)
|
|
|
|
typedef enum {
|
|
TTS_RESULT_OK = 0,
|
|
TTS_RESULT_TIMEOUT,
|
|
TTS_RESULT_HTTP_ERROR,
|
|
TTS_RESULT_ALLOC_FAIL,
|
|
TTS_RESULT_TOWER_DOWN,
|
|
TTS_RESULT_TEXT_TOO_LONG
|
|
} tts_result_t;
|
|
|
|
typedef struct {
|
|
bool tower_reachable;
|
|
uint32_t last_health_check_ms;
|
|
uint32_t last_latency_ms;
|
|
uint32_t total_requests;
|
|
uint32_t total_failures;
|
|
} tts_stats_t;
|
|
|
|
/// Initialize TTS client (call once from setup).
|
|
void tts_init(void);
|
|
|
|
/// Check Tower TTS health (non-blocking, HEAD request).
|
|
/// Updates internal reachability state.
|
|
/// Returns true if Tower responded within TTS_TIMEOUT_MS.
|
|
bool tts_check_health(uint32_t now_ms);
|
|
|
|
/// Periodic health check — only pings if TTS_HEALTH_INTERVAL_MS elapsed.
|
|
void tts_health_tick(uint32_t now_ms);
|
|
|
|
/// Query last known Tower reachability.
|
|
bool tts_is_tower_reachable(void);
|
|
|
|
/// Request TTS synthesis. Blocking call (up to TTS_TIMEOUT_MS).
|
|
/// On success, writes WAV data to out_buf and sets *out_len.
|
|
/// Caller must allocate out_buf of at least TTS_WAV_BUF_SIZE bytes (use PSRAM).
|
|
tts_result_t tts_synthesize(const char* text, uint8_t* out_buf,
|
|
size_t buf_capacity, size_t* out_len);
|
|
|
|
/// Get TTS client statistics.
|
|
tts_stats_t tts_get_stats(void);
|
|
|
|
// ============================================================
|
|
// V3 fallback chain: XTTS-v2 → Piper → SD card
|
|
// ============================================================
|
|
|
|
// XTTS-v2 endpoint on KXKM-AI (GPU, ~2s latency, voice clone)
|
|
#define TTS_XTTS_HOST "kxkm-ai"
|
|
#define TTS_XTTS_PORT 5002
|
|
#define TTS_XTTS_API_PATH "/v1/audio/speech"
|
|
|
|
// Piper TTS fallback (CPU, ~500ms, Tower:8001)
|
|
#define TTS_PIPER_API_PATH "/v1/audio/speech"
|
|
|
|
// Backend priority
|
|
typedef enum {
|
|
TTS_BACKEND_XTTS = 0, // KXKM-AI XTTS-v2 (GPU voice clone)
|
|
TTS_BACKEND_PIPER = 1, // Tower Piper TTS (CPU, faster)
|
|
TTS_BACKEND_SD = 2, // SD card pre-generated WAV (offline)
|
|
TTS_BACKEND_COUNT
|
|
} tts_backend_t;
|
|
|
|
/// Select best available backend (performs health-checks).
|
|
/// Health-check results are cached for TTS_HEALTH_INTERVAL_MS.
|
|
tts_backend_t tts_select_backend(uint32_t now_ms);
|
|
|
|
/// Synthesize text using best available backend.
|
|
/// Fallback chain: XTTS → Piper → SD.
|
|
/// sd_fallback_key: phrase key used to build SD path (e.g. "hints.P1_SON.level_1.0").
|
|
/// Returns TTS_RESULT_OK on success, error code otherwise.
|
|
tts_result_t tts_speak_v3(const char* text, const char* sd_fallback_key,
|
|
uint8_t* out_buf, size_t buf_capacity, size_t* out_len);
|
|
|
|
/// Return the backend used by the last tts_speak_v3() call.
|
|
tts_backend_t tts_last_backend(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|