01GNSS
定位与航向
解析多星座 GNSS 数据，呈现坐标、海拔、速度、航向、定位质量与卫星状态。
FREE & OPEN SOURCE · ESP32-S3
一块圆屏，
读懂你的车与路。
TrailSpud 是为开源硬件爱好者、改装玩家与长途驾驶者打造的车载电脑 / HUD。把定位、车辆、姿态、环境与轨迹数据，收进一块 2.1 英寸圆形触摸屏。
480 × 480圆形 RGB10+1设备状态9核心页面
ENCLOSUREUPDATED LAYOUT
ASSEMBLYMODULAR / SERVICEABLE
OPEN ROADS.
OPEN CODE.BUILT BY OLDPOTATOES.
PRODUCT / 01
圆屏，是它的界面，
也是它的外形。
方圆一体主壳围绕 75 mm 级圆形屏幕与主板展开，顶部设置独立 GNSS / 磁力计舱，背部集成转接屏蔽板、BME280 独立风道与方向球头吸盘支架。参考方案面向可拆卸、可维护与继续改装。
这些图用于表达当前外观与装配方向；最终开孔、间隙、材料与尺寸以工程模型和实物验证为准。
INTERFACE / 02
为 480 × 480
圆屏而生。
左右滑动浏览真实设备页面
CAPABILITIES / 03
不是另一块仪表。
是开放的车辆平台。
TrailSpud 把实时驾驶、户外定位、车辆诊断和设备维护放在同一套本地系统里。数据留在设备上；Wi-Fi 只在需要维护时开启。
02OBD-II
读懂车辆状态
通过 BLE 连接 vLinker BM+，读取车速、转速、水温、电压、负荷与通用故障码。
03IMU
越野姿态
实时显示 Pitch 与 Roll，支持安装误差归零，并用颜色分级提示倾角风险。
04GPX
记录每一段路
用 SmartBeaconing 记录 GPX 轨迹，在圆屏上重建路线，并保存可分析的车辆数据。
05SENSE
环境与设备诊断
监测温度、湿度、气压、电池和 11 项硬件/服务状态，异常不再藏在日志里。
06WEB
按需开启维护热点
需要时才开启 Wi-Fi，通过手机查看状态、调整设置、管理轨迹并执行 OTA 更新。
HARDWARE / 04
从外壳到固件，
都留有继续创造的余地。
当前硬件基于微雪 ESP32-S3-Touch-LCD-2.1。外壳采用方圆一体主壳、独立传感器舱、内部转接屏蔽板与可替换安装支架；固件基于 ESP-IDF 5.5.3 和 LVGL，功能模块在独立任务中运行。
Open roads. Open code. 免费开源发布，欢迎阅读、验证、改装和贡献。
- 01主控
- ESP32-S3
- 02显示
- 2.1 英寸圆形 RGB 触摸屏
- 03分辨率
- 480 × 480
- 04外壳
- 方圆一体主壳 · 独立顶部传感器舱
- 05安装
- 转接屏蔽板 · 方向球头吸盘支架
- 06图形
- LVGL 8.3 · 双帧缓冲
- 07定位
- LC76G 多星座 GNSS
- 08车辆数据
- BLE OBD-II · vLinker BM+
- 09姿态
- QMI8658 六轴 IMU
- 10环境
- BME280 温湿度与气压
- 11存储
- microSD · GPX / CSV / 日志
- 12维护
- 按需 Wi-Fi Web 控制台
QUICK START / 05
从硬件到上路，
三步开始。
以下是面向当前硬件版本的快速文档。首次刷写与旧分区升级请优先使用 USB 完整烧录。
PREPARE
准备硬件
- 微雪 ESP32-S3-Touch-LCD-2.1
- microSD 卡（FAT32）
- LC76G GNSS 与 BME280
- 可选 vLinker BM+ BLE OBD 适配器
FLASH
编译与烧录
安装并激活 ESP-IDF 5.5.3，然后通过 USB 完整写入。
idf.py build
idf.py -p PORT flash monitorDRIVE
首次启动
- 把 GNSS 天线朝向天空，在室外等待首次定位。
- 车辆停在水平地面，进入姿态页执行 ZERO ANGLES。
- 需要设置时，长按开启维护热点并访问 192.168.4.1。
01 如何通过 Web 更新固件？ +
开启设备维护热点并连接手机，访问 192.168.4.1。已经使用 0.0.21 或更高版本完整分区表的设备，可以上传应用固件进行 OTA；轨迹记录期间会拒绝升级。
02 为什么 GPS 有时间却没有坐标？ +
室内收到 NMEA 或 UTC 时间并不代表已经定位。请把天线放到室外开阔位置，保持静止，等待首次定位完成。
03 OBD 一直没有连接怎么办？ +
确认使用支持 BLE 的 vLinker BM+，车辆已点火，并断开手机上正在占用适配器的其他 OBD 应用。
04 旧版本可以直接 OTA 吗？ +
从旧 3 MB OTA 分区升级时不能只写应用 bin。必须先通过 USB 完整烧录当前 bootloader、分区表、OTA 初始数据和应用，之后才能继续使用 Web OTA。
FIRMWARE / 06
把 TrailSpud
装进你的圆屏。
当前提供已构建的稳定固件 v0.0.27；仓库源码版本为 v0.0.28。下载文件适用于已经完成新分区完整刷写的设备 OTA 更新。
重要：从旧 3 MB OTA 分区升级时，必须先通过 USB 完整烧录，不能直接上传此应用固件。