This repo is for split hoverboard with MM32SPIN0X/2X MCU

You can help us by testing this code on actual hardware

Pre-compiled binary is available

Installation

Check here for step by step toturial on how to install this firmware on your board

Control methods

you must use a ESP32 to control the hacked hoverboard

you can find example control methods in this repo

https://github.com/reed-dan/hoverboard_hack_esp32_manualspeed

Working features

The firmware is already 90% functional, basic motor control should all work, but more testing is needed

https://youtu.be/hCaIlEKzI3A
* compatiable with 99.9% of boards without recompile
* working method to unlock and flash the mcu
* motor and hall sensor commutation
* RemoteUartBus protocol(used by gen2.x gd32)
* PID loop for constant speed
* self hold
* voltage and total current
* software and hardware over current protection

auto detect

1. first flash the pinfinder firmware
2. do not run the firmware after flash, power the board from constant current supply, press power button and release it in 1 second
3. all led and buzzer should light up continuely, wait for about 5 second the board will turn off automaticly
4. press power button again, all led should go into fast blinking mode, now use a wire to short circuit the tx and rx pin you want to use
5. led will turn off and you can connect a usb to serial adapter with 19200 baud to it to acess pinfinder cli
6. use autodetect for pins it can detect, and use command line to edit other parameters, there is full guide of how to use auto detect in the serial terminal to guide you through all steps
7. save the configurations permanantly to eeprom
8. flash the normal firmware, make sure to choose erase pages and not erase full chip so the configuration remains
9. now the board should use your configuration file, if all the leds are blinking together it cannot parse the config file you have done something wrong
10. if auto detect fail to detect your layout please use command line to added it manually

todo

• optimizations
• constant torque
• phase current
• foc

Hardware

any board equippted with MM32SPIN0X or MM32SPIN2X microcontroller should be supported

now with the pinfinder firmware, any board type is supported, but below are some example

Layout 1

Layout 2

Layout 3

support

join this server to get support

https://discord.gg/dvrKS9uyV7

Contributions

if you had any feature request or bug report please create issue or use the discussions feature, because im working on this project actively now dont use pr unless you asked me first because it will get desynced and cannot merge