danielnilsson9 / bbs-fw

Open source firmware for multiple electric bike motor controllers.
GNU General Public License v3.0
191 stars 39 forks source link

BBSHD/BBS02/TSDZ2 Open Source Firmware

GitHub all releases GitHub release (latest by date including pre-releases) GitHub

This firmware is intended to replace the original Bafang firmware on the BBSHD/BBS02 motor controller. Almost all functionality of original firmware has been implemented and additional features have been added.

This firmware is compatible with all displays that works with the original Bafang firmware. A custom configuration tool is provided since BafangConfigTool is not compatible due to a different set of supported parameters.

The firmware is also compatible with the TongSheng TSDZ2 controller but requires a custom made cable in order to interface with Bafang compatible displays.

⚠️ Warning: The firmware should NOT be flashed or configured while the eBike battery is charging!

Download
https://github.com/danielnilsson9/bbshd-fw/releases

Install
https://github.com/danielnilsson9/bbs-fw/wiki/Flash-Firmware-(BBS02-&-BBSHD)

Configure
https://github.com/danielnilsson9/bbshd-fw/wiki/Configuration-Tool

If you find this project useful, consider sending a small donation to fund further development.

Known Issues

Highlights

Config Tool

Supported Hardware

BBSHD

Revision MCU Released Comment
V1.4 STC15W4K56S4 ~2017 V1.3 printed on PCB, sticker with 1.4.
V1.5 IAP15W4K61S4 ~2019 V1.4 printed on PCB, sticker with 1.5.

BBS02B

There are compatibility issues reported, this firmware is suspected to be incompatible with older BBS02 controllers. If you have a newer BBS02B you are probably fine, if you have an older controller it might not be a good idea to flash this firmware.

Revision MCU Released Comment
V1.? STC15F2K60S2 Supported from BBS-FW version 1.1
V1.? IAP15F2K61S2 Supported from BBS-FW version 1.1

BBS02A - No idea, not tested, not recommended to try unless you have an already bricked controller.

TSDZ2

Compatible with TSDZ2A/B using the STM microcontroller (which is nearly all off them).

Displays and Controller

Only displays with the Bafang display protocol can work.

Also the controllers need to be those, that are officially designed by Bafang, respectively Tongshen.

Some shops sell kits with their own controller.

Legal