Renesas TM V.3.20A, User Manual

Page 1: ...TM V 3 20A Integrated Development Environment User s Manual Rev 1 00 May 01 2003 REJ10J0018 0100Z...

Page 2: ...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 an...

Page 3: ...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 M16C 80 M32C 80 series 13 1 3 8 2 In t...

Page 4: ...4 Generation Procedure View 62 4 2 2 5 Item Information View 62 4 2 2 6 Member View 62 4 2 2 7 Document View 63 4 2 3 Method of Operation 64 4 2 3 1 Creating a New Project 64 4 2 3 2 Opening a Projec...

Page 5: ...mation 82 4 3 3 12 83 4 3 3 12 To Change Operation Environment 83 4 4 Inspector 84 4 4 1 Overview 84 4 4 2 Inspector Window 84 4 4 3 Starting the Inspector 84 4 4 3 1 To Show Information List 85 4 4 3...

Page 6: ...Selecting a Source File 32 Fig 3 14 View after Registering Source Files 33 Fig 3 15 Option Browser Start Button 33 Fig 3 16 Option Browser 33 Fig 3 17 Option Setup Dialog Box 34 Fig 3 18 Creating a N...

Page 7: ...2 64 Fig 4 24 New Project Step Compiler 65 Fig 4 25 New Project Step OS 66 Fig 4 26 New Project Step Finish 67 Fig 4 27 Opening a Project 67 Fig 4 28 Saving the Project File 68 Fig 4 29 Outputting a M...

Page 8: ...tup Buttons 84 Fig 4 52 Specify Detail Conditions Dialog Box 85 Fig 4 53 Rearrange Entries 87 Fig 4 54 Update button 88 Fig 4 55 Environment Setup Dialog Box Action Tab 89 Fig 4 56 Environment Setup D...

Page 9: ...that the TM does not run on Windows 3 1 Windows NT 3 51 or earlier and EWS If your host computer or OS is not one of the above please contact the manufacturer of your computer or OS to confirm whether...

Page 10: ...nstall 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 com...

Page 11: ...ector subprogram ProjectBarPs dll Project bar subprogram ProjectEditorPs dll Project editor subprogram ServerPs dll Communication server subprogram BuildErr dll Builder subprogram Ie_Inspect dll Inspe...

Page 12: ...ether 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...

Page 13: ...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...

Page 14: ...ssembly option DC_inc 0 2 When you put the source file of C besides Working Directory Compilation option I 3 When you put the assembler source file besides Working Directory Assembly option I When com...

Page 15: ...ed Link library mr79smi lib and c79mrsmi lib are specified Example system message_size 16 interrupt_model SHORT 5 When a time out function is used Compilation option Dtimeout 1 is specified Example sy...

Page 16: ...ion Dfar_msg 1 isn t specified Link library mr77sm lib and c77mrsm lib are specified Example system message_size 16 interrupt_model STANDARD 5 When 16 was specified in the message size and or designat...

Page 17: ...ollowing three primary functions z Manages the software development process using the concept of a project z Provides a seamless environment as a common GUI for various tools z Based on static program...

Page 18: ...actually consists of the following two types of files z Project name TMK file z Project name TMI file The TMK file is prepared in the makefile format corresponding to the make command that is used st...

Page 19: ...Generate Read Read Read 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 to...

Page 20: ...dled by the GNU Make command 4 Fig 2 5 Project Editor Builder The Builder invokes the GNU Make command to build a project based on the makefile TMK file created by the Project Editor Fig 2 6 Builder 4...

Page 21: ...patible with the Make command available in the UNIXTM operating system It can be freely distributed according to GPL GNU Public License The GNU Make command manages build operation based on the file d...

Page 22: ...Release4 or later z SRA74 V 4 10 Release1 or later For the Inspector function to be used add the finfo option before compiling assembling the source files Map Viewer The Map Viewer allows you to exam...

Page 23: ...egistering it to the TM Debugger In addition to the PDxx series debuggers available from Renesas any third party debugger may be used after registering it to the TM 7 The STK Viewer is included in the...

Page 24: ...h 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 i...

Page 25: ...e 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 P...

Page 26: ...ct Bar appears Fig 3 1 Project Bar in Floating State When started for the first time the Project Bar is in a floating state Grasp this window and bring it to the top of the screen and you can have it...

Page 27: ...are accustomed to is we think the most efficient The TM allows any editor available on the market to be registered for use in it 11 10 The Peggy editor has its trial use version included in the Compi...

Page 28: ...we explain the method for creating a new project Creating a new project Press the New Project button on the Project Bar Fig 3 5 New Project Button A wizard to create a new project appears Fig 3 6 New...

Page 29: ...29 Choose the target chip and set a project name and the working directory Fig 3 7 New Project Wizard Step 2 Next choose the type of project Fig 3 8 New Project Wizard Step Compiler...

Page 30: ...oject information the Project Editor window appears Fig 3 10 Project Editor Immediately After Project Creation The Project Editor works internally as an editor for the makefiles handled by the GNU mak...

Page 31: ...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 ncrt0 r30 Post assemble objec...

Page 32: ...30 15 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 relocat...

Page 33: ...final object absolute object The file may be registered for other items In such a case consider the relationship between target and dependencies in the makefile of the GNU make command as you work on...

Page 34: ...and press the Mod button and the dialog box shown below appears Fig 3 17 Option Setup Dialog Box Use this dialog box to choose the options you want to choose Choose the type of option from Category a...

Page 35: ...ach file Choose the file for which to apply the macro Choose the file for which to apply the macro Fig 3 18 Creating a New Macro Registering development members To register the members participating i...

Page 36: ...t members and documents the registered information can be displayed on a project view as shown below Also you can send a mail to a member or open a document by double clicking on it Fig 3 22 Displayin...

Page 37: ...uild Button This invokes the Builder and the Builder starts building the project If you attempted to build a project without saving it the Project Editor prompts you to save Fig 3 25 Dialog Box for Co...

Page 38: ...etup button Fig 3 27 Buttons for Using the Inspector The Inspector performs functional analysis on the string which is entered in the String box by Copy Paste For example when you want to find locatio...

Page 39: ...ce of a memo The basic method to use the Inspector is by Copy Paste However if you enable the function to capture a copied string into the string storage box when you copy you can omit Paste To enable...

Page 40: ...r button and a dialog box like the one shown below appears Fig 3 33 Registering the Debugger Choose the Debugger to use from this dialog box by checking it When you are using the PD Debugger available...

Page 41: ...d invocation of each tool To start the TM start the Project Bar To exit the TM close the Project Bar The Project Bar has the following functions z Start the Project Editor z Start register a debugger...

Page 42: ...ionsorvariablesaredisplayed IfAutoReadfrom ClipboardisenabledusingtheInspectortaboftheCustomizedialogbox the stringcopiedtotheclipboardisautomaticallydisplayedhere FunctionDefinition DisplayButton Sho...

Page 43: ...ersaneditor RegisterApplication P Registersanapplication ExecuteUtility U StartstheutilityincludedwithRenesascompilers TheExecuteUtilitydialogboxopenswhenyouselecta sub menu Pleaseinputaparameterofthe...

Page 44: ...debugger DEBUG TOOL z To register an editor EDIT TOOL tab z To register an application APPLICATION DEBUG TOOL tab Use the DEBUG TOOL tab to register a debugger and select the debugger that starts up...

Page 45: ...ncel button Closes the Tools Information dialog box without reflecting the contents you changed EDITOR TOOL tab Use the EDIT TOOL tab to register an editor and select the editor to use in the TM Fig 4...

Page 46: ...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 app...

Page 47: ...z To change buttons Button tab z For Inspector related settings Inspector tab Setting tab Use the Setting tab to set the behavior of the Project Bar Fig 4 6 Setting tab z Always on Top Shows the Proj...

Page 48: ...a button and the button is displayed Uncheck a button and the button goes out Upper button Moves the selected button on the list view one place forward Lower button Moves the selected button on the li...

Page 49: ...e Inspector tab to set Inspector related settings Fig 4 8 Inspector tab Auto Read from Clipboard Selects whether or not to automatically copy a copied string from the clipboard into the Inspector s se...

Page 50: ...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 C...

Page 51: ...ry dialog box Etc Version Use this text box to set version or other desired information Parameter The TM has the function to show a specified line of the file you specify when starting the editor Befo...

Page 52: ...ect 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 butto...

Page 53: ...x 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 targ...

Page 54: ...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...

Page 55: ...directory Working Directory The project s working directory is made the current directory Other Specify a directory that you want to be the current directory This directory can also be specified by c...

Page 56: ...g Box Name essential Enter an environment variable name Value Specify the value of the environment variable OK button Click the OK button and the contents you changed are reflected before closing the...

Page 57: ...ecify the options for the utility You can also use the Browse button to select the desired file path Detail For the automatically TM recognized tools the Detail button is available When you click on t...

Page 58: ...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...

Page 59: ...position 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 a...

Page 60: ...isplay related commands among the Project Editor functions Menu Menucommand Function Toolbar T Showsorhidesthetoolbar View V StatusBar S Showsorhidesthestatusbar Project menu The Project menu has assi...

Page 61: ...OpenProject Opensanexistingproject Save Savestheprojectbeingworkedontothecurrentfile byoverwriting AddItem Addsanitemtothegenerationprocedure AddFile Addsafiletothegenerationprocedure Command Editsthe...

Page 62: ...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 th...

Page 63: ...63 4 2 2 7 Document View The document view shows information about the documents Shown below is an outline diagram of the document view Fig 4 21 Document View...

Page 64: ...name enter the name of the new project you are creating The name entered here constitutes the final target program name and project file names z For Working directory specify the directory in which to...

Page 65: ...displayed in the Compiler package text box z 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...

Page 66: ...e 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 b...

Page 67: ...played From this dialog box choose the project file you want Fig 4 27 Opening a Project z Choose a project file any file name with the extension tmk z Click the Open button and the project of the sele...

Page 68: ...ormation 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 b...

Page 69: ...e 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 Whe...

Page 70: ...12 Command Edit a generation procedure command When you choose this menu command a Command dialog box is displayed Fig 4 33 Command Dialog Box z This dialog box shows command information for the item...

Page 71: ...ds 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 sp...

Page 72: ...layed Fig 4 36 Item Properties z Properties are displayed only when an existing file is specified z If necessary edit Attributes 4 2 3 15 Partial Build Build an item selected on the generation procedu...

Page 73: ...d Macro dialog box is displayed The new macro is added below the last line of existing macros Move it up or down using the arrow keys Up or Down as necessary z To edit an existing macro choose the mac...

Page 74: ...An Option dialog box is displayed Option names are automatically assigned When you specify an option for each file add the option first Then from Selected files choose the file to which you want to a...

Page 75: ...formation Add member information to the project When you choose this menu command an Add Member dialog box is displayed Fig 4 41 Adding Member Information z For Name specify the name of the informatio...

Page 76: ...pecify 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...

Page 77: ...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 genera...

Page 78: ...n information of the Project Editor When you choose this menu command a Project Editor Version Information dialog box is displayed Fig 4 45 Showing Project Editor Version z This dialog box allows you...

Page 79: ...verview 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 F...

Page 80: ...menu bar Choose Action Reexecute Build from the menu bar z 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 war...

Page 81: ...e to open a submenu and choose Save from that submenu z 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 clipboa...

Page 82: ...arch Downward or Edit Search for Error Warning Search Upward or Search Downward from the menu bar z Searching from a right click submenu Right click on the window to open a submenu and choose Search e...

Page 83: ...etting Tab z Restore window condition The window position is restored next time the Builder starts up z Restore font The display font is restored next time the Builder starts up z Search mode When sea...

Page 84: ...ine number are outputted by each information and it is possible that it opens with text editor 4 4 2 Inspector Window Menu bar Toolbar List window Preview window Fig 4 50 Inspector Window 4 4 3 Starti...

Page 85: ...pecify 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 ta...

Page 86: ...ile 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 sc...

Page 87: ...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 displa...

Page 88: ...bar Choose Edit Search from the menu bar z Searching from a right click submenu Right click on the entry to open a submenu and choose Search from that submenu z Searching from the toolbar Click the S...

Page 89: ...he 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 func...

Page 90: ...90 MEMO...

Page 91: ...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...

Page 92: ......