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

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.

images/PCB2.jpg

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) and the app will be able to receive various parametrs 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. This means that the current setup uses the OEM LCDs (VLCD5, VLCD6, HX18). I own the VLCD5 and this is the LCD i tested. 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)

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

Note

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