Android application

Index

Main dashboards

Swipe left/right to change view

Controller/Display communication Status

If there are problems in the communication between the ESP32 board and the TSDZ2 Controller or Display, a warning appears in the upper bar.

Clicking on it opens a pop-up indicating whether the communication problem concerns the Display or the Controller or both.

Connection Service

You could start/stop the connection service using the floating circular button in the bottom right corner.
Top left icon with the bluetooth logo shows the status of the backgroung connection service.
- : service is running and is connected to the ESP32 board
- : service is running and is trying to connect to the ESP32 Board
- : service is stopped
When the service is running the Notificaton bar will also show a notification (the small cyclist). The service could be stopped also opening the notification and clicking on the "Disconnect" button

Riding mode and level

The first icon and number in the bottom status bar shows the actual riding mode and level
- : Engine Off
- : Power Mode
- : Cadence Mode
- : Torque Mode
- : E-Mtb Mode
- : Walk Mode
- : Cruise Mode

The default riding mode at power-on is selected on the LCD selecting the Wheel diameter.

27" select Torque Mode
28" select Cadence Mode
29" select eMtb Mode
All other values for Power Mode

In any case the speed displayed on the LCD is correct because the ESP32 uses the Wheel diameter selected in the Android Application and adjust the data sent to the LCD according to the wheel diameter selected on the LCD.

It is possible override the default riding mode from the Android App. Long press the riding mode icon and then select the riding mode from the popup menu. This is a temporary selection, when the system is switched-on the LCD selected dafault value is restored.

Bottom Status Bar

The bottom status bar could also shows the following icons
- : System Error, a click over the icon will show the error details
- : Brakes engaged
- : Street mode enabled

Street mode is selected on the LCD with the enable/disable 25Km/h setup option.

It is possible override the LCD selected value from the Android App. Long press the street mode icon and then select the mode from the popup menu. This is a temporary selection, when the system is switched-on the LCD selected dafault value is restored.

Option Menu

The upper right dots opens the Main Option Menu

Bluetooth Setup

	At the first use of the app it is necessary select the Bluetooth device to connect to. Press the 'SCAN' button to start the discovery of nearby Bluetooth devices then select the TSDZ2_ESP32 device and press 'OK' to confirm the selection and start the pairing process. Then you will be asked to enter a PIN. The default PIN is 123456 When the pairing is done, you could exit from this screen and start the connection service. *Note*: is possible to change the pin when you flash a new ESP32 Firmware image.

Bike Configuration

	This is the main configuration screen to access to all the Controller parameters. Read 0.20.0-beta1 Configuration Parameters to have a complete description of the various parameters. The dafault configured values are for a 36V motor with a 36V battery. Change the "System" and "Battery" setup according to your configuration For the temperature control, compared to version 0.20.0-beta1, if you have the DS18B20 Temperature sensor connected to the ESP32 board, you could select the value "ESP32". In this case the Controller Throttle ADC input is not used. The "Hall calibration" item allows you to calibrate the firmware parameters for your motor to compensate for imperfections related to the hall sensors (positioning, sensitivity). It is not mandatory but it is advisable to run it at least once. (youtube video) The "Motor Tuning" item allows to change manually some motor firmware parameters (Hall counter offset, rotor offset). It is used for testing purposes only. Don't change the values unless you know well what you're doing.

ESP32 Configuration

	With this screen it is possible to setup. The data update frequency The DS18B20 motor temperature probe pin nr. (leave the default value "4") The message debug level (if a serial interface is connected to the board).

Firmware -> Show Firmware Versions

	Select this option menu item to display the versions of the ESP32 and TSDZ2 Firmware

Firmware -> Bike Firmware Update

This screen allows you to update the controller firmware.

The "SELECT FILE" button allows to select the HEX image to flash.

Once the HEX file is selected and verified, the "START UPDATE"button is enabled.

Once the "START UPDATE" is pressed, the update procedure start and the bottom part of the screen shows a progress indicator.

At the end of the update proedure a popup message shows the operation result.

Firmware -> ESP32 Firmware Update

This screen allows you to update the ESP32 PCB firmware.

The "SELECT FILE" button allows to select the BIN image to flash.

Once the BIN file is selected and verified it is possible to change the default Bluetooth Pairing PIN embedded into the Firmware BIN image. If the pin is forgotten there is no way to connect to the PCB and it will be necessary to flash a new image using the Hardware interface.

Once the "START UPDATE" is pressed, the update procedure start and the bottom part of the screen shows a progress indicator.

At the end of the update proedure a popup message shows the operation result.