一个现实世界中的Minecraft罗盘

Front	Bottom

声明

• Minecraft游戏素材版权均归微软所有, 所以本项目不提供游戏中罗盘的图片素材
  • 面板文件仅提供外形, 像素块已绘制好
  • 罗盘取模原始图片恕不提供
  • PCB背面丝印的标准银河字母字体版权不明确. 如果有任何借此项目进行商业的行为, 请删除背面标准银河字母

编译说明

不会编译

仓库已添加Github Actions, 可以直接点击Actions找到最近一次的"Build Firmware Workflow"构建成功的记录,

点击后的页面下方有个类似于"mcompass-639b762"的文件, 下载后解压文件得到mcompass.bin文件使用Flash Download Tool选择ESP32C3->USB下载固件.

固件已将bootload.bin, partitions.bin, firmware.bin, littlefs.bin合并, 直接烧录到地址0x0即可, 其余参数保持默认, SPI SPEED:40Mhz;SPI MODE:DIO

手动编译

固件使用PlatformIO平台Arduino框架编写, 已将依赖库迁移至本地lib文件夹下. PlatformIO的安装方式请自行搜索;

Firmware/assets文件夹内附带了一个extract_pixels.py脚本, 会检测Firmware/assets文件夹内compass{id}.bmp的10x5图像, 根据LED灯珠排布取模,生成对应的头文件.

服务端程序使用next.js. 安装好node.js后,进入Server文件夹执行npm i安装依赖.

执行npm run build拷贝生成的Server/out文件夹内容到Firmware/data文件夹下,使用PlatformIO自带的Build Filesystem Image和Upload Filesystem Image指令上传服务器文件到设备.

功能说明

• 首次插上电脑启动会创建一个The Lost Compass的热点, 连接后打开浏览器输入esp32.local, 输入WiFi和密码进行配网,配网完成后装置会重启;
• 当罗盘插上电脑后开机, 此时会启动后台服务, 使用esp32.local访问后台;
• 开机后显示白色指针时按住按钮会进入校准模式(校准时候会观察到指针持续10秒卡住), 请举着罗盘飞来飞去, 尽可能多的让罗盘在各个方向旋转.
• 在室外开阔环境下才能够有GPS信号, 没有GPS信号指针会乱转的.
• 在有GPS信号的情况下, 长按按钮可以设置当前地点为新的出生点.

API

path	类型	描述	参数
/ip	GET	获取当前设备IP	无
/restart	HTTP_POST	重启	无
/setIndex	POST	调试用, 直接显示第N帧, 指针颜色color	index: Int, color: String, eg: #ff5252
/info	GET	获取设备基本信息	无
/wifi	GET	获取设备保存的WiFi	无
/wifi	GET	获取设备保存的WiFi	无
/spawn	GET	获取当前出生点	无
/spawn	POST	设置当前出生点	latitude:Float,longitude:Float
/setColor	POST	调试用,所有灯珠显示该颜色	color: String, eg: #ff5252
/setAzimuth	POST	设置方位角, Mod用的就是这个接口	azimuth: Float
/setWiFi	POST	设置WiFi	ssid: String, password: String

材料说明

• PCB板厚选择1.0mm, 黑色阻焊, 嘉立创制作;
• 面板立创商城制作, 参数选择1.0mm 半透黑色亚克力强遮光,无需背胶;
• 匀光材料选择PET LGT075J, 无需背胶;
• 电池参数 213455 500MAH
• 滚花螺母 M233.2
• 螺丝 M2*4 内六角
• GPS ATGM336H 5N71模块+天线, 尺寸13.1mmx15.7mm

模型

MakerWorld

PCB工程及面板文件

PCB工程文件和面板

参考资料

使用GPS坐标来计算距离和方位角 by 蓝色的飘漂

更新记录

日期	更新内容
2024年12月07日18点29分	增加基于距离的GPS电源策略, 在足够远的情况下关闭GPS以节约电量
2024年12月16日20点01分	修复目标地点配置读取错误
2024年12月29日21点44分	增加重启接口; 修改网页访问启动策略; 主动检测GPS模块是否存在,调整首次启动后工作模式是指向地点还是指向南方; 接口处理数据时候增加数据合法性校验