wizard:firmware-update-definition
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
wizard:firmware-update-definition [2020/03/22 13:34] – ergängzung evid RS200 | wizard:firmware-update-definition [2023/12/04 21:14] (aktuell) – [Firmware-Repo] akuhtz | ||
---|---|---|---|
Zeile 25: | Zeile 25: | ||
Im ''< | Im ''< | ||
- | * DeviceNode: Äusserer Node-Typ der die Firmware-Files eines Node zusammenfasst. Hier // | + | * DeviceNode: Äusserer Node-Typ der die Firmware-Files eines Node zusammenfasst. Hier sollten |
+ | * die Hersteller Id ('' | ||
+ | * die erweiterte Hersteller Id ('' | ||
+ | * die Produkt Id ('' | ||
+ | * ein Kommentar angegeben werden. | ||
* FirmwareNode: | * FirmwareNode: | ||
* SimpleNode: Dieser Node-Typ kann verwendet werden um eine oder mehrere zusätzliche Abstraktions-Ebenen zu definieren. | * SimpleNode: Dieser Node-Typ kann verwendet werden um eine oder mehrere zusätzliche Abstraktions-Ebenen zu definieren. | ||
Zeile 45: | Zeile 49: | ||
Mit dem Attribute '' | Mit dem Attribute '' | ||
\\ | \\ | ||
+ | |||
+ | ===== CV-Definitionsdatei ===== | ||
+ | |||
Es besteht auch die Möglichkeit eine CV-Definition anzugeben, welche dann im // | Es besteht auch die Möglichkeit eine CV-Definition anzugeben, welche dann im // | ||
<code xml> | <code xml> | ||
Zeile 78: | Zeile 85: | ||
</ | </ | ||
</ | </ | ||
+ | |||
+ | ===== Default-Labels ===== | ||
+ | |||
+ | Die Default-Labels können im '' | ||
+ | |||
+ | <code xml> | ||
+ | < | ||
+ | ... | ||
+ | < | ||
+ | ... | ||
+ | <!-- other parts --> | ||
+ | < | ||
+ | | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | :!: Alle referenzierten Dateien wie die // | ||
===== Version, Status und Node-Images ===== | ===== Version, Status und Node-Images ===== | ||
Ab dem Wizard-1.12.2 werden die ''< | Ab dem Wizard-1.12.2 werden die ''< | ||
+ | |||
+ | Folgende Werte sind als '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
Als weitere Änderung muss der '' | Als weitere Änderung muss der '' | ||
Zeile 99: | Zeile 134: | ||
</ | </ | ||
... | ... | ||
+ | < | ||
< | < | ||
+ | |||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | | ||
+ | |||
< | < | ||
< | < | ||
Zeile 109: | Zeile 152: | ||
:!: Alle referenzierten Dateien wie // | :!: Alle referenzierten Dateien wie // | ||
- | ==== Darstellung im Wizard ==== | + | |
+ | ===== Update Only ===== | ||
+ | |||
+ | Um mit einem FW-Update nur die Firmware ohne Löschen der Einstellungen (Port-Konfiguration, | ||
+ | In einem solchen Fall wird das Attribut '' | ||
+ | <code xml> | ||
+ | <Node xsi: | ||
+ | </ | ||
+ | In diesem Fall prüfen die Tools, ob die gleiche ProduktID und Major-Version verwendet wird, bevor diese Option im Firmware-Update-Dialog angeboten wird. | ||
+ | |||
+ | ===== Changelog Informationen ===== | ||
+ | |||
+ | <code xml> | ||
+ | < | ||
+ | ... | ||
+ | < | ||
+ | ... | ||
+ | <!-- other parts --> | ||
+ | ... | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | :!: Die refenrenzierte json Datei muss Firmware-ZIP enthalten sein. | ||
+ | |||
+ | Die json Datei muss dabei dem folgenden Schema entsprechen. | ||
+ | <code json> | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | ... weitere Übersetzungen | ||
+ | ] | ||
+ | }, | ||
+ | ... weitere Versionen | ||
+ | ] | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | ===== Darstellung im Wizard | ||
Nach der Auswahl des Zip-File wird die Struktur im Wizard analysiert und in einem Tree angezeigt. Der Benutzer kann anschliessend die Firmware-Pakete auswählen welche übertragen werden sollen. | Nach der Auswahl des Zip-File wird die Struktur im Wizard analysiert und in einem Tree angezeigt. Der Benutzer kann anschliessend die Firmware-Pakete auswählen welche übertragen werden sollen. | ||
Zeile 181: | Zeile 272: | ||
</ | </ | ||
+ | ==== Firmware-Repo ==== | ||
+ | |||
+ | Firmware-Pakete im ZIP-Format (mit firmware.xml) können im Firmware-Repo auf github comitted und gepushed werden. Nach einem neuen Commit läuft ein Job im Gitlab-Repository welches das Firmware-Paket scanned (auf Vorhandensein des firmware.xml) und die Meta-Daten (PID, VID, EVID, Version, Name, etc.) aus dem firmware.xml ausliest. | ||
+ | Mit diesen Meta-Daten wird dann ein json-Dokument erzeugt, welches den aktuellen Stand im Firmware-Repo beinhaltet. Anschliessend wird das json-Dokument und alle geänderten Firmware-Pakete auf den '' | ||
+ | |||
+ | Dieses json-Dokument ([[https:// | ||
+ | |||
+ | === Neue Firmware hinzufügen === | ||
+ | |||
+ | Um ein neues Firmware-Paket hinzuzufügen, | ||
+ | Die Unterordner sind anhand der '' | ||
+ | |||
+ | Nach Commit und Push läuft der Job im Gitlab-Repo. | ||
+ | |||
+ | === Bestehende Firmware überschreiben === | ||
+ | |||
+ | Um ein bestehendes Firmware-Paket zu überschreiben kann man das neue Firmware-Paket einfach über das alte kopieren. Bei Merge-Konflikten einfach die Änderungen des neuen Firmware-Paket übernehmen.\\ | ||
+ | Es ist nicht notwendig das alte Firmware-Paket zuerst zu löschen. | ||
+ | Nach Commit und Push läuft der Job im Gitlab-Repo. |
wizard/firmware-update-definition.1584880478.txt.gz · Zuletzt geändert: 2020/03/22 13:34 von RS200