快速开始

1. 准备工作

• 一块兼容的 ESP32-C3 / ESP32-S3 开发板
• 一块单色点阵副屏（按仓库原理图接线）
• USB 数据线一条
• Windows 10/11 电脑一台

2. 烧录固件

1. 从 下载中心 获取对应芯片型号的固件。
2. 使用 esptool 或 ESP-IDF 的 idf.py flash 烧录。
3. 烧录完成后，设备会自动重启并进入待配对状态。

3. 安装上位机

1. 下载 Windows 上位机并解压。
2. 双击运行，插入副屏后程序会自动识别串口。
3. 在设备列表中选择你的副屏并连接。

4. 开始播放

打开任意支持系统媒体控制的播放器开始播放音乐， 副屏即可实时显示当前歌词。

常见问题

• 歌词不显示：请确认播放器支持 SMTC，且歌曲能在网易云匹配到歌词。
• 进度漂移：可在上位机中启用 OCR 校准。
• 无法识别串口：检查驱动是否安装，或更换 USB 数据线。