一个现实世界中的Minecraft罗盘

Bilibili
项目主页
源码

声明

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

编译说明

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

Fimware/assets文件夹内附带了一个extract_pixels.py脚本, 会检测Fimware/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访问后台;
• 开机后显示彩虹图案时按住按钮会进入罗盘校准模式, 请举着罗盘飞来飞去, 尽可能多的让罗盘在各个方向旋转.
• 在室外开阔环境下才能够有GPS信号, 没有GPS信号指针会乱转的.
• 在有GPS信号的情况下, 长按按钮可以设置当前地点为新的出生点.

API

path	类型	描述	参数
/ip	GET	获取当前设备IP	无
/setIndex	POST	调试用, 直接显示第N帧	index: Int
/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 内六角

模型

MakerWorld

说在最后

项目制作不易, 并非一次就会成功, 你所看到的成果都是在投入时间金钱得到的.
如果可以的话请给我的github项目star, Makerworld点赞收藏, B站关注和视频一键三连.
您的支持就是我最大的鼓励.

更新记录

2024.11.27:锂电池充电芯片原理图选用有误,现在已更正为MCP73831T-2ATI/OT SOT-23-5

参考资料

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