Skip to content
mspider65 edited this page May 18, 2020 · 54 revisions

Home

Board Firmware Flash

Board Installation

TSDZ Controller Flash

Android Application

Optional Temperature sensor

How to get the Board

About the TSDZ-ESP32 project

This project adds Bluetooth LE capabilities to the the TSDZ2 e-bike engine.

The project provides:

  • A new TSDZ2 controller firmware based on the TSDZ Open source Firmware
  • A small PCB board connected between the Engine Controller Board and the Display.
  • An Android application used to interact with the TSDZ2 Engine Firmware through the Bluetooth interface

Controller Firmware

Actually the TSDZ2 Controller firmware is based on the TSDZ Open Source Firmware version 0.20.0-beta1 (the last Firmware released for the LCD3 display) to which I added some small changes and improvements. I have also in plan to support in future the last Open Source Firmware developed for the 860c and SW102 displays.

Add on Board

The board is a small PCB (24x42mm) based on the ESP32 microcontroller. The board is small enough to be inserted inside the motor just over the controller board.

The board exposes the Bluetooth interface used by the Android application but exposes also the BT 4.0 Cycling Power Profile. In this way you could also use third party app (like Oruxmaps) to collect live riding data like speed, cadence, istantaneous Power, accumulated energy etc.

The PCB board operates as "man in the middle" between motor controller and LCD. It receives the messages sent from the controller, translates the messages to the OEM LCD protocol and then send the messages to the OEM LCD.

I currently use the VLCD5 display but i'm confident that also VLCD6 and XH18 works since they uses the same protocol.

In the future it will be possible to add support for different LCDs (as long as the protocol is known)

You could easly order the board yourself, it is easy and you will receive the board already assembled and ready to use. Look the How to get the Board wiki page.

Android Application

The Android application offers the following functionalities:
  • Two Dashboard showing all the current riding values like (Battery volt, battery current, speed, cadence, motor temperature, etc..)
  • Configuration of all the TSDZ2 Controller firmware parameters
  • OTA (Over The Air) ESP32 board Firmware update
  • OTA TSDZ2 Controller Firmware update
  • History log of all riding values (1 week of data retention)
  • Graphical visualization of the log data

Download

The last version of Android apk, ESP32 firmware, TSDZ controller firmware could be downloaded from the Wiki bin directory.

Note

The project requires some small hardware modifications that require a minimum of soldering skill.