Hoverboard Sideboard Hack for GD32 项目教程

1. 项目介绍

项目概述

hoverboard-sideboard-hack-GD 是一个开源项目，旨在为GD32芯片的Hoverboard侧板实现固件。Hoverboard通常配备两个相同的侧板，这些侧板可以通过此固件进行编程。项目支持多种变体，包括调试模式、Hovercar模式和Hoverboard模式。

硬件支持

侧板硬件支持一个4针电缆，连接到Hoverboard主板的GND、12/15V和USART。此外，侧板还支持连接LED板和光电开关，用于检测用户是否站在Hoverboard上。侧板的核心是GD32F130C6T6芯片，集成了MPU-6050 IMU传感器，用于检测板子的方向。

2. 项目快速启动

环境准备

• 安装PlatformIO IDE（推荐）或Keil uVision。
• 准备ST-Link V2编程器。

代码示例

以下是使用PlatformIO IDE进行编译和上传的步骤：

# 克隆项目
git clone https://github.com/EFeru/hoverboard-sideboard-hack-GD.git

# 进入项目目录
cd hoverboard-sideboard-hack-GD

# 使用PlatformIO编译
pio run

# 使用PlatformIO上传
pio run -t upload

解锁MCU

如果MCU是第一次被编程，可能需要解锁。请参考项目的Wiki页面：How to Unlock MCU flash。

3. 应用案例和最佳实践

应用案例

• Hovercar模式：通过连接iBUS协议的RC接收器，可以将Hoverboard侧板用于Hovercar构建。
• Hoverboard模式：侧板与Hoverboard主板的FOC固件通信，实现Hoverboard的功能。

最佳实践

• 调试模式：通过串行监视器发送命令，观察和检查侧板的功能。
• 自定义固件：根据项目需求，自定义固件以满足特定的应用场景。

4. 典型生态项目

相关项目

• hoverboard-sideboard-hack-STM：针对STM32芯片的Hoverboard侧板固件。
• MPU-6050：IMU传感器项目，提供详细的传感器数据和功能。

社区支持

• PlatformIO：支持GD32F130C6T6芯片的开发环境，提供丰富的插件和工具。
• GitHub Actions：自动化构建和测试，确保固件的稳定性和可靠性。

通过以上步骤，您可以快速启动并使用hoverboard-sideboard-hack-GD项目，实现Hoverboard侧板的固件编程和应用。