Use this panel to control how the compiler generates the output file, as well as error and warning messages. You can specify whether to allocate constant objects in ROM, generate debugging information, and strip file path information.
The following table lists and describes the output options for HCS08 compiler.
| Option | Description |
|---|---|
| Allocate CONST objects in ROM (-Cc) | Check to enables the Compiler assign const objects into the ROM_VAR segment, which the parameter file assigns to a ROM section. |
| Encrypt Files (e.g. %f.e%e)(-Eencrypt) | Encrypts using the given key with the -Ekey: Encryption Key option. |
| Encryption key (-Ekey) | Encrypt files with the given key number (-Eencrypt option).The default encryption key is 0. Using this default is not recommended. |
| Object File Format | Defines the object file format. |
| Generate Assembler Include File (e.g. %f.inc)(-La) | Enables the Compiler to generate an assembler include file when the CREATE_ASM_LISTING pragma occurs. The name of the created file is specified by this option. If no name is specified, a default of %f.inc is taken. To put the file into the directory specified by the TEXTPATH: Text File Path environment variable, use the option -la=%n.inc. The %f option already contains the path of the source file. When %f is used, the generated file is in the same directory as the source file. The content of all modifiers refers to the main input file and not to the actual header file. The main input file is the one specified on the command line. |
| Generate Listing File (e.g. %n.lst)(-Lasm) | Enables the Compiler to generate an assembler listing file directly. The Compiler also prints all assembler-generated instructions to this file. The option specifies the name of the file. If no name is specified, the Compiler takes a default of %n.lst. If the resulting filename contains no path information the Compiler uses the TEXTPATH: Text File Path environment variable. The syntax does not always conform with the inline assembler or the assembler syntax. Therefore, use this option only to review the generated code. It cannot currently be used to generate a file for assembly. |
| Log predefined defines to file (e.g. predef.h)(-Ldf) | Enables the Compiler to generate a text file that contains a list of the compiler-defined #define. The default filename is predef.h, but may be changed (e.g., -Ldf="myfile.h"). The file is generated in the directory specified by the TEXTPATH: Text File Path environment variable. The defines written to this file depend on the actual Compiler option settings (e.g., type size settings or ANSI compliance). Note: The defines specified by the command line (-D: Macro Definition option) are not included. This option may be very useful for SQA. With this option it is possible to document every #define which was used to compile all sources. Note: This option only has an effect if a file is compiled. This option is unusable if you are not compiling a file. |
| List of included files to `.inc' file (-Li) | Enables the Compiler to generate a text file which contains a list of the #include files specified in the source. This text file shares the same name as the source file but with the extension, *.inc. The files are stored in the path specified by the TEXTPATH: Text File Path environment variable. The generated file may be used in make files. |
| Write static output to file (e.g. logfile.txt)(-Ll) | Enables the Compiler append statistical information about the compilation session to the specified file. The information includes Compiler options, code size (in bytes), stack usage (in bytes) and compilation time (in seconds) for each procedure of the compiled file. The Compiler appends the information to the specified filename (or the file make.txt, if no argument given). Set the TEXTPATH: Text File Path environment variable to store the file into the path specified by the environment variable. Otherwise the Compiler stores the file in the current directory. |
| List of included files in make format (e.g. make.txt)(-Lm) | This option causes the Compiler to generate a text file which contains a list of the #include files specified in the source. The generated list is in a make format. The -Lm option is useful when creating make files. The output from several source files may be copied and grouped into one make file. The generated list is in the make format. The filename does not include the path. After each entry, an empty line is added. The information is appended to the specified filename (or the make.txt file, if no argument is given). |
| Append object file name to list (e.g.obklist.txt)(-Lo) | This option causes the Compiler to append the object filename to the list in the specified file.The information is appended to the specified filename (or the file make.txt file, if no argument given). |
| Processor output (e.g. %n.pre)(-Lp) | This option causes the Compiler to generate a text file which contains the preprocessor's output. If no filename is specified, the text file shares the same name as the source file but with the extension, *.PRE (%n.pre). The TEXTPATH environment variable is used to store the preprocessor file. |
| Strip path information (-NoPath) | Check to enable the compiler remove both unreferenced path reference from your program. This reduces your program's memory footprint. |