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:

   

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

   

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 the message above is not displayed in the Status Bar, try to fix the issue using hints from Troubleshooting RTA.