This section describes how to debug applications that have not been built by CrossStudio. To keep things simple, we shall use the application that we have just built as our externally built application.

To start debugging an externally built application, you need to create a new externally built executable project. To do this, do the following:

- From the File menu, click New then New Project...

The New Project dialog appears. This dialog displays the set of project types and project templates.

We'll create an externally built executable project :

- Select the Generic ARM7 > Generic ARM7 Board project type in the Project Types pane.
- Select the ARM7 RAM Only Externally Built Executable icon in the Templates pane which selects the type of project to add.
- Type `Externally_Built_Tutorial` in the Name edit box, which names the project.
- You can use the Location edit box or the Browse button to locate where you want the project to be created.
- Click OK.

This will create a project for a generic ARM 7 device with RAM located at address 0x00000000 which is the same configuration we used when we created our original project.

Once created, the project setup wizard prompts you for the executable file you want to use.

Enter the path to the Tutorial.elf executable file we generated earlier in the Executable File field. For example, if the project was created in the C:/ARM/Projects directory and was built using the ARM RAM Debug configuration, the path to the executable file will be C:/ARM/Projects/ARM RAM Debug/Tutorial.elf.

Clicking Next displays the files that will be added to the project.

The Project files group shows the files that will be copied into the project. The only files that are used are the memory map file that describes the memory layout being used by the application and the target script which is used to reset and control the target. For the debugging session to work both of these files must match and work with with the executable you are using.

Clicking Next displays the configurations that will be added to the project.

Complete the project creation by clicking Finish.

You will be prompted as to whether you want to overwrite the existing memory map and target script, click No to keep the existing files.

Now you have created the externally built executable project you should be able to use the debugger just as we did earlier in the tutorial.