MCompass 制作全攻略
This article is also available in the following language:
English.
The Real-life Minecraft Compass
欢迎来到 MCompass 的制作指南。在这里你可以找到从物料准备、自动化编译、固件烧录到日常交互的所有技术细节。
快速导航
物料与模型 (BOM & 3D)
查看完整的零件清单、选型建议与 3D 打印模型。
烧录与编译 (Flash)
从 GitHub 下载现存固件或使用 PlatformIO 手动编译。
交互使用说明 (Manual)
学习如何操作按钮切换模式、校准传感器及进入后台。
重要声明 (Copyright & Safety)
在使用或制作 MCompass 之前，请务必阅读以下声明：
- 素材声明：Minecraft 游戏相关视觉素材版权均归 Microsoft / Mojang 所有。本项目仅提供基于点阵分布的开源设计，不分发任何游戏原始资源。
- 商业使用限制：
- 严禁 用于任何商业盈利行为。
- PCB 背面使用的标准银河字母（Standard Galactic Alphabet）字体版权不明确，如需商业化请务必自行删除相关丝印。
- 制作建议：本装置涉及锂电池充电与小型电子元件焊接，请在具备基本电子制作常识的情况下进行。
常见问题汇总 (Q&A)
Q: GPS 定位需要多久？
A: 模块首次定位（冷启动）在开阔地带通常需要 30秒以上。
Q: 启动后屏幕显示绿色 "x4" 是什么意思？
A: 这代表了 I2C 通信失败，通常是 QMC5883 传感器或排母焊接虚焊导致的。
Q: 支持双头 Type-C 线线充电吗？
A: 需要在 PCB 上焊接对应的 CC1/CC2 下拉电阻方可识别 C-to-C 线缆。
更新日志 (Changelog)
2025.09.17
- 指针过冲效果：完美复刻游戏中的跳动感，转动过快时指针会产生物理惯性。
- 启动容错优化：多次检测地磁传感器，提高启动稳定性。
2024.12.07
- 智能电源策略：根据距离动态开关 GPS 以延长续航。
MCompass 制作全攻略
