Inhaltsverzeichnis
Cardecoder
oder wer fährt da mein Auto? Ein kleiner Mikrocontroller versorgt mit digitalen Steuersignalen welche per Funk Basis an ihn übertragen werden. Unsere Cardecoder sind vom Anfang bis zum Ende ein Kompromiss aus Nutzen, Notwendigkeit, Baugröße, Kosten und gewünschten Funktionen und nichts ist dabei perfekt. Die Summe all dieser Kompromisse ist der Cardecoder V3. Er ist der erste im Fichtelbahn - Shop erhältliche SMD vorbestückte Cardecoder.
Der Cardecoder ist also der Empfänger und die zentrale Steuereinheit (der Computer) im Fahrzeug. Der empfängt und dekodiert ein digitales Steuersignal und steuert damit selbst den Fahrmotor und die LED Beleuchtung. Für all diese Funktionen ist die Firmware (die Software des Cardecoder - Mikrocontroller) zuständig. Diese gibt es in zwischen in unterschiedlichen Versionen, für unterschiedliche Cardecoder-Konfigurationen, mit unterschiedlichen Funktionsumfang.
Cardecoder V3 als Fahrzeugdecoder
Cardecoder V3 als Anhängerdecoder (Trailer)
Cardecoder V3 Versionsübersicht
| Bezeichnung | Firmware Variante | Beschreibung |
|---|---|---|
| car_V3 | < V03.xx.xx | normaler Cardecoder in der ersten Auslieferungsversion |
| car_V3_trailer | < V03.xx.xx | Anhängerdecoder in der ersten Auslieferungsversion |
| car_V3_m328 | ab V03.xx.xx | normaler Cardecoder neue bidirektionale Version |
| car_v3_sound_m328 | ab V03.xx.xx | Cardecoder Anschluss für Sound und LED Port Erweiterung, bidirektionale Version |
| trailer_v3_m328 | ab V03.xx.xx | Anhängerdecoder zu den bidirektionalen Cardecoder Versionen |
Die fertigen Firmware Dateien stellt der Entwickler unter den Bedingungen der GPLv3 (General Public License) allen kostenfrei zur Verfügung.
Cardecoder V3 Firmwareübersicht
| Firmware | Datum | Beschreibung |
|---|---|---|
| V210 | 2013.10.08 | erste öffentliche Variante Cardecoder V2 |
| V214 | 2014.03.14 | freie Funktionszuordnung für AUX5-10 zu F5-F12 |
| V215 | 2014.04.24 | ASR Fahrspuren Betrieb ergänzt, Anhängerbetrieb ergänzt |
| V218 | 2014.06.01 | Option „Power off“ Licht_5 startet mit +UB |
| V220 | 2014.06.14 | Start Cardecoder V3 |
| V221 | 2014.07.05 | Lastreglung ergänzt, HD_ID ergänzt |
| V022 | 2015.01.27 | Versionsnummer um eine Stelle nach rechts verschoben, Twin Stoppstelle (bremsen + stopp) neu |
| V023 | 2015.02.08 | Bug bei 7 Fahrspuren beseitigt |
| V024 | 2016.01.13 | Auto-Update-Kabel Erkennung + 10ms Lastreglung |
| V025 | 2016.04.22 | RFM75 Unterstützung ergänzt |
| V03.20.12 | 2016.11.29 | erste öffentliche bidirektionale FW Version, Cardecoder „normal“ Hardware kompatibel zu allen Vorgänger Versionen und neu Cardecoder „sound“ zum Anschluss und Betrieb eines externen Sounddecoder mit 8 zusätzlichen LED Ausgängen |
| V03.21.01 | 2016.12.29 | Erweiterungsmodul kann in der Cardecoder „sound“ Firmware deaktiviert werden und Licht_1 dafür verwendet werden |
| V03.21.02 | 2017.01.01 | Firmware Bug beim Decoderinit eines Fabrikneuen Cardecoder beseitigt |
| V03.22.04 | 2017.06.13 | Firmware Bug bei IR Ansteuerung beseitigt, PID Regler Wertebereich optimiert |
| Firmware | Datum | Beschreibung |
|---|---|---|
| V002 | 2014.04.24 | erste öffentliche Variante der Anhänger Firmware |
| V03.01.03 | 2016.12.06 | erste öffentliche Version zur bidirektionalen Cardecoder Variante |
Cardecoder V3 FW Variante wechseln
Der Cardecoder V3 kann ab Software Version V03.xx.xx in drei unterschiedlichen „Hardware Anschluss Varianten“ genutzt werden.
Hinweis: hiermit ist nicht ein normales Software Update zur Fehlerbeseitigung bzw. zur Erweiterung um neue Funktionen gemeint!
Die Cardecoder-Firmware kann die Cardecoder-Hardware und so einzelne Anschlüsse, für unterschiedliche Aufgaben konfigurieren und nutzen. Diese Konfigurationen sind nicht immer kompatibel mit allen extern am Cardecoder angeschlossenen Peripherie Bauteilen. Damit es zu keiner Beschädigung kommen kann, überprüft der Cardecoder beim normalen Firmware Update die Firmware Variante und weigert sich eine nicht passende Version zu starten.
Will man als Anwender jetzt aber gezielt und bewusst einen Cardecoder in einer anderen Hardware Variante betreiben, muss man vor dem Programmieren der Firmware für diese neue Hardware Variante die Hardware ID im Cardecoder auf die neue Variante ändern.
Um dies dem Anwender möglichst einfach zu machen, gibt es für jede Hardware Variante eine Initialisierungsfirmware. Ein Wechsel auf eine andere Hardware Variante erfolgt dann immer gleich nach folgendem Aufbau:
| Cardecoder Variante alt | → | Initialisierungsfirmware für die neue Hardware Variante programmieren | → | Decoder mit der Initialisierungsfirmware einmal starten | → | Firmware für die neue Cardecoder Variante programmieren |
|---|
Folgend die Links zu den Initialisierungsfirmware Versionen:
- Cardecoder_V3_trailer → nur nötig bei Firmware vor V03.xx.xx
Hinweis: das Update einer älteren Cardecoder Firmware auf eine aktuelle bidirektionale Version V03.xx.xx erfolgt auch über den Zwischenschritt „Initialisierungsfirmware“.
Firmwareupdate auf V03.xx.xx im Detail
Mit der Firmware Version V03.xx.xx wird der Cardecoder (und das gesamte System) deutlich ertweitert und somit auch viel leistungsfähiger. Diese neuen Funktionen stellen wir, wie bei OpenDCC / OpenCar üblich auch den Anwendern älterer Baugruppen mit einem Firmware Update zur Verfügung.
Um dem Anwender das Update möglichst einfach zu machen, wurde die Update Prozedur noch einmal verbessert und vereinfacht. Dazu zählen:
- auf eine Update Paket Version mit einheitlicher Bezeichnung umgestellt (siehe unten)
- je eine Initialisierungsversion für die verschiedenen Hardware Varianten eingeführt
- das Update Kabel wird künftig automatisch erkennt, es muss nicht mehr per CV in den Update Modus umgeschaltet werden
Aufbau Update Paket
Die Firmware Pakete für den Cardecoder haben folgenden Aufbau:
| car_v3_m328.xx.xx.xx.000.acy |
|---|
| car_v3_m328_sound.xx.xx.xx.000.acy |
| trailer_v3_m328.xx.xx.xx.000.hex |
| car | Fahrzeug (angetrieben) |
| trailer | Anhänger |
| v3 | Version 3 |
| m328 | Prozessor ATmega328 |
| sound | mit Sounddecoder Anschluss |
| .xx.xx.xx | Firmware Versionsnummer |
| .000 | Kennzeichnung für Flashspeicher |
| acy | Datei Endung für AVRootloader Firmware Paket |
| hex | Datei Endung für ein hex File |
Hinweis: die Firmware wird als 7zip Archiv gepackt bereitgestellt. Sie besteht immer aus nur einer Datei, die im AVRootloader grundsätzlich unter „FLASH“ eingetragen wird. Dabei ist es unerheblich, ob dies ein Paket (Endung acy) oder eine Einzeldatei (Endung hex) ist.
Update Ablauf
Ein Update der Cardecoder Firmware mit einer Version vor V03.xx.xx, wird bei allen Cardecoder Hardware Varianten (ab Cardecoder V2), nach folgender Reihenfolge durchgeführt:
Hinweis: bei diesem Update werden alle Einstellungen im Fahrzeug zurückgesetzt!
- Cardecoder in den Bootloader Modus versetzen (CV55 oder CV32 auf 1 programmieren → Handbuch, bzw. Update Kabel stecken)
- AVRootloader starten und als „FLASH“ Datei die „Decoder Init Firmware“ passend zur künftigen Verwendung öffnen
- Verbindung zwischen Cardecoder und dem AVRootloader herstellen (AVRootloader auf „connect“ und Cardecoder einschalten) und die Init Firmware programmieren
- Verbindung trennen ca. 2 Sekunden warten bis die Fahrzeugbeleuchtung angeht → Decoder init ist fertig
- im AVRootloader jetzt als „FLASH“ Datei die neue Firmware Version (z.B. car_v3_m328.03.20.12.000.acy) auswählen
- Verbindung wieder herstellen und die neue Firmware programmieren → Update fertig
Jetzt hat man einen „Fabrikneuen“ Cardecoder und kann mit der Konfiguration (siehe Handbuch) fortfahren.
Hinweis: diese Update Reihenfolge ist nur bei einem Update von einer älteren Version (vor V03.xx.xx) oder bei einem Wechsel des Verwendungszweck (Hardware Variante) des Cardecoder nötig. Für ein normales Update ist später nur wieder Punkt 5 und 6 nötig.