Features and configurations for version 0.18.X - OpenSourceEBike/TSDZ2_wiki GitHub Wiki
The following only applies to firmware version 0.18.X!
CAUTION:
- Always use the same firmware version for both the motor controller and LCD unless otherwise specified!
- Before using the mid drive with new firmware, you must correctly configure the options on the display. For instance, you should configure your battery low voltage cut off so as not to over discharge the battery. Do set all other parameters also.
- When installing new firmware, always check that no unwanted functions have become enabled or disabled during the install process.
The assist level field displays the active assist level. This sets the motor power as a factor of the power that rider is generating on the pedals. For instance, if current assist level is 3 and if this level is configured as a factor of 2.0, when rider is doing on the pedals a power of 100 watts, the motor power supplied will be 200 watts. The assist level is changed by pressing either UP or DOWN button.
NOTES:
- It is possible to configure the number of assist levels (1 to 9) in the configuration menu.
This sub field displays information about speed. The values are displayed in either metric or imperial units and the user can switch between a couple of different speed measurements. The default one is current wheel speed. Other ones are average speed since power on and peak speed since power on.
- Wheel speed: Displays current wheel speed.
- Average wheel speed: Displays average wheel speed since power on.
- Peak wheel speed: Displays peak wheel speed since power on.
The motor power field displays instantaneous motor power in watts. In the maximum motor power sub menu you can set a limit to maximum motor power. This can be useful for various reasons, like controlling the battery range for long trips.
It is also possible to access a quick set sub menu by long pressing ON/OFF and UP buttons. Press or hold UP and DOWN buttons to increase or decrease the power limit. Exit sub menu by holding the ON/OFF button. The quick set sub menu cannot be accessed when offroad mode is enabled. Disable offroad mode first.
How it works: the motor controller will automatically limit current and therefore limit maximum motor power. As the battery discharges and the voltage decreases the motor controller will adapt and adjust the current to maintain the set power limit.
NOTES:
- It is possible to access a quick set sub menu by long pressing ON/OFF and UP buttons. Press or hold UP and DOWN buttons to increase or decrease the power limit. Exit sub menu by holding the ON/OFF button. The quick set sub menu cannot be accessed when offroad mode is enabled. Disable offroad mode first.
- The motor power will not exceed the maximum allowed battery current set by user.
The odometer field located at the bottom of the display can show a few variables that are logically grouped in sub fields. You can change between fields by pressing the ON/OFF button. To change between sub fields quickly press UP button followed by a long hold on UP button. The current field and sub field number will temporarily blink in the wheel speed field.
NOTES:
- Sub fields are only displayed if the function in question is enabled and not set to hidden in the Configuration Menu, Main Screen Setup.
- 1. Distance
- 1.0 Trip distance: You can manually reset the trip distance by pressing DOWN button quickly followed by a long press on the DOWN button until value resets. It will start to blink when it is about to reset.
- 1.1 Distance since power on: this value will automatically reset during power on/off. But is also manually resettable as described above.
- 1.2 Odometer: can be set to a specific value in the configurations menu or reset as described above.
- 2. Battery State of Charge
- 2.0 State of charge in percentage
- 2.1 Consumed watt-hours
- 3. Battery State
- 3.0 Voltage: voltage of battery.
- 3.1 Current: instantaneous current drawn from battery.
- 4. Pedals
- 4.0 Rider pedal power : in watts.
- 4.1 Pedal cadence : in revolutions per minute.
- 4.2 Pedal torque : in newton meter.
- 5. Motor Temperature
- 5.0 Motor temperature: temperature of motor.
- 6. Time Measurement
- 6.0 Time Measurement: time measured since display is powered on. You can reset by pressing DOWN button quickly followed by a long press on the DOWN button until value resets. It will start to blink when it is about to reset.
- 6.1 Total Time Measurement: total time measured since last reset. Can be reset as described above.
- 7. Wheel Speed
- 7.0 Current wheel speed: Current wheel speed.
- 7.1 Average wheel speed: The average speed since power on.
- 7.2 Peak wheel speed: The measured peak value of wheel speed since power on.
- 8. Cruise Function
- 8.0 See target speed for Cruise:
This field can either show the motor temperature, when the function is enabled and the temperature sensor is installed, or some other data depending on user preference. It is also possible to set so that the field displays nothing.
NOTES:
- Set your desired configuration under the Main Screen Setup in the Configuration Menu.
- The chosen field to be displayed will be temporarily hidden and the motor temperature will be displayed if it is at temperature limits.
- Motor temperature: Motor temperature in degrees Celsius. When the power power is being limited due to over temperature, this field will blink. It is possible to configure the temperature limits in the Configurations Menu.
- Battery state of charge in percent: This percentage value is based on measured watt hours consumed from the battery. Set different modes and read more about this function in the configurations menu.
- Battery voltage: When you prefer to always have the battery voltage displayed it is possible to set this in the motor temperature field.
- Battery current: Monitor the instantaneous current drawn from the battery.
- Pedal cadence: Set to pedal cadence if you wish to see the instantaneous cadence of pedal rotation.
The time measurement field displays elapsed time since power on or since last reset. It displays either the TM symbol, stands for Time Measurement, or TTM symbol, stands for Total Time Measurement. This corresponds to the mentioned "time since power on" and "time since last reset".
- TM: Elapsed time since power on.
- TTM: Elapsed time since last reset.
Battery state of charge based on battery voltage. There are 6 different levels. When battery is near empty, the battery symbol will be empty and blinking and the motor power will be reduced up to battery being totally empty.
The battery voltage used to calculate the state of charge has in consideration the battery pack resistance to avoid floating when power is being draw from the battery (the battery pack resistance value is set on configurations menu).
Enabled or disable LCD backlight, headlights and lights symbol with a long press of UP button. The LCD backlight will change as configured by user.
The brake symbol lights up when user engages the E-Bike brakes, if installed. This is also useful for checking that the E-Brakes are working properly and thus turn of the motor assistance when applied.
Enable or disable walk assist with a long hold of DOWN button at speeds below 8 km/h (approximately 5 mph). The motor will start to give assistance and maintain a walking pace. At the same time the walk assist symbol will light up. To set different power levels simply select appropriate assist level. The power levels can be configured in the configuration menu.
NOTES:
- This function can be disabled in the configuration menu.
- Number of walk assist levels correspond to number of configured assist levels.
Enable or disable the cruise function with a long hold of DOWN button at speeds above 8 km/h (approximately 5 mph). If the function is enabled it will by default save the current wheel speed and maintain it for as long as the DOWN button is pressed. The cruise symbol will light up to let the user know that the function is active.
It is also possible to enable a feature where you enter the desired wheel speed and the cruise function will automatically go to and maintain that speed. More information on how to enable and use the different functions can be found under the configuration menu.
NOTES:
- This function can be disabled in the configuration menu.
- Use with safety in mind.
If offroad mode is enabled it 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.
NOTES:
- It is not recommended to activate offroad mode on public roads.
- In many countries offroad mode may only be used on private property.
- To enter the configuration menu: long press UP and DOWN buttons
- To enter sub menus: press UP or DOWN button
- To move to next sub menu: press ON/OFF button
- To exit sub menu or configuration menu: long press the ON/OFF button
| Submenu number | Configuration name | Default value | Description |
| 0 | Unit | Metric |
Set (0) for metric units (km/h and kilometers) or (1) for imperial units (mph and miles).
|
| 1 | Maximum wheel speed | 50 |
Enter 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. Tip: Europe has generally a speed limit of 25 km/h for E-Bikes.
|
| 2 | Wheel circumference | 2050 |
Enter your wheel circumference so that speed and distance is correctly calculated.
Tip: Search on Google how to measure wheel circumference. But for a quick setup with ball park values use: 26 wheel = 2050; 27 wheel = 2150; 27.5 wheel =2215; 28 wheel = 2250; 29 wheel = 2300. |
| Submenu number | Configuration name | Default value | Description |
| 0 | Maximum current from battery | 16 ampere |
Set maximum allowable current to be pulled from the battery. This value is limited internally by the firmware to the safe value of 18 ampere.
|
| 1 | Battery low-cut-off voltage | 39 volt |
The controller will reduce power to stay over this limit! Calculate the limit by multiplying amount of cells in series with the safe cut-off-voltage per cell, which is usually between 2.8 - 3.0 volts. Example: 39.0 volts for: 13 cells in series * 3.0 volts = 39.0 volts.
Tip: The standard Samsung cells allow down to 2.75 V but you need some safety margin because not all cells have exactly the same capacity. But setting a too large value you loose range and power. I like to use the value of 29 V for a 36 V battery pack (= 10 cells in series). |
| 2 | Number of cells in series | 13 |
Set this value so the battery state indicator works properly. This value can be any integer from 7 to 14
Example values: 7 for 24 V battery; 10 for 36 V battery; 13 for 48 V battery; 14 for 52 V battery. |
| 3 | Battery internal resistance | 130 milliohms |
Set this value so the battery state indicator does not display a lower state of charge when pulling a lot of power from battery and the voltage sags.
Explanation: If you set the value to 0, you will see the battery state indicator fluctuating whenever the motor draws current from the battery. This is due to the internal resistance in the battery. The fluctuation will disappear and be filtered out with a correct value. How to calculate the battery pack resistance: 1. Limit the battery current to a known value, e.g. 10 amps 2. Read the voltage drop when motor is pulling the 10 amps 3. Calculate the resistance value Example for 10 amps current, R = U / I, R = 1.2 volts drop / 10 amps, R = 0.120 = 120 milliohms. |
| 4 | Battery voltage (SOC) | - |
Measured and continuously updated battery voltage State Of Charge (SOC). This value is filtered using the battery pack resistance.
Tip: Here you can evaluate and test how the set internal resistance of the battery affects the voltage reading. |
Under this configuration menu you can set parameters to display the state of charge of your E-Bike battery. If this function is enabled it will display how many watt-hours have been consumed since last charge and what percentage remains of the battery. Depending on preferences it is possible to set so that percentage of consumed charge is displayed instead of percentage of remaining charge.
Tip: If this function is enabled you will be able to see percentage of charge in the temperature field on your display. To enable or disable just click the ON/OFF-button together with the DOWN-button at the same time. Do not forget to enable and set up the function below.
| Submenu number | Configuration name | Default value | Description |
| 0 | Enable and set State of Charge function | 0 |
Set (1) to enable function. It will display watt-hours consumed and percentage of charge remaining, i.e., display percentage value from 100 % to 0 %.
Set (2) to enable function. It will display watt-hours consumed and percentage of charge consumed, i.e., display percentage value from 0 % to 100 %. Set (0) to disable the function. |
| 1 | Threshold voltage to reset watt-hour meter | 54.2 volt |
When powering on the display this value is compared to the battery voltage. If it is lower, the battery is expected to be fully charged and the watt-hour meter is reset.
Tip: To find a suitable value, fully charge the battery and measure the voltage on the KT-LCD3, use a slightly lower value for the threshold voltage. Example: my 48 V battery charges up to 54.6 volts, so I set the threshold to 54.2 volts. |
| 2 | Total watt-hours of battery | 0 |
Set the total capacity in watt-hours your battery has.
Tip: fully charge the battery and then discharge it completely and use the measured value to input here. Tip: the capacities stated from suppliers are often too high, expect a value of around 80 % - 90 % of stated value. I use 350 Wh for my 386 Wh battery. Tip: roughly calculate the capacity by multiplying the nominal voltage with the nominal ampere hours. Example: a 48 volt, 14.5 Ah battery has a nominal watt-hour capacity of 696 Wh. |
| 3 | Consumed watt-hours | - |
This value represents consumed watt-hours since last reset. It is reset automatically when you power on the LCD and the battery is fully charged, i.e. above the set threshold voltage.
|
Here you can configure how many assist levels you wish to be able to select and also their respective multipliers. The defaults should already work for most situations.
The assist level sets the motor power as a factor of the power the rider is generating on the crankshaft. For instance, if assist level 3 is chosen and configured with a multiplier of 2.0, when the rider is generating a power of 100 watts, the motor power will assist another 200 watts.
| Submenu number | Configuration name | Default value | Description |
| 0 | Number of assist levels | 5 |
Select the desired number of assist levels from a minimum of 1 to a maximum of 9.
|
| 1 | Assist level 1 multiplier | 0.5 |
The value with which the human pedaling power is multiplied with.
Example: 0.5 * 200 W (human power) = 100 W assist power. This results in 300 W total power. |
| X | Assist level X multiplier | .... |
The desired multiplier for assist level X.
|
Here you can enable or disable the walk assist function. And also configure the motor duty cycle in each and every enabled assist level. The defaults should work for most situations.
The walk assist PWM value sets the motor duty cycle. It is an open loop controller. A PWM value of 30 will set the target duty cycle to 30. Maximum settable PWM in the walk assist function is limited to a value of 100.
NOTES:
- There are only as many walk assist levels as there are assist levels. This is configured under 3: Assist Levels.
- Carefully test and set appropriate values.
- The function is only active in speeds below 8 km/h or around 5 mph.
| Submenu number | Configuration name | Default value | Description |
| 0 | Enable/disable walk assist function | 0 |
Set (1) to enable or set (0) to disable the walk assist function.
|
| - | Walk assist level 0 | 0 |
-
|
| - | Walk assist level 1 | 25 |
-
|
| - | Walk assist level 2 | 30 |
-
|
| - | Walk assist level 3 | 35 |
-
|
| - | Walk assist level 4 | 40 |
-
|
| - | Walk assist level 5 | 45 |
-
|
| - | Walk assist level 6 | 50 |
-
|
| - | Walk assist level 7 | 55 |
-
|
| - | Walk assist level 8 | 60 |
-
|
| - | Walk assist level 9 | 65 |
-
|
Here you can enable or disable the cruise function. The function can be activated when the bike is traveling at speeds above 8 km/h or around 5 mph and the user presses and holds the DOWN button.
The cruise function has two modes of operation depending on user preference. It can, when activated, save the current speed and maintain it. Or the user can set a desired target speed and the cruise function will accelerate/decelerate to the set speed and then maintain it instead. Both modes of operation are activated the same way as described above.
If it is preferred to set a target speed and let the cruise function maintain that speed there are two ways in which the user can set the speed. The first way is through the configuration menu. The second way is by enabling the cruise display in the odometer field in the Main Screen Setup. This will display an extra sub field where the target speed is displayed in the odometer field. Pressing the UP or DOWN buttons will not change the assist level in this sub field, instead, it will change the target speed.
NOTES:
- It is recommended to install and use the E-brakes when using Cruise.
- The cruise function only works at speeds above 8 km/h or around 5 mph.
- The motor power will not exceed set power limits.
| Submenu number | Configuration name | Default value | Description |
| 0 | Enable/disable cruise function | 0 |
Set (1) to enable or set (0) to disable the cruise function.
|
| 1 | Set speed to maintain | 0 |
Set (1) to enable or set (0) to disable the set speed to maintain feature. This will enable the user to set desired speed and the cruise function will maintain that speed.
|
| 2 | Set target speed | 25 kph or 15 mph |
Here it is possible to set the target speed for the cruise function to maintain. This is when the "set speed to maintain" feature is enabled.
|
| 3 | Display set target speed for cruise | 0 |
Display of user set target speed in which the cruise function will try to maintain. In this menu the UP and DOWN buttons will increment or decrement target speed. The target speed is displayed in the odometer field and is enabled (1) by default. Set (0) to disable.
|
In the Main Screen Setup it is possible to configure and customize the main screen.
NOTES:
- Some variables can only be reset in the odometer field so it is required to enable those variables to be able to reset.
| Submenu number | Configuration name | Default value | Description |
| 0 | Temperature field setup | 0 |
In this sub menu it is possible to set the temperature field to display different data depending on user preference. Such as:
(0) = Display nothing (1) = Motor temperature (2) = Battery state of charge in percent (3) = Instantaneous voltage on battery (4) = Instantaneous current drawn from battery (5) = Pedal cadence NOTE: If the motor temperature is hitting the temperature limits the field will temporarily hide chosen data display so as to show the user the motor temperature. |
| 1 | Distance data | 1 |
Display of distance data, i.e. trip distance, distance since power on and odometer, in the odometer field is enabled (1) by default. Set (0) to disable.
|
| 2 | Battery state | 1 |
Display of battery state, i.e. voltage and current, in the odometer field is enabled (1) by default. Set (0) to disable.
|
| 3 | Pedal data | 1 |
Display of pedal data, i.e. rider pedal power, pedal cadence or pedal torque, in the odometer field is enabled (1) by default. Set (0) to disable.
|
| 4 | Time measurement | 1 |
Display of time measurement, i.e. TM or TTM, in the odometer field is enabled (1) by default. Set (0) to disable.
|
| 5 | Wheel speed | 1 |
Display of wheel speed, i.e. current wheel speed, average wheel speed or peak wheel speed, in the odometer field is enabled (1) by default. Set (0) to disable.
|
| 6 | Display set target speed for cruise | 0 |
Display of user set target speed in which the cruise function will try to maintain. In this menu the UP and DOWN buttons will increment or decrement target speed. The target speed is displayed in the odometer field and is enabled (1) by default. Set (0) to disable.
|
Here you can enable, disable and configure the BOOST feature. This feature helps from standstills where you might need greater assistance. It gives more power during a set time and then fades the power back to normal assistance. To configure the function for you likening please set appropriate values.
| Submenu number | Configuration name | Default value | Description |
| 0 | BOOST feature | 0 |
Set (1) to enable or (0) to disable.
|
| 1 | On startup only / every time | 1 |
Set (1) to enable BOOST feature every time pedal cadence or torque sensor value are zero. Set (0) to enable BOOST feature only when startup and bicycle wheel speed is equal to zero.
|
| 2 | Limit BOOST power to max battery power | 0 |
Set (1) to enable BOOST power limit to the maximum battery power value. Set (0) to disable.
|
| 3 | BOOST time | 2.0 seconds |
Set time limit of BOOST.
|
| 4 | Fade out BOOST | 3.5 seconds |
Set time limit to transition of power from BOOST to regular power.
|
| 5 | Assist level 1 BOOST multiplier | 4 |
Set the BOOST multipler corresponding to assist level 1.
Tip: See assist levels for more information about multipliers. |
| 6 | Assist level X BOOST multiplier | - |
Set the BOOST multipler corresponding to assist level X.
Tip: See assist levels for more information about multipliers. |
In this sub menu it is possible to enable or disable the throttle or the motor temperature protection function. Both can not be activated at the same time because they use the same hardware to operate. If the motor temperature sensor is installed it is not possible to use the throttle and do NOT enable throttle if that is the case.
This motor temperature protection eliminates overheating. Without this function and under heavy loads it would result in permanent damage/loss of torque. See: TSDZ2 motor demagnetized due to overheating. You can only use and enable this feature if you have installed the motor temperature sensor.
How it works:
If you have installed the motor temperature sensor and you enable the function, you will be able to see the motor temperature in the temperature field of the display. When the set minimum motor temperature threshold is reached, the motor current will start to be limited. If the temperature keeps rising this will result in even more current, and therefore overall power, limitations. If the maximum motor temperature is reached the current will be completely limited.
The temperature value on the display will blink if the motor current is being limited. As the function limits the current more it will blink faster corresponding to higher limitations on current. Finally, if the current is completely limited, the blink rate will be very fast.
| Submenu number | Configuration name | Default value | Description |
| 0 | Temperature limit or throttle | 0 |
This sub menu is by default set to (0). This means neither throttle nor motor temperature limit function is enabled. Set (1) to enable the motor temperature control or set (2) to enable the throttle.
NOTE: Do NOT enable the throttle if you have installed the motor temperature sensor. If you have the sensor installed you need to either have the motor temperature limit function enabled or everything disabled, i.e. set to either (1) or (0). |
| 1 | Minimum temperature | 75 °C |
Set the minimum motor temperature at which the motor current will start to be limited.
|
| 2 | Maximum temperature | 85 °C |
Set the maximum motor temperature at which the motor current will be completely blocked, i.e., motor shutoff.
|
| Submenu number | Configuration name | Default value | Description |
| 0 | LCD brightness when backlight is off | 5 |
Percentage of brightness when back light is turned off. The default value is five (5) percent.
|
| 1 | LCD brightness when backlight is on | 80 |
Percentage of brightness when back light is turned on. The default value is eighty (80) percent.
|
| 2 | LCD auto power off | 15 |
Automatic power off after set amount of minutes.
|
| 3 | Reset to factory defaults | 0 |
|
This function enables user to limit speed and power when using bike on road. When using the bike off road where laws may be different it is possible to toggle Offroad mode and unlock a higher speed or power limit. Set parameters suitable for your specific laws and preferences.
| Submenu number | Configuration name | Default value | Description |
| 0 | Feature toggle | 0 |
Set (1) to enable or (0) to disable.
|
| 1 | Active on system startup | 0 |
Determines whether offroad mode should be active on system startup. Select (1) to enable or select (0) to disable.
|
| 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 power from -0.5 km/h to +2,0 km/h.
|
| 3 | Limit power | 0 |
Determines whether power should be limited when offroad mode is not active. Select (1) to enable or (0) to disable.
|
| 4 | Power limit | 250 W |
The power limit in watts. For most countries in Europe the legal power limit is 250 W.
|
| Submenu number | Configuration name | Default value | Description |
| 0 | Motor voltage type | 0 |
Depending on type of motor, set appropriate value so that FOC calculations are correctly executed. The voltage of the battery does not matter, this value should always be set depending on type of motor.
|
| 1 | Current ramp up | 5 amps per second |
Set value after user preference. Higher value corresponds to faster acceleration but also greater forces on the mid drive. Be mindful not to select too fast acceleration.
|
| 2 | Motor assistance startup without pedal rotation | 0 |
Select (1) to enable or select (0) to disable. Recommended to keep disabled (0) if you do not have brake sensors installed.
|
| 3 | Set odometer | 0 |
Set the odometer to preferred value. Increase the value by pressing UP button or press and hold to have the value increment automatically. Decrease the value by pressing the DOWN button or press and hold to have the value decrement automatically.
|
| 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 angle value in degrees.
|