AMX Target Guide Computer Accessories User Manual


 
AMX 68000 Target Guide
K
A
DAK
21
4. Target Configuration Module
4.1 The Target Configuration Process
Every AMX application must include a Target Configuration Module which defines
the manner in which AMX is to be used in your target hardware environment. The
information in this file is derived from parameters which you must provide in your Target
Parameter File.
The Target Parameter File is a text file which is structured according to the
specification presented in Appendix A. You create and edit this file using the AMX
Configuration Builder following the general procedure outlined in Chapter 16 of the
AMX User's Guide. If you have not already done so, you should review that chapter
before proceeding.
Using the Builder
When AMX is installed on your hard disk, the AMX Configuration Manager for
Windows utility program and its related files are stored in directory
CFGBLDW in your
AMX installation directory. To start the Configuration Manager, double click on its
filename, CJ532CM.EXE. Alternatively, you can create a Windows shortcut to the
manager's filename and then simply double click the shortcut's icon.
To create a new Target Parameter File, select New Target Parameter File from the File
menu. The Configuration Manager will create a new, as yet unnamed, file using its
default AMX target parameters. When you have finished defining or editing your target
configuration, select Save As... from the File menu. The Configuration Manager will save
your Target Parameter File in the location which you identify using the filename which
you provide.
A good starting point is to copy one of the Sample Target Parameter Files CJSAMTCF.UP
provided with AMX into file HDWCFG.UP. Choose the file for the evaluation board which
most closely matches your hardware platform. Then edit the file to define the
requirements of your target hardware.
To open an existing Target Parameter File such as
HDWCFG.UP, select Open... from the File
menu and enter the file's name and location or browse to find the file. When you have
finished defining or editing your target configuration, select Save from the File menu.
The Configuration Manager will rename your original Target Parameter File to be
HDWCFG.BAK and create an updated version of the file called HDWCFG.UP.
To direct the Configuration Manager to use its Configuration Generator utility to produce
an updated copy of your Target Configuration Module, say HDWCFG.ASM, select
Generate... from the File menu. If necessary, the path to the template file required by the
generator to create your Target Configuration Module can be defined using the
Templates... command on the File menu.
The assembly language Target Configuration Module must be assembled as described in
the toolset specific chapter of the AMX Tool Guide for inclusion in your AMX system.
The assembler will generate error messages which exactly pin-point any inconsistencies
in the parameters in your Target Parameter File.