Home

Renesas TM V.3.20A User's Manual

1. sss 22410 CNGck a Check IS OX sss an a un ae ra ad ISE NEK re 4444 To Show Nestine of Funcion Trees so AAAS TORE PE ae A E E E E A ETE 4 4 4 7 To Reanalyze after Loading the Latest Object rrrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 4 4 5 Preview Window 2251 10 DETON ANN SS 445 TO Chance the DN TE AA oO Te te l ab Ila Kak o ak a oo e o kro oo 4454 To bin the DAC 4 4 6 Setting the Operating Environment AA A CMON Didi TENT Figures Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig 2 1 Example of Software Development Using the TM rrrrrrrrrrrrrrrrrrrrrnrnrnrnrrrrrrrrnnrrnnnnrnnnnnnnnnrnnne 17 PN 18 2 3 Conceptual Diagram of the TM rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrnrrrrrrrsssrnsrrsrsrsrsssrnssrnrssssnnsnnsssnsnnne 19 TD 19 A PP NE 20 e e NE 20 LESE ENE 21 EE GE ss URRRTRTRTFFTERTTTTmT F p p ppPpp p 7 My F TT 22 MR 23 3 1 Project Bar in Floating Ne 26 3 2 Project Bar Pasted at The Top rrrrrrrrrrrrrrrrnnnnrnvnnnnrnnnnnnrnnnvnrnnsnrssrnnssnnnsnnnnrsssnsnrnsnsnsssssssnnnsnnne 26 3 3 Dialog Box for Registering an Editor rrrrrrrrrrrrrrrrrrnrrrrrrrvrrrnnrrnrrrrrnrnrnnnrrrrrnrrssrnssrsrnnnnnsssnsnnne 26 3 4 Registering an Editor
2. Partial build Fig 4 47 Build Execution Buttons 4 3 3 2 To Stop Building in the Middle O Canceling from the menu bar Choose Action Cancel Build from the menu bar e Canceling from the toolbar Click the Cancel button on the toolbar 4 3 3 3 To Reexecute Previous Build e Reexecuting from the menu bar Choose Action Reexecute Build from the menu bar O Reexecuting from the toolbar 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 1s shown at the beginning of the pertinent message in the build window Q Error Q AAA 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 Oo Starting from the menu bar While the cursor is located at the error or warning line choose Action Open from the menu bar o Starting from a right click submenu Right click the error or warning line to open a submenu and choose Open from that submenu o Starting from the toolbar Click the Open button on the toolbar 80 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 tex
3. eo To show the Project Bar Setting tab eo To change buttons Button tab O For Inspector related settings Inspector tab Setting tab Use the Setting tab to set the behavior of the Project Bar Customize setting Button Inspector Auto hide Load Project Fig 4 6 Setting tab Always on Top Shows the Project Bar always in front of all other windows e Auto Hide Automatically hides the Project Bar when it is docked to the edge of the screen O Load Project Automatically loads the last loaded project when the Project Bar is activated 47 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 Customize Setting Button Inspector Fro space 1 New Project L r Project Open Add Space space ME Project Editor Start Delete Editor Start PACE gt Tool Register ed Customize Fig 4 7 Button tab Button display view Check the check box of a button and the button 1s 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 Inspector tab Use the
4. 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 4 1 4 7 Environment Settings Dialog Box The Environment Settings dialog box is provided for specifying environment variables Environment Settings Cancel Fig 4 13 Environment Settings Dialog Box m Name essential Enter an environment variable name m 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 4 1 4 8 Utility Execute Dialog Box The Utility Execute Dialog Box starts the utility Utility Execute Parameter Browse 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 m 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 m OK Starts the utility Cancel Cancels starting the utility av 4 1 4 9 Option Setti
5. Cancel Fig 4 25 New Project Step OS eo From Realtime OS choose the realtime OS you use An already installed product is automatically displayed in the Realtime OS text box amp Choose a startup program If you choose A default startup program is used the realtime OS s 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 1s displayed From this dialog box choose the startup program you want e Choose a configuration file If you choose A default configuration file is used the realtime OS s 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 1s displayed From this dialog box choose the configuration file you want O When you finished setting click the Next N button New Project Step Finish is displayed 66 Hew Project Step Finish project is made by the following epecifications Information Topic Content Target Chip MEL Family Project Name sample I working Directory CA sample Project Type C language PROJECT Goal File Co isample sample 30 I Compiler NLCAIDAA 1 4 00 Releaze 1 gt Startup Programo defaultjnert0 a30 Fi
6. Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig A ETR OE 45 A A PPPS APON Obs 46 aD Customize Daloa Bik sure 47 A eee ko a 47 A A A Per E O CO TTT TTETKE 48 SEP 49 4 9 Debug Tool Intormati n Dialog Boo 50 4 10 Edit Tool Information Dialog BOX rrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 51 4 11 Application Tool Information Dialog Box rrrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 53 T IZ Current Directory DAS Bs 55 4 13 Environment Settings Dialog Box rrrrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 56 214 Utility Execut DAS BOX sus usta tier Veit tes eae 57 4 15 Option Settings Dilo BO rodde goe 58 4 16 Window Composition of the Project Editor rrrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 59 217 SB ATT TRIETA TTT TTT TTTTA TTT TI TT Me PITT 61 4 18 Generation Procedure View Luske lve o oa la 62 4 19 MEM IO ran NN 62 T20Mener VIs 62 TDN VION een 63 4 22 A A a A ka E Ko E ku a 64 123 NEW Poes DIE Lee 64 4224 NeW Project Sep COMPE adas 65 B25 NEW PG Sle SR 66 426 New Poes A A RK shar 67 O rond skuos ks ou o sd a kupado 67 28 Savino O E leani E A 68 4529 Out putts a Mak tl uii maa and AA nen an eee 68 AS CNN 69 Cl CUT TN 69 A A EE EEE EE Lente cin nicol leads 70 433 Command igloo BO ties 70 454 DEINO TE OM MIAN L
7. TM V 3 20A Integrated Development Environment User s Manual Rev 1 00 May 01 2003 Renesas Technology REJ10J0018 0100Z www renesas com Microsoft MS DOS Windows and Windows NT are registered trademarks of Microsoft Corporation in the U S and other countries IBM and AT are registered trademarks of International Business Machines Corporation Intel and Pentium are registered trademarks of Intel Corporation Adobe Acrobat and Acrobat Reader are trademarks of Adobe Systems Incorporated All other brand and product names are trademarks registered trademarks or service marks of their respective holders Keep safety first in your circuit designs e Renesas Technology Corporation and Renesas Solutions Corporation put the maximum effort into making semiconductor products better and more reliable but there is always the possibility that trouble may occur with them Trouble with semiconductors may lead to personal injury fire or property damage Remember to give due consideration to safety when making your circuit designs with appropriate measures such as i placement of substitutive auxiliary circuits ii use of nonflammable material or iii prevention against any malfunction or mishap Notes regarding these materials e These materials are intended as a reference to assist our customers in the selection of the Renesas Technology product best suited to the customer s application they do not convey any license under any intell
8. part of any entry m EEE 181 E ma ce nite action refs able ce tig Variable name a Clase Definition function DS SET m E gt z pe r A eee A E PA E APA OPPPPFRPPFFPPPPPRFPPRPRR O DataButf unsigned char 512 Global Ox000416 D sample TOe 16 LI amp Itzi zigned int Static within function func20 XsampleYTUlc 25 LI struct ABC typedef struct abc ABO Global Ox00065E O sample TU0c 17 OI Gp WritePoint unsigned char near Global Ox000414 Di zample TDO c 15 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 Oo Saving from the menu bar Choose File Save a List from the menu bar Oo Saving from the toolbar Click the Save button on the toolbar 87 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 En aj a 2 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 a
9. 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 amp 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 amp Paste or by typing directly from the keyboard d Bxff t a MS tal Search tal Select All ta Property Fig 3 28 Copying a String Insp udt 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 1s used 38 9 Inspector lt Sample C Sample Sample x30 gt File Edit View Acton Help L Function de ayy Functinn ref ai Variable def ae variable ref JO Narrow down Variable name Type Class Definition function Reference function File name LI udi unsigned char Global maini CS amples SACA tafmr 8x68 ta Bxffff tabic 6x87 tabsr 8x81 semmi A EOTOT TENO 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
10. 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 mu 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 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 4 1 4 6 Current Directory Dialog Box The Current Directory dialog box is provided for specifying the runtime directory Current Directory Working Directory C Other EA Caneel 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 m Other Specify a directory that you want to be the current directory This directory can also be specified by clicking the Browse button
11. e This dialog box shows a list of options used in the project s generation procedure O To add a new option choose the tool name you want to add and click the New button An Option dialog box 1s 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 1ts check box Oo To edit an existing option choose the option name you want to edit and click the Mod button An Option dialog box is displayed amp 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 5 Define a identifier This function ie thi lu LIndefines the specified predefined rr LIO It makes no diffrence with 03 Ono_asmopt Suppresses execution of assembler c fansi Makes NARA IMRFAN MAI and fE hot reserve asm Exclude asm from reserved words ICO k Paremeten Other e dir finto History Cancel Fig 4 40 Option Dialog Box O 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 comm
12. 10 Edit Tool Information E Mame Praaypro M Default Editor File Path CAAnchorPegayNPegavpro exe Browse Etcfyersion Parameter Ez L L File name ZF Line number XL Environment Add Delete kadi 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 1s 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 Assemblers CD ROM from Renesas Or it can be purchased from the URL shown below http www2 noritz co jp anchor For details about this editor contact Anchor Systems Note that the Peggy is for Japanese only l I Most MS DOS IM based editors do not work well We recommend editors that run in Windows M 27 3 2 Creating a Project There are following three methods to create a project O Create a new project O Read a project file of TM V2 or earlier version MTM file and convert it into TM V3 format project files O 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 2 In this quick tour we explain the method for creating a new pr
13. 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 Dfar msg 1 isn t specified Link library mr77sm lib and c77mrsm lib are specified lt Example gt system message size 16 interrupt_model STANDARD y 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 isn t specified Link library mr77sm lib and c77mrsmi lib are specified lt Example gt system ER 16 interrupt model SHORT y 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 z el 2 When you put the assembler source file besides Working Directory Assembly option L 16 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 Manages the software development process using the concept of a project Oo Provides a seamless environment as a common GUI for various tools o Based on static program analysis supports problem id
14. 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 Inspector function definition Use is possible That an informational display is impossible or use is impossible 12 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 Dfar_msg 1 i
15. dialog box m 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 c in 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 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 m 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 y
16. 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 4 1 4 4 Edit Tool Information Dialog Box The Edit Tool Information dialog box is provided for registering an editor Edit Tool Information Mame pezsypro e Default Editor File Path C anchor Peeey peeeyproexe Browse Current Etc Version Parameter ur LAL File name SF Line number EL Environment Add Mod cae Fig 4 10 Edit Tool Information Dialog Box m 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 m 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 1s the directory where the editor s execution file is stored Clicking the Current button opens the Current Directory
17. history of projects that have once been used 68 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 ProjectE ditor Ei A Save changes to sample tmk Fig 4 30 Confirming to save To save the project before closing it click the Yes button e To close the project without saving it click the No button amp 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 Add item Ei ltem name Cancel Add at top Fig 4 31 Adding an Item O For Item name specify the item name you want to add It is added below the selected item on the generation procedure view O 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 procedur
18. specify a project created by an earlier version of the TM or makefile the Project Editor starts and converts it into the project file useful for this version of the TM Starts the Project Editor If the Project Editoris already active the Project Editoris displayed in front ofall other windows Be Editor Start Button Starts an editor The editor to start must be registered and selected using the EDIT TOOL tab of the Tools Information dialog box Tool Register Button Opens the Tools Information dialog box from which you can register a debugger editor or application CI ou To Specify a function or variable name to be displayed on the Inspector Leave this box blank and all functions or variables are displayed If Auto Read from Chipboard is enabled using the Inspector tab of the Customize dialog box the string copied to the clipboard is automatically displayed here Y Function Definition Showsa list of function definitions on the Inspector Display Button ad Function Reference Shows a list of function references on the Inspector Display Button A Variable Definition Shows a list of variable definitions on the Inspector Display Button Vanable Reference Shows a list of variable references on the Inspector Display Button Specify the contents to be displayed on the Inspector Stk Viewer Start Button Starts the STK Viewer included with Renesas compilers The STK Viewer shows the amount of stack used w E E
19. 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 mu EDITOR TOOL tab Use the EDIT TOOL tab to register an editor and select the editor to use in the TM Tools Information DEBUG TOOL EDIT TOOL APPLICATION Pegg vpro Gitanchor Pegeykpegeypro exe C Notepad exe CaN DOS otepadexe Med Cancel 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 Clicki
20. 4 Inthe case of MR 00 for 7 700 seres aaa Kea KE msko sna 15 1 3 8 5 In the case of MR32R for M32R seriesJ rrrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnne 16 2 Overview 2 1 Integrated Development Environment 17 2 2 Concept of a Project 18 2 3 Roles of Each Tool Working under the TM 19 2 4 Directory Configuration 24 3 Quick Tour 3 1 Starting the TM and Registering the Editor Used 26 3 2 Creating a Project 28 3 3 Building a Project 37 4 Reference Manual 4 1 Project Bar 41 4 1 1 Overview 41 4 1 2 Buttons 42 4 1 3 Menus 43 4 1 4 Dialog Boxs 44 41 41 Too T tormauon Dialog BOX ru A SNO 44 4147 Customize Dialos Bl a 47 4 1 4 3 Debug Tool Information Dialog BOx rrrrnnrnnoonoononronnnrnrnnrnnrrnnsnnnnnnnsnsnnnnnnrsnnnsnnnnnnnnsnnnnnnnnr 50 41 44 Edit Tool Information Dialog Box 51 4 1 4 5 Application Tool Information Dialog BOxX e ss 53 4 146 Current Directory Dialog DOX sam ASADA 55 4 1 4 7 Environment Settings Dialog BOX ede 56 214 SVI Execute DAS Bs ST 4 149 Opiom ses Dialog BOX suo sk aa ek ar a E ii 58 4 2 Project Editor 59 4 2 1 Overview 59 4 2 2 Window Composition 59 222 IND 60 72 TN 6l SN A RE EE EE ES EN NO 6l 42 2 A WENETAMON Procedure VI 62 27 Ten rormannen 62 NNN 62 422 TDM VIN 63 4 2 3 Method of Operation 64 225 LEI NCW Poser SPSS 64 AD OVN 67 32 avmo fo Probe 4 ETEN 67 22 54 Saving the Pro
21. AMTOOL BIN MAKE EXE Makefile C AWORK sample sample imk Make option E Ignore zhell Use real time O5 Fr coed Fig 4 48 Environment Dialog Box Information Tab 82 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 Environment Epp Fig 4 49 Environment Dialog Box Setting Tab O Restore window condition The window position is restored next time the Builder starts up O Restore font The display font is restored next time the Builder starts up Oo 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 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 faj Inspector lt sample D sample sample 30 gt File Edit Viem Action Help Menu bar mj di P A Toolbar 4 Function definition a Function reference variable definition e Variable re
22. BIN LIBSO CAMTODLSLIBSDO INCSO CAMTOOLMINCIO TMP30 CAMTODLSTMP i Cancel Fig 4 44 Project Properties Tool Tab amp This dialog box shows information on the project being worked on Oo 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 71 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 di
23. I Y E zi E a TI Starts the Map Viewer included with Renesas compilers The Map Viewer graphically shows the condition of how the target program is mapped into memory Builds an item selected fiom the Project Editor paar ab Debug Button Starts a debugger The debugger to start must be specified using the DEBUG TOOL tab of the Tools Information dialog box When you press this button without specifying a debugger the Tools Information dialog box opens up Home Page Display Button 4 1 3 Menus Shortcut menus are provided for the operations to be performed from the Project Bar The shortcut menus are listed below Change Button Position B Changes settings to show hide or order of display of each button on the Project Bar Set C Always on Top Shows the Project Bar always in front of all other windows Auto Hide Automatically hides the Project Bar when it is docked to the edge of the screen Load Project Automatically loads the last loaded project when the Project Bar is activated Starts the utility included with Renesas compilers The Execute Utility dialogbox opens when you selecta sub menu Please input a parameter of the utility mn the dialog box Help H Help forTM Shows help forthe TM Help for Compiler Shows help for the compiler Help for Assembler Shows help for the assembler Help for MRxx Shows help for MRxx Help for Debugger Shows help for PDxx o
24. Inspector tab to set Inspector related settings Customize 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 4 1 4 3 Debug Tool Information Dialog Box The Debug Tool Information dialog box is provided for registering a debugger Debue Tool Information Name par File Path ox MTOOLEP OT EP DTT exe Browse Current Ete Wers ior Target Chip 7700 Family Environment Add Delete Wicd ity Caneel Fig 4 9 Debug Tool Information Dialog Box m Name essential Enter a debugger name m 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 m 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
25. acro Browser dialog box is displayed Macro Browser Ei M acro list EA DELETE del A LNLIST PROJECT cmd PRJDIR C sample I MEMATBLFILE mrtable a30 pe MAINCFILES id h mr3Dane sus ram no sys_rom LME LMC30 En cfg30 MKMRTBL LIBFILE Fig 4 37 Macro Browser e This dialog box shows a list of macros used in the project s generation procedure O 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 O 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 O To delete a macro choose the macro you want to delete and then click the Del button Macro DELETE E Value Edel E Cancel Fig 4 38 Adding a Macro O For Macro specify a macro name e For Value specify the value of the macro 73 4 2 3 18 Option Browser Show an option browser When you choose this menu command an Option Browser dialog box is displayed Option Browser Ei Option New Mod Del Tool name E E nest l ee nao Version 300 01 Gq G e as30 en E L AFLAGS Option string 5 Er Ins pedir finto PEN rule Selected files o Le LIBFLAGS Y Asamp30 130 E efg30 CFGFLAGS Ee mkmrtbl MEMATELFLAGS Cancel Fig 4 39 Option Browser
26. alled in the install directory BIN directory when installing the compiler 23 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 e Directory in which to store the project files e Directory in which to store the objects generated as the result of compilation Oo 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 o Files located on the same drive as the working directory These files are registered with a relative path from the working directory eo Files located on a
27. alog box is displayed About ProjectE ditor Fig 4 45 Showing Project Editor Version amp This dialog box allows you to verify the version of the Project Editor 78 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 4 Builder lt sample C WORK sample sample tmk gt File Edit View Acton Help al 0 ae el ROMDATA GBBBAS6 888245H Fvector CODE 6006283 6011BH interrupt i ncrtH ad NC36 c dir finfo MTOOL SMP36 samp3a c H16C 68 HEIA COMPILER U 5 16 Release 1 COPYRIGHT C 2661 2463 RENESAS TECHNOLOGY CORPORATION ALL RIGHTS RESEF AND RENESAS SOLUTIONS CORPORATION ALL RIGHTS RESERVED xx CAUTION xx This product is evaluation release Error ccom MTODL SHP3B Samp3G c line 56 parse error at near Sorry compilation terminated because of these errors in maini v AMTODLYSMPJ YSAMPIG e C AMTODLNBINNMAKE EXE xxx Asamp30 r36 Error 4 xxx Finish Fig 4 46 Builder Window 79 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 Rebuild
28. and an Add Member dialog box is displayed Add member Ei Name IIS h Section o i Mail address E Phone number Hote Cancel ont Fig 4 41 Adding Member Information o 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 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 o 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 Target Tool Compile INCATAA V 4 00 Release 1 Pealtime OS MA SUE V 3 20 Release 1 Package information Topic Content I neca Version 3 00 01 la version 4 00 00 In30 Version 4 00 00 b30 Version 1 00 02 L an MAL AAA Content lul30o 1 00 00 lmca0 Version 3 20 00 Environment variable BINSO CAMTOOLS
29. as com e When using any or all of the information contained in these materials including product data diagrams charts programs and algorithms please be sure to evaluate all information as a total system before making a final decision on the applicability of the information and products Renesas Technology Corporation and Renesas Solutions Corporation assume no responsibility for any damage liability or other loss resulting from the information contained herein e Renesas Technology semiconductors are not designed or manufactured for use in a device or system that is used under circumstances in which human life is potentially at stake Please contact Renesas Technology Corporation Renesas Solutions Corporation or an authorized Renesas Technology product distributor when considering the use of a product contained herein for any specific purposes such as apparatus or systems for transportation vehicular medical aerospace nuclear or undersea repeater use e The prior written approval of Renesas Technology Corporation and Renesas Solutions Corporation is necessary to reprint or reproduce in whole or in part these materials e f these products or technologies are subject to the Japanese export control restrictions they must be exported under a license from the Japanese government and cannot be imported into a country other than the approved destination Any diversion or reexport contrary to the export control laws and regulations of Japan and or t
30. be registered to the project concerned Press the Tool Register button and a dialog box like the one shown below appears Tools Information x DEBUG TOOL EDIT TOOL APPLICATION Add POS051M 44 CAMTOOLSPOSOSIMSPOSOSIMESE M Delete kadi FE 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 ES lalola eee Fig 3 34 Starting the Debugger 40 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 Oo 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 4 1 2 Buttons The following explains the function of each button on the Project Bar Proj o Project Name Display Showsaprojectname Box DI New Project Button Creates a new project Click this button and the Project Editor starts anda New Project Wizard opens Opens a project file When you
31. ct Editor is started from the Project Bar to create a new project or open an existing project O The primary commands of the Project Editor are assigned to its toolbar O Only one project can be edited at a time You cannot open multiple Project Editor windows at the same time 59 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 mO mn Open Project O Opens an existing project Save S Saves the project being worked on to the current file by overwnting EE Gets 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 y Sosa ste Status Bar S Shows or hides the status bar Project menu The Project menu has assigned to it the menu commands to edit project information among the Project Editor functions Scan All Updates the dependency relations of generation procedure Dependencies S 60 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 Help H Hp Shows help for the TM and help for tools used m the project art an electronic manual for the TM and an electronic manual for tools used in the AboutP
32. d or downward direction from the cursor position You can search by error by warning or by error amp 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 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 amp 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 Environment Information Setting Target chip MIEC Family Project name sample Working directory CAWORK sample Make exe C
33. different drive than the working directory These files are registered with an absolute path 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 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 Working directory for model A ModelB Working directory for model B SRCA Source directory for model A SRCB Source directory for model B COMMON Common source directory for A and B HEAD Common header file for A and B G COMMON Common source directory on a network 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 1s the directory in which the common source files are stored when developing a project with multiple people Because the drive 1s different this directory is managed with an absolute path Therefore
34. e My Documents or Program Files The notation cannot be used to specify two or more directories O 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 4 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
35. e 71 4 35 Popup Menu for Dynami MA 71 A S OM let Pops e T2 STN DTO WS SIET E TT A T E A 73 TJA MR 73 OBS 74 AAO POM DA Bae 75 2 41 Adding Member INIOFMANONs iS 75 42 Addis a Documentais ted 76 4 43 Project Properties TTS 76 444 Project Propertics o tee E RK TF 2 45 Showing Project Editor VERS avs 78 226 Builder NR 79 4 47 Build Execution DUNONS anida ade 80 4 48 Environment Dialog Box Information Tab ccccccccccceeeseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 82 4 49 Environment Dialog Box Setting Tab s ssssssssssss 83 2 50 Inspector Wy B NN Kne 84 Flo 42o 1 fe ors BUON si 84 Fig 4 52 Specify Detail Conditions Dialog Box s sssssssssesesssennsesesesssneessutesssssannsesesennns 85 Pio 4233 Ree Five 87 Pie AeA Update bi 88 Fig 4 55 Environment Setup Dialog Box Action Tab rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrnrrrrrrrnnsnnne 89 Fig 4 56 Environment Setup Dialog Box Preview Tab rrrrrrrrrrrrrnrrrrrrrrrnnrnrrnnnrnnrnnnnrnnnnrnrnrrnnrnnnnnne 89 1 Introduction 1 1 Operating Environment The following lists the host computers and OS versions on which TM has been verified to run Host Computer Handling instructions IBM PC AT or compatible Microsdt Windows More than Intemet Explorer4 0 is being installed Miarosdft Windows98 98SE Tome TM teate ote gr insure Note that the TM does not run on Windo
36. e TMI file The TMK file is prepared in the makefile format corresponding to the make command that is used standard in the UNIX 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 eme ie eo 213 ms S plo de Ol er ae o Fig 2 2 Project Name l 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 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 Windows 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 Editor Project Builder Inspector Map Viewer Editor STK Viewer GNU Make ll Absolute object file enerate C compiler assembl
37. e 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 1 File name samp30 c a f Files of type nc30 el Cancel EG Fig 4 32 Adding a File o 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 O Even a nonexistent file name can be specified o Ifthe specified file has the same extension as that of the compiler or assembler s default extension the file is recognized as a source file and has the compiler or assembler s 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 Command New DELETE IOUTCIRIME TARGETI DELETE DUTDIR nertO r30 IDELETE Asamp30 r30 Fig 4 33 Command Dialog Box amp This dialog box shows command information for the item selected on the generation procedure view O 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 Oo To edit an existing command choose the line you want to edit fro
38. ectual property rights or any other rights belonging to Renesas Technology Corporation Renesas Solutions Corporation or a third party e Renesas Technology Corporation and Renesas Solutions Corporation assume no responsibility for any damage or infringement of any third party s rights originating in the use of any product data diagrams charts programs algorithms or circuit application examples contained in these materials e All information contained in these materials including product data diagrams charts programs and algorithms represents information on products at the time of publication of these materials and are subject to change by Renesas Technology Corporation and Renesas Solutions Corporation without notice due to product improvements or other reasons It is therefore recommended that customers contact Renesas Technology Corporation Renesas Solutions Corporation or an authorized Renesas Technology product distributor for the latest product information before purchasing a product listed herein The information described here may contain technical inaccuracies or typographical errors Renesas Technology Corporation and Renesas Solutions Corporation assume no responsibility for any damage liability or other loss rising from these inaccuracies or errors Please also pay attention to information published by Renesas Technology Corporation and Renesas Solutions Corporation by various means including the Renesas home page http www renes
39. ed on the makefile TMK file created by the Project Editor 24 Builder lt Sample C Sample Sample_tmk gt Miel E3 File Edt View Acton Help O Error ccom main c line 39 unknown variable 1 gt 1 1k1k1 p 8x66 Error ccom main c line 39 syntax error at near p gt 1 1k1k1 pH 8x66 Sorry compilation terminated because of these errors in main c C wxHTOOLXBIHXHAKE EXE xxx main r36 Error 4 xXxXxxxxxx Finish a ut se 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 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 gt As a result the following advantages accrue O Comments and other non compiled parts are not searched O Can be searched separately for references and definitions O Even when divided into multiple source files the entire program can always be searched e Inspector lt Sample C Sample Sample x30 gt File Edit View Action Help El ei a a e Function definition qi Function reference sd variable defin
40. entification 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 fi sample x30 MapViewer File F View Optionf0 Help H Online Address size Section Address size Section Label 666666 666466 gt gt 866668 000400 ee 000400 000010 000400 000010 G 000400 pool 000410 000048 G 000408 ment 000458 000600 666a58 000300 66641 6 666648 666416 iob 666d58 66F2a8 66644c mbase Intemet 61 6666 Ge 0000 NCI A mnevt Explorer GOFOOGO OOOG1O MI Inspector lt sample CAXWORkssamplessample x30 gt Ed lo xj B6FOB1O BBO9ad File Edit View Action Help I Br 69bd 66611b rit Gf Gad8 08F228 kii alal 2 2 ACLARA AARY ARA ProjectE ditor lt sample C WORk sample sample tmk gt Eie View Project Help Functionname Type Class Address Filename Line number Dj KP I x ip 2 LI start Static C WORK sample nert0 a30 T all LI 0 main void Global Ox0FO010 C MTOOL NSMP30 samp30 c Se fo 06 talint void Global Ox0FO032 C MTOOL SMP30 samp30 c ELOJ sample cmd O 6 indicate void Global OxOFO046 CAMTOOLASMPZOsamp30 c p 1 5 Asample tmk ES Dependencies LI nit Global 0x0F0048 init c 3 Ancrt0 130 p Asample cmd LI Ginitder Global OxOFOOEA device c Anert0 a30 TD Ancrt0 130 16 speed Global 0x0F0110 device c E E Asect30 i
41. enu bar o Starting from a right click submenu Right click the entry to open a submenu and choose Open from that submenu o Starting from the toolbar Click the Open button on the toolbar o Starting from double clicking Double click the entry 86 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 O Checking from the menu bar Choose Action Set Line Select Mark from the menu bar e Checking from a right click submenu Right click the entry to open a submenu and choose Set Line Select Mark from that submenu Oo Checking directly Check the check box directly o Checking automatically from the editor Check Auto Set Line Mark on the Set Environment dialog box s 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
42. ependency 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 In this example when you register main c the TM registers main r30 simultaneously with it producing the following display E e ASample x30 EA ASample cmd ie Sample mk ELS Ancrt0 r30 Aneti aai 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 99 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 Option New Mod Tool name nca Version 3 00 01 Option string E dir QUT OIA finfo Selected files Armain r30 Fig 3 16 Option Browser 33 Definitions of the following are entered by default for each option respectively Compiler nc30 CFLAGS Assembler as30 AFLAGS Linker 1n30 LFLAGS Load module converter Imc30 LMCFLAGS CFLAGS is a makefile macro which defines the options used when compiling a program Choose CFLAGS and p
43. er 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 Proj id gt ajaj Alis insp 3 wa Mel El SF 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 server process 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 m 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 ProjectEditor lt sample C WORkK sample sample tmk gt xie e el 2l ti teample 30 File View Project Help JX sample cmd B sample tmk 3 Dependencies AnertO r30 Bl sample cmd 2 Amert0 a30 EM Ancrt r30 B AgseckQ ine EM Asamp30 130 Asamp 0 r30 2 Command PLA 00INCMOS LNLIST Fig 2 5 Project Editor Builder The Builder invokes the GNU Make command to build a project bas
44. ers To register the members participating in program development use the Add Member button Fig 3 19 Button for Registering Member Information Add member Ei Mare loe Renesas Section System Design Mail address Jice renesas com 0000 Phone number fs Mote Planning Cancel 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 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 E Mail Address Location 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 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 ee s se 2 MIE KEE Fig 3 23 Save Button Next press t
45. 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 Furthermore the following files are copied into the directory where the OS is installed Directory SYSTEM File Atl dll ATL support DLL 11 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 amp No directory or file names that include kanji 2 byte characters can be used O Only one instance of the period can be used in a file name O No network path names can be used Assign the directory you use to a drive name O No shortcuts can be used Oo No directory or file names that include a space character can be used Exampl
46. f 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 1 The option which you must surely specify Assembly option DC_inc 0 2 When you put the source file of C besides Working Directory Compilation option gt L 3 When you put the assembler source file besides Working Directory Assembly option gt L 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 mr79lm lib and c79mrlm lib are specified lt Expamle gt system message siz 24 interrupt_model STANDARD y 2 When 24 was specified in the message size and SHORT was specified in the interruption prohibition model Compilation option Dfar msg 1 is specified and fMJI isn t specified Link library gt mr79lmi lib and c79mrlmi lib are specified lt Example gt system message size 24 interrupt_model SHORT 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 Dfar_msg 1 isn t specified and fMJI is specified Link library mr79sm lib and c79mrsm lib are specified l
47. f 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 Compiler Product Real time OS Product After MR30 V 3 20 Release 1 After MR308 V 1 00 Release 2 After MR79 V 2 00 Release I Pr After SRA 74 V 4 10 Release I When using any product marked by and TM V 3 20A in combination Once Carry out V2CVT EXE of 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 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 manual 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
48. ference Narrow down ddress void Global OxOFOOFS Diksa mple TOO Ol sub2 void Static o DYsampleXTOOLo LI iunc signed int Global OxOFO010 D sample T01 c LI func signed int Global Ox0F0038 O sample T01 c O func3 sienedint Global Ox0FO082 D sample TO1 c List window LI funci signed int Global OxOFOODOGO D amp zample TOlc LI de subi signed mt Static D sample T00 c P AL ma ama iine l Henle laj x elt row li e ele el DataBuff i 0 I WritePoint UataButt 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 Specify function or variable name Show function reference 1 Show variable reference Detail settings of Inspector Insp En plela ZT Show function definition Show variable definition Fig 4 51 Inspector Startup Buttons 84 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 Setting
49. float double void pointer struct union enum typedef func near pointer far pointer array void m Specifying the storage class Selectable entries Condition Not specify global static inline Function definition function prototype Not specify global static in file static in function Variable definition variable reference m Specifying the start address Selectable entries Condition 0x000000 OXOFFFFFF Function definition variable definition variable reference m Specifying the end address Selectable entries Condition 0x000000 OXOFFFFFF Function definition variable definition variable reference m 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 1s 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 Oo Starting from the menu bar Choose Action Open from the m
50. g 4 26 New Project Step Finish O When you finished setting all entries on the New Project dialog box the contents you ve 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 Ope 3 a EEE al E Pro E aa sample tmk L File name sample tmk E Files of type Project Files tmk Cancel Fig 4 27 Opening a Project Oo Choose a project file any file name with the extension tmk Click the Open button and the project of the selected file opens e 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 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 i
51. he Build button on the Project Bar rem Ola ajo p vage TE 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 1t the Project Editor prompts you to save ProjectE ditor E MESSAGE Project has been changed Do you save the project 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 24 Builder lt Sample C Sample Sample_tmk gt IOl EG File Edit View Acton Help O Error ccom main c line 39 unknown variable 1 gt 1 1k1k1 pH 8x66 Q Error ccom main c line 39 syntax error at near p gt 1 1k1k1 pH 8x66 Sorry compilation terminated because of these errors in main c C YMTODLNBINYMHAKE EXE xxx imain r36 Error 4 xxx Finish m di ze Fig 3 26 Error Display during Build Execution 37 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 Insp Wa Pelo L 44 Detail Setup button Variable Reference Display button Variable Definition Display button Function Reference Display button
52. he country of destination is prohibited Please contact Renesas Technology Corporation or Renesas Solutions Corporation for further details on these materials or the products contained therein For inquiries about the contents of this document or product fill in the text file the installer generates in the following directory and email to your local distributor SUPPORT Product name SUPPORT TXT Renesas Tools Homepage http www renesas com en tools Contents 1 Introduction 1 1 Operating Environment 9 1 2 Installation Method 10 1 2 1 Executing the Installer 10 1 2 2 Notes about TM Versions 10 1 2 3 Compiler and real time OS Combinations 10 1 2 4 Directories and Files Generated After Installation 11 1 3 Usage Precautions 12 1 3 1 Notes about File Names 12 1 3 2 Notes about Updating of Dependency Relations 12 1 3 3 Notes about Utility Software such as Virus Check Program 12 1 3 4 Notes about Network 12 1 3 5 Notes about Inspector 2 1 3 6 Makefile of library source 13 1 3 7 The TM project of the former version was taken over 13 1 3 8 Use real time OS 13 1 3 8 1 In the case of MR308 for the MI6C 80 M32C 80 series rrrrrrrrrnrnrrnnnnrnnnnnnnnnnnnnnnrnnnnnne 13 1 3 8 2 In the case of MR30 for M16C 60 20 series rrrrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 13 1 3 8 3 In the case of MR79 for 7900 SerieS cccceeeeesssssessseseseeseeseeeeseeeeeeeeseeeeeeeeeeeeeeeeeeeees 14 13 8
53. itinn 4 Variable reference Function name Type Class Address File name Line number LI start Static CA SampletnertD0 a30 LI main vold Global O0s0FO010 CASampletmain c a LI talint vold Global O0s0F0034 CS ample main c AB LI indicate void Global 0x0F0048 C Sample main c ataj LI init Global Os0FO044 CNS arnpleMnit c O LI i init dew Global D OFODFO L 5amplesdevice c void Far main p 8x66 pda HxFF udf Hx I tamer 8x68 ta BxFffff L L Fig 2 7 Inspector GNU Make The GNU Make command is an open source software item compatible with the Make command available in the UNIX IM 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 gt 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 lt Searched at this position by grep int l
54. ject Dy Speci ying SNE He 68 zo a A uon a Re kon 68 A a a A T 68 42 EXUINS ME NPR 69 uke su Kero sz I eeo ver T oe o ooBho nO TTT TT 69 ro JB 69 AD VIa Ve le Oat li kis no TTT O ohBhe TE TTT TT MI 69 2 EE MEG GMINA EE An 69 A a O SL 70 Y e nT ER 71 7 BEROR 72 ES A O E UNIA 12 A TTT TTT TTTTTTI TITT ETT6EEIPE PTT REI E T2 AL NB 73 A A AN 74 423 9sAddino Member ION IIA A AS 75 22 520A00m8 4 De ss 76 22 76 32 32 Caral DEP 17 ARM alo EEE RE EN A A N E A N S E A I 27 TOMMI A273 Ab O Oo A A VN A NIN 4 3 Builder 4 3 1 Overview 4 3 2 Builder Window 4 3 3 Functional Description 4 ok A A o o E o o AS 43 32 LO Stop Buldmojn he MING ss ss A ANO ko o To Keexcone Previous Buld ida 4 3 3 4 To Jump to a Location in Error or Warnlng s s sss 4 3 3 5 To Examine the Meaning of an Error or Warning orronooooooooooonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn AO save DUI RESIS SN 2557 O Prat Buld RESUSO E E OE DS E DN As A A 2359 o eo Erroror Warnie eee 43510 10 Chances ne Display FN A gt Sl LO SNOW hora vvs 4 4 Inspector 4 4 1 Overview 4 4 2 Inspector Window 4 4 3 Starting the Inspector 445 1 OS HOw Intormation L r 4492 Nov DON ASC ico 4 4 4 List Window AAA NTO SOW Pei e TTT TITT EERTE TTTTT RITTER 4 4 4 2 To Open a Selected Entry with the Editor i i L L L e
55. lay on the Project Editor should appear like the one shown below E E Amain r30 Show command information on a selected file item on the right side of the window Eno Dependencies E SRCAWnain c 2 Command Ae MCC ICFLAGS SACASmain c 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 E e A5ample s30 I 9 ASample cmd E E Aneri r30 pe neri a30 A B Asect3Qinc EE Amain r30 SRCAMnain c Fig 3 11 Example of a Project In this example there are two items at the top level all and clean 13 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 Command file used when linking nert0 r30 Post assemble object of the startup program main r30 Post compile object of program written in C language The mam r30 file is created from the main c file This relationship of file generation is displayed with a Project Editor view 4 13 For projects using the real time OS you ll have CFGEXECONTM at the top level in addition to the two items all and clean CFGEXECONTM is the item necessary
56. m Command and click the Mod button A Command Setup dialog box is displayed O To delete a command line choose the command line you want to delete and then click the Del button 70 Setup command Fig 4 34 Setting a Command e For Command enter a command The Def macro gt button adds a macro displayed by a macro browser to the command line amp The Dyn macro gt 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 4 2 3 14 Properties Show properties of an item Choose this menu command when an item on the generation procedure view 1s selected A File Properties dialog box is displayed Fig 4 36 Item Properties O Properties are displayed only when an existing file is specified Oo Ifnecessary 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 4 2 3 17 Macro Browser Show a macro browser When you choose this menu command a M
57. n New Project Step Compiler is displayed New Project Step Compiler NC30WA V 4 00 Release 1 e 5 deraut linker scrip Tle used p Ustam va Fig 4 24 New Project Step Compiler e From Compiler package choose the compiler you use An already installed product is automatically displayed in the Compiler package text box O Choose a startup program If you choose A default startup program is used the compiler package s 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 1s displayed From this dialog box choose the startup program you want O When you finished setting all click the Next N button 65 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 New Project Step OS Speci realtime os package to use with the project Pealtime 05 MASOK 1 3 0 Release 1 Specity a startup program fe A default startup program is used Custom E Specif a configration file fe A default configration file is used ko Custom IA
58. nc CM Asamp30 130 10 snet Glnhal NyNFMRA devire e E EA Asamp30 130 3 Command 7 iLN G ODINCMDINSILNLIS od far main p 6x66 pd Bxff udf 6x61 tabmr 6x66 ta OxffFF E Mail Address Location ta ic 6x67 CB Joe Renesas System Design joe renesas E Support txt CAMTOOLASUPPORT tabsr 6x61 asm tFSET I A A AI gt Star A E TM El Project ditor lt sample 5 Inspector lt sample CA EE sample x30 MapViewer Fig 2 1 Example of Software Development Using the TM 17 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 O Procedural information necessary to generate the final object normally the executable object Oo Information on source files associated with development amp Information on compile etc options Oo Information on development members Oo 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 O 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 o Project name TMK file o Project nam
59. ng 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 mu 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 Tools Information DEBUG TOOL EDIT TOOL APPLICATION WIA DOW a lc ee Ei Cancel 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 4 1 4 2 Customize Dialog Box The Customize dialog box is provided for changing various settings of the Project Bar Customize setting Button Inspector Always on top Auto hide Cancel Fig 4 5 Customize Dialog Box From this dialog box the following can be set
60. ngs Dialog Box The Option Settings Dialog Box set a utility s 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 Define a identifier This function is th Undetines the specified predefined lt makes no diffrence with 03 Suppresses execution of assembler Makes INRA INHFAN NRL Land f Fig 4 15 Option Settings Dialog Box 58 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 ProjectEditor lt sample C WORK sample sample tmk gt File View Project Help Helal kape xa EX sa E all sample 30 ME sample x30 Es A sample cmd Dependencies 4 sample cmd EM AnertOr30 EM Asamp30 130 2 Command A SILN E ODINCMDIVSILNLIST El A Fig 4 16 Window Composition of the Project Editor Oo The Proje
61. nnnsnnnnnne 36 DD 37 GE I 5 0 KE TTTTTTVLLV Vy LLL FTRTTTTETTT ETT 37 3 25 Dialog Box for Confirmation to Save imitan eran 37 3 26 Error Display during Build Execution oooooooononononononononononnnnnnnnnnnnnonnnnonnnnnnnnnnnnnonnnnnnnnnnnnnnnnos 37 3 27 Buttons for Using the INSpECtOr asasena O E ekkar a O lO E ku aO 38 3 28 Copying a DIMO eseis pesepkkos ese ksbootogpe bee ksd obi eE brio Se kob sgkagposeskadanoukosyi bopa brokoons bek vepsebkktassekiis 38 3 29 Variable Reference Display Bulonja ss E E EEK 38 3 30 Showing Variable Referentes mesmo rko mad paso ks BEROES ESE ESO KKE ELEK Ko ENEO J ka BELO KGE KAE OKO Kk se aereas 39 3 31 Auto Read from Clipboard Check Box ooooooooooccccccncnnncncnnnononnnnnnnnnnnnnonnnnnnnnnnnnnnnonnnnnnnnonoss 39 332 Showing NR 40 3 33 Registering the Debugger ariens kor ka Ko pros bean ir dings sus anes KONS Ko peep koe koko oka KE 40 3 34 Starting the Debugger oooooooonoooooooooonnnonononnnnnnnnnnnnnnnnnnnnnnnnnnnn nono nn non non nnnnnnnnnn non n nono nono nnnnnnnnnnos 40 4 1 Tools Information Dialog BOX rrrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnne 44 4 2 DEBUG TOOL TAD icscscsccsnesacsnoicheoconencstaasieosancanehtenatcetsaneanedahtansantereecnaidebaacitoatesatidassarseaasoboies 44 Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig
62. oject 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 Hew Project Step 1 project is made Specity Target MEU Project name Working directory made project i kept with the specified project name in the working directory Target chip Project name MIEC Family sample Working directory CAWORkssample a 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 New Project Step 2 Eek WHM RAET esa Re Sine WSF e le Rees Fig 3 7 New Project Wizard Step 2 Next choose the type of project Hew Project Step Compiler e 5 dETEUIIMKEr senpi hie Is used Euston T sak Memo Cancer Fig 3 8 New Project Wizard Step Compiler 29 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 Hew Project Step Finish Ei project is made by the f
63. ollowing specifications Information Content Target Chip MEL Farnly Project Marne Sample Working Directory C S ample Project Type C language PROJECT Goal File CNS amplet S ample 30 Compiler NCSOWA V 4 00 Release 1 Startup Program defaultincri a30 Back Cancel 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 ProjectEditor lt C 15amplet5ample tmk gt File Viem Project Help Beja papel He gt SI se 2 E n A5ample s30 PA Sample cmd i 5 ample tmk Dependencies EA Anert0 r30 e ASample 30 e AnerO a30 2 Command gect3D inc 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 1s 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 1s as follows target dependencies command This means that target depends on dependencies and that to get target from dependencies command must be 30 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 disp
64. ou changed are reflected before closing the Tools Information dialog box Cancel button Click the Cancel button and the Tools Information dialog box 1s closed without reflecting the contents you changed 52 4 1 4 5 Application Tool Information Dialog Box The Application Tool Information dialog box is provided for registering an application Application Information Name ale File Path DXWINDOMSXGalc exe Browse Current EtciVersiond Parameter e Set parameter before executing Environment Add Delete Maas Caneel Fig 4 11 Application Tool Information Dialog Box m Name essential Enter an application name m File Path essential Enter a path to the application s execution file The file can also be selected by clicking the Browse button m 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 m 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 o P Project file name o NW Working directory o X Target program name o T Target chip name m Set parameter before executing Turn this check box on
65. r PDxxSIM Shows a manual for the TM Shows a manual for the compiler Shows a manual for the assembler Shows a manual for MRxx Shows a manual for PDxx or PDxxSIM Show TM Home Page W Shows the home page of the TM Project Bar Version A Shows the version of the Project Bar 43 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 Tools Information user pdi CAM TOOLEPOP YP OT exe EMO Family PO SOs IM CAM TOOLFPOSOSIMEPOSOSIMESE M160 Family Modit Maatpa Fig 4 1 Tools Information Dialog Box From this dialog box the following can be set o To register a debugger DEBUG TOOL eo To register an editor EDIT TOOL tab o To register an application 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 Tools Information user pdi CAM TOOLEPO YEP OT exe 00 Family POSOSIM CM TOG L R abs TMP OOS IM EE MIGO Family odit MEGET Fig 4 2 DEBUG TOOL Tab 44 Debugger List Shows registered debuggers The user registered debuggers are shown as user xxxx The debugger which has its check box checked is
66. rea exits the previous search character is automatically entered in the dialog box When a selected area exists the selected string is entered e Searching from the menu bar Choose Edit Search from the menu bar e Searching from a right click submenu Right click on the entry to open a submenu and choose Search from that submenu amp 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 4 4 6 1 Action Tab Set Environment Action Preview i H estore window i Ekon e Auto set line mark e Restore font W Automatic update carcel ky Fig 4 55 Environment Setup Dialog Box Action Tab m Restore window condition Restores the window position the next time the TM starts m Restore font Restores the display font the nex
67. ress the Mod button and the dialog box shown below appears Define a identifier This function is thi LIndefines the specified predefined rr It makes no diffrence with 03 Ono_asmopt Suppresses execution of assembler c fansi Makes INRAA NRAFAN INAI and fE inot reserve asm Exclude asm from reserved words ICO k Parameter Other c dir FIULITOIR finto History Cancel 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 4 17 The finfo option is needed for the inspector function to be used Do not change options such as c which are associated with make control 34 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 Option Browser E Tool name reso Version 3 00 01 Option string dir QUT DIR finfo Selected files Amain r30 Amodule r30 Choose the file for which JS Fl as30 to apply the macro Fig 3 18 Creating a New Macro Registering development memb
68. rojetEditor A er version information 4 2 2 2 Toolbar The toolbar has various buttons arranged on it that facilitate execution of frequently used commands ID owwe orange Be e O o Svetepgsbrgmutedonbteammtstyome w om ominis OOOO e e sospepsistee O e nue otemem O E ro E EMEN MN OEEEG uINI rias 4 2 2 3 Status Bar T oh EG IU The status bar shows auxiliary information on how to use the TM Shown below is an example of the status bar zt Fig 4 17 Status Bar 61 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 all E e sample x30 E A sample cmd i B sample trik E o Ancrt0 r30 EH Mncrt0 a30 po E Asect lLine EES Asamp30 r30 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 tu sample 30 Dependencies 4 sample cmd EM Ancrt r30 EM Asamp30 130 2 Command A ILLA G JODINCMDSILNLIST 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 E Mail Addre
69. rrrrrrrrrrrrrrrrnnrrrrvrvrrrrnrnnrrnnnnrrnsssnrnsnsnnrsnssnsnsssrrsnrnsnssnnsssssnsssnsssnnnnnsnsnssnne Zel SNITT 28 3 6 New Project Wizard Step Lave ds 28 Now Project W SP NSD 29 3 8 New Project Wizard Step Compiler rrrrrrrrrrrrrrrrrrrnvrrrnrnrrnrnrnnnrrrnnnsnrnnrnrnrnnnrrnsnsnsnsnnnsssssssne 29 3 9 New Project Wizard Step Finish msinione nearne EEEE CEEE ENEE Eie 30 3 10 Project Editor Immediately After Project Creation rrrrrrrrrrrrrrrrrrrnrrrrnrrrrrnnnrnnnrrnrnnnnnrnnnnnnne 30 HP TIP 31 PN 32 lo electo Source mil ee eee en a a E SEEE RE ARE 32 3 14 View alter Registering Source Piles c cccccataccrsessecenacetaceasesdacenadatncnnadescdanadasnoactecsnndaeneamneatnbenes 33 3 15 Option Browser Start BUHO estarias 33 ON 33 3 17 Option Setup Dialog BOX snscoiscozsvornconanceve snanbsieaswda seis Seapasies deus snide Rear 34 3 18 Creating a New Macro ooooooooonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnonnnnnnnnnn nono non nono nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnos 35 3 19 Button for Registering Member Information ooooonccononanananaoonooooonononn non onnnnnnnnnn nono nono non nnnnnnnnnos 35 3 20 Registering Member Information rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrnnnnrnrnsnrnnsnsnrsrnsnnrnnnnsnnnnnnssnnssnne 35 3 21 Button for Adding Document rrrrrrnnnnrnnnnnnnvnnnnnnnnnnnnnnrnnrnnnnnsrnnsnnnnnsssssnnnsssssnsnsssnssnnnnnssssssnne 36 3 22 Displaying Registered Development Members and Documents rrrrrrrrrrrnrvrnrrrrnvnrnnn
70. s displayed Specify any file name and folder in which you want to save the project Save in I sample E EA EX a Laj sample trak File name sample tmk E Save as type Project file trnk Cancel Fig 4 28 Saving the Project File O Enter the file name you want In this case the extension does not need to be specified o Ifyou specify an existing file name a message Is displayed asking you to confirm whether or not to overwrite Follow the instructions displayed here Oo 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 EXA KLE Save sample e Faj EA EX File name Save as lype Project make mak Cancel ve Fig 4 29 Outputting a Makefile O Enter the file name you want In this case the extension does not need to be specified o 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 Oo 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
71. s 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 Specify detail conditions x Project name sample 141 1 4 4 4 Category Variable y Definition Definition y Variable ab M Discriminate uppercaselowercase Analytic range condition Type Al types amp Not specify Class LUNON d l C Global Static in file C Static in function Address Start Mot specify End Mot specify File Not specify Mi Function Not specify Cancel Fig 4 52 Specify Detail Conditions Dialog Box m 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 m 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 m 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
72. s 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 STK Viewer Use the STK Viewer to examine the amount of stack Stk Viewer File Edit Action Help Sl Normal Functions We sgeti sgeb device c 3 bytes E E start nert0 a30 45 bytes Function Name main E B realloc frealloc malloc c 79 bytes init dev finit dev device c 5 bytes La File JSRCAMain c EAE fune func SRCAJmodel c 233 Eta fail SRCAfmodel c 23 Erik ready read ISRCAMOC Type Normal isOKLisOk ISRCOAMM B printti printi printf e gt l H fpute Sfpute foute c Size 236 Bytes E e printo print print E a Works Works I RCAM 01 a SOK isk LISRCA mode E erorFunc errork une SRA E a stop ston fGRGAfma alno E ab down down SACA mai Ni Function Mame Label Source File Line sn printo H nrint e Unknown Recursive Indirect Fig 2 9 STK Viewer Editor Any editor available on the market and you are accustomed to may be used after registering 1t 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 J The STK Viewer is included in the package as a J aval M application For this reason J ava M2 Runtime Environment J REM is used JRE is inst
73. s specified Link library mr3081m lib and c308mrlm lib are specified lt Example gt system message_size 32 y 2 When 16 was specified in the message size or designation was omitted Compilation option Dfar msg 1 isn t specified Link library mr308 lib and c308mr lib are specified lt Exapmle gt system nessage size 16 y 3 When you put the source file of C besides Working Directory Compilation option L 4 When you put the assembler source file besides Working Directory Assembly option bo el 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 MI6C 60 20 series 1 When 32 was specified in the message size Compilation option Dfar msg 1 is specified Link library gt mr30lm lib and c30mrlm lib are specified Expamle system message size 32 y 13 2 When 16 was specified in the message size or designation was omitted Compilation option Dfar msg 1 isn t specified Link library mr30 lib and c30mr lib are specified lt Example gt system meesa s dias 16 y 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 gt el 5 When you specify the output destination o
74. ss PG Joe Renesas System Design joetdrenezas com Fig 4 20 Member View 62 4 2 2 7 Document View The document view shows information about the documents Shown below is an outline diagram of the document view Location Fig 4 21 Document View 63 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 1s a wizard type dialog box From this dialog box set the necessary entries sequentially New Project Step 1 sample CA MUREN ample Fig 4 22 New Project Step 1 e From Target chip choose the target MCU for which you are creating a project e 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 e 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 e 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 Oo Here choose the type of project O When you finished selecting the type of project click the Next N butto
75. t For the Inspector this position is searched 21 Those included with the compiler package Compiler and Assembler TM V 3 20A currently supports the following compilers available from Renesas6 Oo NC30WA V4 00 Release I or later NC308WA V3 00 Release I or later NC79WA V4 00 Release I or later CC32R V 3 00 Releasel or later NC77WA V 5 20 Release4 or later e SRA74 V 4 10 Releasel 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 Sample x30 Map iewer JO File F view DOption O Help H S als a 2 ddress size Section Address size Section Label GHAGAABCOGAHLUAAH gt gt BHABHA 060400 60048081 000601 6 6004881 00001 6 G 508406 pool 00041 8 000048 6 0004688 ment 000458 866666 6064538 8663668 00041 A 000048 G 6004146 iob 600053 BOF 228 G G8044c mbase 01000081 fe ABBA G 000456 mnext BFAAAACA AGTO G 060454 msize BF B81 8 000965 BF A915 BBBTID 000458 GOOG BA BF Bal At HOF 2 dB BAGa58 8663668 BFFAB BBB BCO 600053 BOF 248 Bf fdc BBB 1c 01000081 de ABBA Brffdc BBBB24 BF GB HHAH H DFFFFF BF B61 A 8689 BS G 6f6016 main G 0f0034 tabint 6 or gone indicat k Ready Num PLO Fig 2 8 Map Viewer 6 When you are using other Renesas compiler products or some version of compiler
76. t Example gt system message size 16 interrupt_model STANDARD y 4 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 isn t specified and fMJI is specified Link library mr79smi lib and c79mrsmi lib are specified lt Example gt system TER 16 interrupt model SHORT y 5 When a time out function is used Compilation option Dtimeout 1 is specified lt Example gt system timeout YES y 6 When a time out function isn t used Compilation option Dtimeout 1 isn t specified lt Example gt system Limecut NO y 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 L 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 mr77lm lib and c77mrlm lib are specified lt Expamle gt system message size 24 interrupt model STANDARD 15 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 gt mr77lmi lib and c77mrlm lib are specified lt Example gt system mossa o eir 24 interrupt model SHORT y 4
77. t 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 1s displayed by one of the following operations Oo Saving from the menu bar Choose File Save from the menu bar e Saving from a right click submenu Right click the error or warning line to open submenu and choose Save from that submenu o 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 O Printing from the menu bar Choose File Print from the menu bar O Printing from a right click submenu Right click the error or warning line to open submenu and choose Print from that submenu O Printing from the toolbar Click the Print button on the toolbar 4 3 3 8 To Clear the Window e Clearing from the menu bar Choose Edit Clear from the menu bar Oo Clearing from a right click submenu Right click on the window to open a submenu and choose Clear from that submenu O Clearing from the toolbar Click the Clear button on the toolbar 81 4 3 3 9 To Search for an Error or Warning When an error or warning occurs it can be searched for in the upwar
78. t 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 Set Environment Action Preview Tab size E Display color Keywords MA BLUE E Comments DARKGREEN 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 MEMO 90 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 LENESAS Renesas Technology Corp 2 6 2 Ote machi Chiyoda ku Tokyo 100 0004 Japan
79. 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 ncrt0 r30 main r30 ModelA cmd ModelA tmk nert0 r30 ncrt0 a30 sect30 inc 31 Now well try adding a file to the project Choose the final object and then Add file from the right click menu DPN BK siten op IE i GE Sam Delete Add File ED AnctD Macro Browser Command i jen Anct Option Browser pen hen Secde Property 8 clean Partial Build Fig 3 12 Adding a File Choose the file to add MO Sica El Al ex File name main c Files of type nc30 al Cancel 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 5 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 16 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 d
80. 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 amp 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 Customize x Setting Button Inspector Fig 3 31 Auto Read from Clipboard Check Box If the string storage box does not contain any string 1 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 fs Inspector lt Sample C Sample Sample x30 gt File Edit View Acton Help L Function de at Function ret ga Variable del hy Variahla ref Narn dawn LI start CMS ampletnert0 a30 0 SAME Ernan 0SampleiSRCAMMmain c 38 E O 68 talint C Sample SACASmain c 58 O indicate CAS ampleNSRCAMmain c 60 E dp init CASamplekinit c 0 J TAC armmla lanse nl ni void far main p Hz pda HxFF udf Ax I tamer 8x68 ta Bxffff talar AAT 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
81. 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 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 gt Programs gt RENESAS TOOL gt TM V 3 xx gt TM from the Start menu When the TM starts up the Project Bar appears Pro ma Ds al Er E II Molde 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 Proj Soj 215 mse vade AlE ale Fig 3 2 Project Bar Pasted at The Top Next register the editor you normally use Press the gt button dialog box for registering an editor appears Tools Information x DEBUG TOOL EDIT TOOL APPLICATION Add LI POSOSIM 4 C AMTOOLSPD3051IMSPD 3051M EXE Tole kadi Fig 3 3 Dialog Box for Registering an Editor 26 Choose EDIT TOOL In the example below the Peggy editor from Anchor Systems is registered
82. ws 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 Mam Memory Sufficient memory size in which OS operates normally 16 Mbytes or more Free disk capacity 20 Mbytes or more CRT 1024 x 768 or higher is recommended 1 2 Installation Method 1 2 1 Executing the Installer To install the TM execute the installer included with it Oo Follow the messages displayed on the screen by the installer as you install the TM e The following lists the installer programs included with the package Language Installer name Japanese TM W9S5J SETUP English YIMWOSESETUP 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 i

Renesas TM V.3.20A User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents