If you have upgraded your build tools, you can upgrade your projects to use the new toolchain. For example, if you currently have RealView Developer Kit (RVDK) and you upgrade to a later version, you can upgrade your existing RVDK projects to use the new toolchain. You can also upgrade ADS projects to RVDK.
RealView Debugger determines the location of your ARM build tools automatically (see Managing your build tools for details). If you open a project and a later version of the toolchain exists, RealView Debugger prompts you to upgrade the project. The way in which this happens depends on whether or not the toolchain with which the project was built is installed on your system.
When you open a project, RealView Debugger examines it to find out which toolchain was used to create it. At this stage, the project becomes the active project, but remains in the validation stage instead of being fully opened. RealView Debugger then performs one of the following actions:
If the original toolchain is no longer present on your system and an upgrade is available for the project, you must upgrade the project before you can use it. RealView Debugger displays the Upgrade Project selection box, shown in Figure 2.4.
The name of the project you are about to upgrade appears at the top of the selection box and the display list shows available upgrades. Do one of the following:
If you want to upgrade the project, select the required conversion and click OK. The project is upgraded and RealView Debugger completes the validation process. The project is then open and ready for use. A backup copy of the old project settings file is created automatically in the same location.
If you do not want to upgrade the project, click Cancel. The validation process is not completed and the project is closed.
If the original toolchain is present and an upgrade is available for the project, you can use the project whether or not you upgrade it. RealView Debugger therefore offers you the appropriate binding options before prompting you to upgrade the project (see Chapter 9 Project Binding for information on binding).
RealView Debugger then displays the Upgrade Project ToolChain dialog box, shown in Figure 2.5.
Do one of the following:
Click Yes if you want to upgrade your project. This displays the Upgrade Project selection box, shown in Figure 2.4. A backup copy of the old project settings file is created automatically in the same location.
Click No if you do not want to upgrade your project now. In this case, RealView Debugger remembers the state of the Don’t ask me again for this project check box. If you want to upgrade the project later, then leave this check box unchecked.
RealView Debugger completes the validation process and the project is open and ready for use.
Note
If you select Don’t ask me again for this project, and you want to upgrade that project later, you can use the Project Control dialog box to upgrade the project manually. See Using the Project Control dialog boxUsing the Project Control dialog box for details.
Click Cancel if you do not want to upgrade your project. The Don’t ask me again for this project checkbox is ignored, and the next time you open the project, you are asked if you want to upgrade it.
RealView Debugger completes the validation process and the project is open and ready for use.
If the original toolchain is not present and an upgrade is not available for the project, you cannot use the project and an error message is displayed.
When a project is successfully upgraded to the latest toolchain, the dialog box is not displayed when you next open that project, unless you upgrade your build tools again. If you upgrade your project to an intermediate toolchain, the dialog box is displayed the next time you open the project. Click No and check Don’t ask me again if you do not want to upgrade to the latest toolchain.
Note
If you upgrade a project for which you do not have the tools installed, you must force the binding behavior. To do this, either close the project and reopen it, or use the Project Control dialog box.
Note
It is recommended that you rebuild your project after upgrading it.
PDF version