Renesas Network Card TM V320A User Guide

TM V.3.20A  
Integrated Development Environment  
User’s Manual  
Rev. 1.00  
May 01, 2003  
REJ10J0018-0100Z  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Contents  
3
Download from Www.Somanuals.com. All Manuals Search And Download.  
4
Download from Www.Somanuals.com. All Manuals Search And Download.  
5
Download from Www.Somanuals.com. All Manuals Search And Download.  
Figures  
6
Download from Www.Somanuals.com. All Manuals Search And Download.  
7
Download from Www.Somanuals.com. All Manuals Search And Download.  
1. Introduction  
1.1 Operating Environment  
The following lists the host computers and OS versions on which TM has been verified to run.  
HostComputer  
OSVersion  
Handling instructions  
IBMPC/ATor compatible  
Microsoft Windows95  
MorethanInternetExplorer4.0isbeinginstalled.  
Microsoft Windows98, 98SE  
Microsoft WindowsMe  
Microsoft WindowsNT 4.0  
Microsoft Windows2000  
Microsoft WindowsXP  
ToinstallTM, theuserhave to begrantedthe  
administratorprivilege.  
Note that the TM does not run on Windows 3.1, Windows NT 3.51 or earlier, and EWS.  
If your host computer or OS is not one of the above, please contact the manufacturer of your computer or OS to  
confirm whether the software running under the above conditions will also work on the computer and OS that you now  
have.  
Please note that utility software such as a virus check program or performance acceleration tool may affect part of  
the TM functions.  
The table below lists the recommended hardware requirements.  
Main Memory  
Freediskcapacity  
CRT  
Sufficient memorysizeinwhichOSoperatesnormally(16Mbytesor more)  
20 Mbytesor more  
1024x768orhigherisrecommended  
9
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
1.2 Installation Method  
1.2.1 Executing the Installer  
To install the TM, execute the installer included with it.  
z
z
Follow the messages displayed on the screen by the installer as you install the TM.  
The following lists the installer programs included with the package:  
Language  
Japanese  
English  
Installername  
\TM\W95J\SETUP  
\TM\W95E\SETUP  
1.2.2 Notes about TM Versions  
When you are installing the TM over an existing version of TM, the installer displays a message to that effect. To  
install TM V.3.20A on the same PC that has the version before V.2.xx already installed in it, specify a new directory to  
install, and not the directory in which the earlier version is installed.  
In cases where you have any cross tool which has had TM V.1xx bundled (e.g., NC30 WA V.3.00 Release 1) and is  
installed along with the TM, if you install TM V.3.20A in the same directory without uninstalling TM V.1xx and then  
uninstall the cross tool, you will become unable to use TM V.3.20A. In such a case, reinstall TM V.3.20A.  
1.2.3 Compiler and real time OS Combinations  
TM V.3.20A operates normally in one of the following combinations of compilers and real time OS. Use TM V.2.01  
when you combine and use compiler or real time OS except for these.  
TM  
Compiler Product  
Real time OS Product  
*
V.3.20A  
After NC30WA V.4.00 Release 1  
MR30 V.3.00 Release 1  
After MR30 V.3.20 Release 1  
*
After NC308WA V.3.00 Release 1  
After NC79WA V.4.00 Release 1  
MR308 V.1.00 Release 1  
After MR308 V.1.00 Release 2  
*
MR79 V.1.10 Release 1  
After MR79 V.2.00 Release 1  
After CC32R V.3.00 Release 1  
After NC77WA V.5.20 Release 4  
After SRA74 V.4.10 Release 1  
After MR32R V.3.30 Release 1  
*
MR7700 V.3.20 Release 3  
----------  
When using any product marked by *and TM V.3.20A in combination  
Once, Carry out V2CVT.EXEof the CD-ROM directory ([TM_V2]-[W95e]) which a TMV.2.01 installation  
program is in through. This program is Wizard form in the same way as the installation program. When operation  
is completed in accordance with the process, TM recognizes the product of the *mark.  
10  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
1.2.4 Directories and Files Generated After Installation  
When you finished installing the TM, the directories shown below are created in the directory in which you’ve  
installed the TM, and the files listed below are copied into these directories.  
Directory  
bin  
File  
ProjectBar.exe (Project bar execution file)  
ProjectEditor.exe (Project editor execution file)  
Builder.exe (Builder execution file)  
Inspector.exe (Inspector execution file)  
Server.exe (Communication server execution file)  
Make.exe (GNU Make execution file)  
MtmSubp.exe (Builder subprogram)  
BuilderPs.dll (Builder subprogram)  
InsPs.dll (Inspector subprogram)  
ProjectBarPs.dll (Project bar subprogram)  
ProjectEditorPs.dll (Project editor subprogram)  
ServerPs.dll (Communication server subprogram)  
BuildErr.dll (Builder subprogram)  
Ie_Inspect.dll (Inspector subprogram)  
InsErr.dll (Inspector subprogram)  
Insp_Inter.dll (Inspector subprogram)  
Makefile.dll (Project editor subprogram)  
PBResEn.dll (Project Bar resource file for English)  
PEResEn.dll (Project editor resource file for English)  
BldResEn.dll (Builder resource file for English)  
InsResEn.dll (Inspector resource file for English)  
Tme.hlp (TM help file)  
Tme.cnt (TM help contents file)  
ProjectBar.hlp (Project bar help file)  
Tmue.pdf (TM electronic manual)  
manual  
Furthermore, the following files are copied into the directory where the OS is installed.  
Directory  
SYSTEM  
File  
Atl.dll (ATL support DLL)  
11  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
1.3 Usage Precautions  
1.3.1 Notes about File Names  
The source program file names and work directory names are subject to the following limitations:  
z
z
z
z
z
No directory or file names that include kanji (2-byte characters) can be used.  
Only one instance of the period (.) can be used in a file name.  
No network path names can be used. Assign the directory you use to a drive name.  
No shortcuts can be used.  
No directory or file names that include a space character can be used.  
Example: My Documentsor Program Files”  
z
z
The ...notation cannot be used to specify two or more directories.  
File names exceeding 128 characters in length including path specification cannot be used.  
1.3.2 Notes about Updating of Dependency Relations  
In the analysis of file contents (detection of include files) performed while updating dependency relations, no  
judgment is made with respect to whether #define statements are defined or not.  
Also, for #if...#else...#endif statements, analysis is always made of the contents of source files between #if and #else  
regardless of whether or not the condition statement holds true. Although there will be a case that you cannot find your  
intended header files on the TM display, build (compile, assemble, and link) processing is performed exactly as written  
in the source files.  
1.3.3 Notes about Utility Software such as Virus Check Program  
If build is executed while a specific version of utility software such as a virus check program or performance  
accelerator is memory resident, a problem may occur that build execution results are not displayed on the builder. In  
such a case, upgrade the utility software version or remove the utility software from memory while you use the TM.  
1.3.4 Notes about Network  
If you have the project or source files located on a network drive, make sure the computer on which you run the TM  
and the computer on which files are placed are matched in time. Otherwise, build may not work correctly.  
1.3.5 Notes about Inspector  
In the project which used the compiler shown below, since an inspector has use restrictions, please be careful.  
SRA74  
NC77WA  
CC32R  
Inspector  
function definition  
function reference  
variable definition  
variable reference  
---  
---  
---  
---  
---  
---  
---  
---  
---  
---  
---  
---  
*
---  
*
---  
*
MAPViewer  
STKViewer  
---  
* : Use is possible.  
--- : That an informational display is impossible or use is impossible.  
12  
Download from Www.Somanuals.com. All Manuals Search And Download.  
           
1.3.6 Makefile of library source.  
A project can’t make it normally when makefile.dos of the compiler accessory is read with TM. Carry out Make in  
accordance with User’s Manual of the compiler from the Dos window when you change standard input and output  
library.  
1.3.7 The TM project of the former version was taken over.  
Precondition: With NC30WA, NC308WA, and NC79WA in the combination  
When the project made with TM of the former version is read, Inspector information output option “-finfo” isn’t added  
automatically, and it can’t indicate information with Inspector. Carry out building after you add a “-finfo” option to  
CFLAGS and AFLAGS to indicate Inspector information.  
1.3.8 Use real time OS  
Be careful because a compilation option and the designation of link library must be changed when you change the  
next definition item of Configration file.  
And, refer to the manual of the real time OS which copes with it for Configration file and the details of each definition  
item.  
1.3.8.1 In the case of MR308 (for the M16C/80, M32C/80 series)  
1) When 32 was specified in the message size.  
Compilation option  
Link library  
:
:
-Dfar_msg=1 is specified.  
mr308lm.lib and c308mrlm.lib are specified.  
<Example>  
system {  
:
message_size = 32;  
:
};  
2) When 16 was specified in the message size or designation was omitted.  
Compilation option  
Link library  
:
:
-Dfar_msg=1 isnt specified.  
mr308.lib and c308mr.lib are specified.  
<Exapmle>  
system {  
:
message_size = 16;  
:
};  
3) When you put the source file of C besides Working Directory(.\).  
Compilation option -I.  
4) When you put the assembler source file besides Working Directory(.\).  
Assembly option -I.  
5) When you specify the output destination of the objects besides Working Directory(.\).  
mr308tbl option The directory is specified at the output destination.  
:
:
:
1.3.8.2 In the case of MR30 (for M16C/60, 20 series)  
1) When 32 was specified in the message size.  
Compilation option  
Link library  
:
:
-Dfar_msg=1 is specified.  
mr30lm.lib and c30mrlm.lib are specified.  
<Expamle>  
system {  
:
message_size = 32;  
:
};  
13  
Download from Www.Somanuals.com. All Manuals Search And Download.  
         
2) When 16 was specified in the message size or designation was omitted.  
Compilation option  
Link library  
:
:
-Dfar_msg=1 isnt specified.  
mr30.lib and c30mr.lib are specified.  
<Example>  
system {  
:
message_size = 16;  
:
};  
3) When you put the source file of C besides Working Directory(.\).  
Compilation option -I.  
4) When you put the assembler source file besides Working Directory(.\).  
Assembly option -I.  
5) When you specify the output destination of the objects besides Working Directory(.\).  
mkmrtbl option The directory is specified at the output destination.  
:
:
:
1.3.8.3 In the case of MR79 (for 7900 series)  
All version  
1) The option which you must surely specify  
Assembly option  
2) When you put the source file of C besides Working Directory(.\).  
Compilation option -I.  
3) When you put the assembler source file besides Working Directory(.\).  
Assembly option -I.  
:
-DC_inc=0  
:
:
When combining with the version before V.2.10 Release1  
1) 24 was specified in the message size. When STANDARD was specified in the interruption prohibition model  
or designation was omitted.  
Compilation option  
:
:
-Dfar_msg=1 fMJI is specified.  
Link library  
<Expamle>  
mr79lm.lib and c79mrlm.lib are specified.  
system {  
:
message_size = 24;  
interrupt_model = STANDARD;  
:
};  
2) When 24 was specified in the message size and SHORT was specified in the interruption prohibition model.  
Compilation option  
Link library  
:
:
-Dfar_msg=1 is specified, and fMJI isnt specified.  
mr79lmi.lib and c79mrlmi.lib are specified.  
<Example>  
system {  
:
message_size = 24;  
interrupt_model = SHORT;  
:
};  
14  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
3) When 16 was specified in the message size or designation was omitted, and STANDARD was specified in  
the interruption prohibition model or designation was omitted.  
Compilation option  
Link library  
:
:
-Dfar_msg=1 isnt specified, and fMJI is specified.  
mr79sm.lib and c79mrsm.lib are specified.  
<Example>  
system {  
:
message_size = 16;  
interrupt_model = STANDARD;  
:
};  
4) When 16 was specified in the message size and or designation was omitted, and SHORT was specified in the  
interruption prohibition.  
Compilation option  
Link library  
:
:
-Dfar_msg=1 isnt specified, and fMJI is specified.  
mr79smi.lib and c79mrsmi.lib are specified.  
<Example>  
system {  
:
message_size = 16;  
interrupt_model = SHORT;  
:
};  
5) When a time-out function is used.  
Compilation option  
<Example>  
:
-Dtimeout=1 is specified.  
system {  
:
timeout = YES;  
:
};  
6) When a time-out function isnt used.  
Compilation option  
<Example>  
:
-Dtimeout=1 isnt specified.  
system {  
:
timeout = NO;  
:
};  
1.3.8.4 In the case of MR7700 (for 7700 series)  
1) When you put the source file of C besides Working Directory(.\).  
Compilation option -I.  
:
2) 24 was specified in the message size. When STANDARD was specified in the interruption prohibition model  
or designation was omitted.  
Compilation option  
:
:
-Dfar_msg=1 is specified.  
Link library  
<Expamle>  
mr77lm.lib and c77mrlm.lib are specified.  
system {  
:
message_size = 24;  
interrupt_model = STANDARD;  
:
};  
15  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
3) When 24 was specified in the message size and SHORT was specified in the interruption prohibition model.  
Compilation option  
:
:
-Dfar_msg=1 is specified.  
Link library  
<Example>  
mr77lmi.lib and c77mrlm.lib are specified.  
system {  
:
message_size = 24;  
interrupt_model = SHORT;  
:
};  
4) When 16 was specified in the message size or designation was omitted, and STANDARD was specified in  
the interruption prohibition model or designation was omitted.  
Compilation option  
Link library  
:
:
-Dfar_msg=1 isnt specified.  
mr77sm.lib and c77mrsm.lib are specified.  
<Example>  
system {  
:
message_size = 16;  
interrupt_model = STANDARD;  
:
};  
5) When 16 was specified in the message size and or designation was omitted, and SHORT was specified in the  
interruption prohibition.  
Compilation option  
:
:
-Dfar_msg=1 isnt specified.  
Link library  
<Example>  
mr77sm.lib and c77mrsmi.lib are specified.  
system {  
:
message_size = 16;  
interrupt_model = SHORT;  
:
};  
1.3.8.5 In the case of MR32R (for M32R series)  
1) When you put the source file of C besides Working Directory(.\).  
Compilation option -I.  
2) When you put the assembler source file besides Working Directory(.\).  
Assembly option -I.  
:
:
16  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
2. Overview  
2.1 Integrated Development Environment  
The Integrated Development Environment, TM, has been devised to increase the efficiency of software development  
by integrating various tools such as the compiler, assembler, debugger, and editor into a common Graphical User  
Interface (GUI). The TM has the following three primary functions:  
z
z
z
Manages the software development process using the concept of a project  
Provides a seamless environment as a common GUI for various tools  
Based on static program analysis, supports problem identification and reverse engineering needed during  
large-scale software development  
These functions together offer a greatly improved, comfortable development environment as compared when using  
various tools individually.  
Fig. 2-1 Example of Software Development Using the TM  
17  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
2.2 Concept of a Project  
The TM manages the software development process using the concept of a project. Following are managed as part of a  
project by the TM:  
z
z
z
z
z
Procedural information necessary to generate the final object (normally the executable object)  
Information on source files associated with development  
Information on compile, etc. options  
Information on development members  
Information on development-related documents  
You specify these items of information as you define a project. Furthermore, the TM reads out the following  
information which was recorded to a file when the compiler, etc. were installed.  
z
Information on generation dependency relationship for the MCU family used  
All these pieces of information are stored in a project file for management purposes. A project file actually consists of  
the following two types of files:  
z
z
Project name.TMKfile  
Project name.TMIfile  
The TMK file is prepared in the “makefile format” corresponding to the make command that is used standard in the  
UNIXTM operating system, etc. This file contains the information necessary to generate the final object. On the other  
hand, the TMI file contains information about the development members or documents that cannot be accommodated  
by the makefile format TMK file. The project name always matches the project file names. The current project name  
is displayed on the project bar when you start the TM.  
Fig. 2-2 Project Name  
1
Because a project name is used for file names, project names are subject to the same limitations as are file names. For example, any string that  
contains kanji cannot be used for a project name.  
2
Although when you created a new project, the final object name is created from the project name, the final object name and the project name do not  
always have to coincide.  
18  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
2.3 Roles of Each Tool Working under the TM  
The TM works in close cooperation with many tools. Some of these tools have GUI as WindowsTM programs, and  
others such as the C compiler or assembler or the GNU Make command operate at the back end of the TM.  
The diagram below schematically shows the primary tools controlled by the TM.  
Project Bar  
Map Viewer  
STK Viewer  
Editor  
Builder  
Inspector  
Debugger  
Project  
Editor  
Read  
Read  
Read  
Edit  
Source File  
Read  
Edit  
GNU Make  
Absolute object file  
Makefile  
Read  
Generate  
C compiler, assembler  
Fig. 2-3 Conceptual Diagram of the TM  
Those included in TM V.3.20A  
Project Bar  
The project Bar plays the central role of the TM, helping to accomplish a linked startup of each tool. To start the TM,  
you start the Project Bar. To exit the TM, you close the Project Bar.  
Fig. 2-4 Project Bar  
When you start the Project Bar, the TM creates a process named the “server” which exchanges tool linkage  
information.  
3
Should a problem occur such as when the TM terminates abnormally, the serverprocess may remain active without being closed. In such a case,  
because the TM cannot be restarted under this condition, press the Ctrl + Alt + Del keys to bring up Close Program(Task Manager) and close the  
server.  
19  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
Project Editor  
Use the Project Editor to define or alter the source files, compile options, or generation procedure included in a project.  
The Project Editor works as an editor for the “makefile” handled by the GNU Make command.  
Fig. 2-5 Project Editor  
Builder  
The Builder invokes the GNU Make command to build a project based on the “makefile (TMK file)” created by the  
Project Editor.  
Fig. 2-6 Builder  
4
When you added to or altered a project with the Project Editor, save the project to make your editing reflected in it. If you do not save the project  
before operating on it, you are prompted to save.  
20  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Inspector  
The Inspector provides a facility that based on the debug information included in the “absolute object file” generated  
by build, analyzes the locations where functions and variables are defined or referenced. Unlike a simple string search,  
the Inspector does the search based on the information embedded by the compiler. As a result, the following  
advantages accrue:  
z
z
z
Comments and other non-compiled parts are not searched  
Can be searched separately for references and definitions  
Even when divided into multiple source files, the entire program can always be searched  
Fig. 2-7 Inspector  
GNU Make  
The GNU Make command is an open-source software item compatible with the Make command available in the  
UNIXTM operating system. It can be freely distributed according to GPL (GNU Public License). The GNU Make  
command manages build operation based on the file dependency relations described in files known as the “makefile”  
(e.g., a file .x30 is created from a file .r30).  
5
The information on source file line numbers indicated by the Inspector is derived from syntactical analysis of the  
source file by the compiler, etc. Therefore, the information is displayed at positions where syntactical analysis is  
completed (same as displayed on the debugger). Because the grep command, etc., indicates the location of a searched  
string, whereas the Inspector indicates separation in language syntax, there will be a difference between the two. For  
example,  
int func( char, <Searched at this position by grep  
int);  
<For the Inspector, this position is searched  
21  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Those included with the compiler package  
Compiler and Assembler  
TM V.3.20A currently supports the following compilers available from Renesas :  
z
z
z
z
z
z
NC30WA V4.00 Release 1 or later  
NC308WA V3.00 Release 1 or later  
NC79WA V4.00 Release 1 or later  
CC32R V.3.00 Release1 or later  
NC77WA V.5.20 Release4 or later  
SRA74 V.4.10 Release1 or later  
For the Inspector function to be used, add the “-finfo” option before compiling/assembling the source files.  
Map Viewer  
The Map Viewer allows you to examine memory mapping.  
Fig. 2-8 Map Viewer  
6
When you are using other Renesas compiler products or some version of compilers other than these versions, you cannot use TM V.3.20A. In such  
a case, please use TM V2.01. Note that TM V.3.20A and TM V2.01 can coexist, so you can use either version as necessary.  
22  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
STK Viewer  
Use the STK Viewer to examine the amount of stack.  
Fig. 2-9 STK Viewer  
Others  
Editor  
Any editor available on the market and you are accustomed to may be used after registering it to the TM.  
Debugger  
In addition to the PDxx series debuggers available from Renesas, any third-party debugger may be used after  
registering it to the TM.  
TM  
TM  
application. For this reason, Java  
TM  
2 Runtime Environment (JRE ) is used. JRE  
TM  
7
The STK Viewer is included in the package as a Java  
is  
installed in the \install directory \BIN directory when installing the compiler.  
23  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
2.4 Directory Configuration  
This section describes how to configure the directory structure of the program when using the TM. When thinking of  
the directory structure, it is important to understand the exact meaning of the “working directory” and the form in which  
the source files registered to the project are entered “internally” in the system.  
Working Directory  
When generating a project, the Project Editor asks you to specify a working directory. This working directory has the  
following three roles:  
z
z
z
Directory in which to store the project files  
Directory in which to store the objects generated as the result of compilation  
Directory from which to start the compiler or debugger  
When working with a project, this is the directory from which you start the compiler, etc., to which you output objects,  
and in which you debug the program. (The source files, etc. do not always need to exist in locations below the working  
director.) If you want to store the files output by the compiler in one directory, it may be a good idea to make that  
directory the working directory.  
Directory for source files, etc.  
The directory in which the source files, etc. are registered by the Project Editor is as follows:  
z
Files located on the same drive as the working directory  
These files are registered with a relative path from the working directory  
Files located on a different drive than the working directory  
These files are registered with an absolute path  
z
Open the TMK file with an editor to examine how the source files are registered in your system.  
8
Prior to TM V2, we had the concept of an output directory. However, because this concept had difficulty processing the source line information and  
other problems, we in V3 combined the working directory and output directory into one.  
24  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Example of a directory structure  
With the above concept taken into account, a directory structure like the one shown below may be conceived.  
C:\WORK  
\ModelA  
\ModelB  
\SRCA  
Working directory for model A  
Working directory for model B  
Source directory for model A  
\SRCB  
Source directory for model B  
\COMMON  
\HEAD  
Common source directory for A and B  
Common header file for A and B  
Common source directory on a network  
G:\COMMON  
In this example, separate working directories, one for model A and one for model B, are prepared, in which a project  
is worked on. The files placed on drive C are managed with a relative path from the working directory. All the  
directories and files below the “\WORK” directory can be moved collectively to any desired location, providing that the  
relative path relationship is maintained.  
Prepared on drive G is the directory in which the common source files are stored when developing a project with  
multiple people. Because the drive is different, this directory is managed with an absolute path. Therefore, we  
recommend that this directory be assigned the same drive name on multiple computers.  
This is just an example. Any directory structure may be configured as desired, only if you know the meaning of the  
working directory and how the files are registered.  
9
Because network path names are not guaranteed for the TM to work properly, be sure to assign a drive for this common directory.  
25  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
3. Quick Tour  
3.1 Starting the TM and Registering the Editor Used  
When the TM has been installed normally, the TM can be started by selecting [Start] -> [Programs] -> [RENESAS-  
TOOL] -> [TM V.3.xx] -> [TM] from the Start menu. When the TM starts up, the Project Bar appears.  
Fig. 3-1 Project Bar in Floating State  
When started for the first time, the Project Bar is in a “floating” state. Grasp this window and bring it to the top of the  
screen, and you can have it located at the uppermost part of the desktop.  
Fig. 3-2 Project Bar Pasted at The Top  
Next, register the editor you normally use.  
Press the  
button. A dialog box for registering an editor appears.  
Fig. 3-3 Dialog Box for Registering an Editor  
26  
Download from Www.Somanuals.com. All Manuals Search And Download.  
         
Choose [EDIT TOOL].  
In the example below, the Peggy editor from Anchor Systems is registered.  
Fig. 3-4 Registering an Editor  
The TM does not have any particular editor internally. The editor is a most frequently used tool for program  
developers. To use an editor the program developers each know well and are accustomed to is we think the most  
efficient. The TM allows any editor available on the market to be registered for use in it.  
10  
The Peggy editor has its trial use version included in the Compilers and AssemblersCD-ROM from Renesas. Or it  
can be purchased from the URL shown below.  
For details about this editor, contact Anchor Systems.  
Note that the Peggy is for Japanese only.  
TM  
TM  
11  
Most MS-DOS  
based editors do not work well. We recommend editors that run in Windows  
27  
.
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
3.2 Creating a Project  
There are following three methods to create a project:  
z
z
z
Create a new project  
Read a project file of TM V2 or earlier version (MTM file) and convert it into TM V3 format project files  
Read an existing makefile and add additional information to create a project  
Because the TM can read in existing makefiles, a project can easily be created even when you are conventionally not  
using the TM.  
In this quick tour, we explain the method for creating a new project.  
Creating a new project  
Press the [New Project] button on the Project Bar.  
Fig. 3-5 [New Project] Button  
A wizard to create a new project appears.  
Fig. 3-6 New Project Wizard (Step 1)  
12  
Only the existing makefiles written with the GNU make compatible commands can be read into the TM. Those using NMAKE from Microsoft  
cannot be read. Note also that when reading an existing makefile, the TM does a partial read assuming macros such as CFLAGS which are  
customarily used for specific purposes. Therefore, if the makefile you read is contrary to general conventions, your expected results may not be  
obtained.  
28  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
Choose the target chip and set a project name and the working directory.  
Fig. 3-7 New Project Wizard (Step 2)  
Next, choose the type of project.  
Fig. 3-8 New Project Wizard (Step Compiler)  
29  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Choose [A default startup program is used.] for the startup program, and the startup program that comes standard with  
the compiler is copied into the working directory.  
Fig. 3-9 New Project Wizard (Step Finish)  
Click [Finish] on the above dialog box, and the basic project information is created.  
Registering files  
When the TM has finished creating initial project information, the Project Editor window appears.  
Fig. 3-10 Project Editor Immediately After Project Creation  
The Project Editor works internally as an editor for the makefiles handled by the GNU make command. The project  
view is a reflection of the concept of GNU make. To acquire a good command of the Project Editor, you need to  
understand the basic concept of GNU make.  
The basic structure of a makefile is as follows:  
target : dependencies  
command  
This means that target depends on dependencies, and that to get target from dependencies, command must be  
30  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
executed. If main.r30 is created from main.c, for example, write a statement as shown below.  
main.r30 : main.c  
nc30 -c main.c  
In such a case, display on the Project Editor should appear like the one shown below.  
Show command information on a selected file (item) on the right side of the window.  
The information will be displayed as shown above. What is meant by this is that main.r30 is created from main.c by an  
operation “$(CC)$(CFLAGS) main.c.”  
Now, we’ll show an example of a simple project.  
Fig. 3-11 Example of a Project  
In this example, there are two items at the top level: all and clean.  
all  
Item to build a project  
clean  
Item to delete generated objects  
These two are always displayed as essential items. (Other items can be added.)  
The item all creates a “ModelA.x30” file. The “ModelA.x30” file is created from the following three files (it depends  
on these three files):  
ModelA.cmd  
ncrt0.r30  
Command file used when linking  
Post-assemble object of the startup program  
Post-compile object of a program written in C language  
main.r30  
The “main.r30” file is created from the “main.c” file. This relationship of file generation is displayed with a Project  
Editor view.  
13  
For projects using the real-time OS, youll have CFGEXECONTM at the top level, in addition to the two items, all and clean. CFGEXECONTM is  
the item necessary to execute the configurator singly. However, since when you update the configuration file, it is automatically reconfigured,  
reconfiguration by this item normally is unnecessary.  
14  
When written in makefile description, this becomes as follows:  
all:  
ModelA.x30  
ModelA.x30:  
ModelA.cmd:  
ModelA.cmd ncrt0.r30 main.r30  
ModelA.tmk  
ncrt0.r30: ncrt0.a30 sect30.inc  
31  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Now, we’ll try adding a file to the project. Choose the final object and then [Add file] from the right-click menu.  
Fig. 3-12 Adding a File  
Choose the file to add.  
Fig. 3-13 Selecting a Source File  
Before you can create the final object file “ModelA.x30,” you must have “main.r30” registered in your project. The  
TM knows the dependency relationship between “.C” files and the “.R30” . When you register a “.C” file by making  
use of this, the file is registered reflecting the relationship between “.R30” and “.C” as judged by the TM.  
main.r30: main.c  
15  
For NC30WA and NC308WA, the relocatable object files are identified by the extension .R30.For NC79WA, the relocatable object files are  
identified by the extension .R79.Shown above is an example for NC30WA.  
16  
To update the dependency relations with the header files, use the [Scan All Dependencies] button. Unlike in TM V.2.01 or earlier, dependency  
relations are not searched for by only registering a file.  
32  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
In this example, when you register “main.c,” the TM registers “main.r30” simultaneously with it, producing the  
following display.  
Fig. 3-14 View after Registering Source Files  
When you register the source files, be sure to choose basically the final object (absolute object). The file may be  
registered for other items. In such a case, consider the relationship between target and dependencies in the “makefile”  
of the GNU make command as you work on file registration.  
Choosing compile options  
Use the “Option Browser” to choose or set compile (assemble) options.  
Fig. 3-15 Option Browser Start Button  
When the Option Browser starts up, a setup dialog box is displayed.  
Fig. 3-16 Option Browser  
33  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Definitions of the following are entered by default for each option, respectively:  
Compiler (nc30)  
CFLAGS  
AFLAGS  
LFLAGS  
Assembler (as30)  
Linker (ln30)  
Load module converter (lmc30)  
LMCFLAGS  
“CFLAGS” is a makefile macro, which defines the options used when compiling a program. Choose “CFLAGS” and  
press the [Mod] button, and the dialog box shown below appears.  
Fig. 3-17 Option Setup Dialog Box  
Use this dialog box to choose the options you want to choose. Choose the type of option from Category and check the  
options you need. Use [Other] when you set any option not found in the above check box or when you set a known  
option directly.  
17  
The -finfooption is needed for the inspector function to be used. Do not change options such as -cwhich are associated with make control.  
34  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Or when you want to use different compile options for each file, choose “nc30” press the [New] button. This creates a  
new macro named “CFLAGS1.” Choose options for this new macro and then the file for which you want the macro to  
be applied. In this way, you can use different options for each file.  
Choose the file for which  
to apply the macro  
Fig. 3-18 Creating a New Macro  
Registering development members  
To register the members participating in program development, use the [Add Member] button.  
Fig. 3-19 Button for Registering Member Information  
Fig. 3-20 Registering Member Information  
When added in this way, the members are recorded to a project file and the development member information can be  
managed as part of the project.  
35  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Registering documents  
Specifications and other documents can be registered. To register documents, use the [Add Document] button.  
Fig. 3-21 Button for Adding Documents  
For example, when you register development members and documents, the registered information can be displayed on  
a project view as shown below. Also, you can send a mail to a member or open a document by double-clicking on it.  
Fig. 3-22 Displaying Registered Development Members and Documents  
18  
Registering a document means registering file information. Therefore, you are not registering the content of the actual document file by registering  
a document.  
36  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
3.3 Building a Project  
The Project Editor is an editor. Therefore, if the project has been changed, it must be saved before building. To save a  
project, press the [Save] button on the Project Editor.  
Fig. 3-23 Save Button  
Next, press the [Build] button on the Project Bar.  
Fig. 3-24 Build Button  
This invokes the Builder, and the Builder starts building the project. If you attempted to build a project without  
saving it, the Project Editor prompts you to save.  
Fig. 3-25 Dialog Box for Confirmation to Save  
The Builder starts up, compiling, assembling, and linking the source files. If an error occurs while compiling, for  
example, double-click the location in error, and the editor starts up, showing the relevant location.  
Fig. 3-26 Error Display during Build Execution  
37  
Download from Www.Somanuals.com. All Manuals Search And Download.  
         
Analyzing with the Inspector  
The Inspector allows for static program analysis by reading into it the final object “ModelA.x30” that has been built.  
Use one of the Project Bar buttons shown below to start the Inspector.  
Detail Setup button  
Variable Reference Display button  
Variable Definition Display button  
Function Reference Display button  
Function Definition Display button  
String box  
Fig. 3-27 Buttons for Using the Inspector  
The Inspector performs functional analysis on the string which is entered in the String box by Copy & Paste.  
For example, when you want to find locations where a variable system_code is used in the program, first enter that  
string into the String box on the Project Bar by Copy & Paste or by typing directly from the keyboard.  
Fig. 3-28 Copying a String  
Fig. 3-29 Variable Reference Display Button  
Press the [Variable Reference Display] button, and the Inspector starts up and outputs information on locations where  
system_code is used.  
38  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Fig. 3-30 Showing Variable References  
In this example, system_code is used in five locations. The variable can be previewed in the window located below by  
selecting one instance of system_code. (The variable cannot be edited in this window. Double-click the variable location  
you want to select, and the editor starts up.) The square boxes on the left side of the list are check boxes which can be  
used in place of a memo.  
The basic method to use the Inspector is by Copy & Paste. However, if you enable the function to capture a copied  
string into the string storage box when you copy, you can omit Paste. To enable this function, press the [Customize]  
button on the Project Bar and turn on the check box [Auto Read from Clipboard.]  
Fig. 3-31[Auto Read from Clipboard] Check Box  
If the string storage box does not contain any string, i.e., the box is blank, all information is displayed. For example,  
when you press the [Function Reference Display] button while the box is blank, you will have a list of relationship of  
function calls.  
39  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Fig. 3-32 Showing Function References  
Starting the debugger  
The Debugger can be started from the Project Bar. However, before the Debugger can be started in this way, it must  
be registered to the project concerned. Press the [Tool Register] button, and a dialog box like the one shown below  
appears.  
Fig. 3-33 Registering the Debugger  
Choose the Debugger to use from this dialog box by checking it. When you are using the PD Debugger available from  
Renesas, choices to select are listed. When you are using a third-party debugger, press the [Add..] button and register  
the necessary items.  
When you finished registering here, the Debugger is ready to start.  
Fig. 3-34 Starting the Debugger  
40  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
4. Reference Manual  
4.1 Project Bar  
4.1.1 Overview  
The Project Bar plays the central role of the TM. It accomplishes a linked invocation of each tool. To start the TM,  
start the Project Bar. To exit the TM, close the Project Bar.  
The Project Bar has the following functions:  
z
z
z
z
z
z
z
Start the Project Editor  
Start/register a debugger  
Start/register an editor  
Start/register applications  
Start the Inspector  
Start the STK Viewer  
Start the Map Viewer  
41  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
4.1.2 Buttons  
The following explains the function of each button on the Project Bar.  
Button  
Name  
Function  
ProjectNameDisplay  
Box  
Showsaprojectname.  
NewProjectButton  
Createsanewproject. Click thisbutton, andtheProjectEditorstarts andaNew  
ProjectWizardopens.  
ProjectOpenButton  
Opensaprojectfile. Whenyouspecifyaprojectcreatedbyanearlierversionof  
theTMor makefile, theProjectEditorstartsandconvertsit intotheprojectfile  
usefulforthisversionoftheTM.  
ProjectEditorStart  
Button  
StartstheProjectEditor. IftheProjectEditorisalready active, theProjectEditor is  
displayedinfrontofallotherwindows.  
EditorStart Button  
Startsaneditor. Theeditortostart mustberegisteredandselectedusingtheEDIT  
TOOLtaboftheToolsInformationdialogbox.  
ToolRegister Button  
OpenstheToolsInformationdialogboxfromwhichyoucanregisteradebugger,  
editor, orapplication.  
CustomizeButton  
InspectStringBox  
OpenstheCustomizedialogboxfromwhich youcansetuptheProjectBar.  
Specify afunctionorvariablename to bedisplayedontheInspector. Leave this  
boxblank, andallfunctionsorvariablesaredisplayed. IfAuto Readfrom  
ClipboardisenabledusingtheInspectortaboftheCustomizedialogbox, the  
stringcopied totheclipboardisautomaticallydisplayedhere.  
FunctionDefinition  
DisplayButton  
ShowsalistoffunctiondefinitionsontheInspector.  
ShowsalistoffunctionreferencesontheInspector.  
ShowsalistofvariabledefinitionsontheInspector.  
ShowsalistofvariablereferencesontheInspector.  
Specify thecontents to bedisplayedontheInspector.  
FunctionReference  
DisplayButton  
VariableDefinition  
DisplayButton  
Variable Reference  
DisplayButton  
DetailSetupButton  
StkViewerStart Button StartstheSTKViewerincludedwithRenesas compilers. TheSTKViewer  
showstheamountofstackused.  
MapViewerStart  
Button  
Startsthe MapViewer includedwithRenesascompilers. The MapViewer  
graphically showstheconditionofhowthetargetprogramis mapped into  
memory.  
Partial Build Button  
Build Button  
Builds an itemselected fromtheProjectEditor.  
Builds aproject.  
Rebuild Button  
DebugButton  
Rebuilds aproject.  
Startsadebugger. Thedebuggerto startmustbespecifiedusingtheDEBUG  
TOOLtaboftheToolsInformationdialogbox. Whenyoupressthisbutton  
withoutspecifyingadebugger, theToolsInformationdialogboxopensup.  
HomePageDisplay  
Button  
Showsthehomepageof theTM.  
Help Button  
Showsthishelp.  
42  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
4.1.3 Menus  
Shortcut menus are provided for the operations to be performed from the Project Bar. The shortcut menus are listed  
below.  
MenuItem  
Function  
ChangeButtonPosition(B)...  
Set(C)  
Changessettingsto show, hide, ororderofdisplayofeachbuttonontheProjectBar.  
AlwaysonTop  
ShowstheProjectBaralwaysin frontofallotherwindows.  
Automaticallyhides theProjectBarwhenit isdockedto theedgeofthescreen.  
Automatically loadsthe last loadedprojectwhentheProjectBaris activated.  
Registers adebugger.  
Auto Hide  
LoadProject  
RegisterDebugger(D)...  
RegisterEditor(E)...  
RegisterApplication(P)...  
ExecuteUtility(U)  
Registers aneditor.  
Registers anapplication.  
Startstheutility includedwith Renesascompilers. TheExecuteUtilitydialogboxopenswhenyouselecta  
sub-menu. Pleaseinputaparameteroftheutilityin thedialogbox.  
Help(H)  
HelpforTM  
ShowshelpfortheTM.  
HelpforCompiler  
HelpforAssembler  
Help forMRxx  
Showshelpforthecompiler.  
Showshelpfortheassembler.  
Showshelp forMRxx.  
Help forDebugger  
Electronic Manual(M)  
TMManual  
Showshelp forPDxxorPDxxSIM.  
ShowsamanualfortheTM.  
Showsamanualforthecompiler.  
Showsamanualfortheassembler.  
ShowsamanualforMRxx.  
Compiler Manual  
AssemblerManual  
MRxxManual  
DebuggerManual  
ShowTMHomePage(W)  
ProjectBarVersion(A)  
Exit(X)  
ShowsamanualforPDxxorPDxxSIM.  
Showsthehomepageof theTM.  
ShowstheversionoftheProjectBar.  
Exits theTM.  
43  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
4.1.4 Dialog Boxs  
4.1.4.1 Tools Information Dialog Box  
The Tools Information dialog box is provided for registering a debugger, editor, or application.  
Fig. 4-1 Tools Information Dialog Box  
From this dialog box, the following can be set:  
z
z
z
To register a debugger...  
To register an editor...  
DEBUG TOOL  
EDIT TOOL tab  
APPLICATION  
To register an application...  
DEBUG TOOL tab  
Use the DEBUG TOOL tab to register a debugger and select the debugger that starts up when you press the debug  
button.  
The debuggers available from Renesas are automatically added to the debugger list according to the project files  
loaded. When you are using a third-party debugger, use the Add button to register it.  
Fig. 4-2 DEBUG TOOL Tab  
44  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
Debugger List  
Shows registered debuggers. The user-registered debuggers are shown as “user:xxxx.” The debugger which has its  
check box checked is the debugger used in the current project. The debugger to use can be changed by clicking the  
check box of another debugger.  
Add button  
Adds a debugger. Clicking this button opens the Debug Tool Information dialog box.  
Delete button  
Deletes a selected debugger from the debugger list. However, this button can delete only the user-registered  
debuggers.  
Modify button  
Modifies the registered content of a selected debugger on the debugger list. Clicking this button opens the Debug Tool  
Information dialog box.  
OK button  
Reflects the contents you changed before closing the Tools Information dialog box.  
Cancel button  
Closes the Tools Information dialog box without reflecting the contents you changed.  
EDITOR TOOL tab  
Use the EDIT TOOL tab to register an editor and select the editor to use in the TM.  
Fig. 4-3 EDITOR TOOL tab  
Editor List  
Shows registered editors. The editor used in the TM has its check box checked. The editor to use can be changed by  
clicking the check box of another editor.  
Add button  
Adds an editor. Clicking this button opens the Edit Tool Information dialog box.  
Delete button  
Deletes a selected editor from the editor list. However, this button can delete only the user-registered editors.  
Modify button  
Modifies the registered content of a selected editor on the editor list. Clicking this button opens the Edit Tool  
Information dialog box.  
OK button  
Reflects the contents you changed before closing the Tools Information dialog box.  
Cancel button  
Closes the Tools Information dialog box without reflecting the contents you changed.  
45  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
APPLICATION tab  
Use the APPLICATION tab to register an application and select the editor to use in the TM. A button for starting the  
registered application is added to the Project Bar.  
Fig. 4-4 APPLICATION tab  
Application list  
Shows registered applications.  
Add button  
Adds an application. Clicking this button opens the Application Information dialog box.  
Delete button  
Deletes a selected application from the application list.  
Modify button  
Modifies the registered content of a selected application on the application list. Clicking this button opens the  
Application Information dialog box.  
OK button  
Reflects the contents you changed before closing the Tools Information dialog box.  
Cancel button  
Closes the Tools Information dialog box without reflecting the contents you changed.  
46  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
4.1.4.2 Customize Dialog Box  
The Customize dialog box is provided for changing various settings of the Project Bar.  
Fig. 4-5 Customize Dialog Box  
From this dialog box, the following can be set:  
z
z
z
To show the Project Bar...  
To change buttons...  
Setting tab  
Button tab  
Inspector tab  
For Inspector-related settings...  
Setting tab  
Use the Setting tab to set the behavior of the Project Bar.  
Fig. 4-6 Setting tab  
z
z
z
Always on Top  
Auto Hide  
Shows the Project Bar always in front of all other windows.  
Automatically hides the Project Bar when it is docked to the edge of the screen.  
Automatically loads the last loaded project when the Project Bar is activated.  
Load Project  
47  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Button tab  
Use the Button tab to show or hide each button on the Project Bar and change the order in which they are displayed.  
Fig. 4-7 Button tab  
Button display view  
Check the check box of a button, and the button is displayed. Uncheck a button, and the button goes out.  
Upper button  
Moves the selected button on the list view one place forward.  
Lower button  
Moves the selected button on the list view one place backward.  
Add Application button  
Adds an application.  
Add Space button  
Adds a space in front of the button selected on the list view.  
Delete button  
Deletes an added application.  
48  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
Inspector tab  
Use the Inspector tab to set Inspector-related settings.  
Fig. 4-8 Inspector tab  
Auto Read from Clipboard  
Selects whether or not to automatically copy a copied string from the clipboard into the Inspector’s search string  
display box.  
49  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
4.1.4.3 Debug Tool Information Dialog Box  
The Debug Tool Information dialog box is provided for registering a debugger.  
Fig. 4-9 Debug Tool Information Dialog Box  
Name (essential)  
Enter a debugger name.  
File Path (essential)  
Enter a path to the debugger’s execution file. The file can also be selected by clicking the Browse button.  
Current button  
The current directory from which to start the debugger can be specified. By default, this is the directory where the  
debugger’s execution file is stored. Clicking the Current button opens the Current Directory dialog box.  
Etc(Version)  
Use this text box to set version or other desired information.  
Target Chip (essential)  
Select the target chip to be operated on by the debugger.  
Environment  
This field shows environment variables used by the debugger.  
Add button  
Click this button when you want to add an environment variable. The Environment Settings dialog box opens.  
Delete button  
To delete any environment variable, select it from the list and click the Delete button.  
Modify button  
To modify any environment variable, select it from the list and click the Modify button. The Environment Settings  
dialog box opens.  
OK button  
Click the OK button, and the contents you changed are reflected before closing the Tools Information dialog box.  
Cancel button  
Click the Cancel button, and the Tools Information dialog box is closed without reflecting the contents you changed.  
50  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
4.1.4.4 Edit Tool Information Dialog Box  
The Edit Tool Information dialog box is provided for registering an editor.  
Fig. 4-10 Edit Tool Information Dialog Box  
Name (essential)  
Enter an editor name.  
Default Editor check box  
Check this check box, and the editor you are registering is registered as the default editor to be used by the TM. When  
this button is unchecked, the editor is only registered.  
File Path (essential)  
Enter a path to the editor’s execution file. The file can also be selected by clicking the Browse button.  
Current button  
The current directory from which to start the editor can be specified. By default, this is the directory where the editor’s  
execution file is stored. Clicking the Current button opens the Current Directory dialog box.  
Etc(Version)  
Use this text box to set version or other desired information.  
Parameter  
The TM has the function to show a specified line of the file you specify when starting the editor. Before this function  
can be used, the method by which to specify a file and line must be registered to the TM.  
To specify this, enter the startup option of the editor which you enter when starting the editor from the command  
line. At this time, use %F and %L to specify the file name and line number, respectively. For example, if the editor  
you use require specifying the following when you want to open the 166th line of the file sample.cin the editor  
named MyEditor,  
MyEditor.exe sample.c+166  
enter %F+%L.  
However, if the editor you are registering cannot be started by specifying a line number of the file, enter only the  
method to specify a file. The method of specifying varies with each editor. For details, consult the user’s manual of your  
editor.  
51  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Environment  
This field shows environment variables used by the editor.  
Add button  
Click this button when you want to add an environment variable. The Environment Settings dialog box opens.  
Delete button  
To delete any environment variable, select it from the list and click the Delete button.  
Modify button  
To modify any environment variable, select it from the list and click the Modify button. The Environment Settings  
dialog box opens.  
OK button  
Click the OK button, and the contents you changed are reflected before closing the Tools Information dialog box.  
Cancel button  
Click the Cancel button, and the Tools Information dialog box is closed without reflecting the contents you changed.  
52  
Download from Www.Somanuals.com. All Manuals Search And Download.  
4.1.4.5 Application Tool Information Dialog Box  
The Application Tool Information dialog box is provided for registering an application.  
Fig. 4-11 Application Tool Information Dialog Box  
Name (essential)  
Enter an application name.  
File Path (essential)  
Enter a path to the application’s execution file. The file can also be selected by clicking the Browse button.  
Current button  
The current directory from which to start the application can be specified. By default, this is the directory where the  
application’s execution file is stored. Clicking the Current button opens the Current Directory dialog box.  
Etc(Version)  
Use this text box to set version or other desired information.  
Parameter  
Enter the options or parameters the application uses. Write the following parameters, and the project file name, target  
chip name, etc. can be passed to the application.  
z
z
z
z
%P  
Project file name  
Working directory  
Target program name  
Target chip name  
%W  
%X  
%T  
Set parameter before executing  
Turn this check box on, and a dialog box opens when the application starts up, allowing you to specify startup options  
and parameters.  
Environment  
This field shows environment variables used by the application.  
Add button  
Click this button when you want to add an environment variable. The Environment Settings dialog box opens.  
Delete button  
To delete any environment variable, select it from the list and click the Delete button.  
53  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Modify button  
To modify any environment variable, select it from the list and click the Modify button. The Environment Settings  
dialog box opens.  
OK button  
Click the OK button, and the contents you changed are reflected before closing the Application Information dialog  
box.  
Cancel button  
Click the Cancel button, and the Application Information dialog box is closed without reflecting the contents you  
changed.  
54  
Download from Www.Somanuals.com. All Manuals Search And Download.  
4.1.4.6 Current Directory Dialog Box  
The Current Directory dialog box is provided for specifying the runtime directory.  
Fig. 4-12 Current Directory Dialog Box  
Directory that contains the execution file  
The directory that contains the execution file of the tool to start is made the current directory.  
Working Directory  
The project’s working directory is made the current directory.  
Other  
Specify a directory that you want to be the current directory. This directory can also be specified by clicking the  
Browse button.  
Browse button  
OK button  
Click the OK button, and the contents you changed are reflected before closing the Current Directory dialog box.  
Cancel button  
Click the Cancel button, and the Current Directory dialog box is closed without reflecting the contents you changed.  
55  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
4.1.4.7 Environment Settings Dialog Box  
The Environment Settings dialog box is provided for specifying environment variables.  
Fig. 4-13 Environment Settings Dialog Box  
Name (essential)  
Enter an environment variable name.  
Value  
Specify the value of the environment variable.  
OK button  
Click the OK button, and the contents you changed are reflected before closing the Environment Settings dialog box.  
Cancel button  
Click the Cancel button, and the Environment Settings dialog box is closed without reflecting the contents you  
changed.  
56  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
4.1.4.8 Utility Execute Dialog Box  
The Utility Execute Dialog Box starts the utility.  
Fig. 4-14 Utility Execute Dialog Box  
Parameter  
Specify the options for the utility. You can also use the Browse button to select the desired file path.  
Detail  
For the automatically TM recognized tools, the Detail button is available. When you click on this button, the Option  
Settings dialog box appears, allowing you to set options.  
OK  
Starts the utility.  
Cancel  
Cancels starting the utility.  
57  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
4.1.4.9 Option Settings Dialog Box  
The Option Settings Dialog Box set a utilitys option.  
Choose an option you want to specify by checking its check box. If the option requires specifying one or  
more parameters, a Specify Parameter dialog box is displayed. From this dialog box, specify the  
necessary parameters.  
Fig. 4-15 Option Settings Dialog Box  
58  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
4.2 Project Editor  
4.2.1 Overview  
The Project Editor is a window in which you can view and edit a project. Use the Project Editor to define or change  
the source files or compile options or the project generation procedure included in the project. The Project Editor  
functions as an editor for makefiles handled by the GNU Make command.  
4.2.2 Window Composition  
The diagram below shows the window composition of the Project Editor. The Project Editor is divided into a menu,  
toolbar, status bar, generation procedure view, item information view, member view, and document view.  
Fig. 4-16 Window Composition of the Project Editor  
z
z
z
The Project Editor is started from the Project Bar to create a new project or open an existing project.  
The primary commands of the Project Editor are assigned to its toolbar.  
Only one project can be edited at a time. You cannot open multiple Project Editor windows at the same time.  
59  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
4.2.2.1 Menus  
The Project Editor has the following menus available.  
File menu  
The File menu has assigned to it the menu commands to load or save a project file or makefile, exit the Project Editor,  
and perform other file-related operations.  
Menu  
Menucommand  
Function  
File(F)  
NewProject(N)  
OpenProject(O)  
Save(S)  
Createsanewproject  
Opensanexistingproject  
Savestheprojectbeingworkedon to thecurrentfile(byoverwriting)  
Savestheprojectbeingworkedon to anotherfile(byspecifyinganame)  
Outputstheprojectbeingworkedontomakefile  
Opensa projectfromthehistoryof recentlyusedprojects  
Closes theProjectEditor  
SaveAs(A)  
OutputMakefile(E)  
Recentlyusedfile  
Exit(X)  
View menu  
The View menu has assigned to it the menu commands to show/hide the toolbar or status bar and other display related  
commands among the Project Editor functions.  
Menu  
Menucommand  
Function  
View(V)  
Toolbar(T)  
Showsorhidesthetoolbar  
Showsorhidesthestatusbar  
StatusBar(S)  
Project menu  
The Project menu has assigned to it the menu commands to edit project information among the Project Editor  
functions.  
Menu  
Menucommand  
Function  
Project(P)  
EditItem(E)  
Edits the itemselectedonthegenerationprocedureview  
Addsanitemto thegenerationprocedure  
Addsafile to thegenerationprocedure  
Edits thegenerationprocedurecommands  
Opensan item in itsassociatedapplication  
Showsthepropertiesofanitem  
AddItem(I)  
AddFile(F)  
Command(C)  
Open (O)  
Property(P)  
Partial Build(B)  
Delete(D)  
Builds anitem  
Deletesan item  
MacroBrowser(M)  
OptionBrowser(O)  
AddMember(A)  
AddDocument(D)  
Information(I)  
ScanAll  
Shows(edits)a macro  
Shows(edits)options  
Addsmember informationtotheproject  
Addsadocument to theproject  
Showsinformationontheprojectbeingworkedon  
Updatesthedependencyrelationsofgenerationprocedure  
Dependencies (S)  
60  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
Help menu  
The Help menu has assigned to it the menu commands to show the method for using the Project Editor or its version  
information.  
Menu  
Menucommand  
Function  
Help(H)  
Help (H)  
Showshelp fortheTMandhelp fortoolsusedin theproject  
OnlineManual(M)  
Showsanelectronic manualfortheTMandanelectronic manualfortoolsusedin the  
project  
AboutProjectEditor(A)  
ShowstheProjectEditorsversioninformation  
4.2.2.2 Toolbar  
The toolbar has various buttons arranged on it that facilitate execution of frequently used commands.  
Button  
ButtonName  
Contents  
NewProject  
OpenProject  
Save  
Createsanewproject  
Opensanexistingproject  
Savestheprojectbeingworkedon to thecurrentfile(byoverwriting)  
Addsanitemto thegenerationprocedure  
Addsafile to thegenerationprocedure  
Edits thegenerationprocedurecommands  
Opensanitem inits associatedapplication  
Showspropertiesofanitem  
AddItem  
AddFile  
Command  
Open  
Property  
Delete  
Deletesan item  
MacroBrowser  
OptionBrowser  
AddMember  
AddDocument  
ScanAllDependencies  
AboutProjectEditor  
Shows(edits)a macro  
Shows(edits)options  
Addsmember informationto theproject  
Addsadocument to theproject  
Updatesthedependencyrelationshipofgenerationprocedure  
Showsprograminformation, version, andcopyright  
4.2.2.3 Status Bar  
The status bar shows auxiliary information on how to use the TM. Shown below is an example of the status bar.  
Fig. 4-17 Status Bar  
61  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
4.2.2.4 Generation Procedure View  
The generation procedure view shows information on project generation procedure (dependency relationship) in tree  
form. Shown below is an outline diagram of the generation procedure view.  
Fig. 4-18 Generation Procedure View  
4.2.2.5 Item Information View  
The item view shows detail information about the item selected on the generation procedure view. Shown below is an  
outline diagram of the item information view.  
Fig. 4-19 Item Information View  
4.2.2.6 Member View  
The member view shows information about the members added to the project. Shown below is an outline diagram of  
the member view.  
Fig. 4-20 Member View  
62  
Download from Www.Somanuals.com. All Manuals Search And Download.  
           
4.2.2.7 Document View  
The document view shows information about the documents. Shown below is an outline diagram of the document  
view.  
Fig. 4-21 Document View  
63  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
4.2.3 Method of Operation  
4.2.3.1 Creating a New Project  
Create a new project.  
When you choose this menu command, a New Project dialog box appears. The New Project dialog box is a wizard-  
type dialog box. From this dialog box, set the necessary entries sequentially.  
Fig. 4-22 New Project - Step 1  
z
z
From Target chip:, choose the target MCU for which you are creating a project.  
For Project name:, enter the name of the new project you are creating. The name entered here constitutes the  
final target program name and project file names.  
z
z
For Working directory:, specify the directory in which to save the new project you are creating. If a nonexisting  
directory is specified, the Project Editor creates a new directory. Press the [...] button, and a dialog box for  
referencing folders appears. From this dialog box, choose a directory.  
When you finished specifying all, click the [Next (N)] button. When settings are completed normally, New  
Project Step 2 is displayed.  
Fig. 4-23 New Project - Step 2  
64  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
z
z
Here, choose the type of project.  
When you finished selecting the type of project, click the [Next (N)] button. New Project - Step Compiler is  
displayed.  
Fig. 4-24 New Project - Step Compiler  
z
z
From Compiler package:, choose the compiler you use. An already installed product is automatically displayed  
in the [Compiler package] text box.  
Choose a startup program. If you choose [A default startup program is used.], the compiler packages default  
startup program is copied to the working directory. If you choose [Custom], the file input box is activated,  
allowing you to enter an existing startup program. Click the [...] button, and a dialog box for opening files is  
displayed. From this dialog box, choose the startup program you want.  
z
When you finished setting all, click the [Next (N)] button.  
65  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
If you selected [ASM Project,] [C Project,] [Library Project,] or [Free Project] for the project type in New Project  
Step 2, you are brought to New Project Step - Complete. If you selected [Realtime OS + ASM Project] or  
[Realtime OS + C Project], New Project - Step OS is displayed. In this case, specify the startup program in New  
Project - Step OS.  
Fig. 4-25 New Project - Step OS  
z
z
From Realtime OS:, choose the realtime OS you use. An already installed product is automatically displayed  
in the Realtime OS text box.  
Choose a startup program. If you choose [A default startup program is used.], the realtime OSs default  
startup program is copied to the working directory. If you choose [Custom], the file input box is activated,  
allowing you to enter an existing startup program. Click the [...] button, and a dialog box for opening files is  
displayed. From this dialog box, choose the startup program you want.  
z
z
Choose a configuration file. If you choose [A default configuration file is used.], the realtime OSs default  
configuration file is copied to the working directory. If you choose [Custom], the file input box is activated,  
allowing you to enter an existing configuration file. Click the [...] button, and a dialog box for opening files is  
displayed. From this dialog box, choose the configuration file you want.  
When you finished setting, click the [Next (N)] button. New Project - Step Finish is displayed.  
66  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
Fig. 4-26 New Project - Step Finish  
z
When you finished setting all entries on the New Project dialog box, the contents youve set are displayed  
here. If the contents shown here are correct, click the [Finish (F)] button. If incorrect, click the [Back (B)]  
button and reedit any entries that need to be corrected.  
4.2.3.2 Opening a Project  
Open an existing project file.  
When you choose this menu command, a dialog box for opening files is displayed. From this dialog box, choose the  
project file you want.  
Fig. 4-27 Opening a Project  
z
z
z
Choose a project file (any file name with the extension .tmk).  
Click the [Open] button, and the project of the selected file opens.  
Project files of TM V.2 or earlier versions (any file name with the extension .mtm) can be specified here.  
Also, makefiles can be specified.  
If a project file or makefile of TM V.2 or earlier version is specified, a project complement wizard is executed. Set  
up following the instructions displayed.  
4.2.3.3 Saving the Project by Overwriting  
Save the project being worked on to the current project file by overwriting.  
67  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
4.2.3.4 Saving the Project by Specifying a Name  
Save the project being worked on to another project file by specifying a file name.  
When you choose this menu command, a Save As dialog box is displayed. Specify any file name and folder in which  
you want to save the project.  
Fig. 4-28 Saving the Project File  
z
z
Enter the file name you want. In this case, the extension does not need to be specified.  
If you specify an existing file name, a message is displayed asking you to confirm whether or not to  
overwrite. Follow the instructions displayed here.  
z
Click the [Save] button, and the project information is saved to the specified file.  
4.2.3.5 Outputting a Makefile  
Output the generation procedure for the project being worked on to a makefile.  
When you choose this menu command, a Save As dialog box is displayed. From this dialog box, specify a makefile  
name.  
Fig. 4-29 Outputting a Makefile  
z
z
Enter the file name you want. In this case, the extension does not need to be specified.  
If you specify an existing file name, a message is displayed asking you to confirm whether or not to  
overwrite. Follow the instructions displayed here.  
z
Click the [Save] button, and the generation procedure is saved to the specified file. The file is saved in a  
format that can be executed with the GNU make command.  
4.2.3.6 Recently Used Files  
Open a project from the history of projects that have once been used.  
68  
Download from Www.Somanuals.com. All Manuals Search And Download.  
         
A history of up to four projects is displayed.  
4.2.3.7 Exiting the Application  
Exit the Project Editor.  
If the project being worked on has been edited, a message is displayed asking you to confirm whether or not to save.  
Fig. 4-30 Confirming to save  
z
z
z
To save the project before closing it, click the [Yes] button.  
To close the project without saving it, click the [No] button.  
To cancel closing the project, click the [Cancel] button.  
4.2.3.8 Toolbar  
Show or hide the toolbar.  
The toolbar is displayed when this menu command is checked, and not displayed when this menu command is  
unchecked.  
4.2.3.9 Status Bar  
Show or hide the status bar.  
The status bar is displayed when this menu command is checked, and not displayed when this menu command is  
unchecked.  
4.2.3.10 Adding an Item  
Add an item to the generation procedure.  
When you choose this menu command, an Add Item dialog box is displayed. From this dialog box, specify the item  
name you want to add.  
Fig. 4-31 Adding an Item  
z
z
For Item name:, specify the item name you want to add. It is added below the selected item on the generation  
procedure view.  
Check [Add at top], and the item is added at the level equivalent to that of all or clean, not below the selected  
item on the generation procedure view.  
4.2.3.11 Adding a File  
Add a file to the generation procedure.  
When you choose this menu command, an Open File dialog box is displayed. From this dialog box, specify the file  
you want to add.  
69  
Download from Www.Somanuals.com. All Manuals Search And Download.  
             
Fig. 4-32 Adding a File  
z
Specify the file name you want. Two or more file names can be specified. (File names can be specified in up  
to about 2,600 characters assuming that they are indicated with the absolute path.)  
Even a nonexistent file name can be specified.  
z
z
If the specified file has the same extension as that of the compiler or assemblers default extension, the file is  
recognized as a source file and has the compiler or assemblers execution code automatically added as a  
command.  
4.2.3.12 Command  
Edit a generation procedure command.  
When you choose this menu command, a Command dialog box is displayed.  
Fig. 4-33 Command Dialog Box  
z
z
This dialog box shows command information for the item selected on the generation procedure view.  
To add a new command line, click the [New] button. A Command Setup dialog box is displayed. The  
command is added below the last line of existing commands. Move it up or down using the arrow keys [Up]  
or [Down] as necessary.  
z
z
To edit an existing command, choose the line you want to edit from [Command:] and click the [Mod] button.  
A Command Setup dialog box is displayed.  
To delete a command line, choose the command line you want to delete and then click the [Del] button.  
70  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Fig. 4-34 Setting a Command  
z
z
z
For Command, enter a command.  
The [Def macro ->] button adds a macro displayed by a macro browser to the command line.  
The [Dyn macro ->] button adds a special macro defined by make to the command line. Click the button, and  
a popup menu appears.  
Fig. 4-35 Popup Menu for Dynamic Macro  
4.2.3.13 Open  
Open an item in its associated application.  
After specifying a text file from items on the generation procedure view, choose this menu command. The text file is  
opened using the editor which has been set with the Project Bar.  
71  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
4.2.3.14 Properties  
Show properties of an item.  
Choose this menu command when an item on the generation procedure view is selected. A File Properties dialog box  
is displayed.  
Fig. 4-36 Item Properties  
z
z
Properties are displayed only when an existing file is specified.  
If necessary, edit Attributes.  
4.2.3.15 Partial Build  
Build an item selected on the generation procedure view.  
4.2.3.16 Delete  
Delete a selected item.  
Delete an item from the project that is selected on the generation procedure view, member information view, or  
document view.  
72  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
4.2.3.17 Macro Browser  
Show a macro browser.  
When you choose this menu command, a Macro Browser dialog box is displayed.  
Fig. 4-37 Macro Browser  
z
z
This dialog box shows a list of macros used in the projects generation procedure.  
To add a new macro, click the [New] button. An Add Macro dialog box is displayed. The new macro is  
added below the last line of existing macros. Move it up or down using the arrow keys [Up] or [Down] as  
necessary.  
z
z
To edit an existing macro, choose the macro you want from [Macro list:] and click the [Mod] button. An Add  
Macro dialog box is displayed.  
To delete a macro, choose the macro you want to delete and then click the [Del] button.  
Fig. 4-38 Adding a Macro  
z
z
For Macro:, specify a macro name.  
For Value:, specify the value of the macro.  
73  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
4.2.3.18 Option Browser  
Show an option browser.  
When you choose this menu command, an Option Browser dialog box is displayed.  
Fig. 4-39 Option Browser  
z
z
This dialog box shows a list of options used in the projects generation procedure.  
To add a new option, choose the tool name you want to add and click the [New] button. An Option dialog  
box is displayed.  
Option names are automatically assigned.  
When you specify an option for each file, add the option first. Then, from [Selected files:] choose the file to which  
you want to assign the option by checking its check box.  
z
To edit an existing option, choose the option name you want to edit and click the [Mod] button. An Option  
dialog box is displayed.  
z
To delete an option, choose the option you want to delete and then click the [Del] button.  
No options can be deleted unless two or more options exist.  
74  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Fig. 4-40 Option Dialog Box  
z
Choose an option you want to specify by checking its check box. If the option requires specifying one or  
more parameters, a Specify Parameter dialog box is displayed. From this dialog box, specify the necessary  
parameters.  
4.2.3.19 Adding Member Information  
Add member information to the project.  
When you choose this menu command, an Add Member dialog box is displayed.  
Fig. 4-41 Adding Member Information  
z
For Name:, specify the name of the information you want to add. Specify any entries other than the name as  
necessary.  
If information for Mail address: is specified, when you choose a member from the member information view and  
then execute Open, mail creation by a mail transmit/receive application is automatically performed.  
75  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
4.2.3.20 Adding a Document  
Add a document file to the project.  
When you choose this menu command, an Open File dialog box is displayed.  
Fig. 4-42 Adding a Document  
z
Specify the document file you want to add to the project.  
When you choose a registered document file and then execute Open, the file is executed by the application  
associated with it by Windows.  
4.2.3.21 Information  
Show information on the project being worked on.  
When you choose this menu command, project properties are displayed.  
Fig. 4-43 Project Properties (Target Tab)  
76  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
Fig. 4-44 Project Properties (Tool Tab)  
z
z
This dialog box shows information on the project being worked on.  
With the Tool tab, you can specify whether or not to use any tool, such as a load module converter, not just  
normally used tools. To specify to use a tool, check its check box.  
The checked tool is displayed on the option browser. Change options for the tool as necessary.  
4.2.3.22 Scan All Dependencies  
Update the dependency relationship in generation procedure.  
This menu command updates the dependency relationship between the source files registered to the project. As a result,  
the include files written in a source file are recognized and are automatically added to the project’s generation  
procedure.  
In TM V.2 or earlier versions, the dependency relationship was automatically updated when you added or edited  
any source file. In TM V.3, however, this automatic updating of the dependency relationship is not supported. You  
need to update the dependency relationship when necessary.  
4.2.3.23 Help  
Show help for the TM and help for the tools used in the project.  
4.2.3.24 Online Manual  
Show an electronic manual for the TM and an electronic manual for the tools used in the project.  
77  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
4.2.3.25 About Project Editor  
Show version information of the Project Editor.  
When you choose this menu command, a Project Editor Version Information dialog box is displayed.  
Fig. 4-45 Showing Project Editor Version  
z
This dialog box allows you to verify the version of the Project Editor.  
78  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
4.3 Builder  
4.3.1 Overview  
Builder is the window which does the practice of build and result indication.  
An error and warning place are indicated with the mark, and help and text editor can start it.  
4.3.2 Builder Window  
Fig. 4-46 Builder Window  
79  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
4.3.3 Functional Description  
4.3.3.1 To Execute Build  
The build operation can be executed in three ways: Build only the files selected with the Project Editor, build the  
entire project, or rebuild the entire project. For details on how to run, refer to the description of the Project Bar in earlier  
sections of this manual.  
Build  
Rebuild  
Partial build  
Fig. 4-47 Build Execution Buttons  
4.3.3.2 To Stop Building in the Middle  
z
Canceling from the menu bar  
Choose [Action] - [Cancel Build] from the menu bar.  
Canceling from the toolbar  
z
Click the [Cancel] button on the toolbar.  
4.3.3.3 To Reexecute Previous Build  
z
Reexecuting from the menu bar  
Choose [Action] - [Reexecute Build] from the menu bar.  
Reexecuting from the toolbar  
z
Click the [Reexecute] button on the toolbar.  
4.3.3.4 To Jump to a Location in Error or Warning  
When an error or warning occurs, a mark is shown at the beginning of the pertinent message in the build window.  
Error  
Internal error  
Warning  
If the displayed error message contains a file name and line number, the editor can be started by one of the following  
operations, showing the relevant line in the source file or header file.  
z
z
z
Starting from the menu bar  
While the cursor is located at the error or warning line, choose [Action] - [Open] from the menu bar.  
Starting from a right-click submenu  
Right-click the error or warning line to open a submenu and choose [Open] from that submenu.  
Starting from the toolbar  
Click the [Open] button on the toolbar.  
80  
Download from Www.Somanuals.com. All Manuals Search And Download.  
           
4.3.3.5 To Examine the Meaning of an Error or Warning  
Right-click the error or warning line to open a submenu and choose [Search for Help On] from that submenu. Help for  
the cross tool is invoked, with the error message entered in the keyword text box. Choose a keyword string from the list.  
Click the [View] button on the dialog box to verify the content of the error message.  
4.3.3.6 To Save Build Results  
The build results can be saved to a file in text format. A Save As dialog box is displayed by one of the following  
operations.  
z
z
z
Saving from the menu bar  
Choose [File] - [Save] from the menu bar.  
Saving from a right-click submenu  
Right-click the error or warning line to open a submenu and choose [Save] from that submenu.  
Saving from the toolbar  
Click the [Save] button on the toolbar.  
In addition to saving the entire result, you also can copy the result to the clipboard one character at a time.  
4.3.3.7 To Print Build Results  
A Print dialog box is displayed by one of the following operations.  
z
z
z
Printing from the menu bar  
Choose [File] - [Print] from the menu bar.  
Printing from a right-click submenu  
Right-click the error or warning line to open a submenu and choose [Print] from that submenu.  
Printing from the toolbar  
Click the [Print] button on the toolbar.  
4.3.3.8 To Clear the Window  
z
z
z
Clearing from the menu bar  
Choose [Edit] - [Clear] from the menu bar.  
Clearing from a right-click submenu  
Right-click on the window to open a submenu and choose [Clear] from that submenu.  
Clearing from the toolbar  
Click the [Clear] button on the toolbar.  
81  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
4.3.3.9 To Search for an Error or Warning  
When an error or warning occurs, it can be searched for in the upward or downward direction from the cursor position.  
You can search by error, by warning, or by error & warning. Furthermore, when the end of the file is reached during  
search, you can start searching from the beginning of the file again, by setting up environment settings accordingly.  
Execute one of the following operations to search for an error or warning.  
z
z
z
Searching from the menu bar  
Choose [Edit] - [Search for Error] - [Search Upward] or [Search Downward], or [Edit] - [Search for  
Warning] - [Search Upward] or [Search Downward], or [Edit] - [Search for Error & Warning] - [Search  
Upward] or [Search Downward] from the menu bar.  
Searching from a right-click submenu  
Right-click on the window to open a submenu and choose [Search error/warning upward] or [Search  
error/warning downward] from that submenu. Errors and warnings cannot be searched for individually from  
a submenu.  
Searching with a function key  
The search command has function keys F5 through F7 assigned to it. For details about the contents of key  
assignments, refer to the menu.  
4.3.3.10 To Change the Display Font  
Choose [View] - [Font] from the menu bar.  
4.3.3.11 To Show Information  
Choose [Action] - [Environment] from the menu bar.  
Click the Information tab of the Environment dialog box to look up information on build operation.  
Fig. 4-48 Environment Dialog Box (Information Tab)  
82  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
4.3.3.12 To Change Operation Environment  
Choose [Action] - [Environment] from the menu bar.  
The Setting tab of the Environment dialog box allows you to set the following.  
Fig. 4-49 Environment Dialog Box (Setting Tab)  
z
z
z
Restore window condition  
The window position is restored next time the Builder starts up.  
Restore font  
The display font is restored next time the Builder starts up.  
Search mode  
When searching for an error or warning, this mode allows you to choose to finish the search at the beginning  
(or the end) of the file or restart the search after wrapping to the beginning (or the end) of the file.  
83  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
4.4 Inspector  
4.4.1 Overview  
Inspector is the window which indicates function information and variable information. Information on the made  
object is analyzed statically in the cause. Each information is classified with the tab, and indicated respectively in the  
list.  
A file name and a line number are outputted by each information, and it is possible that it opens with text editor.  
4.4.2 Inspector Window  
Menu bar  
Toolbar  
List window  
Preview window  
Fig. 4-50 Inspector Window  
4.4.3 Starting the Inspector  
Use the Project Bar to start the Inspector and display various information.  
Show function reference  
Show variable reference  
Specify function or variable name  
Detail settings of Inspector  
Show function definition  
Show variable definition  
Fig. 4-51 Inspector Startup Buttons  
84  
Download from Www.Somanuals.com. All Manuals Search And Download.  
           
4.4.3.1 To Show Information List  
Click on either "Show function definition", "Show function reference", "Show variable definition ", " Show variable  
reference " on the project bar. The indication tab of the button which it clicked on becomes active.  
When a function or variable name are specified with [Insp:] box, a focusing tab is indicated, and only the information  
which corresponded to the specified name is indicated. The wildcard (* or ?) can be used for this name.  
4.4.3.2 Narrow Down Search  
Click the [Detail Settings of Inspector] button on the Project Bar.  
A Specify Detail Conditions dialog box is displayed. Specify various settings from this dialog box, and the Inspector  
shows the information that matches specified conditions as a list in the narrow down tab.  
Fig. 4-52 Specify Detail Conditions Dialog Box  
Specifying the category and definition  
For the Category and Definition entries, set the contents of analysis to be made.  
Selectable entries  
Condition  
Function definition, function reference, function prototype, None  
variable definition, variable reference  
Specifying a function or variable name  
Enter a function or variable name. The wildcard (* or ?) can be used for this name. If you do not want the function or  
variable names to be case-sensitive, uncheck the check box for [Discriminate uppercase/lowercase].  
85  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Specifying the type  
Selectable entries  
Condition  
All types, signed int, unsigned int, signed char, unsigned char, Other than function reference  
signed short, unsigned short, signed long, unsigned long,  
float, double,  
void pointer, struct, union, enum, typedef, func, near pointer,  
far pointer, array, void  
Specifying the storage class  
Selectable entries  
Condition  
Not specify, global, static, inline  
Not specify, global, static in file, static in function  
Specifying the start address  
Selectable entries  
Function definition, function prototype  
Variable definition, variable reference  
Condition  
0x000000 - 0x0FFFFFF  
Function definition, variable definition,  
variable reference  
Specifying the end address  
Selectable entries  
Condition  
0x000000 - 0x0FFFFFF  
Function definition, variable definition,  
variable reference  
Specifying a file  
Specify a file name as a scope. This specification is accepted for all but function references. Write the file name in full  
path. Only one file can be written.  
Specifying a function  
Specify a function name as the scope. This specification is accepted for only variable definitions and variable  
references.  
4.4.4 List Window  
4.4.4.1 To Show Preview  
Choose any entry with the mouse. If the file name and line number are correct, they are displayed in the preview  
window.  
4.4.4.2 To Open a Selected Entry with the Editor  
If, while any entry is selected (while the preview window is displayed normally), the focus is located in the list  
window, the editor can be started by one of the following operations performed, showing the relevant line.  
z
z
z
z
Starting from the menu bar  
Choose [Action] - [Open] from the menu bar.  
Starting from a right-click submenu  
Right-click the entry to open a submenu and choose [Open] from that submenu.  
Starting from the toolbar  
Click the [Open] button on the toolbar.  
Starting from double-clicking  
Double-click the entry.  
86  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
4.4.4.3 To Check a Check Box  
If, while a line mark area is displayed and any entry is selected, the focus is located in the list window, the check box  
for an entry can be checked or unchecked by one of the following operations performed.  
z
z
z
z
Checking from the menu bar  
Choose [Action] - [Set Line Select Mark] from the menu bar.  
Checking from a right-click submenu  
Right-click the entry to open a submenu and choose [Set Line Select Mark] from that submenu.  
Checking directly  
Check the check box directly.  
Checking automatically from the editor  
Check [Auto Set Line Mark] on the Set Environment dialog boxs Action tab, and the check box is  
automatically checked by the editor when it starts up. The check box cannot be unchecked by this method,  
however.Choose [Action] - [Environment] to open the Set Environment dialog box.  
4.4.4.4 To Show Nesting of Function Trees  
To show nesting of function trees displayed for function references, click the [+] mark. To expand all trees below the  
selected entry, choose [View] - [Show Tree Nest] from the menu bar.  
4.4.4.5 To Rearrange Entries  
In list view of all but function references, entries can be sorted in descending or ascending order by clicking the header  
part of any entry.  
Fig. 4-53 Rearrange Entries  
4.4.4.6 To Save a List  
The results of analysis can be saved to a tag file in text format or a file in CSV format. When the focus is located in  
the list window, a Save As dialog box is displayed by one of the following operations.  
z
Saving from the menu bar  
Choose [File] - [Save a List] from the menu bar.  
Saving from the toolbar  
z
Click the [Save] button on the toolbar.  
87  
Download from Www.Somanuals.com. All Manuals Search And Download.  
         
4.4.4.7 To Reanalyze after Loading the Latest Object  
If the object or project has been altered, the [Update] button on the toolbar is enabled. Click the [Update] button, and  
the Inspector loads the latest object and reanalyzes the project under the previous analysis conditions.  
Fig. 4-54 [Update] button  
4.4.5 Preview Window  
4.4.5.1 To Search for a String  
When the focus is located in the preview window, a Search for String dialog box is displayed by one of the following  
operations. When no selected area exits, the previous search character is automatically entered in the dialog box. When  
a selected area exists, the selected string is entered.  
z
z
z
Searching from the menu bar  
Choose [Edit] - [Search] from the menu bar.  
Searching from a right-click submenu  
Right-click on the entry to open a submenu and choose [Search] from that submenu.  
Searching from the toolbar  
Click the [Search] button on the toolbar.  
4.4.5.2 To Change the Display Font  
Choose [View] - [Font] from the menu bar.  
4.4.5.3 To Change the Tab Width  
Choose [Action] - [Environment] from the menu bar to open the Set Environment dialog box. Click to open the  
Preview tab of this dialog box and change the tab size.  
4.4.5.4 To Change the Display Color  
Choose [Action] - [Environment] from the menu bar to open the Set Environment dialog box. Click to open the  
Preview tab of this dialog box and choose your desired colors for the keywords and comments.  
4.4.6 Setting the Operating Environment  
Choose [Action] - [Environment] from the menu bar. From the Environment setup dialog box, the following can be  
set.  
88  
Download from Www.Somanuals.com. All Manuals Search And Download.  
               
4.4.6.1 Action Tab  
Fig. 4-55 Environment Setup Dialog Box (Action Tab)  
Restore window condition  
Restores the window position the next time the TM starts.  
Restore font  
Restores the display font the next time the TM starts.  
Auto set line mark  
Automatically checks line marks when opening the editor from the Inspector.  
Automatic update  
When using the Inspector from the Project Bar, if the object has been updated or the project has been altered, this  
function automatically loads the object to perform analysis with updated contents. Unless this function is checked  
(turned on), a dialog box is displayed for your confirmation.  
4.4.6.2 Preview Tab  
Fig. 4-56 Environment Setup Dialog Box (Preview Tab)  
Tab size  
Sets the preview window's display tab width. The tab size can be set in the range of 0 to 64.  
Display color  
Sets the colors in which to display the keywords and comments on the preview window.  
89  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
MEMO  
90  
Download from Www.Somanuals.com. All Manuals Search And Download.  
TM V.3.20A User’s Manual  
Rev. 1.00  
May 01, 2003  
REJ10J0018-0100Z  
COPYRIGHT ©2003 RENESAS TECHNOLOGY CORPORATION ALL RIGHTS RESERVED  
AND RENESAS SOLUTIONS CORPORATION ALL RIGHTS RESERVED  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Download from Www.Somanuals.com. All Manuals Search And Download.  

Q See DVR QSD9004CM User Guide
RCA Stereo System ANT2050X User Guide
Reliable Iron i500 User Guide
Renesas Network Card M3T F160 128NRD User Guide
Roberts Radio Clock Radio CD9959 User Guide
Samsung Bluetooth Headset GH68 xxxxxA User Guide
Samsung IP Phone DS 5000 User Guide
Sanyo DVD Player DVD DX501 User Guide
Seagate Computer Drive ST980825A User Guide
SECO LARM USA Security Camera EV 260 CM User Guide