Skip to content
mspider65 edited this page Nov 19, 2021 · 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 motor.

The project provides:

  • A new optimized TSDZ2 controller firmware
  • A small PCB board connected between the Motor Controller Board and the Display.
  • An Android application used to interact with the TSDZ2 Controller Firmware through the Bluetooth interface

Controller Firmware

My TSDZ2 Controller firmware was developed starting from the TSDZ Open source Firmware version 0.20.0-beta1 (the last Firmware released for the LCD3 display).

Compared to the initial firmware, I have added numerous changes that have significantly improved the responsiveness and efficiency of the motor.

  • The code has been speed optimized in many places and now the main loop that reacts to external inputs, runs four times faster (40 times per second instead of 10)

  • I added the possibility to enable the "Field Weakening" which allows the motor to provide assistance up to almost 120rpm.

  • The part that deals with the motor control has been completely redesigned and now the motor run quieter and cooler. See Optimized TSDZ2 Firmware for the details.

  • And many others small things....

Most of these improvements were then also imported by mbrusa in its TSDZ2 Firmaware version (https://endless-sphere.com/forums/viewtopic.php?f=30&t=110682)

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 and 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 Display. It receives the messages sent from the controller, translates the messages to the OEM protocol and then send the messages to the OEM Display.

Actually the PCB is compatible with all Displays that use the OEM protocol (VLCD5, VLCD6 and XH18).

In the future it will be possible to add support for different Dislplays (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.