TSDZ2 OSF for all displays, VLCD5-VLCD6-XH18, LCD3, 860C-850C-SW102.

@stancecoke is that intentional?
Are you talking about the Wiki?

That's a copy-paste relict of the old Kunteng project, I think. I've never edited the TSDZ2 Wiki, see the history.
But any user with a github account can edit it, so feel free to update the link to the release area.

regards
stancecoke
 
I haven't logged in there in years, I don't think I still have an active account. Edit: I do, but I don't feel comfortable making edits to the wiki without permission from the owner.

I think the issue is more that when I downloaded, I am fairly certain the guide I was using told me to explicitly use the latest stable release. And if you come from the wiki, and click on the link to 'download repository' there is no explanation on what you need to download from there ( see my previous post ).

edit:
stancecoke edited this page on 21 Mar · 27 revisions

You have to buy a STLink-V2 or clone, to flash the firmware to the motor. See the main wiki page how to wire the STLink to the motor connector. Keep the wires as short as possible.

A few steps are required to set up the software on a Windows computer. But they should also be feasible for inexperienced computer users :).

  1. download and install Java Runtime Environment
  2. download SDCC and install either the "full version" or at least the version with the "include" and "stm8 libraries" (they are required to compile all ".c" files from the "src/controller" directory and to link the output ".rel" files into a "main.ihx" file). Make sure, that the checkbox for setting the path is activated.
  3. download and install ST Visual Development. It is recommended to install it directly to C:\ but you can also let it use the default install path if that shows as C:\Program Files (x86). The file STVP_CmdLine.exe must be located in one of these paths. Alternatively, you can add a different path in the file _TSDZ2-Smart-EBike/src/controller/flash.bat
  4. download or clone the Github repository and unpack in directly to C:\
  5. Start the Java GUI by double-click on JavaConfigurator.jar in the extracted folder.
  6. See the parameter configuration guide in the manuals folder. The red texts refer to the use of the GUI configurator.
  7. adjust your personal settings in the GUI and click the Compile & Flash button. You can simply click on the list items on the right to restore former settings.
  8. optional for brave people who want to add more features themselves: Download Eclipse for C++ Developers and unzip it to the desired location. There is no installer here, just double-click on eclipse.exe and import the repo as new C project.
For detailed information read the operation manuals in the manuals folder.

I knew there was a reason I thought of you ;) Your name is above it.
I would edit and clarify step 4 according to my previous post, to ensure people download the latest stable version.

People who are wanting to contribute will already know how github works and how to clone / set up repositories.
 
Last edited:
ChatGP says...

"....Custom firmware (like OSF - Open Source Firmware) can improve throttle response and provide better configurability, making it behave more like a BBS02 throttle."

I haven't found that true at all. A BBS02B throttle kicks the bike in the butt. That will never happen with the TSDZ2,
 
:ROFLMAO: OK, you are too lazy....
I've set the link to release area. I prefer noiseless direct drives, have fun with your coffee grinders ;)

Thanks!

I'm not lazy, just not comfortable making edits :(

ChatGP says...

"....Custom firmware (like OSF - Open Source Firmware) can improve throttle response and provide better configurability, making it behave more like a BBS02 throttle."

I haven't found that true at all. A BBS02B throttle kicks the bike in the butt. That will never happen with the TSDZ2,

This is why I explicitly said I have no experience with using a throttle, I also said tsdz2 will not be comparable from what I've heard from people. But is it true it did 'improve' throttle response, or not at all?
 
I continue my discovery of the OSF.
I don't understand how to fill in the "torque sensor settings" part.
Concretely, I have the values TE 0 and TE 1 which are given to me by the vlcd5 display, but I don't understand in which boxes I have to put them...
TE 0: 97
TE 1: 167 when I am standing on the pedal, I weigh 76kg
What can I do with all this data?
 
You don't 'need' to calibrate the torque sensor, it's only recommended.

I never done it, don't have any complaints really since running OSF. OSF is more tollerant for 'out of expected range' torque sensor values anyway.

I would leave it alone, unless you run into issues and are told to try calibrating it.

ps also the calibration is done with a weight of 20-25kg, not your body weight. It's all in the wiki / manual ( page 4-5-6 ).

 
You don't 'need' to calibrate the torque sensor, it's only recommended.

I never done it, don't have any complaints really since running OSF. OSF is more tollerant for 'out of expected range' torque sensor values anyway.

I would leave it alone, unless you run into issues and are told to try calibrating it.

ps also the calibration is done with a weight of 20-25kg, not your body weight. It's all in the wiki / manual ( page 4-5-6 ).

Yes I know that don't need, but I am curious to understand
 
An update to earlier...I have successfully now flashed the motor, so, fantastic...well not initially totally successful, the throttle didn't work. So I checked it by re flashing to display throttle data (as per mbrusa suggestion in another thread) and the throttle ADC was fine...I knew the throttle and wiring were ok anyway because it was all working with stock firmware half an hour before....so...I rolled back to 20.1C.2-update-2....and the throttle is now working. Brilliant. Hope this is useful to know.
 
I did not want to open up my TSDZ2B to mess with the torque sensor unless I was force to, instead as per my reply on page 113 "as the torque sensor seemed a bit limp or I am just a light weight, I increased by 20% the Power and Torque Assist Mode values to give me the same feel as on my other bike, did not want a this point in time to open the TSDZ2B up and mess with the torque sensor, know what load cell elements are like. Think my Configurator is a few versions back but it works for me." There a photos of my setting, I do not the throttle, set for VLCD5 but using DZ41 display. From memory the TE and TE1 values do not relate to those of the standard firmware and the OSF.
 
Some clarification is needed.

The v20.1C.6-beta-1 version is now tested and stable.
I recommend everyone to use this one, it is more performant and efficient than the previous v20.1C.2-update-3.
Use v20.1C.2-update-3 only if you have problems in the compilation that you can't solve (remember that you need SDCC 4.4.0 or higher).
Do not use v20.1C.2-update-2 or earlier!
In this regard I also added a note on GitHub.

An update to earlier...I have successfully now flashed the motor, so, fantastic...well not initially totally successful, the throttle didn't work. So I checked it by re flashing to display throttle data (as per mbrusa suggestion in another thread) and the throttle ADC was fine...I knew the throttle and wiring were ok anyway because it was all working with stock firmware half an hour before....so...I rolled back to 20.1C.2-update-2....and the throttle is now working. Brilliant. Hope this is useful to know.
If with v20.1C.6-beta-1 the throttle does not work it is only a problem of settings in the configurator.

Throttle.png
Brake sensor must be enabled.
Optional ADC in, set to Throttle.
Throttle mode to Unconditional, or to another option you prefer.
The same in the "Street mode" section if you want to use it in that mode.

I continue my discovery of the OSF.
I don't understand how to fill in the "torque sensor settings" part.
Concretely, I have the values TE 0 and TE 1 which are given to me by the vlcd5 display, but I don't understand in which boxes I have to put them...
TE 0: 97
TE 1: 167 when I am standing on the pedal, I weigh 76kg
What can I do with all this data?
TE and TE1 with OSF have a different meaning than the stock firmware.
- TE, adc value without pedal push. To be entered in “Pedal torque ADC offset”.
- TE1, pedal torque delta, the value without pedal push is zero, it increases with pedal push.
The value to be entered in “Pedal torque ADC max”, is the maximum value (obtained with the rider standing, on the right pedal in a horizontal position) added to the TE value”, so “Pedal torque ADC max” = TE1 + TE.
To complete the calibration it is necessary to enable "Calibrated", enable "Estimated", enable "Torque sensor adv".
In your case with “Pedal torque ADC delta” = 167 you have a very good torque sensor. By enabling the calibration, at the same level you will notice a decrease in assistance, but it will be better distributed on the 4 levels.

You don't 'need' to calibrate the torque sensor, it's only recommended.

I never done it, don't have any complaints really since running OSF. OSF is more tollerant for 'out of expected range' torque sensor values anyway.

I would leave it alone, unless you run into issues and are told to try calibrating it.

ps also the calibration is done with a weight of 20-25kg, not your body weight. It's all in the wiki / manual ( page 4-5-6 ).

Calibration of the torque sensor is recommended, but becomes necessary if the value of “Pedal torque ADC delta” is low.
There are two calibrations, with different purposes.
The first to obtain the values of "Pedal torque ADC offset" and "Pedal torque ADC max", with the weight of the rider on the pedals and is used to balance the assistance on the 4 levels.
The second to obtain the values of "Pedal torque ADC step" or "Pedal torque ADC step advanced", these parameters, in addition to balancing the assistance on the 4 levels, are mainly used to correctly calculate the human power to be displayed.
Enabling "Estimated" calculates an estimated value of these parameters, less precise than the one obtained with the calibration with weight, but suitable for the purpose.
For those who also want to do this calibration precisely, it is not necessary to physically put a weight, a luggage scale is enough.
 
Yes, I did notice I don't have ANY data displayed when it should show 'human power', it's just an empty value.

I will install the latest version. I use xh18 so I will try 'estimated'.
 
If you do the first calibration and enable “Calibrated” and “Torque sensor adv”, the human power is still calculated correctly.
In this case "Estimated" even if enabled is not used. It is only needed if you disable “Torque sensor adv” and only in Power mode.
Edit:
It is important to do the calibration, enter the values in “Pedal torque ADC offset ” and “Pedal torque ADC max” and enable “Calibrated” and “Torque sensor adv”, you can also enable "Estimated" but it is not important.
 
Last edited:
I hope this is the right place....I've never posted before. I really want to install the OSF and have followed all the instructions...all software and github repository put in the root C directory, but no matter how many reinstalls/restarts (all day so far) I just can't get JavaConfigurator.jar to 'open'. I have tried reinstalling Java several times over, including the development kit version (20.01 I think), and downloaded the repository again but the same happens. I double click or 'open with' , Java appears then to be running in task manager, but no sign of the configurator. I tried the run from command prompt suggestion I found on Github and met with the Nullpointerexception problem.
...er..any suggestions ? (Windows 10 64 bit)
Cheers
silas
I didn't realize that you downloaded TSDZ2-Smart-EBike-1-master from the main repository and not the latest tested version.
Usually that is reliable too, but that day the repository was under maintenance!
I recommend always downloading the latest tested version, you can find it in the link in the signature or in the Releases section of the repository.
 
By the way there is also an update for the stock display version (Java Configurator).
It is a confirmation of the 6-beta-1 version with a few other changes.

Before the release I should do one last test over the weekend, but I don't know if I can do it, I already plan to try something else with 860C.
Or, if someone is available to try this is the link:
TSDZ2-Smart-EBike-1-master
I only need 2 confirmations that everything is ok and I proceed with the release.
 
A question...
where to buy a tsdz2b (36v) with the OSF compatible V1 controller??
 
TSDZ2
tsdz2 tongsheng 36V 250W/350W TSDZ2 electric bicycle central mid motor torque sensor with coast/foot brake function
TSDZ2B
TSDZ2B tongsheng 36V 250W 350W tsdz2 electric bicycle mid motor with torque sensor throttle e-brake lever VLCD5 VLD6 XH18-LCD 850C

I think better choice is TSDZ2 is better choice. My B versions have been broken more early than TSDZ2. I thought newer is better but I was disappoiment to TSDZ2B. I have used 48V versions.
Others can also say what they like different versions.
 
TSDZ2
tsdz2 tongsheng 36V 250W/350W TSDZ2 electric bicycle central mid motor torque sensor with coast/foot brake function
TSDZ2B
TSDZ2B tongsheng 36V 250W 350W tsdz2 electric bicycle mid motor with torque sensor throttle e-brake lever VLCD5 VLD6 XH18-LCD 850C

I think better choice is TSDZ2 is better choice. My B versions have been broken more early than TSDZ2. I thought newer is better but I was disappoiment to TSDZ2B. I have used 48V versions.
Others can also say what they like different versions.
I asked pswpower and they told me that the motors have the V2 controller :(
 
when did you buy your motor ? I asked them last week...


May.01.2024 Order No.


TSDZ2B tongsheng 48V 500W 350W 15A tsdz2 electric bicycle  mid motor with torque sensor throttle e-brake lever VLCD5 VLD6 XH18-LCD 850C

TSDZ2B tongsheng 48V 500W 350W 15A tsdz2 electric bicycle mid motor with torque sensor throttle e-brake lever VLCD5 VLD6 XH18-LCD 850C

  • Ships From: Germany
  • Power: 48V 500W
  • LCD: 8PIN VLCD5
 
Back
Top