4.14. Creating the register tab for displaying custom registers and peripherals

Having created the custom registers and peripheral registers, you must have a way of displaying them in RealView Debugger, so that you can monitor or modify the values. You must define the visual appearance of the registers and peripheral registers, and specify the name of the tab that is to contain the registers. The tab is displayed in the Registers view.

To define the visual appearance of the custom registers and peripheral registers in the Registers view:

  1. Select Target → Connection Properties... from the Code window main menu to open the Connection Properties window.

  2. Locate the Register_Window group in the Advanced_Information block group. Figure 4.24 shows an example:

    Figure 4.24. Register_Window group

    Register_Window group

  3. Expand the Register_Window group in the left pane.

  4. Rename the Default group under Register_Window to MP3_REGS.

    Note

    This specifies the name for the new register tab in the Registers view.

  5. Select MP3_REGS in the left pane.

  6. Add the first Line setting:

    1. Right-click on the Line setting to display the context menu.

    2. Select Edit Value from the context menu.

    3. Enter $+.

    4. Press Enter to complete the entry.

    This makes the SERBUS_CTRL_SET peripheral register an expandable entry in the register tab.

    Note

    It is important in the following steps to right-click on the last *Line you created when adding a new Line. If you right-click on the original Line setting, the lines are added in reverse order.

  7. Create a line setting to display the SERBUS_CTRL_SET peripheral register:

    1. Right-click on the *Line "$+" setting to display the context menu.

    2. Select Make New... from the context menu.

    3. Set the *Line setting, to =SERBUS_CTRL_SET.

    4. Press Enter to complete the entry.

    This displays the peripheral register name and the peripheral register on the same line in the register tab.

    This displays the SERBUS_CTRL_SET peripheral register. The name displayed for the register is defined by the Gui_name setting (for example, Serial Bus Control), and the name and peripheral register value are displayed on the same line in the register tab.

  8. Create a line setting for any bit field names you have created. For example B_SCLS, of the SERBUS_CTRL_SET peripheral register:

    1. Right-click on the *Line "=SERBUS_CTRL_SET" setting to display the context menu.

    2. Select Make New... from the context menu.

    3. Set the *Line setting, to B_SCLS.

    4. Press Enter to complete the entry.

  9. Create a line to expand the SERBUS_CTRL_SET peripheral register:

    1. Right-click on the *Line "B_SCLS" setting to display the context menu.

    2. Select Make New... from the context menu.

    3. Set the *Line setting, to $+.

    4. Press Enter to complete the entry.

  10. Create a line setting to display the Newreg register:

    1. Right-click on the last *Line "$+" setting to display the context menu.

    2. Select Make New... from the context menu.

    3. Set the *Line setting, to =Newreg.

    4. Press Enter to complete the entry.

    The register name and the register are displayed on the same line in the register tab.

    If you specified a descriptive name for the register in the Gui_name setting (for example, New Register), then that name is displayed for the register. Otherwise, the register symbol name (Newreg) is displayed.

  11. Create a line setting for the Newreg register to display the name INDICATORS for the register tab:

    1. Right-click on the *Line "=Newreg" setting to display the context menu.

    2. Select Make New... from the context menu.

    3. Set the *Line setting, to _INDICATORS.

      Literals entered in *Line (or Line) must be preceded by an underscore. The underscore is not displayed in the tab.

    4. Press Enter to complete the entry.

  12. Create a line setting for any bit field names you have created. For example B_REMAP, B_IND1, B_IND2, and B_IND3 of the Newreg register group:

    1. Right-click on the *Line "_INDICATORS" setting to display the context menu.

    2. Select Make New... from the context menu.

    3. Set the *Line setting, to B_Remap,B_IND1,B_IND2,B_IND3.

    4. Press Enter to complete the entry.

    The Connection Properties window looks like Figure 4.25.

    Figure 4.25. The MP3_REGS group

    The MP3_REGS group

    All BCD file entries are now complete.

  13. Select File → Save and Close from the menu to save your changes and close the Connection Properties window.

See also:

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