ARM Technical Support Knowledge Articles

How can I use workspaces to control RVD's GUI?

Applies to: RealView Development Suite (RVDS)


What is a workspace?
Workspaces are used by the RealView Debugger (RVD) to store the configuration of the GUI.  They store settings such as the layout of panes, whether line numbers are displayed, and font size.  They also store the connection status.

Where are workspaces stored?
Each workspace is stored in a configuration file, normally with the .aws file extension.  These files can be placed wherever you wish.  However, RVD will create a default workspace ( for each user in their RVD home directory.

How do I control workspaces?
There are several settings which control how RVD makes use of workspaces.  These are accessed from the File menu, and summary of the available options is given below:

Same Workspace on Startup
If this option is selected then RVD will re-load the same workspace file next time you launch RVD.  When de-selected  RVD starts up with a blank workspace each time (default GUI settings).

Save Workspace on Exit
If this option is selected then the loaded workspace file be updated when you exit RVD.

Save Workspace
This option updates the current workspace file with any changes you have made.  Normally only used when 'Save Workspace on Exit' is disabled.

Open Workspace...
Allows you to load a different workspace (.aws) file.

Workspace Settings
This option opens a new dialog box, and gives access to some of the lower level GUI settings.  Some settings you may find useful are:

  ...vdebug.ini -> DEBUGGER -> Disassembler -> Asm Source
  Whether C/C++ source is interleaved into the disassembly view

  ...vdebug.ini -> ALL -> Edit -> Line number  
 Whether lines numbers are displayed in the source view

  ...vdebug.ini -> ALL -> Edit -> Tab
 The number of spaces a tab translates to in the source view

  ...vdebug.ini -> ALL -> Text -> Font information -> Pane font
  The font type and size used within RVD.

How do I use workspaces?
There are two common usage models for workspaces:

Always Load With the Same Settings 
When you have Save Settings On Exit de-selected, and Same Workspace on Startup selected, RVD will always start up with the same settings.  This allows you to configure RVD as you wish, use the Save Workspace to save that configuration, and then always have that configuration restored at start-up.

Restore The Last Session's Settings
When you have Save Settings On Exit and Same Workspace on Startup selected, RVD will save your current configuration on exit and restore that configuration when it next starts up.  This mode of operation should be used with care, as your connections are included in the workspace.  This means RVD will try to re-establish them when it next launches.  Which may not be desirable if you frequenctly change targets or share targets.

I have broken my workspace, what can I do?
If RVD is attempting to load a corrupted workspace, or a workspace with unusable settings, on start-up it can be difficult to recover from using the GUI.  Open a console and launch RVD with the following command:

    rvdebug -aws=-

This will load RVD a blank workspace (default settings).  You can now use the GUI to set up a usable workspace.

Can I have more than one workspace loaded at once?
Yes.  RVD supports having more than one code window open, using the same underlying instance of the debugger.  Each main window can have a different workspace applied to it.  To do this, go to:

  File menu -> Workspace -> Open Workspace...

This allows you to navigate to a workspace file (.aws) and load it.  RVD will automatically open a new code window for this workspace.

Article last edited on: 2011-08-12 10:20:54

Rate this article

Disagree? Move your mouse over the bar and click

Did you find this article helpful? Yes No

How can we improve this article?

Link to this article
Copyright © 2011 ARM Limited. All rights reserved. External (Open), Non-Confidential