ULINK2 User's Guide

Upgrading from Real-Time Agent V1.0

Real-Time Agent V1.0 shipped with RealView MDK V3.04 and V3.05a. Starting with RealView MDK V3.10, Real-Time Agent V2.x replaces Real-Time Agent V1.0. Between Real-Time Agent V1.0 and V2.x, major protocol changes were required that unfortunately are incompatible with each other. As a result, RealView MDK V3.10 no longer supports Real-Time Agent V1.0 protocol.

The bad news: If your project uses V1.0, you will have to upgrade to V2.x.

The good news: Upgrading is very easy to do. The following steps show you how to upgrade.

Upgrading Projects Using Real-Time Agent V1.0 to V2.x

  1. Open the project to upgrade in µVision and display the current configuration of the two Real-Time Agent V1.0 files: RT_Agent.c and Retarget.c. Click the Configuration Wizard tab, then click the Expand All button to display the option settings.

    For the RT_Agent.c file, write down the settings for the highlighted options below:

    RT_Agent.c Highlighted options

    For the Retarget.c file, write down the settings for the highlighted options below:

    Retarget.c Highlighted options

  2. Remove the RT_Agent.c and Retarget.c files from the project.
  3. For RTX or RL-ARM only: Note the RTX_Config.c configuration options and any custom changes you have made to this file, then replace it with a new one from the template folder (C:\KEIL\ARM\Startup) and re-add your custom changes to the new file.
  4. Follow the steps in Configuring the Real-Time Agent using the settings recorded in Step 1 (and Step 3 for RTX or RL_ARM).
  5. Re-compile and run the project in the µVision debugger. If everything was successful, µVision will report:
    Real-Time Agent v2.x: Connected
    
    in the µVision status bar.

If you do not see the above message in the µVision status bar, follow the troubleshooting tips in the Troubleshooting section.