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/29 15:45] – [Version, Status und Node-Images] akuhtz | 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 sollten die Hersteller Id (VID), | + | * 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 110: | Zeile 153: | ||
- | ===== Default-Labels | + | ===== Update Only ===== |
- | Die Default-Labels können im '' | + | 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 ===== | ||
- | < | + | < |
< | < | ||
... | ... | ||
Zeile 121: | Zeile 171: | ||
<!-- other parts --> | <!-- other parts --> | ||
... | ... | ||
- | <DefaultLabels> | + | <Changelog>changelog.json</Changelog> |
- | < | + | |
- | < | + | |
- | | + | |
- | | + | |
</ | </ | ||
</ | </ | ||
</ | </ | ||
- | :!: Alle referenzierten Dateien wie die // | + | :!: 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 ==== | + | ===== 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 204: | 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.1585489500.txt.gz · Zuletzt geändert: 2020/03/29 15:45 von akuhtz