《Muse Gadgets 实战》第 8 章：AMOLED 圆屏刷机

第 6 章用的 ESP32-C5 是无屏板，编译时什么都不用加，因为默认配置就是它的。带屏板子不一样——屏幕要驱动、触屏要配置，多了个东西要学：overlay。本章讲 Muse Gadgets 带屏板子的 overlay 配置，以 Waveshare 1.75 寸 AMOLED 圆屏为例，一步一步走完编译和刷机。

主角：Waveshare 1.75 寸圆屏两兄弟

官方仓库里这块屏有两个版本，长得一模一样，名字差一个字母 C：

型号	主控	屏幕	Flash / PSRAM
ESP32-S3-Touch-AMOLED-1.75C	ESP32-S3	1.75 寸 466×466 圆屏 AMOLED，触屏	32 MB / 8 MB
ESP32-S3-Touch-AMOLED-1.75	ESP32-S3	1.75 寸 466×466 圆屏 AMOLED，触屏	16 MB / 8 MB

（2026-10-15 读取官方 esp32/devices/README.md 第 43、45 行表格实测）

看清楚了：两者的唯一区别是 flash 大小，32MB 和 16MB，屏幕一模一样。驱动这块屏的芯片叫 CO5300，是一块圆形 AMOLED。买哪个都行，本章以 1.75C 为例，换 1.75 只改一个 overlay 文件名。

1.75 和 1.75C 买哪个？

功能上没区别。flash 大的是 C 版，留的余量更多；非 C 版 16MB 也够用，官方 overlay 里给它配的就是完整 UI。

价格写不出来——具体售价每天在变，本章不写数字，免得误导你。买之前去微雪官网核对一眼就行。

overlay 到底是个啥

一句话：overlay 是给特定板子打的配置补丁。

编译固件时，ESP-IDF 先读一个基础配置 sdkconfig.defaults。无屏的 C5 板子到这一步就够了。带屏板子不够，屏幕引脚、触屏驱动、音频芯片这些配置不在基础配置里，得再叠两层：

sdkconfig.defaults——所有板子共用的底子
devices/sdkconfig.muse——Muse Gadgets 的通用配置
devices/sdkconfig.muse-waveshare-s3-175c——这块板子专属的（1.75 非 C 版是 muse-waveshare-s3-175）

顺序不能错。官方 README 原话是”load sdkconfig.defaults first and then the board’s overlays, in order”——先底子、再通用、最后专属。叠错了，编译能过，但屏幕大概率不亮。

说白了，overlay 就是告诉编译器：”这块板子多了块屏，引脚是这么接的，驱动是这么配的”。

编译命令，一行一行看

这两块板子官方没给 tools/board.sh 快捷命令，表格 Build 列写的是 by hand——意思是自己拼 idf.py 参数。别怕，抄官方给的模板就行：

idf.py -B build-muse-175c -DIDF_TARGET=esp32s3 \
  -DSDKCONFIG=build-muse-175c/sdkconfig \
  -DSDKCONFIG_DEFAULTS="sdkconfig.defaults;devices/sdkconfig.muse;devices/sdkconfig.muse-waveshare-s3-175c" build

（转述自官方 README Build 节”by hand”示例，原文以 AIPI Lite 为例，板子名换成 1.75C）

逐行拆开：

-B build-muse-175c：编译产物放这个目录。每块板子单独一个目录，互不干扰。
-DIDF_TARGET=esp32s3：告诉编译器目标芯片是 ESP32-S3。第 4 章装 ESP-IDF v6.0.1 时讲过，版本必须对，target 也必须对。
-DSDKCONFIG=...：生成的最终配置写哪。
-DSDKCONFIG_DEFAULTS="..."：核心就是这一行。三个文件用分号连起来，顺序就是上面说的叠加顺序：底子 → muse 通用 → 1.75C 专属。

1.75 非 C 版把最后一项换成 devices/sdkconfig.muse-waveshare-s3-175，别的全一样。

敲回车，等编译走完。第一次编译慢，正常。

先备份原厂固件，再刷机

刷机前先把板子出厂自带的固件备份出来。万一想回去，还有退路。官方在多块板子的说明里都建议这么做：

python -m esptool --chip esp32s3 -p PORT read-flash 0 0x1000000 waveshare-175c.bin

（转述自官方 README 多个板子段落的备份命令，如 Core2、JC3248W535）

把上面命令里的 PORT 换成你电脑上板子的串口。备份完，再刷：

idf.py -B build-muse-175c -DIDF_TARGET=esp32s3 \
  -DSDKCONFIG=build-muse-175c/sdkconfig \
  -DSDKCONFIG_DEFAULTS="sdkconfig.defaults;devices/sdkconfig.muse;devices/sdkconfig.muse-waveshare-s3-175c" \
  -p PORT flash

跟编译命令一模一样，尾巴加个 -p PORT flash。PORT 照样换成你自己的串口号。

刷完长什么样

带屏板子刷出来的是完整 UI——圆屏上会显示 Muse 的头像界面。不像无屏板子只能看灯猜状态，带屏的直接看屏幕。

配对流程跟第 7 章讲的一样：Muse App 里 Settings > Devices > 开开发者模式 > Add Device，选 MuseGadget-XXXXXX。区别是状态提示从”看灯”变成”看屏幕”，屏幕上会告诉你现在到哪一步了。

屏幕不亮是刷坏了吗？

大概率不是刷坏了。按这个顺序查：

先查 overlay 对没对。屏幕不亮最常见的原因就是 overlay 文件名写错，或者三个文件的顺序叠反了。对着上面那条命令再看一遍，muse-waveshare-s3-175c 和 muse-waveshare-s3-175 别搞混——C 版和非 C 版就差这一个字母。

再查 ESP-IDF 版本。第 4 章强调过，必须是 v6.0.1。版本不对，编译可能侥幸通过，运行时出各种怪问题。

换板子别忘换 overlay。从 1.75C 换到 1.75，或者换到别的板子，overlay 文件名必须跟着换。编译目录 -B 也建议换个新的，免得旧配置残留捣乱——官方 AGENTS.md 专门讲了”build picks up stale settings”这个坑。

同系列其他 AMOLED 板子速览

微雪这套 AMOLED 板子是个家族，本章只讲深 1.75C，其他的列个表，overlay 名给你备着：

板子	屏幕	overlay 专属文件	快捷命令
S3 2.16 寸	2.16 寸 480×480 方屏 AMOLED	muse-waveshare-s3-216	`tools/muse/board.sh build s3-216`
C6 1.8 寸	1.8 寸 368×448 AMOLED	muse-waveshare-c6-18	by hand
C6 2.06 寸	2.06 寸 410×502 AMOLED	muse-waveshare-c6-206	`tools/muse/board.sh build c6-206`

（2026-10-15 读取官方 README Build 表格实测）

规律很明显：overlay 文件名就是板子名的缩写。以后出新板子，先去 README 的 Build 表格查这一行，比瞎猜靠谱。

硬件准备

本章涉及的硬件：Waveshare ESP32-S3-Touch-AMOLED-1.75C（或 1.75）一块，USB 数据线一根（第 3 章讲过，要数据线不要充电线）。

购买链接：（待补——联盟账号未下来，位置先留着，不放编造链接）

事实核实声明

1.75C（32MB flash / 8MB PSRAM）与 1.75（16MB / 8MB）同为 1.75 寸 466×466 圆屏 AMOLED 触屏，唯一区别是 flash 大小：2026-10-15 实测，来源 esp32/devices/README.md 第 43、45 行表格。
圆屏驱动芯片 CO5300：2026-10-15 实测，来源 README 第 202 行（”same CO5300 round AMOLED as the Waveshare S3 1.75C”）。
两块板子 Build 列为 by hand，overlays 为 sdkconfig.muse + muse-waveshare-s3-175c / muse-waveshare-s3-175，target esp32s3：2026-10-15 实测，来源 README Build 表格。
overlay 叠加顺序（sdkconfig.defaults → muse → 板子专属）：2026-10-15 实测，来源 README Build 节”load sdkconfig.defaults first and then the board’s overlays, in order”。
by hand 编译命令模板：2026-10-15 实测，转述自 README Build 节 AIPI Lite 示例，板子名替换为 1.75C。
刷机前备份原厂固件的建议与 read-flash 命令：2026-10-15 实测，转述自 README Core2 / JC3248W535 等板子段落。
带屏板子为完整 UI（full UI / avatar UI），配对流程与无屏板一致：2026-10-15 实测，来源 README 各板子 port 说明。
2.16 / C6 1.8 / C6 2.06 的屏幕参数与 overlay 文件名：2026-10-15 实测，来源 README Build 表格第 43-51 行。
仓库状态（star 2170、最后推送 2026-10-14、open issue 97、支持板子 30 款）：2026-10-15 调 GitHub API 实测。
两块板子的具体售价：未写，待验证，不编造。
Muse 是否需要付费订阅才能完整使用 Gadgets：未确认，待验证，本章不写死。

《Muse Gadgets 实战》第 8 章：AMOLED 圆屏刷机

《Muse Gadgets 实战》第 8 章：AMOLED 圆屏刷机

主角：Waveshare 1.75 寸圆屏两兄弟

1.75 和 1.75C 买哪个？

overlay 到底是个啥

编译命令，一行一行看

先备份原厂固件，再刷机

刷完长什么样

屏幕不亮是刷坏了吗？

同系列其他 AMOLED 板子速览

硬件准备

事实核实声明

相关章节