Flash page from 0xFE00 to 0xFFFF address containing information about the firmware version and name

Using the EOPX2 postbuild tool with the command setVersion this information is copied into the hex file. The information is very useful to determine which firmware is currently running on the HW module once the module is installed in the field. The information can also be queried through the air using the Remote Management (see Remote Management specification in References).

To use this feature, each application should have an array saved in FLASH with the following format:

code uint8 VERSION_APP[] = {0xE0,'V','E','R','S','I','O','N',VER_MAJOR,VER_MINOR,VER_MICRO,VER_BUILD,'A','T','C','M','3','0',....,'0',0x00,0xE0};

Where:

0xE0,'V','E','R','S','I','O','N' - characters identifying the version information in the hex file

VER_MAJOR,VER_MINOR,VER_MICRO,VER_BUILD - the application version defines

'A','T','C','M','3','0',....,'0' - 'A' is defining the application and the rest characters are the description of the firmware

A post-build script run after compiling your project in Keil project takes cares of storing the version information in the right place within SWI area. Be sure that your Keil project includes a postbuild.txt file with at least the following text.

setVersion

Check the section Post-buildTools for correct postbuild script set up

Example:

//This array stores the version <b>1.2.0.0</b> of the <b>My App</b> application in FLASH.
//EOPX2.exe will parse this info from *.hex and burn to the CFG area.
code uint8 VERSION_APP[] = {0xE0,'V','E','R','S','I','O','N',
                                                        1,2,0,0,                                  // change APP Version here
                                                        'A',
                                                        'M','y',' ','A','p','p',                  // change APP Description here (max. 15 chars)
                                                        0x00,0xE0};

Note:: The array has to begin always with 0xE0,'V','E','R','S','I','O','N', the description has to begin with 'A' and the whole array has to be finished with 0x00, 0xE0. Between the version number and application description the character 'A' has to be defined.

The API library version is also stored by the postbuild script in the correct adress within MOD area.