X-TRACK 开源GPS自行车码表安装和配置指南
1. 项目基础介绍和主要的编程语言
项目基础介绍
X-TRACK 是一个开源的GPS自行车码表项目,支持离线地图和轨迹记录功能。它能够显示实时位置、记录和显示实时轨迹,并导出标准GPX格式的轨迹文件。项目采用了全新的“页面生命周期管理”和“消息订阅发布框架”设计。
主要编程语言
该项目主要使用C和C++编程语言进行开发。
2. 项目使用的关键技术和框架
关键技术
- GPS定位:使用ATGM336H模块,支持BDS、GPS、GLONASS、GALILEO、QZSS和SBAS。
- 离线地图:支持显示实时位置和缩放功能。
- 轨迹记录:支持记录轨迹并导出GPX格式的文件。
- RTC时钟:MCU内置RTC时钟,支持自动根据GPS校准。
- 加速度计和地磁计:使用LSM6DSM和LIS3MDL模块,支持硬件计步输出。
框架
- LVGL V8:用于图形用户界面(GUI)的开发。
- 页面生命周期管理:用于管理不同页面的生命周期。
- 消息订阅发布框架:用于模块间的消息传递和通信。
3. 项目安装和配置的准备工作和详细的安装步骤
准备工作
-
硬件准备:
- 主控板:AT32F435CGU7
- 屏幕:ST7789 IPS 1.54英寸,SPI接口,240x240分辨率,60Hz刷新率
- 储存器:Micro SD CARD 32GB
- 输入设备:旋转编码器
- RTC:MCU内置RTC时钟
- 加速度计:LSM6DSM
- 地磁计:LIS3MDL
- GPS:ATGM336H
- 电池:Li-ion 3.7V 683030 700mAh
- 电源管理:LP5907-3.3 + MCP73831
- 外壳:3D打印光固化
-
软件准备:
- 操作系统:Windows/Linux/macOS
- 开发环境:Visual Studio Code(推荐)或任何支持C/C++开发的IDE
- 依赖库:LVGL V8、GPS库、SD卡库等
安装步骤
步骤1:克隆项目仓库
首先,打开终端或命令提示符,使用以下命令克隆项目仓库:
git clone https://github.com/FASTSHIFT/X-TRACK.git
步骤2:安装依赖库
进入项目目录,安装所需的依赖库。具体依赖库可以在项目的README.md
文件中找到。
cd X-TRACK
# 根据README.md文件中的说明安装依赖库
步骤3:配置开发环境
- 打开Visual Studio Code或其他IDE。
- 打开项目目录
X-TRACK
。 - 配置编译器和构建工具,确保能够正确编译C/C++代码。
步骤4:编译项目
在终端中运行以下命令编译项目:
# 根据项目README.md文件中的说明进行编译
make
步骤5:烧录固件
将编译生成的固件烧录到主控板中。具体烧录方法可以参考主控板的官方文档或项目README.md
文件中的说明。
步骤6:连接硬件
按照硬件配置要求,将屏幕、GPS模块、加速度计、地磁计等硬件连接到主控板上。
步骤7:运行和测试
连接电源后,启动设备,观察屏幕显示和GPS定位功能是否正常。可以通过记录轨迹并导出GPX文件来测试轨迹记录功能。
总结
通过以上步骤,您可以成功安装和配置X-TRACK开源GPS自行车码表项目。希望这篇指南能够帮助您顺利完成项目的搭建和测试。