Configuration File
- Kamil Możdżyński
The first startup of NXP-Flasher shows a window with default settings. After you adjust the settings to your needs and close the application, the settings will be saved in the configuration file. This allows retaining previous settings after restarting the application.
It is possible to save many more configuration files to the location you specify. It is possible to recreate a given configuration by loading a previously saved configuration.
Configuration File Export from GUI
The configuration file layout with the set values can be obtained by exporting the settings from the NXP-Flasher Windows GUI. To export a .cfg file, select “File-> Save Setup as..”.
“Save Setup” saves the settings to a default location
Configuration file content
The configuration file mainly contains parameters for commands sent to the MCU bootloader or Flashloader
The table below shows the list of parameters that are in the configuration file:
Parameter | Limitation/Range | GUI location | Description and GUI location | Usage |
|---|---|---|---|---|
Flashloader_FileName | supported files: .bin |  | Absolute path to Flashloader binary file | F_Load_Flashloader() |
Image_FileName | supported files: .bin, .s19, .sb | Absolute path to Image file | F_Write() | |
OTP_FileName | supported files: .json, .bin | Absolute path to fuse data file for OTP memory | F_OTP_Write() | |
MCU_name | supported families: RT10xx, RT11xx | Selected target microcontroller. Sets the default settings for: | F_Connect() | |
Target_EN | 0-255 where: Target 1 enable = 1 | Selection of target devices to be connected during actions in the GUI. |
| |
Interface | USB HID only | Host computer connection interface with target MCU. |
| |
OTP_WrAutoProgramEn | 0 or 1 | Allows OTP memory to be written during an autoprogram sequence. | includes F_OTP_Write() to F_Autoprogram() | |
OTP_LockAutoProgramEn | 0 or 1 | Allows MCU to be blocked at the end of an autoprogram sequence. | includes F_OTP_Lock() to F_Autoprogram() | |
Flashloader_Default_Setup | 0 or 1 | Flashloader settings relate to the load address, jump address, and binary file. This option means choosing between the settings: 1 - default 0 - user defined | F_Connect() | |
UserMemoryOptions | 0 or 1 | Selection of address ranges for read delete and write operations. Setup->Memory Options | F_MemoryConfig() | |
EraseAll | 0 or 1 | Setup->Memory Options | F_Erase() | |
Boot_Dev_Type | 0,1,2 | Setup->Memory Configuration 0 - Nor Flash | F_MemoryConfig() | |
Memory_Configuration_Address | Internal RAM address range | Load Address for Memory_Configuration_Word1
| F_MemoryConfig() | |
Memory_Configuration_Word1 | 0x0000 0000 … 0xFFFF FFFF | External Flash configuration word Setup->Memory Options | F_MemoryConfig() | |
Memory_Configuration_Word2 | 0x0000 0000 … 0xFFFF FFFF | External Flash configuration word2 | F_MemoryConfig() | |
Memory_ID | 0 … 0xFF |
| External memory ID | F_MemoryConfig() |
Memory_Size | 0x0000 0000 … 0xFFFF FFFE | External memory size Setup->Memory Options |
| |
Property_Tag | 0 … 0x20 |
| F_GetProperty() | |
Property_Value | 0x0000 0000 … 0xFFFF FFFF | Value to be entered into the specified Property_Tag | F_SetProperty() | |
Read_Start_Address | 0x0000 0000 … 0xFFFF FFFE | Read memory start address. Setup->Memory Options | F_Read() if UserMemoryOptions = 1 | |
Read_Stop_Address | 0x0000 0001 … 0xFFFF FFFF | Read memory end address Setup->Memory Options | F_Read() if UserMemoryOptions = 1 | |
Write_Erase_Start_Address | 0x0000 0000 … 0xFFFF FFFE | Start address for Erase and Write operations Setup->Memory Options | F_Erase() if(UserMemoryOptions == 1 and EraseAll ==0) | |
Write_Erase_Stop_Address | 0x0000 0001 … 0xFFFF FFFF | End address for Erase and Write operations Setup->Memory Options | F_Erase() if(UserMemoryOptions == 1 and EraseAll ==0) | |
Flashloader_Load_Address | Internal RAM address range | Setup->Memory Options | F_Load_Flashloader() | |
Flashloader_Jump_Address | Internal RAM address range | Setup->Memory Options | F_Load_Flashloader() | |
Flashloader_VID | 0x0000 … 0xFFFF | USB Vendor ID of Flashloader running in MCU Setup->Memory Options | F_Connect(), F_Load_OS() if (Flashloader_Default_Setup == 0) | |
Flashloader_PID | 0x0000 … 0xFFFF | USB Product ID of Flashloader running in MCU Setup->Memory Options | F_Connect(), F_Load_OS() if (Flashloader_Default_Setup == 0) | |
MCU_VID | 0x0000 … 0xFFFF | USB Vendor ID of MCU Setup->Memory Options | F_Connect() | |
MCU_PID | 0x0000 … 0xFFFF | USB Vendor ID of MCU Setup->Memory Options | F_Connect() |
Summary