# esp32

**Repository Path**: ggxia-007/esp32

## Basic Information

- **Project Name**: esp32
- **Description**: 自制的一款小栗智能手表
- **Primary Language**: C
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESP32 AI 语音助手项目

基于 ESP32 的 AI 语音助手项目，集成了语音交互、图形界面、传感器等丰富功能。

## 项目简介

本项目是一个运行在 ESP32 开发板上的 AI 语音助手应用程序，支持语音对话、文字转语音（TTS）、语音识别（ASR）等核心 AI 功能，并配套图形用户界面、音频编解码、传感器采集等完整的外设驱动支持。

## 主要功能特性

### AI 智能交互
- **语音识别 (ASR)**: 支持百度语音识别 API，实现语音转文字
- **语音合成 (TTS)**: 支持百度 TTS API，实现文字转语音播放
- **大语言模型对接**: 集成阿里云千问大语言模型 API，实现智能对话

### 音频系统
- **ES8311 音频编解码器**: 高品质音频输入输出
- **麦克风采集**: 支持单声道音频采集
- **扬声器播放**: 支持音频流式播放
- **回声消除**: 集成回声处理功能

### 图形显示
- **ST7789 IPS 液晶屏**: 240x240 分辨率显示
- **电容触摸屏**: 支持触摸操作
- **LVGL v9 图形库**: 强大的图形界面框架

### 传感器支持
- **MPU6050**: 六轴加速度计和陀螺仪
- **QMC5883**: 三轴电子罗盘
- **BMP280**: 气压和温度传感器

### 存储系统
- **SD 卡支持**: SPI 接口大容量存储
- **SPIFFS**: 内部 Flash 文件系统

## 硬件要求

- ESP32 系列开发板
- ES8311 音频编解码模块
- ST7789 240x240 IPS 显示屏
- 触控面板 (CTP)
- SD 卡模块
- 传感器模块 (可选)

## 软件架构

```
components/
├── AI_APP/           # AI 应用主程序
├── BSP/              # 板级支持包
│   ├── ES8311_AUDIO/ # 音频驱动
│   ├── IPSLCD/       # 显示和触控
│   ├── SDCARD/      # 存储驱动
│   ├── SPIFFS/      # Flash 文件系统
│   ├── TTS/         # 文字转语音
│   ├── WIFI/        # 网络及 API
│   ├── bmp280/      # 气压传感器
│   ├── mpu6050/    # 运动传感器
│   └── qmc5883/    # 电子罗盘
└── LVGL_9/          # 图形库
```

## 构建说明

1. 安装 ESP-IDF 开发环境
2. 克隆项目后进入目录
3. 配置目标芯片: `idf.py set-target esp32`
4. 编译项目: `idf.py build`
5. 烧录固件: `idf.py flash`

## 配置说明

在 `components/BSP/config.h` 中可配置以下参数：

- WiFi 账号密码
- 百度 API 密钥
- 阿里云 API 配置
- 音频参数设置
- 显示屏参数

## 应用场景

- AI 语音助手设备
- 智能物联网网关
- 嵌入式 AI 实验平台
- 语音交互原型开发

## 依赖项

- ESP-IDF v4.4+
- LVGL v9
- 百度语音识别/合成 API
- 阿里云千问大模型 API

## 许可证

MIT License

## 注意事项

1. 使用语音识别和 TTS 功能需要配置有效的百度 API 密钥
2. 使用大语言模型功能需要配置阿里云 API 凭证
3. 部分功能需要联网才能正常使用