Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- wizard:firmware-update-definition [2021/01/17 11:39] – [Firmware-Repo] akuhtz
+++ wizard:firmware-update-definition [2023/12/04 21:14] (aktuell) – [Firmware-Repo] akuhtz
@@ Zeile 85: / Zeile 85: @@
    </FirmwareDefinition>
 </code>
+===== Default-Labels =====
+Die Default-Labels können im ''firmware.xml'' angegeben werden. Sie müssen an der letzten Stelle der Daten innerhalb der ''FirmwareDefinition'' eingefügt werden. Beim Laden des Firmware-Archiv erscheint dann im Wizard der Hinweis, ob die Default-Labels importiert werden sollen.
+<code xml>
+<Firmware ...>
+   ...
+   <FirmwareDefinition Version="2.06.00" Status="beta" ProtocolVersion="0.7" RequiredMinVersion="2.01.00" >
+      ...
+      <!-- other parts -->
+      <CvFilename>BiDiBCV-13-201.xml</CvFilename>
+      <DefaultLabels>
+         <DefaultLabelsFile Lang="de-DE" Filename="bidib-default-names-13-138-de.xml" />
+         <DefaultLabelsFile Lang="en-EN" Filename="bidib-default-names-13-138-en.xml" />
+      </DefaultLabels>
+   </FirmwareDefinition>
+</Firmware>
+</code>
+:!: Alle referenzierten Dateien wie die //DefaultLabelsFile//s müssen im Firmware-ZIP enthalten sein.
 ===== Version, Status und Node-Images =====
@@ Zeile 111: / Zeile 134: @@
          </Node>
          ...
+         <!--
          <CvFilename>BiDiBCV-13-132.xml</CvFilename>
+         <DefaultLabels>
+             <DefaultLabelsFile Lang="de-DE" Filename="bidib-default-names-13-138-de.xml" />
+             <DefaultLabelsFile Lang="en-EN" Filename="bidib-default-names-13-138-en.xml" />
+         </DefaultLabels>
+         -->
          <NodeImages>
              <Image>bidib-13-132.png</Image>
@@ Zeile 122: / Zeile 153: @@
-===== Default-Labels =====
+===== Update Only =====
-Die Default-Labels können im ''firmware.xml'' angegeben werden. Sie müssen an der letzten Stelle der Daten innerhalb der ''FirmwareDefinition'' eingefügt werden. Beim Laden des Firmware-Archiv erscheint dann im Wizard der Hinweis, ob die Default-Labels importiert werden sollen.
+Um mit einem FW-Update nur die Firmware ohne Löschen der Einstellungen (Port-Konfiguration, Makros, etc.) zu aktualisieren, wird oft die "Update Only" Option angeboten.
+In einem solchen Fall wird das Attribut ''IsUpdate="true"'' verwendet, wodurch die Tools erkennen, dass es sich um eine "Update Only" Option handelt.
+<code xml>
+<Node xsi:type="DeviceNode" Comment="BiDiB-IF2 UPDATE" IsUpdate="true" VID="013" PID="132" EVID="258">
+</code>
+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>
@@ Zeile 133: / Zeile 171: @@
       <!-- other parts -->
       ...
-      <DefaultLabels>
+      <Changelog>changelog.json</Changelog>
-         <DefaultLabelsFile Lang="de-DE" Filename="bidib-default-names-13-138-de.xml" />
-         <DefaultLabelsFile Lang="en-EN" Filename="bidib-default-names-13-138-en.xml" />
-      </DefaultLabels>
    </FirmwareDefinition>
 </Firmware>
 </code>
-:!: Alle referenzierten Dateien wie die //DefaultLabelsFile//s müssen im Firmware-ZIP enthalten sein.
+:!: Die refenrenzierte json Datei muss Firmware-ZIP enthalten sein.
+Die json Datei muss dabei dem folgenden Schema entsprechen.
+<code json>
+{
+	"product": "",
+	"owner": "",
+	"versions": [
+		{
+			"version": "1.04.05",
+			"releaseDate": "20210630",
+			"changelog": [
+				{
+					"lang": "de",
+					"description": "..."
+				},
+				... weitere Übersetzungen
+			]
+		},
+		... weitere Versionen
+	]
+}
+</code>
-==== 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.
@@ Zeile 221: / Zeile 277: @@
 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 ''bidib.org'' Server kopiert.
-Dieses json-Dokument ([[http://bidib.org/node_firmware/repository.json|http://bidib.org/node_firmware/repository.json]]) kann heruntergeladen werden und wird z.B. auch vom BiDiB-Monitor verwendet um die Firmware-Daten im Knoten-Firmware-Repository anzuzeigen.
+Dieses json-Dokument ([[https://repository.bidib.org/repository.json|https://repository.bidib.org/repository.json]]) kann heruntergeladen werden und wird z.B. auch vom BiDiB-Monitor verwendet um die Firmware-Daten im Knoten-Firmware-Repository anzuzeigen.
 === Neue Firmware hinzufügen ===