Configuring Compiler

Build tools use a tool directory for configuring and locating its generated files. For Microcontrollers V10.x build tools, the tool directory is the prog folder, and is located in the CWInstallDir\MCU folder, where CWInstallDir is the directory in which the CodeWarrior software is installed.

A build tool such as the Compiler requires information from configuration files. There are two types of configuration data:

Global
Global data is common to all build tools and projects, and includes data for each build tool, such as the directory path for recent project listings. All tools may store some global data in a mcutools.ini file. Each tool looks for this file in the tool directory first, then in the Microsoft Windows installation directory (for example, C:\WINDOWS). The following listing lists the typical locations for a global configuration file.

Listing: Typical Locations for a Global Configuration File
```
<CWInstalldir>\MCU\prog\mcutools.ini - #1 priority C:\WINDOWS\mcutools.ini - used if there is no mcutools.ini file above 
```
The Compiler uses the initialization file in the prog folder if you start the tool from the prog folder. That is:

<CWInstallDir>MCU\prog\mcutools.ini

The compiler uses the initialization file in the Windows directory if the tool is started outside the prog folder. That is, the tool uses C:\WINDOWS\mcutools.ini.

For information about entries for the global configuration file, refer to the Global Configuration File Entries topic in the Appendices.
Local
Local data files can be used by any build tool for a particular project. These files are typically stored in a project folder. For information about local configuration file entries, refer to the Local Configuration File Entries topic in the Appendices.

To configure the Compiler, proceed as follows:

Double-click crs08.exe, which is located in the <CWInstallDir>\MCU\prog folder.
The RS08 Compiler window appears.
Figure 1. RS08 Compiler Window
Read the tips, if you want to, and then click Close.
The Tip of the Day dialog box closes.
Select File > New / Default Configuration from the RS08 Compiler window menu bar.
Note: You can also use an existing configuration file if you desire. Use File > Load Configuration to open and read the configuration file.
Select File > Save Configuration (or Save Configuration As).
The Saving Configuration as dialog box appears.
Browse and select the folder where you want to save the configuration. In this example, folder X15 is used to save the configuration.
Figure 2. Saving Configuration as Dialog Box
Click Save.
The folder becomes the project directory. The project directory folder is often referred to as the current directory.

Figure 3. Compiler's Current Directory Switches to your Project Directory

The project directory folder now contains the newly-created project.ini configuration file. The project configuration file contains a copy of the [CRS08_Compiler] portion of the project.ini file in the build tools prog folder. If a build tool modifies any project option, the changes are specified in appropriate section of the project configuration file.

Note: Option changes made to the project.ini file in the prog folder apply to all projects. Recall that this file stores the global tool options.
Select Compiler > Options > Options from the RS08 Compiler window menu bar.
The compiler displays the RS08 Compiler Option Settings dialog box.

Figure 4. RS08 Compiler Option Settings Dialog Box
Select the Output tab.
Check the Generate Listing Filecheckbox.
Check the Object File Format checkbox and select the ELF/DWARF 2.0 option which appears for the Object File Format checkbox.
Click OK.
The RS08 Compiler Option Settings dialog box closes.
Save the changes to the configuration by either:
- selecting File > Save Configuration (Ctrl + S) or
- clicking Save on the toolbar.

The compiler is now configured with the selected settings.

Note: For more information about configuring the Compiler options, refer to the Graphical User Interface.