Home |
RTTarget-32 Programming Manual Running Win32 Programs without Win32 HexFile Command Running a Program on the Target Compiling and Linking with On Time RTOS-32 |
HexFile CommandThe HexFile command instructs RTLoc to produce one or more Intel HEX files containing the program image: HexFile Name Address Size [,Split [,RecLen]] Parameter Name is the base name of the hex file to be produced. Address specifies the location in the target's address space where the HEX file should start. This will usually be the start address of an EPROM to be programmed with the HEX file. Parameter Size specifies the number of bytes to be covered in the target's address space. Optional parameter Split may be set to 1, 2, or 4 and defines how many EPROMs are used in parallel. For example, if you use two 8-bit EPROMs to implement a 16-bit memory system, Split must be set to 2. For 32-bit systems built with 8-bit EPROMS, 4 must be specified. The default value is 1 (no splitting). Parameter RecLen can be used to change RTLoc's default HEX file record length of 16. Any value which is a power of two in the range 4 to 64 may be used. Any number of HexFile commands can be used in a single configuration file. Each command should describe a portion of the address space implemented by EPROMs. The number of files actually produced per HexFile command depends on the Split value. If Split is equal to 1, a single file named Name.HEX is produced. For other Split values, one file is produced per EPROM. They will have the names Name.HE0, Name.HE1, etc. The last digit in the file name specifies the byte offset of the data contained in each file. RTLoc does not fill unused portions of an EPROM with a specific pattern. Unused parts of the EPROM's address space are not written to the HEX file(s). Example:The target system uses a single 64k EPROM at address F0000h to implement 8-bit wide memory: HexFile MyEPROM F0000h 64k RTLoc will produce a single HEX file named MyEPROM.HEX. It will contain any data mapped into the given address range. Example:The target system uses 16-bit memory implemented with 8-bit EPROMs. One EPROM pair is located at address F0000h to cover 64k (using 32k EPROMs), and a second pair is located at 100000h and implements 512k with 256k EPROMs: HexFile EPROM1 F0000h 64k 2 HexFile EPROM2 100000h 512k 2 RTLoc will produce four HEX files named EPROM1.HE0, EPROM1.HE1, EPROM2.HE0, and EPROM2.HE1. EPROM1.HE0 will contain the byte data at address F0000h, F0002h, F0004h, etc. EPROM1.HE1 will contain the byte data at F0001h, F0003h, F0005h, etc.
|