Renesas TM V.3.20A Manual do Utilizador

TM V.3.20AIntegrated Development EnvironmentUser’s ManualRev. 1.00May 01, 2003REJ10J0018-0100Z

101.2 Installation Method1.2.1 Executing the InstallerTo install the TM, execute the installer included with it.z Follow the messages displayed on th

111.2.4 Directories and Files Generated After InstallationWhen you finished installing the TM, the directories shown below are created in the director

121.3 Usage Precautions1.3.1 Notes about File NamesThe source program file names and work directory names are subject to the following limitations:z

131.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 inacco

142) When 16 was specified in the message size or designation was omitted.Compilation option : -Dfar_msg=1 isn’t specified.Link library : mr30.lib an

153) When 16 was specified in the message size or designation was omitted, and STANDARD was specified inthe interruption prohibition model or designa

163) When 24 was specified in the message size and SHORT was specified in the interruption prohibition model.Compilation option : -Dfar_msg=1 is spec

172. Overview2.1 Integrated Development EnvironmentThe Integrated Development Environment, TM, has been devised to increase the efficiency of software

182.2 Concept of a ProjectThe TM manages the software development process using the concept of a project. Following are managed as part of aproject by

192.3 Roles of Each Tool Working under the TMThe TM works in close cooperation with many tools. Some of these tools have GUI as WindowsTM programs, an

Microsoft, MS-DOS, Windows, and Windows NT are registered trademarks of Microsoft Corporation in the U.S. and other countries.IBM and AT are registere

20 Project EditorUse the Project Editor to define or alter the source files, compile options, or generation procedure included in a project.The Proj

21 InspectorThe Inspector provides a facility that based on the debug information included in the “absolute object file” generatedby build, analyzes

22Those included with the compiler package Compiler and AssemblerTM V.3.20A currently supports the following compilers available from Renesas6:z NC

23 STK ViewerUse the STK Viewer to examine the amount of stack.7Fig. 2-9 STK ViewerOthers EditorAny editor available on the market and you are acc

242.4 Directory ConfigurationThis section describes how to configure the directory structure of the program when using the TM. When thinking ofthe dir

25Example of a directory structureWith the above concept taken into account, a directory structure like the one shown below may be conceived.C:\WORK\M

263. Quick Tour3.1 Starting the TM and Registering the Editor UsedWhen the TM has been installed normally, the TM can be started by selecting [Start]

27Choose [EDIT TOOL].In the example below, the Peggy editor from Anchor Systems is registered.10Fig. 3-4 Registering an EditorThe TM does not have any

283.2 Creating a ProjectThere are following three methods to create a project:z Create a new projectz Read a project file of TM V2 or earlier versio

29Choose 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-

3Contents1. Introduction 91.1 Operating Environment 91.2 Installation Method 101.2.1 Executing the Installer 101.2.2 Notes about TM Versions 101.2.3 C

30Choose [A default startup program is used.] for the startup program, and the startup program that comes standard withthe compiler is copied into the

31executed. If main.r30 is created from main.c, for example, write a statement as shown below.main.r30 : main.cnc30 -c main.cIn such a case, displ

32Now, 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 FileChoose the

33In this example, when you register “main.c,” the TM registers “main.r30” simultaneously with it, producing thefollowing display.Fig. 3-14 View after

34Definitions of the following are entered by default for each option, respectively:Compiler (nc30) CFLAGSAssembler (as30) AFLAGSLinker (ln30) LFLAGSL

35Or when you want to use different compile options for each file, choose “nc30” press the [New] button. This creates anew macro named “CFLAGS1.” Choo

36Registering documentsSpecifications and other documents can be registered.18 To register documents, use the [Add Document] button.Fig. 3-21 Button f

373.3 Building a ProjectThe Project Editor is an editor. Therefore, if the project has been changed, it must be saved before building. To save aprojec

38Analyzing with the InspectorThe Inspector allows for static program analysis by reading into it the final object “ModelA.x30” that has been built.Us

39Fig. 3-30 Showing Variable ReferencesIn this example, system_code is used in five locations. The variable can be previewed in the window located bel

44.1 Project Bar 414.1.1 Overview 414.1.2 Buttons 424.1.3 Menus 434.1.4 Dialog Boxs 444.1.4.1 Tools Information Dialog Box...

40Fig. 3-32 Showing Function ReferencesStarting the debuggerThe Debugger can be started from the Project Bar. However, before the Debugger can be star

414. Reference Manual4.1 Project Bar4.1.1 OverviewThe Project Bar plays the central role of the TM. It accomplishes a linked invocation of each tool.

424.1.2 ButtonsThe following explains the function of each button on the Project Bar.Button Name FunctionProject Name DisplayBoxShows a project name.N

434.1.3 MenusShortcut menus are provided for the operations to be performed from the Project Bar. The shortcut menus are listedbelow.Menu Item Functio

444.1.4 Dialog Boxs4.1.4.1 Tools Information Dialog BoxThe Tools Information dialog box is provided for registering a debugger, editor, or application

45Debugger ListShows registered debuggers. The user-registered debuggers are shown as “user:xxxx.” The debugger which has itscheck box checked is the

46 APPLICATION tabUse the APPLICATION tab to register an application and select the editor to use in the TM. A button for starting theregistered app

474.1.4.2 Customize Dialog BoxThe Customize dialog box is provided for changing various settings of the Project Bar.Fig. 4-5 Customize Dialog BoxFrom

48 Button tabUse 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 tabB

49 Inspector tabUse the Inspector tab to set Inspector-related settings.Fig. 4-8 Inspector tabAuto Read from ClipboardSelects whether or not to auto

54.2.3.24 Online Manual ... 774.2.3.25

504.1.4.3 Debug Tool Information Dialog BoxThe Debug Tool Information dialog box is provided for registering a debugger.Fig. 4-9 Debug Tool Informatio

514.1.4.4 Edit Tool Information Dialog BoxThe Edit Tool Information dialog box is provided for registering an editor.Fig. 4-10 Edit Tool Information D

52 EnvironmentThis field shows environment variables used by the editor. Add buttonClick this button when you want to add an environment variable.

534.1.4.5 Application Tool Information Dialog BoxThe Application Tool Information dialog box is provided for registering an application.Fig. 4-11 Appl

54 Modify buttonTo modify any environment variable, select it from the list and click the Modify button. The Environment Settingsdialog box opens.

554.1.4.6 Current Directory Dialog BoxThe Current Directory dialog box is provided for specifying the runtime directory.Fig. 4-12 Current Directory Di

564.1.4.7 Environment Settings Dialog BoxThe Environment Settings dialog box is provided for specifying environment variables.Fig. 4-13 Environment Se

574.1.4.8 Utility Execute Dialog BoxThe Utility Execute Dialog Box starts the utility.Fig. 4-14 Utility Execute Dialog Box ParameterSpecify the opti

584.1.4.9 Option Settings Dialog BoxThe Option Settings Dialog Box set a utility’s option.Choose an option you want to specify by checking its check b

594.2 Project Editor4.2.1 OverviewThe Project Editor is a window in which you can view and edit a project. Use the Project Editor to define or changet

6FiguresFig. 2-1 Example of Software Development Using the TM ... 17Fig. 2-2 Project Nam

604.2.2.1 MenusThe Project Editor has the following menus available. File menuThe File menu has assigned to it the menu commands to load or save a p

61 Help menuThe Help menu has assigned to it the menu commands to show the method for using the Project Editor or its versioninformation.Menu Menu c

624.2.2.4 Generation Procedure ViewThe generation procedure view shows information on project generation procedure (dependency relationship) in treefo

634.2.2.7 Document ViewThe document view shows information about the documents. Shown below is an outline diagram of the documentview.Fig. 4-21 Docume

644.2.3 Method of Operation4.2.3.1 Creating a New ProjectCreate a new project.When you choose this menu command, a New Project dialog box appears. The

65z Here, choose the type of project.z When you finished selecting the type of project, click the [Next (N)] button. New Project - Step Compiler isd

66If you selected [ASM Project,] [C Project,] [Library Project,] or [Free Project] for the project type in New ProjectStep 2, you are brought to New P

67Fig. 4-26 New Project - Step Finishz When you finished setting all entries on the New Project dialog box, the contents you’ve set are displayedhere

684.2.3.4 Saving the Project by Specifying a NameSave the project being worked on to another project file by specifying a file name.When you choose th

69A history of up to four projects is displayed.4.2.3.7 Exiting the ApplicationExit the Project Editor.If the project being worked on has been edited,

7Fig. 4-3 EDITOR TOOL tab ... 45Fig. 4-4

70Fig. 4-32 Adding a Filez Specify the file name you want. Two or more file names can be specified. (File names can be specified in upto about 2,600

71Fig. 4-34 Setting a Commandz For Command, enter a command.z The [Def macro ->] button adds a macro displayed by a macro browser to the command

724.2.3.14 PropertiesShow properties of an item.Choose this menu command when an item on the generation procedure view is selected. A File Properties

734.2.3.17 Macro BrowserShow a macro browser.When you choose this menu command, a Macro Browser dialog box is displayed.Fig. 4-37 Macro Browserz This

744.2.3.18 Option BrowserShow an option browser.When you choose this menu command, an Option Browser dialog box is displayed.Fig. 4-39 Option Browserz

75Fig. 4-40 Option Dialog Boxz Choose an option you want to specify by checking its check box. If the option requires specifying one ormore parameter

764.2.3.20 Adding a DocumentAdd a document file to the project.When you choose this menu command, an Open File dialog box is displayed.Fig. 4-42 Addin

77Fig. 4-44 Project Properties (Tool Tab)z This dialog box shows information on the project being worked on.z With the Tool tab, you can specify whe

784.2.3.25 About Project EditorShow version information of the Project Editor.When you choose this menu command, a Project Editor Version Information

794.3 Builder4.3.1 OverviewBuilder is the window which does the practice of build and result indication.An error and warning place are indicated with

8Fig. 4-51 Inspector Startup Buttons... 84Fig. 4-52

804.3.3 Functional Description4.3.3.1 To Execute BuildThe build operation can be executed in three ways: Build only the files selected with the Projec

814.3.3.5 To Examine the Meaning of an Error or WarningRight-click the error or warning line to open a submenu and choose [Search for Help On] from th

824.3.3.9 To Search for an Error or WarningWhen an error or warning occurs, it can be searched for in the upward or downward direction from the cursor

834.3.3.12 To Change Operation EnvironmentChoose [Action] - [Environment] from the menu bar.The Setting tab of the Environment dialog box allows you t

844.4 Inspector4.4.1 OverviewInspector is the window which indicates function information and variable information. Information on the madeobject is a

854.4.3.1 To Show Information ListClick on either "Show function definition", "Show function reference", "Show variable defin

86 Specifying the typeSelectable entries ConditionAll types, signed int, unsigned int, signed char, unsigned char,signed short, unsigned short, sig

874.4.4.3 To Check a Check BoxIf, while a line mark area is displayed and any entry is selected, the focus is located in the list window, the check bo

884.4.4.7 To Reanalyze after Loading the Latest ObjectIf the object or project has been altered, the [Update] button on the toolbar is enabled. Click

894.4.6.1 Action TabFig. 4-55 Environment Setup Dialog Box (Action Tab) Restore window conditionRestores the window position the next time the TM st

91. Introduction1.1 Operating EnvironmentThe following lists the host computers and OS versions on which TM has been verified to run.Host Computer OS

90MEMO

TM V.3.20A User’s ManualRev. 1.00May 01, 2003REJ10J0018-0100ZCOPYRIGHT ©2003 RENESAS TECHNOLOGY CORPORATION ALL RIGHTS RESERVEDAND RENESAS SOLUTIONS C