# ESP32-S3 音频可视化项目

这是一个基于 ESP32-S3 和 MicroPython 的音频可视化项目，使用 ST7789 方形屏幕和 I2S 音频接口，实现了音频播放、麦克风录音和实时音频可视化功能。

## 项目概述

本项目将原有的 C++ Otto 机器人代码移植到 MicroPython 平台，专注于音频处理和可视化功能。主要特性包括：

- 🎵 **音频播放**: 支持 I2S 接口的音频输出，内置马里奥主题曲
- 🎤 **麦克风录音**: 支持 I2S 接口的数字麦克风（ICS-43434）
- 📊 **实时可视化**: 在 240x240 ST7789 屏幕上显示音频电平柱状图
- 🎯 **按键交互**: 使用 Boot 按键控制录音和播放
- 🔧 **模块化设计**: 清晰的代码结构，易于扩展和维护

## 硬件要求

### 核心硬件
- **ESP32-S3 开发板**
- **ST7789 240x240 方形屏幕**
- **MAX98357A I2S 音频放大器**
- **ICS-43434 I2S 数字麦克风**

### 硬件连接

项目支持两种硬件配置版本：

#### 非摄像头版本（默认）
```
屏幕连接：
- BL (背光): GPIO 3
- MOSI: GPIO 10
- SCK: GPIO 9
- DC: GPIO 46
- RST: GPIO 11
- CS: GPIO 12

音频输出 (MAX98357A)：
- BCK: GPIO 15
- WS: GPIO 16
- SD: GPIO 7

麦克风输入 (ICS-43434)：
- SCK: GPIO 5
- WS: GPIO 4
- SD: GPIO 6
```

#### 摄像头版本
```
屏幕连接：
- BL: GPIO 38
- MOSI: GPIO 45
- SCK: GPIO 48
- DC: GPIO 47
- RST: GPIO 1
- CS: 无

音频 (Duplex I2S)：
- BCK: GPIO 42
- WS: GPIO 40
- 输出 SD: GPIO 39
- 输入 SD: GPIO 41
```

## 软件架构

### 文件结构
```
main.py          # 主程序，包含核心逻辑循环
config.py        # 硬件配置管理
audio.py         # 音频播放器和麦克风类
display.py       # 屏幕显示管理
st7789py.py      # ST7789 驱动
boot.py          # 启动脚本
```

### 核心功能

#### 1. 音频播放 (`audio.py`)
- `AudioPlayer` 类：管理 I2S 音频输出
- 支持立体声输出（MAX98357A 自动混合 L+R）
- 内置马里奥主题曲播放功能
- 可播放指定频率和时长的音调

#### 2. 麦克风录音 (`audio.py`)
- `Microphone` 类：管理 I2S 音频输入
- 支持 32-bit 单声道录音（ICS-43434）
- 实时音频电平监测
- 按键触发的录音功能

#### 3. 屏幕显示 (`display.py`)
- `Display` 类：管理 ST7789 屏幕
- 音频电平实时柱状图显示
- 颜色分级（绿色→黄色→红色）
- 按键状态和心跳指示器

#### 4. 配置管理 (`config.py`)
- 支持多硬件版本配置
- 引脚定义集中管理
- 音频参数可配置

## 使用说明

### 基本操作

1. **启动**: 系统上电后自动初始化屏幕、音频和麦克风
2. **音频测试**: 启动时会自动播放马里奥主题曲
3. **实时监测**: 屏幕显示实时音频电平柱状图
4. **录音功能**: 
   - 按住 Boot 按键开始录音
   - 释放按键停止录音并自动播放

### 屏幕显示

- **左上角**: 按键状态指示（红色=按下，蓝色=释放）
- **右上角**: 心跳指示器（每 100ms 翻转，证明程序运行正常）
- **中央**: 音频电平柱状图
  - 绿色: 低电平（安静环境）
  - 黄色: 中等电平（正常说话）
  - 红色: 高电平（大声说话/噪音）

### 串口输出

系统通过串口输出调试信息：
- 初始化状态
- 音频电平数值（每秒更新）
- 录音/播放状态
- 错误信息

## 技术细节

### 音频处理

#### 麦克风数据处理
- 32-bit 采样数据右移 8 位转换为 24-bit 有效数据
- RMS（均方根）计算用于音频电平评估
- 峰值检测用于可视化显示

#### 录音播放
- 录音时保存原始字节数据
- 播放时提取高 16-bit 数据
- 动态重配置 I2S 参数匹配录音格式

### 显示优化

#### 柱状图更新策略
- 高度变化时只重绘变化部分
- 颜色变化时重绘整个柱状图
- 黑色背景清除多余部分

#### 性能考虑
- 最小化屏幕刷新区域
- 使用内存缓冲区减少分配
- 定期垃圾回收防止内存溢出

## 故障排除

### 常见问题

1. **屏幕无显示**
   - 检查背光引脚连接
   - 确认 SPI 引脚配置正确
   - 验证屏幕供电电压

2. **无音频输出**
   - 检查 I2S 引脚连接
   - 确认 MAX98357A 供电正常
   - 验证扬声器连接

3. **麦克风无响应**
   - 检查 I2S 引脚连接
   - 确认 ICS-43434 供电正常
   - 验证麦克风数据格式配置

4. **录音播放有噪音**
   - 调整音频电平阈值
   - 检查电源稳定性
   - 验证 I2S 时钟配置

### 调试建议

- 使用串口监视器查看详细日志
- 检查 `config.py` 中的引脚配置
- 验证硬件连接与配置匹配
- 逐步测试各个模块功能

## 扩展开发

### 功能扩展
- 添加更多音频效果
- 实现频谱分析显示
- 增加存储功能（SD 卡）
- 添加无线控制（WiFi/蓝牙）

### 代码优化
- 实现更高效的音频算法
- 优化内存使用
- 添加错误恢复机制
- 改进用户界面

## 许可证

本项目基于开源协议发布，详见 LICENSE 文件。

## 致谢

- Otto DIY 社区提供原始 C++ 代码
- MicroPython 社区提供优秀的开发平台
- 开源硬件社区的支持