16.3.4. Loading macros on connection

You can load one or more macros automatically when you connect to a given target. The macros must be defined in a script file, which can be loaded on connection.

To load one or more script files containing macro definitions on connection:

  1. Select Target → Connect to Target from the Code window main menu to open the The Connect to Target window.

  2. Select Configuration from the Grouped By drop-down list.

  3. Expand the Debug Interface containing the Debug Configuration to be customized.

  4. Make sure that there are no targets connected on the Debug Configuration.


    You cannot customize a Debug Configuration when the debugger is connected to a target in that Debug Configuration.

  5. Right-click on the required Debug Configuration to display the context menu.

  6. Select Properties... from the context menu to open the Connection Properties dialog box.

  7. Click the Commands tab to display the commands list.

  8. To add a command:

    1. Click the Browse button to open the Choose Command file dialog box.

    2. Locate the required script file.

    3. Click Open. The Choose Command file dialog box closes, and the appropriate include command is added to the command list.

    4. Repeat these steps to add more commands as required.


    1. Enter the command in the command entry field. For example, enter:

      include C:\rvd\Test_files\tutorial.inc


      If the path contains spaces, then you must delimit the path with single quotes.

    2. Click the Add button.

      The command is added to the command list.

  9. Click OK to save your changes.

When you connect to a target in the Debug Configuration, the commands are executed in the order listed in the command list. If RealView Debugger cannot locate one of the specified files, it displays a message box and gives you the option to abort the connection.

See also

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