SynthCard README

---

🎛️ 1. 基础控制（Basic Control）

按键	功能	说明
空格 (Space)	播放 / 暂停	⏯️ 切换音乐播放状态。
回车 (Enter)	确认 / 选歌	在文件列表中播放当前选择的歌曲。
Esc / `	返回 / 停止播放	列表中返回播放界面；播放界面停止音乐。
Backspace	打开歌单	📂 随时进入文件列表。

---

🧭 2. 导航与跳转（Navigation）

Cardputer 键盘右下角的符号键被映射为方向控制：

按键	对应符号	功能
; (分号)	⬆️ 上	上一首（播放中） / 光标上移（列表）。
. (句号)	⬇️ 下	下一首（播放中） / 光标下移（列表）。
/	➡️ 右	快进约 5 秒。
, (逗号)	⬅️ 左	快退约 5 秒。

---

🔊 3. 音量控制与音频系统（Audio）

按键	功能	说明
= / +	音量增加	支持长按连续调节。
- / _	音量减少	支持长按连续调节。
机身顶部实体键（Ctrl）	一键静音	显示 “MUTED”，再次按恢复音量。
R	修复音频	发生变速、爆音、卡顿时重置音频系统。

---

🔁 4. 播放模式切换（System Mode）

按键	功能	模式说明
Tab	切换播放模式	SEQ → LOOP → RND 循环切换： SEQ = 顺序播放 LOOP = 单曲循环 RND = 随机播放

---

📁 5. 文件系统说明

• 支持 FAT32 SD 卡
• 推荐使用 高速度 SD（如 Sandisk Extreme）
• 支持读取 .mp3
• 高比特率 MP3 推荐在 带 PSRAM 的机型 上运行

---

⚙️ 6. 注意事项（Important Notes）

1. 音频解码必须持续调用 loop()
   否则会停止播放或崩溃。

2. I2S 引脚不可随意修改：

   • BCLK: 42
   • LRCLK: 41
   • DOUT: 1

3. 若播放卡顿：

   • SD 卡太慢
   • MP3 比特率过高
   • PSRAM 未启用

4. 播放模式与音量调节有 UI 提示。

---

📦 7. 参考工程

背景与输入处理逻辑参考了：
https://github.com/Treblewolf/M5Cardputer-Sun-Rider

---