CHAPTER 3 W ORK B ENCH
3.6 Project and Work Space
The work bench manages a program development task using a work space folder and a project file that contains file and other information necessary for invoking the development tools.
3.6.1 Creating a New Project
A new project file can be created by the following procedure:
1. Select [New] from the [File] menu or click the [New] button.
[New] button
The [New] dialog box appears.
2. Select [E0C Project File] and click [OK].
The [Project] dialog box appears.
3. Enter a project name, select an ICE parameter file and select a directory, then click [OK].
∗ The [ICE parameter file:] box lists the parameter files that exist in the "dev63" directory.
The work bench creates a folder (directory) with the specified project name as a work space, and puts the project file (.epj) into the folder.
If a folder which has the same name as that of a specified one already exists in the specified location, the work bench uses the folder as the work space. Thus you can specify a folder in which sources are created.
The specified project name will also be used for the absolute object and other files.
3.6.2 Inserting Sources into a Project
The sources created must be inserted into the project.
To insert a source into a project, use one of the four methods shown below:
1. [Insert | Files into project...] menu item
A dialog box appears when this menu item is selected.
Choose a source file from the list box and then click [Open].
2. [File | Open...] menu item or [Open] button [Open] button
A dialog box appears when this menu item or button is selected.
Choose a source file from the list box and select the [Into project] button, then click [Open].
3. [Insert into project] button on the [Edit] window [Insert into project] button
When the source file has been opened, click the [Insert into project] button on the [Edit] window. Do not forget to save the source to the file before inserting into the project.
4. Dragging source files on the [Project] window
Drag source files from Windows Explorer to the [Project] window. These files will be added to the current project.
When a source file is inserted into the project, the source file name appears in the [Project] window.
Removing a source from the project
To remove a source file from the project, select the source in the [Project] window and then press the [Delete] key. This removes only the source information, and does not delete the actual source file.
3.6.3 [Project] Window
The [Project] window shows the work space folder and the source files included in the project that has been opened.
When a source file icon is double-clicked, the source file will be opened or the corresponding [Edit]
window will be activated.
Shortcut menu in the [Project] window
When the folder icon or a source file icon is clicked with the right mouse button, a shortcut menu including the available build menu items appears.
[Properties...] shows the source file information as follows:
Note: Note that the list in the [project] window is not the actual directory structure.
Sources of the project in other folders than the work space folder are also listed as they exist in the work space folder.
3.6.4 Opening and Closing a Project
To open a project, select [Open WorkSpace...] from the [File] menu.
A dialog box appears allowing selection of a project file.
The work bench allows only one project to be opened at a time. So if a project has been opened, it will be closed when another project is opened. At this time, a dialog box appears to select whether the current project file is to be saved or not if it has not already been saved after a modification.
The project file can also be opened by selecting [Open] from the [File] menu or clicking the [Open]
button. In this case, choose the file type as E0C Project Files (*.epj) in the file open dialog box.
To close the currently opened project file, select [Close WorkSpace] from the [File] menu. At this time, a dialog box appears to select whether the current project file is to be saved or not if it has not already been saved after a modification. If [Yes] (save) is selected in this dialog box, all the modification items
includ-3.6.5 Files in the Work Space Folder
The work bench generates the following files in the work space folder:
<file>.epj Project file
This file contains the project information.
<file>.cm Linker command file
This file is generated when a build task is started, and is used by the linker to generate an absolute object file.
Example:
; E0C WorkBench Generated
; Thursday, November 05, 1998
"C:\E0C63\dev63\DEV63A08\PAR63A08.PAR" ;ICE parameter file -o "test.abs" ;output file : absolute object
; linked object file(s)
"sub.o"
"main.o"
The contents vary according to the source files included in the project and the linker option setting.
<file>.cmd Debugger startup command file
This file is generated when a build task is started, and is used by the debugger to execute the com-mand in this file when it is started up.
Example:
lf "test.abs"
The work bench generates this file so that the executable file according to the format selection is loaded when the debugger starts up.
<file>.mak "make" file for build task
This file is generated when a build task is started, and is used for the build process in the work bench.
Example:
# E0C WorkBench Generated
# Thursday, November 05, 1998 ASM = as63.exe
test.abs : test.cm sub.o main.o
$(LINK) $(LINK_FLG) test.cm sub.o : C:\E0C63\Test\sub.s
$(ASM) $(ASM_FLG) C:\E0C63\Test\sub.s main.o : C:\E0C63\Test\main.s
$(ASM) $(ASM_FLG) C:\E0C63\Test\main.s
This is a generic make file that contains macro setting and dependency list.
The following files are generated by the development tools during a build process:
<file>.o Relocatable object files (generated by the assembler)
<file>.abs Absolute object file (generated by the linker)
<file>.hsa, <file>.lsa, <file>.csa Motorola S files (generated by the HEX converter when this format is specified in the work bench)
<file>h.hex, <file>l.hex, <file>c.hex Intel HEX files (generated by the Hex converter when this format is specified in the work bench)