# ESP32_AI助手

**Repository Path**: r-glory/esp32i-assistant

## Basic Information

- **Project Name**: ESP32_AI助手
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESP32-S3 智能硬件控制项目

## 1. 项目简介
本项目是一个基于 ESP32-S3 芯片开发的嵌入式工程，主要功能融合了语音唤醒及控制、舵机控制、OLED 显示、以及硬件状态监测等，支持与大语言模型（LLM）等进行交互。项目中拆分了多个 BSP (Board Support Package) 组件（如 I2S 麦克风/扬声器驱动组件），以便于代码的维护与复用。

## 2. 硬件依赖
- **主控**：ESP32-S3 开发板（Flash: 16MB）
- **音频**：I2S 麦克风和扬声器模块（用于语音指令输入及音频提示）
- **显示**：OLED 显示屏
- **执行器**：SG90 360度连续旋转舵机等
- **其他外围**：状态指示灯及控制引脚

## 3. 开发环境
- **开发框架**: ESP-IDF
- **编程语言**: C 语言
- **辅助工具**: Python (用于运行工程下的 `build.py` 及字模生成脚本 `oled_font_generator.py`)

## 4. 目录结构说明
```text
├── components/            # 项目组件存放目录 (例如: BSP/I2S, Servo 控制相关等)
├── main/                  # 主程序逻辑入口
├── managed_components/    # ESP-IDF 组件管理器自动下载的依赖包 (已被 git 忽略)
├── spiffs_data/           # SPIFFS 文件系统对应的数据内容
├── build/                 # 编译输出产物目录 (已被 git 忽略)
├── partitions-16MIB.csv   # 定制的 16MB Flash 分区表文件
├── CMakeLists.txt         # 顶层构建配置文件
├── sdkconfig.defaults     # 工程基础默认配置
├── sdkconfig.defaults.esp32s3 # 针对 ESP32-S3 的特定默认配置
├── build.py / build.bat   # 本地辅助构建脚本
└── oled_font_generator.py # OLED 字体/字模生成实用脚本
```

## 5. 编译与下载
1. **环境准备**：
   确保您的系统已安装并正确配置好 ESP-IDF 的环境路径。
2. **下载依赖包并编译**：
   如果您的终端已配置好 `idf.py`，可以直接使用工程内的脚本或是输入以下指令：
   ```bash
   idf.py build
   ```
3. **烧录并监控输出**：
   ```bash
   idf.py flash monitor
   ```

## 6. Git 提交注意事项
工程根目录已配置了 `.gitignore` 文件。自动忽略了 `build/` 构建目录、`sdkconfig` 本地配置文件以及 `managed_components/` 包含的第三方库包等。在推送到远程仓库前，请不要强制添加这些被忽略的文件，以保证仓库干净。