2.3.11. BOARD

Changes the current board, also known as the current connection. By default, all actions apply to the current connection.


BOARD [{,next | ,default | [=]resource}]



Connects the debugger to the next connection listed in the connection list.


Connects the debugger to the connection that is listed first in the connection list.


Identifies the connection that is to become the current connection. The = in this parameter is optional.

The connection information is specified in the same format as it is displayed in the Code window title bar. You can specify this using one of the following formats:





  • target is the connection name for the target, for example ARM966E-S_0

  • DebugConfiguration is the Debug Configuration (for example RVISS), which you can determine from the board file or from the Connect to Target window.


With no parameters, the BOARD command displays the name of the current board. The displayed information has the following format:

Current Board is target:manufacturer target - DebugConfiguration_description

where target is the name of the target processor, and DebugConfiguration_description is either:

  • CONNECTION via localhost (P1), if no description is specified for the Debug Configuration and any assigned BCD file

  • the description of the Debug Configuration, if specified for the Debug Configuration or in an assigned BCD file.

With one of the qualifiers or the resource argument, the command sets the current connection to:

  • to the current board

  • to the next board in the board list

  • the default board.

The newly selected board becomes the current target connection. RealView Debugger uses the term board because a target connection is defined by more than a processor. The memory map and the available peripherals are normally defined by the target as a whole, and so it is more appropriate to refer to boards than to processors.

You can display the boards that you can cycle through using board,next by clicking the connection drop-down list from the toolbar.

You can remove an unconnected board from the list using DELBOARD. To add or remove a board from the board list permanently, you must edit the board file using EDITBOARDFILE.


If a Code window is attached to a connection, then connection information is displayed only if you use the BOARD command without a qualifier or the resource argument.

Restrictions on the use of BOARD

The BOARD command is not allowed in a macro.


The following examples show how to use BOARD:

  • To change the current board to the next defined board from the board list:

    > board,next
    New Current Board is ARM1176JZ-S:ARM-A-SW ARM1176JZ-S - ARM1176JZF-S (simulated on RVISS) (P1)
  • To change the current board to the named board in the board list:

    > board "ARM966E-S_0@RVI"
    New Current Board is ARM966E-S_0:ARM-ARM-NW ARM966E-S - ARM966E-S on Integrator/AP (RVI-USB) (P1)
  • To display the name of the current connection use the BOARD command without arguments, for example:

    > board
    Current Board is ARM966E-S_1:ARM-ARM-NW ARM966E-S - ARM966E-S on Integrator/AP (RVI-USB) (P1)

See also

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