Alternative dashboard display for Zydtech based electric scooters using BLE
The example code provided and shown in the picture is running on an ESP32 development module and a SH1106 compatible OLED display, though adaptation to other means of displaying is very easy. Almost all ESP32 modules should work as long as they have working BLE.
This repository is largely abandoned because my scooter got stolen and I have lost interest in developing this further.
Wanting to have a more permanent dashboard with more usable information while also collecting more detailed battery data and not sacrificing my phone, I went and decoded the data protocol of my ePowerFun ePF-1 which uses a Zydtech HW9027 or similar motor driver. The display has a built-in bluetooth module for communicating with an app supplied by the vendor. Decoding most of the Bluetooth telemetry and commands for the Display/Driver combo has been very straightforward, although there is more to discover in the Update mode.
So far, the interesting bits like current speed, voltage, total distance etc. can be read by using a BLE app and a bit of decoding.
To read up on my findings, go to BLE_Telemetry.md.
The display data bus is discussed in-depth in Display_Telemetry_Analyzing.md
More on the individual registers can be seen in decoding_memory.md
The scooter's data protocols, which are primarily based on MODBUS, are explained in commands.md
An example app is provided with ePF1_gatt.py. Find out your scooter's BLE MAC and characteristic UUIDs and look for the first byte in the telemetry packets. It typically starts with AF, AB or A5. The app will connect to your scooter and try to read and interpret the data received on the bluetooth interface.
All further development is continued in ePF1_gatt_gui.py which is an extended and GUIfied version of the core code. You will need to install pysimplegui and libscrc to run it.