Skip to main content

IAR Embedded Workbench for RL78 5.20

Loading multiple debug images

In this section:

Normally, a debuggable application consists of a single file that you debug. However, you can also load additional debug files (debug images). This means that the complete program consists of several debug images.

Typically, this is useful if you want to debug your application in combination with a prebuilt ROM image that contains an additional library for some platform-provided features. The ROM image and the application are built using separate projects in the IAR Embedded Workbench IDE and generate separate output files.

If more than one debug image has been loaded, you will have access to the combined debug information for all the loaded debug images. In the Images window you can choose whether you want to have access to debug information for a single debug image or for all images.

To load additional debug images at C-SPY startup:

  1. Choose Project>Options>Debugger>Images and specify up to three additional debug images to be loaded. For more information, see Images.

  2. Start the debug session.

    To load additional debug images at a specific moment:

    Use the __loadImage system macro and execute it using either one of the methods described in Using C-SPY macros.

    To display a list of loaded debug images:

    Choose Images from the View menu. The Images window is displayed, see Images window.