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 [2016/12/31 16:26] – [XML-Struktur einer Firmware-Update-Definition] akuhtz | wizard:firmware-update-definition [2023/12/04 21:14] (aktuell) – [Firmware-Repo] akuhtz | ||
---|---|---|---|
Zeile 24: | Zeile 24: | ||
</ | </ | ||
- | Im < | + | Im '' |
- | * DeviceNode: Äusserer Node-Typ der die Firmware-Files eines Node zusammenfasst. Hier //können// VID und PID sowie ein Kommentar angegeben werden. | + | * 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. | ||
- | Das nachfolgende Beispiel zeigt eine minimale Definition des < | + | Das nachfolgende Beispiel zeigt eine minimale Definition des '' |
<code xml> | <code xml> | ||
< | < | ||
- | <Node xsi: | + | <Node xsi: |
< | < | ||
< | < | ||
Zeile 43: | Zeile 47: | ||
</ | </ | ||
- | Mit dem Attribute | + | Mit dem Attribute |
\\ | \\ | ||
- | Es besteht auch die Möglichkeit eine CV-Defintions | + | |
+ | ===== CV-Definitionsdatei ===== | ||
+ | |||
+ | Es besteht auch die Möglichkeit eine CV-Definition | ||
<code xml> | <code xml> | ||
< | < | ||
- | <Node xsi: | + | <Node xsi: |
< | < | ||
< | < | ||
Zeile 55: | Zeile 62: | ||
</ | </ | ||
... | ... | ||
+ | < | ||
</ | </ | ||
- | < | ||
</ | </ | ||
</ | </ | ||
Zeile 67: | Zeile 74: | ||
Description=" | Description=" | ||
< | < | ||
- | <Node xsi: | + | <Node xsi: |
< | < | ||
< | < | ||
Zeile 74: | Zeile 81: | ||
</ | </ | ||
... | ... | ||
+ | < | ||
</ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | ===== Default-Labels ===== | ||
+ | |||
+ | Die Default-Labels können im '' | ||
+ | |||
+ | <code xml> | ||
+ | < | ||
+ | ... | ||
+ | < | ||
+ | ... | ||
+ | <!-- other parts --> | ||
< | < | ||
+ | | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | | ||
</ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | :!: Alle referenzierten Dateien wie die // | ||
+ | |||
+ | ===== Version, Status und Node-Images ===== | ||
+ | |||
+ | Ab dem Wizard-1.12.2 werden die ''< | ||
+ | |||
+ | Folgende Werte sind als '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | Als weitere Änderung muss der '' | ||
+ | |||
+ | Neu besteht auch die Möglichkeit ein Bild der Baugruppe im Firmware-ZIP mitzuliefern. Dazu muss das Element '' | ||
+ | |||
+ | <code xml> | ||
+ | < | ||
+ | Description=" | ||
+ | |||
+ | < | ||
+ | <Node xsi: | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | ... | ||
+ | </ | ||
+ | ... | ||
+ | < | ||
+ | < | ||
+ | |||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | | ||
+ | |||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | :!: Alle referenzierten Dateien wie // | ||
+ | |||
+ | |||
+ | ===== 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 ==== | + | ===== 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 104: | Zeile 225: | ||
< | < | ||
Description=" | Description=" | ||
- | < | + | < |
- | <Node xsi: | + | <Node xsi: |
< | < | ||
< | < | ||
Zeile 138: | Zeile 259: | ||
</ | </ | ||
</ | </ | ||
- | <Node xsi: | + | <Node xsi: |
< | < | ||
< | < | ||
Zeile 151: | 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.1483197981.txt.gz · Zuletzt geändert: 2016/12/31 16:26 von akuhtz