Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- wizard:firmware-update-definition [2016/12/31 16:26] – [XML-Struktur einer Firmware-Update-Definition] akuhtz
+++ wizard:firmware-update-definition [2019/11/24 15:09] – [Version, Status und Node-Images] akuhtz
@@ Zeile 24: / Zeile 24: @@
 </code>
-Im <FirmwareDefinition>-Tag wird die Struktur der Firmware angegeben. Dabei werden unterschiedliche Node-Typen unterstützt:
+Im ''<FirmwareDefinition>''-Tag wird die Struktur der Firmware angegeben. Dabei werden unterschiedliche Node-Typen unterstützt:
   * DeviceNode: Äusserer Node-Typ der die Firmware-Files eines Node zusammenfasst. Hier //können// VID und PID sowie ein Kommentar angegeben werden.
   * FirmwareNode: Node-Typ der ein Firmware-File (hex) definiert. Hier muss die Destination des Hex-File, der Text sowie der Filename des HEX-File innerhalb des Archiv (Zip-File) angegeben werden.
   * 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 <FirmwareDefinition>-Tag:
+Das nachfolgende Beispiel zeigt eine minimale Definition des ''<FirmwareDefinition>''-Tag:
 <code xml>
    <FirmwareDefinition>
@@ Zeile 43: / Zeile 43: @@
 </code>
-Mit dem Attribute "DestinationNumber" wird der Zielspeicherbereich auf dem Knoten festgelegt ( 0 = Flash, 1 = EEPROM.). Details dazu sind auf [[http://www.bidib.org/protokoll/bidib_fw_update.html#T443|bidib.org]] zu finden.\\
+Mit dem Attribute ''DestinationNumber'' wird der Zielspeicherbereich auf dem Knoten festgelegt ( 0 = Flash, 1 = EEPROM.). Details dazu sind auf [[http://www.bidib.org/protokoll/bidib_fw_update.html#T443|bidib.org]] zu finden.\\
 \\
 Es besteht auch die Möglichkeit eine CV-Defintions anzugeben, welche dann im //firmware.zip// mitgeliefert werden muss:
@@ Zeile 76: / Zeile 76: @@
       </Node>
       <CvFilename>BiDiBCV-13-201.xml</CvFilename>
+   </FirmwareDefinition>
+</code>
+===== Version, Status und Node-Images =====
+Ab dem Wizard-1.12.2 werden die ''<FirmwareDefinition>'' in den CV-Dateien mit den Attributen ''Version'' und ''Status'' versehen importiert. Wenn ''Version'' angegeben ist, wird auf das Parsen der Filenamen zur Ermittlung der Version verzichtet. //Optional// können noch die Protokollversion ''ProtocolVersion'' sowie die aktuelle minimal Version ''RequiredMinVersion'' angegeben werden.
+Als weitere Änderung muss der ''CvFilename'' jetzt unter dem ''DeviceNode'' angegeben werden.
+Neu besteht auch die Möglichkeit ein Bild der Baugruppe im Firmware-ZIP mitzuliefern. Dazu muss das Element ''NodeImages'' wie im Beispiel unten angegeben werden.
+<code xml>
+   <Version Version="0.1" Lastupdate="20190920" Author="BiDiB.org" Pid="132" Vendor="013"
+      Description="Firmware Definition for IF-2"/>
+   <FirmwareDefinition Version="2.06.00" Status="beta" ProtocolVersion="0.7" RequiredMinVersion="2.01.00" >
+      <Node xsi:type="DeviceNode" Comment="BiDiB-IF2" VID="013" PID="132">
+         <Nodetext Lang="de-DE" Text="Beispiel Firmware"/>
+         <Nodetext Lang="en-EN" Text="Sample Firmware"/>
+         <Node xsi:type="FirmwareNode" DestinationNumber="0" >
+         ...
+         </Node>
+         ...
+         <CvFilename>BiDiBCV-13-132.xml</CvFilename>
+         <NodeImages>
+             <Image>bidib-13-132.png</Image>
+         </NodeImages>
+      </Node>
    </FirmwareDefinition>
 </code>
@@ Zeile 104: / Zeile 132: @@
    <Version Version="0.1" Lastupdate="20140411" Author="BiDiB.org" Pid="201" Vendor="013"
       Description="Firmware Definition for StepControl !!!Minimum-Beispiel!!!"/>
-   <FirmwareDefinition>
+   <FirmwareDefinition Version="1.04.00" Status="stable" ProtocolVersion="0.7" RequiredMinVersion="1.01.00">
       <Node xsi:type="DeviceNode" VID="013" PID="201" >
          <Nodetext Lang="de-DE" Text="StepControl: Komplette Installation"/>