|Non-Confidential||PDF version||ARM DUI0446Z|
|Home > Working with the Snapshot Viewer > Components of a Snapshot Viewer initialization file|
Describes the groups and sections used to create a Snapshot Viewer initialization file.
The Snapshot Viewer initialization file is a simple text file consisting of one or more sections that emulate the state of the original system. Each section uses an
Before creating a Snapshot Viewer initialization file you must ensure that you have:
One or more binary files containing a snapshot of the application that you want to analyze.
The binary files must be formatted correctly in accordance with the following restrictions.
Details of the type of processor.
Details of the memory region addresses and offset values.
Details of the last known register values.
To create a Snapshot Viewer initialization file, you must add grouped sections as required from the following list and save the file with .ini for the file extension.
A section for information about the processor or device. The following options can be used:
This is the name that is reported from RDDI and is used to identify the device. This value is necessary and must be unique to each device.
The general type of device, for example
The specific device type, for example
This describes how the agent that produced the snapshot locates the device.
One or more sections for contiguous memory regions stored in a binary file. The following options can be used:
Location of the binary file.
Memory start address for the specified region.
Length of the region. If none specified then the default is the rest of file from the offset value.
Offset of the specified region from the start of the file. If none specified then the default is zero.
A section for standard ARM® register names and values, for example,
Banked registers can be explicitly specified using their names from the ARM Architecture Reference Manual, for example,
R13_fiq. In addition, the current mode is determined from the Program Status Registers
(PSRs), enabling register names without mode suffixes to be identified with the appropriate banked registers.
The values of the PSRs and PC registers must always be provided. The values of other registers are only required if it is intended to read them from the debugger.
[regs] CPSR=0x600000D2 ; IRQ SP=0x8000 R14_irq=0x1234
Reading the registers named SP, R13, or R13_irq all yield the value
Reading the registers named LR, R14, or R14_irq all yield the value
All registers are 32-bits.
For more information about Snapshot Viewer file formats, see the documentation in
The following restrictions apply:
Consecutive bytes of memory must appear as consecutive bytes in one or more dump files.
Address ranges representing memory regions must not overlap.
[device] name=cpu_0 class=core type=Cortex-A7 ; Selected processor location=address:0x1200013000 ; Location of a contiguous memory region stored in a dump file [dump] file="
path/dumpfile1.bin" ; File location (full path must be specified) address=0x8000 ; Memory start address for specific region length=0x0090 ; Length of region ; (optional, default is rest of file from offset) ; Location of another contiguous memory region stored in a dump file [dump] file="
path/dumpfile2.bin" ; File location address=0x8090 ; Memory start address for specific region offset=0x0024 ; Offset of region from start of file ; (optional, default is 0) ; ARM registers [regs] R0=0x000080C8 R1=0x0007C000 R2=0x0007C000 R3=0x0007C000 R4=0x00000363 R5=0x00008EEC R6=0x00000000 R7=0x00000000 R8=0x00000000 R9=0xB3532737 R10=0x00008DE8 R11=0x00000000 R12=0x00000000 SP=0x0007FFF8 LR=0x0000808D PC=0x000080B8