Firmware file format (.gdf) - Revision history

Tero K: /* GDF version 400 - draft */

2018-10-11T11:34:54Z

‎GDF version 400 - draft

Tero K: /* GDF version 400 - draft */

2018-10-09T21:09:52Z

‎GDF version 400 - draft

Tero K: /* Header */

2018-10-09T21:09:31Z

‎Header

Tero K: /* Header */

2018-10-09T21:08:37Z

‎Header

Tero K: /* GDF version 400 - draft */

2018-10-09T13:30:19Z

‎GDF version 400 - draft

Tero K: /* GDF version 400 - draft */

2018-10-09T13:30:02Z

‎GDF version 400 - draft

Tero K: /* GDF version 310 - draft */

2018-10-09T13:24:21Z

‎GDF version 310 - draft

Tero K at 12:01, 9 June 2017

2017-06-09T12:01:43Z

Tero K: /* Header */

2017-03-29T13:14:27Z

‎Header

Tero K at 13:13, 29 March 2017

2017-03-29T13:13:57Z

@@ Line 29: / Line 29: @@
           * ----------------------
+          *
-          * Note: GDF v400 is not limited to firmware files any more,
+          * Note: GDF v400 is not limited to firmware files any more,"
           * it can be used as general purpose data container for up to 4GB data chunks.
+          *
@@ Line 40: / Line 40: @@
           * 2	GDF version = 400
           * 2	GDF backwards compatible version = 400
           * 4	number of data chunks in file = N
+          *
@@ Line 52: / Line 53: @@
+          *
           * 4	file's CRC-32
-          */
-</pre>
-−
-<pre>
-        /*
           * data chunk types
           * ----------------
@@ Line 68: / Line 65: @@
           * 7=disclaimer, UTF8
           * 8=circulation, UTF8 (i.e. customer name)
-          * 20=unix timestamp, S=4
+          * 20=unix timestamp divided by 4, S=4
-          * 50=target device type ID and mask, S=8
+          * 50=target device type ID range, S=8
-          *   first 4 bytes are target device ID, i.e. 11000=IONI
+          *   first 4 bytes are lowest supported target device ID, i.e. 11000=IONI
-          *   second 4 bytes are mask/divider for type comparison, must be >0
+          *   second 4 bytes are highest supported target device ID's, i.e. 11200=IONI PRO HC
-         *   file is compatible if following eq is true: floor(readID/divider) == floor(targetID/divider)
           * 100=main MCU FW binary, S=any
-          * 101=main MCU FW unique identifier number, S=4
+          * 101=main MCU FW unique identifier number (this value is also readable from target device over SM bus), S=4
           * 102=main MCU FW required HW feature bits, S=4
           *     helps to determine whether FW works on target
@@ Line 88: / Line 84: @@
           * bits 1-31: reserved
+          *
-          */
+          */</pre>
 </pre>
 For practical reading software implementation, see devicedeployment.c from SimpleMotion library.

@@ Line 53: / Line 53: @@
           * 4	file's CRC-32
           */
-</pre><pre>
+</pre>
          /*
           * data chunk types

@@ Line 52: / Line 52: @@
+          *
           * 4	file's CRC-32
+          */
           * data chunk types
           * ----------------

@@ Line 28: / Line 28: @@
          /* GDF version 400 format
           * ----------------------
+          *
           * Binary file contents
@@ Line 37: / Line 40: @@
           * 2	GDF version = 400
           * 2	GDF backwards compatible version = 400
           * 4	number of data chunks in file = N
+          *
           * repeat N times:
           * 4	data chunk type
           * 4	data chunk option bits
@@ Line 55: / Line 59: @@
           * 2=firmware version string, UTF8
           * 3=remarks, UTF8
           * 100=main MCU FW binary, S=any
           * 101=main MCU FW unique identifier number, S=4
           * 200=secondary MCU FW binary, S=any
+          *
@@ Line 64: / Line 82: @@
           * ----------------------
           * bit 0: if 1, GDF loading application must support/understand the chunk type to use this file
+          *
           */

@@ Line 59: / Line 59: @@
           * 200=secondary MCU FW binary, S=any
+          *
-          * note: firmware may contain any many combinations of above chunks. in basic case, it contains just chunk type 100 and nothing else.
+          * note: firmware may contain many combinations of above chunks. in basic case, it contains just chunk type 100 and nothing else.
+          *
           * data chunk option bits

@@ Line 22: / Line 22: @@
-==GDF version 310 - draft==
+==GDF version 400 - draft==
 ===Header===
-IDString - 4 bytes, always="GDFW"
+Version 400 described below:
-BLFileVersion - 2 bytes, value=310
+For practical reading software implementation, see devicedeployment.c from SimpleMotion library.
-−
-TargetDriveType - 2 bytes, Argon=4000, Ion=11000, Atomi=14000
-−
-HostFWbytes - 4 bytes, number of bytes for STM32 CPU
-−
-GCFWbytes - 4 bytes, number of bytes for GraniteCore CPU or 0xffffffff if not included
-−
-BLBackwardsCompatibilityVersion - 2 bytes. Value indicates if file is backwards comaptible with older versions (i.e. BLFileVersion may be >310 but if BLBackwardsCompatibilityVersion==310, then software supporting only up to 310 will be able to use this file)
-−
-AdditionalHeaderVariabalesAmount - 4 bytes, number of following structures in the header
-−
-''Following items are optional - following ValueID & Value pairs repeats AdditionalHeaderVariabalesAmount  times''
-−
-ValueID - 2 bytes, specifies type of data
-−
-Value - 4 bytes
-−
-''List of currently supported ValueIDs''
-* ValueID=100: Value contains unique binary file ID used by SimpleMotion deployment tool API
-−
-===Data===
-Data of HostFW begins. Amount of bytes is HostFWbytes
-−
-Data of GCFW begins. Amount of bytes is GCFWbytes
-−
-===File checksum===
-FileCksum - 4 bytes calculated from the current file. Simply sum of all unsigned bytes in file except CKSum itself
 [[Category:Development]]
 [[Category:Development]]

@@ Line 1: / Line 1: @@
-Argon firmware file contains embedded software for [[Argon (servo drive)]]. Firmware file is generated by makefirmware utily.
+GD motor drive firmware file format with file extension .gdf contains embedded software for most of devices based on {{G2.0}} and later. Firmware file is generated by makefirmware utily.
 ==File format byte by byte==
 All multibyte integers are stored LSB first.
@@ Line 7: / Line 7: @@
 BLFileVersion - 2 bytes, current=300
-TargetDriveType - 2 bytes, Argon=4000, Ion=5000
+TargetDriveType - 2 bytes, Argon=4000, Ion=14000, Atomi=14000
 HostFWbytes - 4 bytes, number of bytes for STM32 CPU