How do I set up a custom register?

This example describes the steps that you should follow to set up a register MYREG for a custom target MY_TARGET. This register is displayed as a new tab in the Register pane. You can follow this procedure to set up a custom register for any target.

1.   Open RealView Debugger without connecting to a target.

2.   Select Connection Properties… from the Code window Target menu to display the Connection Properties window.

3.   Click in the left pane to expand the CONNECTION=MY_TARGET group and top-level entries until it looks like this:

To set up your new register, you must make changes in the Memory_block, Register, and Register_Window settings.

If you want to display any of the register values as an enumeration, you must change the Register_enum settings.

This example sets up a register MYREG, which is displayed in a Register pane tab labeled MYREG. There is an area of memory defined for registers from 0x10800000.

4. Click in the left pane to expand the Memory_Block entry

5. Right-click on Default under Memory_block to display a context menu.

6. Select Make New….

7. Enter a name for the new entry. In this example it is REGS.

8. A new group is created, identical to the Memory_block Default.

9. Click on the REGS line to see these settings in the right pane:

10. Right-click on Start, select Edit Value from the context menu, and enter a value for the start of the memory block. In this example, enter 0x10800000.

11. Right-click on Length, select Edit value from the context menu, and enter a value for the length of the memory block. In this example, enter 0x100000.

12. Right-click on Description, select Edit value from the context menu, and enter an appropriate description. In this example, enter Registers. You can change other values in the same way, but this example keeps the default values.

13. Right-click on Default under Register to display a context menu, and select Make Copy…. Enter MYREG in the dialog.

14. Click on MYREG to see these settings in the right pane:

15. Right-click on Start to display a context menu. Select Edit Value, and enter 0 (zero).

16. In the same way, set Length to 4, Base to REGS and Gui name to My new register.

17. Right-click on Default under Register_Window to display the context menu. Select Make Copy…, and enter MYREG in the dialog. This is the name that appears on the tab in the Register pane.

18. Click MYREG and set up the display details for the register in the right pane.

19. Right-click Line, and select Edit value. Enter MYREG.

If you want any text other than the Gui name specified for the register, it must be preceded by _ (underscore).

20. Your register is now set up. Select the Save and Close option from the File menu to save your settings.

The next time you connect to this target, the register is displayed automatically.