《Muse Gadgets 实战》第 7 章：手机配对实战
第 6 章刷机成功后，板子的灯开始呼吸橙色——这就是 Muse Gadgets 告诉你"我准备好了"的方式。本章讲 Muse Gadgets 手机配对实战：Muse App 添加设备、蓝牙配对、Wi-Fi 下发，一步一步走完。
配对前先对一下清单
动手前核对这 5 项，缺一项都可能配不上。
- 固件刷好了：第 6 章走完，板子通电后灯呈呼吸橙色。这是"ready for setup"的信号。
- Token 填了：第 5 章领的 SDK Token，已经在第 6 章编译时塞进固件。没 Token 配不成。
- Muse App 装了：iOS 或 Android 手机上装好。
- Wi-Fi 密码在手边：配对时 App 会让你选 Wi-Fi 并输密码，板子通过它连网。
- 开发者模式开了：最容易漏的一步，下面细讲。
（2026-10-14 读取官方 esp32/README.md"### 4. Set it up with Muse"实测）
Muse App 开发者模式在哪开
配对入口不在显眼处。打开 Muse App，进 Settings > Devices，先把 Developer mode 开关打开，再点 Add Device（页面右上角 + 号）。
顺序别反：不开开发者模式，添加设备时看不到社区板子。
然后在搜索列表里找 `MuseGadget-XXXXXX`——前缀固定叫 MuseGadget，后面是随机后缀。点它，App 开始走配对流程。
蓝灯呼吸时按一下 BOOT 键
这是配对的核心动作，就一步：
App 发起配对后，板子灯变呼吸蓝色。这时候按一下板子上的 BOOT 键，证明是你本人在操作。松手，灯变绿色，配对成功，Muse 连上了。
多说一句：每次配对都会建立一个全新的加密会话。旧会话作废，不留尾巴。
七种灯语对照表
配对全程盯着灯，颜色就是状态机：
| 灯色 | 含义 |
|---|---|
| 橙色呼吸 | 准备就绪，可以开始配对 |
| 蓝色呼吸 | 等你按 BOOT 键确认 |
| 蓝色常亮 | 正在连 Wi-Fi、连 Muse，耐心等 |
| 绿色 | 连上了，配对成功 |
| 黄色闪烁 | 重连中，Wi-Fi 可能断了 |
| 紫色 | 没配上 |
| 红色闪烁 | 出错了，接 USB 看串口日志 |
（2026-10-14 读取官方 esp32/README.md 原文表格实测）
App 找不到设备怎么办？
先看灯。灯是橙色呼吸、手机蓝牙开了、App 开发者模式也开了，还是搜不到，大概率撞上已知坑：
iPhone 有案例卡在配对循环：App 连上设备、走完 MTU 协商就没下文了（Issue #50），或者卡在 get_device_info 反复打转（Issue #101），还有 App 直接搜不到、但 nRF Connect 能搜到的（Issue #99）。这些 issue 目前都是 open 状态——去 GitHub issue 区搜最新回复，看看有没有人已经趟出路子。
通用排查三板斧：板子断电重上（回到橙色呼吸）、App 彻底杀掉重进、手机蓝牙开关拨一次。
华为手机能配对吗？
目前不行，这是个硬坑。华为 EMUI 的蓝牙栈有 bug，GATT 写入到不了固件，配对走不完（Issue #137，open 状态）。
华为用户别反复折腾：先换一台别的品牌手机配，配完板子照常用。等官方或社区有人修了这个 bug 再说。
你在的国家 App 没上架怎么办？
这是另一个硬门槛。土耳其、巴西的用户报告过：当地应用商店没有 Muse App（Issue #157、#190）。没有 App 就加不了设备，社区板子目前没有别的配对入口。
人在国内不用担心这个，正常上架。但如果你在海外，先确认商店里能下到 Muse App 再买板子。
换 Wi-Fi 要重刷吗？
不用重刷。长按板子按键 5 秒，设备清空配对信息，回到橙色呼吸状态，重新走一遍 App 配对、下发新 Wi-Fi 就行。
顺带说清两个概念：第 6 章讲过，普通重刷固件保留配对和 Wi-Fi 设置；只有 `erase-flash` 全片擦除才清空一切——那之后 Token 也要重新填。
（2026-10-14 读取官方 esp32/README.md"### 4. Set it up with Muse"实测）
安全提醒：配对要在信任的网络下做
官方把话说得很直白：配对要求物理按键确认，但社区设备没有厂商签名验证，防不住中间人攻击。
翻译成人话：别在咖啡馆、机场这种公共 Wi-Fi 下做首次配对。回家连自己家 Wi-Fi 再弄。配完之后正常用，风险主要在首次配对那几分钟。
（2026-10-14 读取官方 esp32/README.md 安全段落实测）
本章不涉及硬件购买
配对是纯操作章节，没有要买的东西。联盟链接位置本章留空——第 8 章带屏板子（Waveshare 1.75 寸 AMOLED 圆屏）会讲具体购买。
事实核实声明
- 配对入口（Settings > Devices > Developer mode > Add Device 右上角 + 号）、设备名前缀 MuseGadget、蓝灯呼吸按 BOOT 确认、绿灯=已连接：2026-10-14 实测，来源 esp32/README.md"### 4. Set it up with Muse"。
- 七种灯语对照表：2026-10-14 实测，来源同上原文表格。
- 长按 5 秒重置重配：2026-10-14 实测，来源同上"To reset the device and set it up again, hold the button for 5 seconds"。
- 每次配对新建加密会话、无厂商验证、防不了中间人、要在信任网络下操作：2026-10-14 实测，来源同上安全段落。
- 重刷保留配对和 Wi-Fi、erase-flash 彻底清空：2026-10-14 实测，来源 esp32/README.md"### 3. Flash"。
- 每个设备配对前都要有 SDK Token：2026-10-14 实测，来源主 README。
- 华为 EMUI 蓝牙配对失败（GATT 写入到不了固件）：Issue #137，open 状态，现象描述来自 issue 标题，待验证。
- 土耳其/巴西 Muse App 未上架导致无法配对：Issue #157/#190，open 状态，待验证。
- iPhone 配对卡 get_device_info 循环 / App 搜不到设备：Issue #99/#101/#50，open 状态，待验证。
- Muse 是否需要付费订阅才能完整使用 Gadgets：未确认，待验证，本章不写死。
相关章节
- 上一章：《Muse Gadgets 实战》第 6 章：第一次编译和刷机（https://jinbufenzi.com/13292.html）
- 下一章：《Muse Gadgets 实战》第 8 章：带屏板子进阶：AMOLED 刷机（待发布）
