Parameter Files - Epson S5U1C17001C Manual

10.9 Parameter files

Parameter files are text files in which memory map information of the target system is written. The debugger reads
this file to create memory map information, based on which it performs the following processing:
• Checks whether software PC break addresses are within a valid mapped area
• Breaks at write operation to ROM area (only in simulator mode)
• Breaks at accessing undefined areas (only in simulator mode)
• Breaks when stack overflows (only in simulator mode)
• Refers TTBR at reset.
When a parameter file is loaded, the appropriate size of storage (required for all areas of memory written to the file)
is reserved in internal memory of your computer.
How to load a parameter file
A parameter file is loaded in the debugger by executing the c17 rpf command.
(gdb) c17 rpf Filename .par
The IDE may be used to create a special command file, like the one loaded when the debugger starts. For
details about IDE, see Chapter 5, "GNU17 IDE".
Be sure to execute the c17 rpf command before the file, target, and load commands. The following
shows the basic sequence of command execution:
(gdb) c17 rpf sample.par
(gdb) file sample.elf
(gdb) target sim
(gdb) load
(gdb) c17 rst
How to create a parameter file
You can create parameter files by selecting [GNU17 Parameter Settings] from the [Properties] dialog box of the
IDE. For details about IDE, see Chapter 5, "GNU17 IDE". Because parameter files are text files, you can use a
general-purpose editor to create and correct parameter files.
note: Do not use non-ASCII (Japanese, etc.) characters for file names (including extensions) and text in
a file.
Contents of parameter file
The following shows an example of a parameter file.
#gnu17 gdb parameter file
ESSIM S1C17701
TTBR 8000
RAM 000000 001fff 00W
IO 040000 04ffff 00H
RAM 600000 6fffff 11H
ROM c00000 cfffff 55B
STACK 000000 001fff
(1) Comment
From # to the end of the line is interpreted as a comment.
(2) Target model
This parameter specifies the target model to simulate with the ES-Sim17.
(3) TTBR
This parameter specifies the trap table base address. The set value is referenced when the reset command
(c17 rst) is executed and is used as the trap table (vector table) start address. The reset vector written in
this address will be loaded to the PC for booting the system.
S5U1C17001C ManUal
(C COMPilEr PaCkagE fOr S1C17 faMily) (Ver. 1.5.0)
(loads a parameter file to set a memory map.)
(sets map information.)
(loads debugging information.)
(connects the target.)
(loads the program.)
(resets the CPU.)
(1)
(2)
(3)
(4)
#IRAM
#IO
#RAM
B #ROM
(5)
#STACK
EPSOn
10 DEBUggEr
10
Debugger
10-159