MCompass Interaction & Manual
本文同时提供以下语言的翻译：
中文.
Button Interaction Logic
All operations of MCompass are completed via a single button on the side.
| Actions | Description | Notes |
|---|---|---|
| Single Click | Switch Mode | Toggle between “Spawn Point Mode” and “Compass Mode” |
| Click 4 Times | Check Status | In Web mode, it displays the current IP address |
| Click 6 Times | Compass Calibration | After the countdown, rotate the compass in a steady “8” pattern in the air |
| Click 8 Times | Factory Reset | Clear all saved configurations and restart to the initial state |
| Long Press 3s | Special Actions | Spawn Mode: Set Current Position as new spawn point (GPS req.) Compass Mode: Switch to Nether Mode, where the pointer spins randomly |
Note: Compass calibration is crucial for accuracy. If the pointer deviation is too large, please perform calibration.
Configuration Modes
1. Bluetooth Dashboard (WeChat Mini Program)
Within 1 minute of startup, you can connect via the WeChat Mini Program “罗盘控制台” (Compass Console).
- Features: Customize pointer colors, calibrate sensors, select/search target coordinates via a map.
- Note: Ensure Bluetooth and location permissions are enabled on your phone.
2. Web Dashboard
If Bluetooth is not connected, the device will try to connect to an existing WiFi; if no WiFi is configured, it will open an AP hotspot named The Lost Compass.
- How to Enter: After connecting to the hotspot, visit
esp32.localor192.168.4.1in your browser. - Advanced Actions: You can manage GZIP compression, change WiFi settings, and debug sensor values in real-time.
Special Status Explanations
- Pointer Spinning Randomly:
- In Nether Mode (manually enabled via long press).
- In Spawn/Compass mode, but no GPS signal (please go outdoors or to an open area).
- Green “x4” displayed: Indicates an I2C communication error, meaning the geomagnetic sensor (QMC5883) cannot be recognized. Please check soldering or chip damage.
MCompass Interaction & Manual
