MCompass 交互与功能说明

This article is also available in the following language: English.

返回制作指南

按钮交互逻辑

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.local192.168.4.1
  • 高级操作: 你可以在网页端实现 GZIP 压缩管理、更改 WiFi 设置以及实时调试传感器数值。

特殊状态说明

  • 指针乱转:
    • 处于 Nether(下界) 模式(手动长按开启)。
    • 处于出生点/指南针模式,但没有 GPS 信号(请前往室外或开阔地带)。
  • 显示绿色 “x4”: 代表 I2C 通信异常,即地磁传感器 (QMC5883) 无法识别。请检查焊接或芯片是否损坏。

MCompass 交互与功能说明

https://chaosgoo.com/mcompass/manual

作者

Chaos Goo

发布于

2026-02-04

更新于

2026-02-04

许可协议