# lib-esp32-xzai

**Repository Path**: dyun1988/lib-esp32-xzai

## Basic Information

- **Project Name**: lib-esp32-xzai
- **Description**: ESP32-S3 小智语音助手扩展库
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-18
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小智AI聊天机器人 v2.2.4（ESP32专用）

## 简介
本库基于 xiaozhi-esp32 v2.2.4官方 ESP-IDF 项目全量迁移，
保留 v0.0.6 全部 Blockly API 向后兼容，同时新增 v2.2.4 核心引擎、95 板卡、SH1106 屏幕等支持。
适用于 ESP32 / ESP32S3 / ESP32C3 / ESP32P4 开发板。

## v2.2.4 新增功能
- **核心引擎升级**: Application 单例 + DeviceStateMachine + McpServer（v2.2.4 C++ 源码并入 src/esp32aisrc/core/）
- **音频子系统**: AudioService + 8 种 AudioCodec + OggDemuxer + 3 种 Processor + 3 种 WakeWord
- **通信协议**: WebSocket / MQTT+UDP 双协议支持（src/esp32aisrc/protocols/）
- **95 板卡配置**: bread-compact、ESP-BOX、M5Stack、LILYGO、SenseCAP、Otto Robot 等（src/boards/）
- **显示系统**: LCD ST7789 / OLED SSD1306 / SH1106 (128x64) + LVGL v9.4.0 表情动图 + GIF/JPEG
- **LED 控制**: GPIO LED / 单灯 / 环形灯条（src/esp32xzai/led/）
- **42 语言多语言**: 中文、英文、日文等 locale 语音包（src/esp32xzaicommon/locales/）
- **分区表 v1/v2**: 支持 4M/8M/16M/32M Flash

## 新增 Blockly 块（v2.2.4）
工具箱中「板卡与硬件 (v2.2.4)」分类：
- **选择板卡** — 14 种常用板卡下拉选择
- **摄像头** — OV2640/OV3660/OV5640 + QVGA~UXGA 分辨率
- **4G 模块 ML307** — UART 引脚配置
- **电池监测** — ADC 引脚 + 满电/空电电压
- **电池电量** — 返回百分比数值
- **回声消除 AEC** — 关闭/设备端/服务端三档

## 更新日志
### 从 v0.0.6 升级到 v2.2.4
- `ai_vox::Engine::GetInstance()` -> `Application::GetInstance()`（新代码兼容，旧块不受影响）
- `ai_vox::ChatState::*` -> `kDeviceState*` 枚举
- 新增 SH1106 (128x64 I2C) 屏幕驱动（src/esp32aisrc/components/sh1106/）
- lvgl_display/ 子目录文件提升到 esp32xzai/ 顶层（兼容 Aily 构建系统扁平拷贝）
- toolbox.json 结构修复：所有顶层项均为 category，消除 getContents().some 错误

## 兼容性
- ESP32 / ESP32-S3 / ESP32-C3 / ESP32-P4

## 开源协议
- 上游项目: https://github.com/78/xiaozhi-esp32 (v2.2.4)
- 遵循 MIT License
- Copyright (c) 2025 Shenzhen Xinzhi Future Technology Co., Ltd.
- 本库在"nulllab-雷神"所做的 AI_VOX 库及"笨笨熊"的 Blockly 封装上修改而来

## 致谢
本库由笨笨熊版本的 lib-esp32-xzai 衍化而成，只是站在巨人的肩膀上。感谢笨笨熊在 Blockly 封装上的开拓性工作，以及 nulllab-雷神 所做的 AI_VOX 库。本库在此基础上进行了 v2.2.4 全量升级与跨平台兼容性修复。

## 作者
016