按钮交互逻辑
MCompass 的所有操作通过机身侧边的单按键完成。
| 操作次数 | 功能描述 | 备注 |
|---|---|---|
| 单击 1 次 | 切换模式 | 在“出生点模式”与“指南针模式”间切换 |
| 连按 4 次 | 查询状态 | 网页模式下会显示当前设备的 IP 地址 |
| 连按 6 次 | 地磁校准 | 倒计时结束后，需拿稳罗盘在空中平稳画“8”字旋转 |
| 连按 8 次 | 出厂设置 | 清除所有保存的配置并重启，恢复初始状态 |
| 长按 3秒 | 背景功能 | 出生点模式：将当前位置设为新的出生点 (需 GPS 信号) 指南针模式：切换到 Nether(下界) 模式，指针将无序乱转 |
注：地磁校准对指针准确度至关重要，如发现指针指向偏差过大，请务必执行校准。
后台配置模式
1. 蓝牙后台 (WeChat Mini Program)
启动后 1 分钟内，你可以通过微信小程序 “罗盘控制台” 搜索并连接。
- 功能: 自定义指针颜色、校准传感器、通过地图选择/搜索目标经纬度。
- 注意: 请确保已开启手机蓝牙和定位权限。
2. 网页后台 (Web Dashboard)
如果未连接蓝牙，设备会尝试连接已有的 WiFi；如果没有 WiFi 配置，则会开启名为 The Lost Compass 的 AP 热点。
- 进入方式: 连接热点后，浏览器访问
esp32.local或192.168.4.1。 - 高级操作: 你可以在网页端实现 GZIP 压缩管理、更改 WiFi 设置以及实时调试传感器数值。
特殊状态说明
- 指针乱转:
- 处于 Nether(下界) 模式（手动长按开启）。
- 处于出生点/指南针模式，但没有 GPS 信号（请前往室外或开阔地带）。
- 显示绿色 “x4”: 代表 I2C 通信异常，即地磁传感器 (QMC5883) 无法识别。请检查焊接或芯片是否损坏。