Android application - TSDZ2-ESP32/TSDZ2-ESP32-Wiki GitHub Wiki
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.
-
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
- 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.
- 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.
-
The upper right dots opens the Main Option Menu
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.
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. |
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. |
With this screen it is possible to setup.
|
Select this option menu item to display the versions of the ESP32 and TSDZ2 Firmware |
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.
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.
A Swipe Up from the main dashboard bring to the Graph View. From the Graph View press Back to return to the Dashboard