[Twiz O'Meter] Update to firmware 1.3

Time has come for the first firmware release.

I want to public thank all of you for the appreciation received for my project.
I thought Twizy'o'meter to be a nice toy. I didn't expect such a great enthusiasm!

What is new in firmware 1.3
====================
- now "Ah" value auto swaps to show reku recharging current. In this case, the "Ah" icon contains a flash ad has orange colour
- added recharge page. It starts automaticaly during charging, but it can be disabled in settings page
The values showed are customizable, except the sixth value, inside the charging animation, which is fix and shows SOC
ETA is calculated starting from the actual power supplied by the charger, considering the theoric capacity of the battery (nominal capacity, corrected with SOH)
So, ETA is an estimated value, which gives and idea of the remaining charge time, in minutes
- added wi-fi connectivity. Now Twizy o'meter can connect via wi-fi to share data, relaying on a Mqtt broker
- added wi-fi settings page. Here you can enter max four SIDD, with passwords, and select if wi-fi should be enabled during charging and/or during drive
On connect, Twizy o'meter will scan for available ssid and, if one of the four saved ssid is found, it will try to connect to it, starting from the ssid with the higher power
If none of the four saved ssid is found, Twizy o'meter will look for a free ssid (with no authentication password), and try to connect
If neither a free ssid is available, Twizy ometer will scan again the networks after 2 minutes
Although scanning function is coded to be non-blocking, Twizy o'meter could be less responsive than usual during scan / attempts to connect
When conected, the IP address is shown in the wi-fi page. Tap on it, to read the MAC address
- added MQTT settings page. Here you can enter your mqtt account parameters and select the frequency of publishing data (not less than 1 sec)
Without settings mqtt parameters, the wi-fi connection will be unuseful. So, take time to do it
A message in settings page shows the state of mqtt connection (connected/disconnected)
When the connection to the broker is lost, Twizy o'meter will retry to reconnect after 30 seconds
- a very, very, very basic android app is provided to connect, via Mqtt broker, to your Twizy o'meter to read (at the moment) charging values
- added keyboard, to enter values
- added a "condensed" battery info page. You can choose it in settings page, as an alternative to multiple info pages.
- battery power (full capacity in kwh) can be modify in settings page
- range of battery total voltage setted to 46.0-58.8
- range of charger temperature setted to 0.0-70.0
- added power off animation
- extended also to text string the sensitive touch area for the values in second plane
- some bugs fixed (lost the count!). Don't blame me if others are still existing: I had to rewrite a large part of the code to implement wi-fi connection
and I was also forced to change the custom comunication protocol with the display, to handle passing of wi-fi and mqtt parameters. So, some issues could be present

Known bugs:
=========
-sporadic graphical mismatch in charging page (ETA segment bar), under investigation

Special thanks go to:
===============
Snorre, the first brave who successfuly completed the update with Linux OS. He found the right command line syntax, wrote the linux updating "hints" and gave me many improvement ideas, most already included in this release.
HollandHannes, who pointed me in the right direction, providing me usefull documentation and precious informations for this release
JPB, for the general support he gave me, since the first "wellcome" in this forum
Ulli-and-Tom, Kerstin66, maikt, Snorre and all the others for the words they wrote about my project and the signs of appreciation of my work, words and signs that left me literaly embarrassed and a little drunk .

General update instructions
====================
You have to upgrade both balckbox and LCD frimware, following the below steps.
I suggest you to first update the LCD firmware and only then the blackbox firmware.
Take all the time you need to carefully read and strictly follow the steps.
The updating procedure is a quiet easy task, but you have to avoid to do it with rush and/or proceed by intuition, otherwise you risk to brick your device.

LCD updating procedure
=================


Blackbox updating procedure with Windows OS
==================================


Blackbox updating procedure with Linux OS
===============================

Android app installation & Mqtt configuration
================================

Some pictures of the new firmware release
===============================


That's all for now!

For who wants to install Twizy o'meter above the windscreen, up side down, I share here a flipped version of the LCD firmware.

German translation of the update instructions!

Deutsche Übersetzung von Fabios Update Anleitung:


Vorgehensweise für Firmware-Updates des LCD-Touchscreen:

1) Das Twizy o'meter mit dem Schalter amd OBDII-Stecker ausschalten und den Zündschlüssel des Twizy auf '0' stellen
Es ist wichtig alle Schritte der Reihe nach auszuführen um keine Schäden zu verursachen.

2) Die Datei UpdateLCDfw.zip (alternativ: Fw13_LCD_flipped.zip) herunterladen und entpacken.
Im Ordner UpdateLCDfw befindet sich die Datei "Fw13_LCD_rel.tft" bzw. die Datei "Fw13_LCD_flipped.tft" im selben Verzeichnis wie die zip-Datei.

3) Die Datei "Fw13_LCD_rel.tft" (alternativ die Datei "Fw13_LCD_flipped.tft") auf eine microSD Karte kopieren.
Diese microSD Karte muss ansonsten leer und mit FAT32 Dateisystem formatiert sein.
Nicht alle microSD Karten funktionieren, insbesondere neuere microSD Karten für Kameras können Schwierigkeiten bereiten.
Klasse 10HC Karten mit Speichervolumen zwischen 8 und 32 GB haben sich bewährt.
Es können aber auch andere funktionieren.

4) Die microSD Karte in das Display vom Twizy o'meter stecken.
Da der Kartenschlitz im Gehäuse höher als der Kartenslot auf der Displayplatine ist, bitte die Karte besonders sorgfältig einlegen.
Ansonsten könnte es passieren, dass die microSD Karte im Displaygehäuse verloren geht.
Es hat sich bewährt die Karte leicht geneigt in den Kartenslot einzuführen, siehe Fotos.





5) Die microSD Karte so weit in den Slot einführen bis man ein leichtes Klicken hört und die Karte im Slot arretiert ist.

6) Jetzt kann der Schalter am ODII-Stecker eingeschaltet und der Schlüssel des Twizy auf Stufe 1 gedreht werde.
Das Update beginnt!



7) Das Update beginnt sobald das Display angeht.
Während des Update-Vorgang unter keinen Umständen den Schalter betätigen oder den Zünschlüssel drehen.
Dies könnte die Beschädigung des Displays zur Folge haben.

8) Warten bis die Meldung "Update Successed!" im Display angezeigt wird.



9) Nun können der Twizy und das Display wieder ausgeschaltet werden.

10) Die microSD Karte durch leichten Druck ausrasten und entfernen.

11) Das Update des Display ist nun vollständig durchgeführt-

12) Wenn nötig nun mit dem Update der "Blackbox" fortfahren, ansonsten den Schalter am OBDII-Stecker wieder einschalten.

Gratulation!

Meine dringende Bitte an alle derzeitigen und künftigen Twizy o´meter-Besitzer:
Das Twizy o´meter ist ein hervorragendes Hard- und Software-Projekt für den Twizy und Fabio leistet ganz herausragende Arbeit und ist bemüht alle unsere Wünsche zu erfüllen.
An dieser Stelle noch mal ein ganz herzliches Dankeschön an Fabio.
Es steckt derzeit eine gewaltige Dynamik in der Firmware-Entwicklung des Twizy o´meter.
Entsprechend kurzlebig werden die jeweils aktuellen Firmwareversion wohl sein.
Was heute up-to-date ist kann nächste Woche schon Schnee von gestern sein.
Deshalb ist es wichtig dass ihr am Ball bleibt.

Die Anleitungen zu den Firmware-Update wirken zugegebenermaßen kompliziert und abschreckend.
Es ist aber nicht annähernd so schlimm, wie es zunächst erscheint.
Mein erster Versuch die Firmware der Blackbox unter Linux zu updaten endete darin, dass das Twizy o´meter ins Koma fiel.
Die Reanimation gelang aber Dank der engagierten Hilfe von Fabio in recht kurzer Zeit.
Unter Windows sollte das nicht passieren, da dort das Verfahren bereits bekannt und erprobt ist.
Und falls doch, dann sollte die Wiederbelebung ähnlich einfach gelingen, wie bei mir.
Im Zweifel einfach vorher kurz nachfragen und Fabio (und auch ich) ist bemüht zu helfen.
Also traut euch!

Ich liebe das Twizy o´meter schon jetzt und freue mich riesig auf das was da in den nächsten Tagen und Wochen noch alles kommen wird.

Mir ist eins noch unklar, muss ich dieses Update downloaden und das mit der SD Karte machen?
Ich dachte ich verstöpsele und erhalte die Infos, welche von Beginn aus da waren ohne die Updates.
Sorry ist evtl zu kurz gedacht, doch das was am Anfang stand hat mir erstmal gereicht.

No, you don't.
Your unit was already updated to this firmware (ver. 1.3).
So, just "plug and play" (better, plug & drive !)

Vorgehensweise für Firmware-Updates der ESP32-Blackbox:

1) Das Twizy o'meter mit dem Schalter amd OBDII-Stecker ausschalten und den Zündschlüssel des Twizy auf '0' stellen
Es ist wichtig alle Schritte der Reihe nach auszuführen um keine Schäden zu verursachen.

2) Am Windows-Rechner die Treiber für "CP210x" installieren, so fern dies noch nicht geschehen ist.
Die werden benötigt damit die ESP32 Hardware der Blackbox erkannt wird.

3) Die Blackbox mit einem micro USB Kabel mit dem Windows-Rechner verbinden.
Der micro USB Stecker muss an der den Kabelabgängen gegenüber liegenden Seite in die Buchse der Blackbox gesteckt werden, der andere Stecker in einen freien USB Port des Windows-Rechner.

4) Wenn die CP210x Treiber sauber installiert sind, dann sollte der Windows-Rechner die ESP32 Hardware erkennen.

5) Das "flash_download_tool" auf dieser Seite www.espressif.com/en/support/download/other-tools herunterladen.

6) Die aktuelle Firmware herunterladen (derzeit "Fw13_ESP32_rel.bin")

7) Das flash_download_tool starten (flash_download_tool.exe ausführen)

8) ESP 32 auswählen



9) Im nächsten Fenster die zu flashende Firmware auswählen (derzeit "Fw13_ESP32_rel.bin")



10) In der Windows Systemsteuerung prüfen welcher COM Port der ESP32 Hardware zugewiesen wurde.
Es handelt sich um das Gerät mit "CP210x" im Namen.



11) Im ESP32 Download Tool den Haken für die ausgewählte Firmware-Datei setzen

12) rechts daneben als Speicheradresse "0x10000" eintragen

13) unten rechts den COM Port auswählen, der der ESP32 Hardware in Windows Systemsteuerung zugewiesen wurde

14) alle anderen Einstellungen wie auf folgendem Bild vornehmen:



15) Nun den Start Button klicken und warten



16) Wenn der Fortschrittsbalken das Ende erreicht hat, kommt eine "Finish" Meldung



17) Das Firmware-Update ist nun beendet und die ESP32-Blackbox kann vom Windows-Rechner getrennt werden.

18) Nach dem ersten Start des Twizy o'meter kurz in die Einstellungen gehen und wieder verlassen um die Änderungen zu speichern.

Gratulation!


Ergänzung meinerseits:
Da ich selbst keinerlei Windows-Rechner im Einsatz habe, musste ich auf die Bilder von Fabio zurückgreifen.
Es ist also gut möglich, dass sich das Erscheinungsbild der deutschen Softwareversionen ein wenig anders darstellt.
Gravierende Unterschiede würde ich aber nicht erwarten.
Falls doch, kann man mir gerne die jeweiligen "deutschen" Bilder schicken, dann werde ich den Mod bitten, diese auszutauschen.

I'm sorry, but in the first post I forgot the Twizy o'meter apk.
You find it herewith enclosed.

Installation und Konfigurationsschritte zur Nutzung der Twizy-App für Android:

1) Die Apk-Datei auf dem Smartphone herunterladen bzw. auf das Smartphone kopieren
Die derzeit aktuelle Version findet ihr im Anhang dieses Posts von Fabio
2) Im Dateimanager die Datei 2x antippen.
3) Wenn noch nicht geschehen, dann müsst ihr zustimmen, dass Apps aus Drittquellen installiert werden dürfen.
4) Den Hinweis, dass die App für eine andere Android-Version erstellt wurde könnt ihr durch "Ok" bestätigen bzw. ignorieren.
5) Nachdem die App installiert wurde mit dem ersten Start der App warten wenn ihr noch keinen MQTT Zugang habt.
6) In diesem Fall müsst ihr zunächst einen Zugang bei einem MQTT Broker einrichten.
Fabio empfiehlt www.maqiatto.com .
Manchmal ist der Server tot, aber meistens funktioniert alles problemlos, und der Zugang ist kostenlos.
Ich bin seiner Empfehlung gefolgt, und kann das, Stand heute, bestätigen.
7) Notiert euch den Benutzernamen und das Passwort des Zugang zum MQTT Broker.
Nun müsst ihr noch ein Topic für ausgehende Daten des Twizy o´meter erstellen, etwa "TwizyometerOut".
Fabio empfiehlt einen individuellen Topicnamen zu wählen, damit es nicht zu Konflikten kommt, falls sich mehrere Twizy o´meter Nutzer beim selben MQTT Broker anmelden.
Notiert euch ebenso den MQTT TCP Port (normalerweise 1883)
Ein Topic für eingehende Daten ist derzeit nicht zwingend erforderlich, da das Twizy o´meter noch keine Daten empfängt.
8) Nun das Twizy o´meter einschalten und auf die Einstellungsseite "MQTT" wechseln.
9) Dort alle Felder ausfüllen:
Im Falle von Maqiatto lautet die Broker-Adresse maqiatto.com, der Port 1883.
User, Passwort und Out Topic entnehmt ihr euren Notizen.
Hinweis: Beim kostenlosen Maqiatto-Zugang muss das OUT TOPIC aus Benutzername, Slash und dem eigentlichen Namen des Out Topic gebildet werden.
Also z.B.: erika.mustermann@gmx.de/TwizyometerOut
ClientID ist ein frei wählbarer Name und die Frequenz könnt ihr auf 5000 belassen.
Der Schieberegler für "Publish" muss "ON" sein, "Subscribe" kann "OFF" bleiben.
10) Beim Verlassen der Seite werden die Eingaben gespeichert.
11) Dass die Wifi Einstellungen zuvor bereits erfolgreich durchgeführt wurden, ist natürlich Vorraussetzung dass die Verbindung zum MQTT Broker funktioniert!
Dort sollte nicht nur mindestens eine SSID inklusive zughörigem WLAN-Schlüssel korrekt eingetragen sein, sondern mindestens der Schieberegler "ON CHARGE" eingeschaltet sein.
Bis alles korrekt eingerichtet ist, empfehle ich zusätzlich den Schieberegler "ON DRIVE" einzuschalten.
Wenn ihr alles richtig gemacht habt, dann sollte auf der MQTT Einstellungsseite zeitnah der Status auf "CONNECTED" wechseln.
12) Nun könnt ihr die App starten und dort auf die Einstellungsseite wechseln.
Dort ist eigentlich alles vergleichbar, ausser dass OUT TOPIC des Twizy o´meter nun in der App beim "Topic In" eingetragen werden muss.
Nur noch "SAVE" und "CONNECT Mqtt" klicken und die Verbindung zum MQTT Broker sollte zügig hergestellt werden.
Nach verlassen der Einstellungsseite mit "<<" sollte die App die ersten Daten vom Twizy o´meter präsentieren.

Gratulation!

Moin Zusammen,

euch zunächst erst einmal einen schönen 4. Advent !

Ich war mal eben so frei und habe die Anleitung von Martin (Snorre) für das Update des Display und der Blackbox in eine Datei zusammen getragen, weil ich mit einem Laptop irgendann in die Garage gehen werde (mit dem nächsten Firmware-Update) und somit alles quasi dort zusammen habe.
Danke an Martin !

Die Datei möchte ich euch natürlich nicht vorenthalten und seht es mir nach, wenn ich irgendetwas nicht ganz richtig kopiert habe...

LG Tom

Moin together,

you first of all a happy 4th Advent !

I was just so free and have the instructions of Martin (Snorre) for the update of the display and the black box in a file together, because I will go with a laptop sometime in the garage (with the next firmware update) and thus have everything quasi together there.
Thanks to Martin !

Of course I don't want to withhold the file from you and please forgive me if I didn't copy anything quite right...

LG Tom

Translated with www.DeepL.com/Translator (free version)

Ich habe inzwischen in enger Zusammenarbeit mit Fabio, unzählige neuere Versionen der Firmware installiert und getestet.
Das erste Mal ist am schwierigsten, danach verliert das seinen Schrecken.
Eine Sache hatte ich oben nicht erwähnt, da ich sie erst zu einem späteren Zeitpunkt zur Kenntnis bekommen habe:
Bitte unbedingt sofort nach dem Update der LCD-Firmware die microSD-Karte aus dem LCD entfernen.
Wird das vergessen, dann wird beim nächsten Einschalten des Twizy o`meter das Update erneut gestartet.
Nur dann läuft es nicht vollständig durch.
Das ist mir 2x passiert, und danach hatte ich ein paar Probleme das Display wieder in Gang zu bekommen.
Was letztlich der entscheidende Trick war, da bin ich gar nicht dahinter gekommen.
Ansonsten ist es relativ einfach.

Moin Zusammen,
leider muss ich durch die Schusseligkeit der deutschen Post auf min Twiz o´meter etwas länger warten. Der Briefträger hatte entweder den Infozettel, das ein Paket aus Italien angekommen war, nicht in meinen Briefkasten geschmissen...oder aber, was lt. der Frau in der Postfilale lt. ihrer Anzeige im PC abzulesen war, war das Paket nur bis ins letzte Verteilerzentrum gebracht worden. Dort dümpelte es vor sich hin um dan nach einer Woche nach Italien zurück gesendet zu werden. Seis drum...ich hab seither fleißig mitgelesen und hab immer mehr einen wässrigen Mund bekommen...freu mich irre auf das Paket (UPS solls nun endlich bringen). Was mir dabei immer wieder aufgefallen ist: wie geil Ihr alle seid!!! Mit welcher Hingabe Fabio sich mit Eifer an diese Projekt gewagt hat, die tollen Unterstützer aus dem Forum geholfen haben ein wohl eh geiles Teil noch genialer zu machen: WOW...ihr seit Klasse !!!!
Ich freu mich das es noch solche Menschen wie Euch gibt, ob Twiz o meter, Zusatzlager, Motorwelle, Workshop, TC und der ganze Rest was dies Forum wirklich EINZIGARTIG macht...das musste ich mal loswerden und DANKE sagen!
Grüßle
Kangoo

I read that firmware 1.4 will be installed on the units made this year, will it be available for us to update soon?

Of course.
By this evining I'll share the user manual , the video preview and the new 1.4 fw
So, stay tuned.