Chapter 5 Work Bench
5.2.4 Executing Individual Tools
Each software tool can be executed using the buttons in the execution window.
To execute a software tool
1. Choose the startup options of the tool you want to be executed in the execution window.
2. Choose the file you want to be input to a software tool using the file list box and click on the tool's execution button.
Multiple input files can be selected. In this case, the software tool is executed repeatedly as many times as the number of files selected.
About [Stop] button
[Stop] button
Once you execute a software tool using the execution button, processing cannot be stopped in the wb33 until the tool (including make) finishes processing. However, if the tool is executed after selecting multiple files, processing can be halted by using the [Stop] button. Since a software tool processes one file at a time no matter how many files are selected, execution of the tool is halted when it finishes processing the file that was being processed when you clicked on the [Stop] button.
The following outlines the files input and output by each software tool and the startup options of each tool that can be selected by the wb33. (For make, refer to Section 5.2.6.) Explained below is the function of each option when selected.
For more information, refer to the chapters where each tool is detailed.
C Compiler gcc33 Execution button:
Input file: *.c (C source file; lower-case is only allowed for ".c", ".C" cannot be used.) Output file: *.ps (assembly source file bearing the same name as input)
Options:
Vdebug info: Selection of the -g option (turned on by default)
The information required for the C source level debug is generated in the output file.
Normally, you should choose this option.
CHAPTER 5: WORK BENCH
E0C33 FAMILY EPSON 59
define: Selection of the -D option (turned off by default)
This option defines the macro name used in a conditional compilation. Input the definitions in the text box to the right of this option. When defining multiple macro names, separate each with a comma (,).
{NO, {O, {O2, {O3: Selection of a -O, -O2 or -O3 option (O by default) This option selects the optimization level.
inline memcopy: Selection of the -mno-memcpy option (turned off by default) This option expands the strcpy or memcpy function in-line.
include path: Selection of the -I option (turned off by default)
The directory selected in the directory list box to the right of this option is set in one of the directories where the include file is searched.
Preprocessor pp33 Execution button:
Input file: *.s (assembly source file)
Output file: *.ps (assembly source file bearing the same name as the input) Options:
debug info: Selection of the -g option (turned on by default)
The information required for debugging at the assembly source level is generated in the output file. Normally, you should choose this option.
define: Selection of the -d option (turned off by default)
This option defines the define name used in a conditional assembly. Input the definitions in the text box to the right of this option. When defining multiple define names, separate each with a comma (,).
Instruction Extender ext33 Execution button:
Input files: *.ps (assembly source file)
*.cmx (command file, specification of option required) Output file: *.ms (assembly source file bearing the same name as the input) Options:
use .cmx file: Selection of the -c option (turned off by default)
This option inputs a command file (.cmx) and executes it. When this option is selected, be sure to choose a .cmx file from the file list box of the execution window.
global pointer optimize: Selection of the -gp option (turned off by default)
This option performs optimization by a global pointer. When this option is selected, input the address of the global pointer in the text box to the right of this option.
far call is 2 inst: Selection of the -near option (turned off by default)
This option generates two instructions (one ext + branch instruction) for a jump to a nonexistent label in the file being processed. If this option is not selected, three instructions (two ext + branch instruction) are generated for the jump.
symbol,map optimize: Selection of the -lk option (turned off by default)
This option performs optimization using the symbol and link map files output by the linker. The source files that have been linked can be optimized. When this option is selected, input a common name for the symbol and map files in the text box to the right of this option.
CHAPTER 5: WORK BENCH
Vchange threshold: Selection of the -j option (turned off by default)
This option specifies the threshold value to be used for a branch instruction over a relatively long distance. When this option is specified, input a threshold value in the text box to the right of this option. If this option is not specified, a threshold value of 0x180000 is assumed.
Assembler as33 Execution button:
Input file: *.ms (assembly source file)
Output file: *.o (object file bearing the same name as the input) Options:
Vdebug info: Selection of the -g option (turned on by default)
The information required for debugging is generated in the output file. Normally, you should choose this option.
Vlist file: Selection of the -l option (turned off by default) This option generates an assembly list file.
Linker lk33 Execution button:
Input files: *.cm (command file, specification of option required)
*.o (object file)
Output file: *.srf (object file in srf33 format) Options:
Vdebug info: Selection of the -g option (turned on by default)
The information required for debugging is generated in the output file. Normally, you should choose this option.
Vuse .cm file: Selection of the -c option (turned on by default)
This option links modules according to the commands written in a command file. When this option is selected, be sure to choose a .cm file from the file list box of the execution window. Normally, you should specify this option.
Vsymbol,map file: Selection of the - s and -m options (turned on by default)
This option generates a symbol and a link map file. These files are used during optimization by the Instruction Extender.
Debugger db33 Execution button:
Input file: *.par (parameter file) Options:
Debugger mode:Selection of the -sim, -icd or -mon option (ICD mode by default)
This option selects a debugger operating mode.
CHAPTER 5: WORK BENCH
E0C33 FAMILY EPSON 61
1 win: Selection of the -w option (turned off by default)
This option opens only the [Command] window when the Debugger starts up. If this option is not selected, the [Command], [Source] and [Register] windows are opened.
small font: Selection of the -sf option (turned off by default)
This option changes the font used in the debugger window to 10-point Terminal. The default font is 14-point FixedSys.
Communication rate: Selection of the -b option (115200 bps by default)
This option selects the rate of communication with the ICE33, ICD33 or MON33 (DMT33MON).
When using the ICE33 or ICD33, make sure that the DIP switch on the ICE33/ICD33 has been set correctly.
Serial port: Selection of the -comX option (com1 by default) This option selects the personal computer's serial port.
db33 *.cmd file: Selection of the -c option (turned off by default)
This option executes a specified debug command file when the Debugger starts up. When this option is selected, choose a debug command file from the file list box located below the option select button. This list box displays the debug command file names in the directory currently selected in the execution window.
Parallel port: Selection of the -lptX option (No by default) This option selects the personal computer's parallel port.
Disassembler dis33 Execution button:
Input file: *.srf (object file in srf33 the format)
Output file: *.dis (disassembly list file bearing the same name as the input) Options:
src mix: Selection of the -m option (turned on by default)
This option outputs disassembled lines to a disassembly list file with the source corresponding to it. If a data section is encountered, its dump is output.
code only: Selection of the -c option (turned off by default) This option outputs a disassembly list of only code sections.
data only: Selection of the -d option (turned off by default) This option outputs only a dump of data sections.
Note: These three options can be selected simultaneously, however, choose one option at a time. If multiple options are selected simultaneously, one or all specifications may be invalidated depending on the combination of selected options. (Refer to Section 13.3.2.)
addr range: Selection of the -a option (turned off by default)
This option specifies an address range for disassembling. When using this function, enter the start and end addresses in the text box.
CHAPTER 5: WORK BENCH
Binary/HEX Converter hex33 Execution button:
Input file: *.srf (object file in srf33 format)
Output file: *.sa* (file in Motorola S3 format bearing the same name as the input) Options:
Address range: Selection of an address range (0xc00000 to 0xc0ffff by default) This option specifies an address range in the input file representing the extent to which the data is converted. The start and end addresses specified here must reside on the 32-byte boundaries.
abs addr: Selection of the -z option (turned on by default)-
This option generates an output file that contains absolute address information. Unless this option is selected, the output address is an offset address from the address at which conversion is started.
addr to name: Selection of the -x option (turned on by default)
This option adds information on a specified address range after the extension ".sa" of the output file.
Example: test.sa_c00000_c0ffff
If this option is not selected, the extension will consist of only ".sa".
Librarian lib33 Execution button:
Input files: *.lib (library file) Selected in the execution window
*.o (relocatable object file) Selected in the option window Output files: *.lib (library file)
*.o (relocatable object file) Options:
{list: Selection of the -l option (turned on by default)
This option lists the object files registered in the library file in the output window (default) in the order in which they are registered.
{add: Selection of the -a option (turned off by default)
This option adds the object files (can be multiple files) that are selected in the [*.o for new, add] list box to a specified library file.
{new: Deselecting all options (turned off by default)
This option creates a new library file. Input the library file name in the text box located below the option button. No extension is required. Choose the object files you want to register from the [*.o for new, add] list box (multiple files selectable).
If you specify a library name present in the current directory, the object files are added to the existing file in the same way as when the [add] option is selected.
{del: Selection of the -d option (turned off by default)
This option deletes a specified object from the library file. Input the object name you want deleted in the text box provided below the option button. No extension is required.
{extract: Selection of the -x option (turned off by default)
This option restores a specified object of the library file in the current directory as a file.
Input the object name you want restored in the text box provided below the option button.
No extension is required.
{extract all: Selection of the -x option (turned off by default)
This option restores all the objects of the library file in the current directory as a file.
CHAPTER 5: WORK BENCH
E0C33 FAMILY EPSON 63