Usage and configuration of firmware version 0.12 - OpenSourceEBike/TSDZ2_wiki GitHub Wiki

The following applies to firmware version 0.12 only!

CAUTION: always use the same firmware version for both the motor controller and LCD!

NOTE: Before start using the firmware, you must configure correctly the options on LCD3. For instance, you should configure your battery low voltage cut off (battery voltage when it is discharged) and all the other parameters -- follow the next section.

KT-LCD3 shows and/or configure the following from TSDZ2 motor:

Table of Contents

1. Main screen

  • Main screen: this is the default screen after turn on the LCD.
    • assist level: Assist level scales/amplify the torque sensor signal, if you want a higher assist level from the motor, choose the max assist level value. Assist level has 5 levels in total and user can define (on firmware configuration) a custom scale value for each level. Level 0 keep always the motor disabled.
    • ebike wheel speed: the value can be shown in kms or mph.
    • battery power: real time value in watts of the power being draw from the battery.
    • battery state of charge: 6 different levels. When battery is empty, the empty symbol on LCD will also blink (state of charge is based on battery voltage and can be setup on the motor controller firmware configuration)
    • lights: enabled with a button up long press, the motor controller will enable the ebike lights. LCD backlight will also be enabled. (backlight intensity can be setup on the motor controller firmware configuration).
    • brake: LCD symbol is enabled when user press the ebike brakes, good to check that sensor brakes are working.
    • walk assist: although it is implemented on LCD, it is not yet implemented on the motor controller. Enabled with a button down long press.
    • odometer field: the following information will cycle with on/off button click
      • battery voltage: see your battery pack voltage.
      • battery current: see the current being draw from your battery pack.
      • battery power: see the accumulated battery power (in watts/hour) draw from your battery pack, since last battery full charge. This value is automatically reset when LCD turns on and battery voltage equals to charged battery voltage - this value can also be reset or set to a custom value on the configurations.
      • pedal cadence: see the pedals cadence in rotations per minute.
    • battery state of charge in percentage: this value can be shown as an option on the temperature field. The percentage is based on the accumulated battery power draw from your battery pack and user can define on LCD configurations menu, the battery pack total watts/hour.
    • offroad mode: if you have enabled the offroad mode (see configuration section below) this can be activated with the ON/OFF and UP button combination and deactivated with the ON/OFF and DOWN button combination. When active, the assist symbol above the assist level will start blinking. Offroad mode is disabled and inactive by default. We do not recommend you to activate offroad mode on public roads. In many countries offroad mode may only be used on private property.

2. Max battery power screen

Motor controller will automatically choose a battery current in a way to limit the max battery power usage. The battery current value will never be higher than the max battery current setup on the configurations screen. Long click on on/off and up buttons to enter on this screen. Up and down buttons to increase/decrease the value. Long click of on/off button lo leave. NOTE: this functionality cannot be used when offroad mode is enabled. Disable offroad mode first.

3. Configurations screen

Long click on up and down buttons to enter on this screen. On/off button click to enter on subscreens and on/off button click to cycle on subscreens, long press on/off to exit menue

0: General Basic setup

submenu number configuration name default value description
0 Maximum wheel speed 50 Put in your speed limit (by law) to run legal on public roads , the motor will fade out from - 0.5 km/h to +2,0 km/h in Europe often 25 km/h
1 Wheel perimeter in mm 2050 first estimate: 26= 2050; 27= 2150; 27.5=2215; 28= 2250; 29=2300
2 Speed Unit 0 km/h 0 is km/h and 1 is miles per hour ( british miles of course)

1: Battery voltage & current setup

submenu number configuration name default value description
0 Maximum current of battery 16?? This is the maximum current your battery can supply, without damage, standard cells can suply 2C, means 2 times the capayity of cell without damage with 1.7C you are quite save
1 battery low cut-off voltage< 39 The controller will reduce power to stay over this limit! usualy 2.85-3.05 V per cell of (39.0 (3.0 * 13 = 39.0)). The standard Samsung cells allow down to 2.75V but you need some savety margine because not all cells are discharging in the same way, but by setting too high you loose range power on a discharged battery and capacity I like 29V for 10 Cells but 30V is saver
2 Number of cells 13 24V ->6/7?; 36v->10; 48V->13 based on the voltage of comon Samsung or Parasonic cells
3 Battery pack resistance 130? TBD

2: Battery power setup

submenu number configuration name default value description
0 Enable / disable show the percentage of battery charge (SOC) in temperature field 0 Enable/disable for the gauge in the temperature field. 0 to disable and 1 to enable.
1 Increment or decrement 0 You can switch if the percentage should go form 0% - 100% or from 100% to 0% - set 0 for the first option and 1 for the other.
2 Voltage to reset Wh counter 54.2 (volts) On power on the LCD, this value is compared to the battery voltage and if is lower, means that battery is fully charged and the Wh counter is reset.
To find the correct value for this field, fully charge your battery and measure the voltage on LCD3, use a slight lower voltage value for this field, example: my 48V battery charges up to 54.6 volts and so I use the value 54.2.
3 Total watt hour 0 Adjust the battery pack power. You can fully charge the battery and then discharge it fully and use the measured value to input here. The value that supplier give you is often to a quite high, you should expect a value of maybe 85% - 90% (I use 350 for my 386 wh battery).
4 Used power (wh) of battery 0 Counted value for used watt hour from the battery. This value is reset automatically when you power on the LCD and the battery is fully charged.

3: Assist level setup

Here you can choose how many assist levels are used (the ones you can choose on LCD3 when clicking up and down buttons). You can also choose the max power value in watts that motor will use to assist you.

submenu number configuration name default value description
0 Number of assist levels 9 Please select the number of assist levels you like to use from min. 1 to max. 9
1 Assist level 1 power 400 Max value of motor energy (in watts) that motor will use to assist you, on this assist level. The motor will use this max value only when you hit the max torque sensor force * max pedal cadence.

Use higher values (more than what motor can give) to get more sensitivity from the torque sensor, like you can setup a value of 2000 that will double the torque sensitivity comparing to use the value of 1000.
2 Assist level X power .... The same a previous but for assist level X.

4: startup power boost

Here you can configure the BOOST feature. This feature gives a peak of power to the motor at startup. The amount of time of the peak as also the amount of motor power during the peak, can be configured. You can also disable this feature if you prefer.

submenu number configuration name default value description
0 Config 0 0 to enable power boost only when startup and bicycle wheel speed is equal to zero; 1 to enable power boost every time pedal cadence or torque sensor are zero
1 limit boost power to max battery power value 0 1 to enable power boost limit to the Max battery power value and 0 to disable.
2 boost time 25 (2.5 seconds) 0 to disable startup power boost feature.
3 fade out/transition time 25 (2.5 seconds) fade out from boost power to regular power.
4 assist level 1 boost power 200 Max value of motor energy (in watts) that motor will use to assist you during power boost, on this assist level. The motor will use this max value only when you hit the max torque sensor force.

Use higher values (more than what motor can give) to get more sensitivity from the torque sensor, like you can setup a value of 2000 that will double the torque sensitivity comparing to use the value of 1000.
5 assist level X boost power --- The same a previous but for assist level X.

5: motor temperature protection

This feature is for protecting your motor from overheating and avoid permanent damage/loss of torque -- see here: TSDZ2 motor demagnetized due to overheating. You can only use and enable this feature if you installed the motor temperature sensor.

How it works

On LCD3 temperature field you will be able to see the motor temperature value. Once the configured minimum motor temperature value is hit, the motor current will start to be reduced and as long as it increases, the more the current will be reduce. After hitting the configured maximum motor temperature value, the motor is shutoff.

The temperature value shown on LCD3 will blink when the motor current is being limited and will blink faster for higher rates of limited current. Finally, if the motor is shutoff, the blink rate will be very fast.

Possible configurations on LCD3:

submenu number configuration name default value description
0 enable motor temperature sensor 0 (disabled) NOTE: if you don't have the motor temperature sensor installed, you should disable this option and ignore the next configurations.
1 enable current limiting 0 (disabled) limit the motor current to avoid the motor get over the max temperature.
2 min temperature 75 degrees Celsius motor temperature value at which the motor current will start to be limited.
3 max temperature 85 degrees Celsius motor temperature max value at which the motor current will be zero / motor shutoff.

6: LCD display configuration

submenu number configuration name default value description
0 LCD brightness when backlight is off 1 1 means 5%? TBD
1 LCD brightness when backlight is on 16 16 means 80%? TBD
2 LCD auto power off 15 Configured in minutes
3 Reset to defaults - Requires 10 button UP clicks to reset EEPROM default values? TBD

7: Offroad mode configuration

submenu number configuration name default value description
0 Offroad functionality 0 enabled (1) or disabled (0)
1 Active on system startup 0 Determines whether offroad mode should be active on system startup. Enabled (1) or disabled (0)
2 Speed limit 25 km/h This speed limit is used when offroad mode is not active. Configure your speed which is legal for using on public roads. The motor will fade out from - 0.5 km/h to +2,0 km/h.
3 Limit power 0 Determines whether power should be limited as well when offroad is not active. Enabled (1) or disabled (0)
4 Power limit 250 W The power limit in Watt. For certain EU countries this power limit is often 250W.

8: Various

submenu number configuration name default value description
0 Motor voltage type 0 0 for 48V brushless motor (TSDZ2 52V version has a 48V brushless motor); 1 for 36V brushless motor. This configuration is needed for FOC calculations.
1 Motor assistance startup without pedal rotation 0 Enabled (1) or disabled (0). Recommended to keep at 0 value if you don't have brake sensors installed.
2 PAS max cadence 25 km/h This value is used for calculation of human pedal power that will after be used for motor assist level.

9: Advanced technical data

submenu number configuration name description
0 ADC throttle see the current value
1 Throttle see the current value
2 ADC pedal torque sensor see the current value
3 Pedal torque sensor see the current value
4 Pedal cadence see the current value
5 Pedal human power see the current value
6 PWM duty cycle see the current value
7 Motor speed in ERPs see the current value
8 FOC angle see the current value. This value must be multiplied by 1.4 to get and angle value in degrees.
⚠️ **GitHub.com Fallback** ⚠️