So for any one wishing to go OSF for TSDZ2 with a stock display and with first hand exp of the pitfalls I would say go, go, go for it.
BELOW IS MY IDIOTS GUIDE TO INSTALLING.
The only real issue is the the PC op system and whether it accepts the Java Runtime (jre) as this was really the main stumbling block for me. The geeky terms and practice of programming (even minor ones like this throws up), one soon can get the hold of it after a few days of trial and error.
My 2020 W10 laptop refused to install it , yet my smashed but still working 2015 slow W10 Notepad happily installed it.
1. An ST -Link (dongle) needs to be simply made and wired correctly. Quite easy to do but wires must be short so no longer then 17cm from end of ST-Link to end of tsdz speed wire connector. The total wire length in between being a max 11cm, an st -link is needed and a spare tsdz2 speed sensor cable to cut up.
Go to page #1 and post #11 to see my diagram.
This is for Windows as I have no exp of other systems.
1A. If not loaded use a free down load of Notepad++ from
https://notepad-plus-plus.org/
Download to the Download folder and then open it to install on the pc, it doesn't matter where as it will auto run when needed.
2. The most important bit Download Java jre and check it is loaded and running on your pc. Download from
Download Java for Windows
Simply down load it and all the other Downloads when it comes to it, in to your PC's Download folder. From the Download folder copy it to C:, once done open & install it to your pc.
To check it is installed correctly use the magnifying glass/search box, located bottom lhs of the screen. Type in Cmd and then simply open the Command Prompt app, a new Black box will open. In the box a curser flashes next to your C:\ user name. Simply type java after your name and then press the enter key on the rhs of the querty board, if all is well then a pleatherer of text will start printing. Once this has finished press the enter key agian for your user name and cursor to flash again, type java _version ( after java there is a space then the under score dash line) and it should confirm the version.
Once this is done close the Cmd Prompt box.
3. Download SDCC from
Download Small Device C Compiler from SourceForge.net in to your Download folder.
In Local disk C:\ make a new folder called STMicroelectronics, from Downloads copy the SDCC to the STM folder.
Open the SDCC in the STM folder to install it in your PC via the install wiazard, during the install a box will appear with add to PATH (make sure the box precceding the PATH is ticked).
It will read; Add to path [Tick] Add C:\Program Files\SDCC\bin to PATH or C:\STMicroelectronics\bin to PATH.
4. Download the ST Visual Developer/STVD -stm8 from
STVD-STM8 - ST Visual develop IDE for developing ST7 and STM8 applications - STMicroelectronics . One has to supply the email for a reply link to allow the free down load. Again download to pc Download folder.
From the PC Download folder simply copy it to the folder C:\STMicroelectronics.
In the STMicroelectronics right click the en.stvd-stm8.zip folder and select extract all (tick the show all files box) in the new pane delete any wording that follows C:\ STMicroelectronics (in the destination box). The files will then extract to single ones in the STMicroelectronics folder.
Whilst in the C:\STM folder open the sttoolset_pack42.exe and install via the wizrard which auto runs. Ignore the acrobat box, accept the terms and leave the standard tools box as is.
Now let the wizard go thru half a dozen process's quite quickly.
5. Download the latest TSDZ2 OSF commit from
GitHub - emmebrusa/TSDZ2-Smart-EBike-1: TSDZ2 Open Source Firmware adapted to VLCD5-VLCD6-XH18 displays
In the GitHub simply left click the Green Code box and select the Download ZIP.
Down load to Downloads folder or direct to C:
When folder is in C: right click and extract the zip folder to a folder of the same name minus the ZIP on the end. I found it best to keep the folder name exactly the same as the commit version rather then use the master name.
Once extracted one will see a list of files and folders, here we have to make sure the path is correct for JAR to open properly. Select the 'src' folder and open it, then select the 'controller' folder and open it. In the 'controller 'folder right click the 'compile_and _flash folder (it may say .bat) after it and select the 'Edit with Notepad++'. In here copy/re-type the text from page #10 & post #182 exactly (the last entry box).
Once all this is done open the C:\TSDZ2 folder not the zipped one and open the JavaConfigurator.jar file and the tsdz2 configurator screens should open.
You are the ready to make the parameter changes.