8 SUPPORT FOR USER-DESIGNED TARGET BOARDS

This chapter contains the steps you have to take to support user-designed target boards.

To create support files for a user-designed target board:

1. Create a mytarget.asm file in the lib\src\ directory by copying one of the startup files (for example, def_targ.asm).

2. Change the new file to contain adequate values for the AARx registers etcetera for the board. Refer to the DSP manual and the hardware manual of the board for the correct settings.

3. Add the new startup file to your project:

Using EDE:

- add mytarget.asm to the project file list.

Using the command line:

- add mytarget.asm to the makefile.

Alternatively, you can add the new startup file to the libraries. From the command line, in the product directory, add the new file to the libraries with (example for the DSP563xx ):

4. Create a correct memory description of your board for the locator.

Memory descriptions are in the product etc directory (*.mem) for several targets. They are included in the *.dsc files. If you created a mytarget.asm file, name these files mytarget.dsc and mytarget.mem. mytarget.dsc can be a copy of any of the *.dsc files, just replace the .mem include with mytarget.mem, and the .cpu include with the correct cpu type.

Create a mytarget.mem file with the correct sizes of the external memory. One of the existing .mem files can be used as a starting point for this. Take care that your bus structure is correct: some files have a unified bus (X/Y/P maps to the same physical memory, so sections are placed after each other), others have separate buses (X/Y/P map to different chips, so sections can be placed in parallel). Take the file that resembles your board, and then just change the memory sizes in the chips section of the file.

5. If you added a new startup file to your project (in step 3), disable the startup file from the libraries and specify the correct startup code label and description file:

Using EDE:

- Select the Project | Project Options... menu item. Expand the Linker/Locator entry and select Control File. Select User supplied, no library startup code in the Target list box. In the User defined target name field, fill in "mytarget". This will tell the tools to include the startup file mytarget.asm from the library, and to use the file mytarget.dsc for the locating process.

Using the command line:

- Add -Tmytarget to the control program (cc563) command line.

6. If you added a new startup file to the libraries (in step 3), specify the correct description file:

Using EDE:

- Select the Project | Project Options... menu item. Expand the Linker/Locator entry and select Control File. Select User supplied target definition in the Target list box. Specify mytarget.dsc in the field of the Use project specific linker/locator control file (.dsc) radio button.

Using the command line:

- Add -T mytarget.dsc to the control program (cc563) command line.


Copyright © 2002 Altium BV