User manual

GDB SERVER FOR ARM, XSCALE AND CORTEX
USER MANUAL
Emulation Parameter File
The core and CPU dependent emulation parameters are stored in the .par file used in
conjunction with the -emu option. These parameters are a subset of the parameter list displayed
by the Chameleon emu command. Refer to the .par files provided with the package for
guidelines for determining which of these parameters are essential to the operation of the server.
If the server package includes a .par file designated for your target, you can use it unmodified.
It is possible to apply multiple -emu file options and set individual emulation parameters using
the “-emu name=value” syntax.
Macro/Initialization Files
The .mac and .ini files used in conjunction with the -init and -term options allow you to utilize
the following subset of Chameleon Debugger’s macro commands.
COMMAND DESCRIPTION
S8/SB/S16/SW/S32/SD <addr> = <value>
Set Byte, 16 bit Word, 32 bit Double word.
S8/SB/S16/SW/S32/SD <addr> |= <value>
OR value with memory at <addr>
S8/SB/S16/SW/S32/SD <addr> &= <value>
AND value with memory at <addr>
S8/SB/S16/SW/S32/SD <addr> ^= <value>
XOR value with memory at <addr>
D8/DB/D16/DW/D32/DD <addr>
Reads Byte, 16 bit Word, 32 bit Double word. Displays
them when ECHO is on.
ECHO ON|OFF
ECHO control. OFF by default.
PAUSE <ms>
Pause the execution of commands for <ms>
milliseconds. Use, for example, to allow the PLL to
stabilize.
EMU <name> = <value>
Emulation parameters (the same as in Chameleon).
RESET [/HALT]
Reset the CPU and, optionally, stop the CPU if it did
not stop automatically after a reset.
STOP
Stop the CPU.
GO [<start-addr>] [TILL <break-addr>…]
Start the CPU at an optional start address and set
optional breakpoints.
RUNTIMEOUT <ms>
Stop the CPU started by the GO TILL command after
<ms> milliseconds. The default timeout is 5 sec. A
value of zero denotes no timeout.
MEM SPACE
Display the current memory space (when ECHO is
on).
MEM SPACE DEFAULT
Select the default (index 0) memory space.
MEM SPACE <space-index>
Select the memory space defined by an index. E.g.,
0x1F - CP15 register access; 0x1E - CP14 register
access.
TABLE 2 Chameleon macro commands that can be use with the –init and -term options.
5