2.3.108. REGINFO

Displays a description of the registers available for the current target.

Syntax

REGINFO [{,qualifier}] [=address-range] [{;windowid | ;fileid}]

where:

all

Displays information for all register types (target, user, and access).

target

Displays information for the registers on the connected target.

user

Displays information for the memory mapped registers defined in one or more BCD files attached to the target connection, if any.

access

Displays information for the target access registers.

details

Displays additional information for each register. The information displayed depends on the specified register type (target, user, or access).

bitfields

Displays information for any bit fields associated with the specified register type (target, user, or access).

match:[@]register_name

Displays information for all registers with names that contain the given string. The string can form any part of the name. For example, match:SPSR matches all register names beginning with SPSR.

address-range

Displays information for any memory mapped registers within the specified address range.

,windowid | ,fileid

Identifies the window or file where the command is to send the output.

If you do not supply a ,windowid or ,fileid parameter, or there is no window or file associated with the ID, the output is displayed on the screen. If you are using the GUI, then the output is displayed in the Output view.

Description

The REGINFO command enables you to view the list of available registers for the current connection. You can list:

  • All registers.

  • Registers only for the connected target.

  • User-defined memory mapped register and peripheral registers defined in any BCD files associated with the current connection.

  • Target access registers.

By default, a summary of the registers is displayed. However, you can choose to display:

  • More detailed information for each register, such as:

    • the size (in bytes)

    • type of value (such as, signed char and unsigned long)

    • type of register: core register, memory-mapped register, target access register.

  • The bitfields for any registers that have them (such as the CPSR register).

Examples

The following examples show how to use REGINFO:

reginfo,match:@SPSR

Lists all the SPSR registers:

Register @SPSR_FIQ (display name "SPSR")
Register @SPSR_SVC (display name "SPSR")
Register @SPSR_ABT (display name "SPSR")
Register @SPSR_IRQ (display name "SPSR")
Register @SPSR_UND (display name "SPSR")
reginfo,match:SPSR_SVC,bitfields

Displays the following bit field information for the SPSR_SVC register:

Register @SPSR_SVC (display name "SPSR")
    bit-fields:
        name: @SPSR_SVC_FLG             display name: "NZCV"                mask: ( >> 28) & 0xf
        name: @SPSR_SVC_FLGE            display name: "NZCVQ"               mask: ( >> 27) & 0x1f
        name: @SPSR_SVC_N               display name: "N"                   mask: ( >> 31) & 0x1
        name: @SPSR_SVC_Z               display name: "Z"                   mask: ( >> 30) & 0x1
        name: @SPSR_SVC_C               display name: "C"                   mask: ( >> 29) & 0x1
        name: @SPSR_SVC_V               display name: "V"                   mask: ( >> 28) & 0x1
        name: @SPSR_SVC_Q               display name: "Q"                   mask: ( >> 27) & 0x1
        name: @SPSR_SVC_GE              display name: "GE"                  mask: ( >> 16) & 0xf
        name: @SPSR_SVC_IT              display name: "IT"                  mask: ( >> 10) & 0x1803f
        name: @SPSR_SVC_E               display name: "E"                   mask: ( >> 9) & 0x1
        name: @SPSR_SVC_A               display name: "A"                   mask: ( >> 8) & 0x1
        name: @SPSR_SVC_I               display name: "IRQ"                 mask: ( >> 7) & 0x1
        name: @SPSR_SVC_F               display name: "FIQ"                 mask: ( >> 6) & 0x1
        name: @SPSR_SVC_T               display name: "STATE"               mask: ( >> 5) & 0x1
        name: @SPSR_SVC_J               display name: "BYTECODE"            mask: ( >> 24) & 0x1
        name: @SPSR_SVC_JT              display name: "STATE"               mask: ( >> 0) & 0x1000020
        name: @SPSR_SVC_MODE            display name: "MODE"                mask: ( >> 0) & 0x1f

See Also

Copyright © 2002-2011 ARM. All rights reserved.ARM DUI 0175N
Non-ConfidentialID052111