## Registers Details Window

The Register Details window (Windows OS) lets you view detailed information about individual bits of registers from 2 bits to 32 bits in size. This window shows information for both system registers and memory-mapped registers. To open the Register Details window, click View > Register Details or Window > Register Details Window.

The Register Details window has fields that describe the register, its bitfields, and the values of those bitfields. XML files in the Registers folder of your Carbide installation provide the information that appears in the window. The Registers folder is inside the Support folder. The Support folder is inside the Plugins folder of your Carbide installation.

Figure 1 shows the Register Details window. Table 1 explains items in the window.

Figure 1 Register Details window

##### Table 1. Register Details window—items

Item | Icon | Explanation
--- | --- | ---
Description File text box |  | Enter the name or full path to the XML file for the register you want to view, or click the Browse button to open a dialog box that you can use to specify the file.
Register Name |  | Shows the name of the register depicted in the window.
Address text box |  | Enter the starting address of the register values that you want to see in the Register Display. An error message appears if you enter an invalid starting address.
Format list box |  | Specify the data format for bit values in the Register Display: Binary Character Decimal Unsigned Decimal Hexadeccimal Default—have the IDE determine the best format
Register Display |  | Shows a depiction of the register that you specify in the Description File text box, including individual register bits and their values.
Bitfield Name list box |  | Specify a bitfield to highlight in the Register Display. The Description portion of the window reflects available information for the bitfield. Select None to have the Description portion of the window reflect information for the entire register and not a bitfield in that register.
Bit Value text box |  | Shows the current value of the bits in the Bitfield Name list box, according to the format that you specify in the Format list box. Click the spin buttons to increment or decrement the current value, or enter a new value in the text box. Changing the value changes only the Register Display. You must click the Write button to write the new value to the register itself.
Bit Value Modifier list box |  | Specify a new value for the selected bitfield, or view a brief explanation of specific bitfield values. Changing the value changes only the Register Display. You must click the Write button to write the new value to the register.
Description |  | Shows a description of the register or a selected bitfield in the register. Use the Description File text box to specify the register. Use the Text View list box to view specific register information, such as register descriptions, bitfield descriptions, and register details.
Revert button |  | Click to change a modified value in the Register Display to its original value. If you clicked the Write button to write a new value to the register, you cannot revert that value.
Read button |  | Click to have the Register Display reflect current bit values from the register itself.
Write button |  | Click to write the bit values in the Register Display to the register. After you write new values to the register, you cannot revert them.
Reset Value button |  | Click to restore the default value for the selected bitfield. The IDE disables this button if the selected bitfield does not have a default value.
Text View list box |  | Use to specify information that appears in the Description portion of the window.

#### Description File

Enter in this text box the name of the register that you want to see in the Register Display of the Register Details window. Alternatively, enter the full path to the register description file on your computer, or click the Browse button to open a dialog box that lets you specify the register description file. The text box is not case sensitive.

After you enter a name or path, the debugger searches for a matching register description file in the Registers folder of your Carbide installation and the project access paths. If the debugger finds a matching file, the Register Display updates the information in the Register Details window. If the debugger does not find a matching name, an error message appears.

For example, to view the contents of the Opcode register, you can:

- type Opcode in the Description File text box and press Enter or Return, or
- type the full path to the opcode.xml file in the Registers folder and press Enter or Return.

The debugger matches your entry with the opcode.xml file in the Registers folder. The Register Display in the Register Details window updates its information to show Opcode register details.

The debugger also updates the Register Display to show the current values in the register. If the debugger fails to update the display, an error message appears.

#### Register Display

This display shows the current contents of 32 bits of register data, starting at the address that you specify in the Address text box. The data appears according to the format that you specify in the Format list box.

The Register Display groups the 32 bits of data into register bitfields. Clicking one of the bits selects its associated bitfield. Additional information about the bitfield, such as its name and permissions, appears in the Description portion of the Register Details window.

#### Text View

Use this list box to change the information that appears in the Description portion of the Register Details window:

- Auto—select to have the IDE determine which information to display in the window
- Register Description—select to show information about the entire register, such as the name of the register itself and the meaning of its contents
- Bitfield Description—select to show information about the selected bitfield in the Register Display, such as the name of the bitfield and its access permissions
- Register Details—select to show in-depth information about the current register, such as its name, its bit values, and bit-value explanations