Home

FR FAMILY SOFTUNE WORKBENCH OPERATION MANUAL

1. 355 Watch Window Watch 82 166 Window Edit window sse 59 Main Window cesses 36 Project 40 Window 151 Window display Control related to window display 331 Window display debug session 151 420 Window name Window name display 331 Window view Window view nonview 151 Workbench Debugger control when SOFTUNE Workbench is in the debug session 258 How to Register Workbench Menu 353 Migrating SOFTUNE Workbench to debug SESSION eet 29 Setting the SOFTUNE Workbench execution environment ssssssseeeees 289 Setting SOFTUNE Workbench operating conditions MATE 4 SOFTUNE Workbench configuration 3 Starting SOFTUNE Workbench 15 Terminating SOFTUNE Workbench 15 Version information display when SOFTUNE Workbench is in the debug session Version information display when SOFTUNE Workbench is not in the debug session PE 341 When SOFTUNE Workbench is in the debug SESSION c 122 Workspace Creating Blank Workspace 17 Creating Workspace in Creating New Project
2. 370 Error Messages 355 Example of error jump setup 329 Next OO iicet feiert eee rite 139 Previous 139 TOP OLOMON tet tete es 139 Error jump Error jump function eeeeeeeeeee 123 Error jump setup procedure 328 Example of error jump setup 329 Event Event List ncn arare dte 275 Setting events sssssssssseeee 272 Execution environment Setting the SOFTUNE Workbench execution environment eese 289 Existence check Setting method when debug information existence check for library file module inhibited 231 Existing Project Creating Project Configuration on Settings of Existing Project Configuration 22 Defining Subproject between Existing Projects 21 Existing workspace file Opening the existing workspace file 115 Export EXpOIT 248 External I F Simulator external I F specification 388 Outline of External I F DLL 387 F File accessing Functions related to project and file accessing MCN EMEN NR 109 File editing File editing function 123 File name File name specification
3. 194 Creating a 30 Creating Project Configuration on Settings of Existing Project Configuration 22 Creating Workspace in Creating New Project 16 Creating Workspace in Opening Project 16 Creation of New 111 Creation of Project Configuration 22 Defining Subproject between Existing Projects EAE E E E EEE E E E E A heavens 21 Deleting Project Stored in Workspace 19 Deleting Specific Project Configuration from Project ces 23 Deleting Subproject from 21 Designing a 4 Functions related to project and file accessing 109 Making or Building of 28 Making or Building Specified Project 28 Procedure for defining Project dependence 251 Project Configuration 252 Project Configuration Add and Delete 253 Project Configuration Configuration at Build EUER 255 Project Dependencies 251 Project 152 Project related item setup 189 Registering the created file in the project 20 Select the
4. 71 CHAPTER 3 WINDOWS E Shortcut Menu 72 There are seven menus below Jump Opens the source window of the specified function e Watch Sets specified symbol as watch point Break See Section 4 6 4 Break Point Property Displays symbol properties Mangled name Specify whether to display a symbol name as a mangled name Refresh The latest symbol information is displayed Close Closes symbol window Jump Click the right button of the mouse on the function name to display the shortcut menu then select Jump from the menu The source window in which the function is defined opens Watch Click the right button of the mouse on the variable or function name to display the shortcut menu then select Watch from the menu The variable or function is added to the watch and the watch window is displayed Property Click the right button of the mouse to display the shortcut menu then select Property from the menu File information is displayed see Section 4 3 9 Property Mangled name Click the right button of the mouse to open the shortcut menu and select Mangled name Switch between display and nondisplay of a symbol name as a mangled name Refresh Click the right button of the mouse to open the shortcut menu and select Refresh The latest symbol information is displayed CHAPTER 3 WINDOWS 3 9 Disassemble Window This window is displayed
5. 246 Debug environment setup procedure 299 Deleting debugger setup 246 Display setup iere biet 164 Error jump setup procedure 328 Example of error jump setup 329 Example of tool setup 322 Keyboard setup procedure 323 Memory map setup Note The memory map setup dialog box is displayed only at simulator debugger 319 Setting Options in Setup 245 Tool setup 321 Trace setup errat entere 16 Setup name Shortcut menu Click the right button of the mouse on setup name 51 Setup Project Select the Project Setup Project Menu 24 Setup Wizard Setup Wizard an A E a A 30 Setup Wizard operation procedure 317 Shortcut Menu Shortcut Menu 56 60 68 72 74 76 80 81 83 84 94 96 99 Shortcut menus Click the right button of the mouse on a Debug category 48 Shortcut menus Click the right button of the mouse on a Dependencies 47 418 Shortcut menus Click the right button of the mouse on a file in the Dependencies Categoly eese tees 51 Shortcut menus Click the right button of the mou
6. 6 14 Find FING ius citet neret Joder abe fue 127 Flag bar Flag nd teen ets 38 Flag name Register name flag 11 Flash Memory Flash Memory Menu 359 Floating point number Floating point number 8 Folder Shortcut menus Click the right button of the mouse on a folder 46 Font Changing fonts 180 INDEX Font related 151 Resetting 180 Setting 180 Format Setting absolute format assemble list options n 230 Formula Address formula sss 6 Data formula iio reete dene 6 Operators Usable in Data and Address Formulas EA E E E detain eit 12 Full addressing Full addressing 13 Function name Shortcut menus Click the right button of the mouse on a function name 55 G General Setting General Options 210 220 Setting General options 227 Setting Options in General 244 239 H Horizon ese se ee ihe rk 332 Host system Communication with host system 381 I F Outline of External I F DLL
7. 227 Specifying disposition connection 233 Disposition Connection When initializing Disposition Connection option based on MCU information 238 DLL Outline of External I F DLL 387 Document files Creating source file and document files etc 111 DSU Trace Detail 0503 176 E Edit M M 164 Edit window 59 130 Editing File editing 123 Editor Editor change procedure 326 Editor deletion procedure 326 Editor registration procedure 326 Registering an editor 325 Setting the editor to be used 326 Setting the standard editor 63 Emulator Procedure when the emulator debugger is selected 317 Environment Debug environment setup procedure 299 Setting the debugger mode environment EET 289 Setting the SOFTUNE Workbench execution environment ssesssseeeee 289 Environment variable Environment 290 Error Bottom of error seen 139 Error jump setup procedure 328 Error
8. 56 152 416 Use Output window 249 Output listing Setting the Output listing 240 P Paste PASS ee ie Eh tete ds 125 PC side Setting LAN interface at PC side 377 Performance Display Performance Display Setup 187 Performance Interval Performance Interval 185 Performance Mode Performance Mode 184 Performance Window Performance Window 95 184 Port Resetting an input 295 Resetting an output 297 Setting an input 294 Setting an output 296 Program Automatic downloading of monitor program erret ed e een eT heated at 29 Display error at loading monitor program to emulator entere 386 Explanation of Sample Program 383 Loading the target program 29 Program suspension ABORT switch 381 Program source Creating a program source and executing make build esses 4 Project Active Project eee eee 190 ss ee Irene 191 Add Project 192 Add Project Existing
9. pete 82 Trace WITOOWzz iini RR a DUREE ecd tute val ce 84 3 15 Command Window tr p et bee 85 3 15 1 Setting Character String Replacement ssesssssssssssssseeeeeneeen eee nnns 88 Em oM RE 92 3 16 Realtime Memory Window 93 3 17 Performance Window nennen nennen nnns 95 3 18 RAM Checker WindOW 5 itin iie hi eden Lan aee 97 3 18 1 RAM Checker setting 99 3 18 2 Startup of the RAM Checker Viewer sssssssssssesesee eene eene trennen sineret 103 CHAPTER 4 MENUS iiie Y vaa Ru pa 105 4 1 Menu Configuration Tree eene eene nennt nennen nnns rennes ensis intrent senis essent 106 4 2 miS uM 109 4 2 1 NACE 110 4 2 2 Opern iiie no ne om han Lun sube rent fedet eec 112 4 2 3 sdb bt t 114 4 2 4 Open Workspace MEAE etae te sur rt beet e eaaet eee E 115 4 2 5 Close WOfFKSDaCe s os eee ter tette merde Eee cage eric eroe denn Laur teaver cie Presse 116 4 2 6 SEV PEE 117 4
10. D 4 struct D 5 struct D 6 struct D 7 struct D 8 struct Each element of the array variable is displayed RR State of monitoring is displayed blue on red off 82 B Shortcut Menu There are twelve menus below Radix Set Element Edit Delete All Delete Inaccessible area Monitoring Individual setting Memory window Property Close Memory window CHAPTER 3 WINDOWS See Section 4 4 7 Watch See Section 4 4 7 Watch Specify range of displayed array element See Section 4 4 7 Watch See Section 4 4 7 Watch Deletes all variables being stored from the window Call up the Inaccessible area tab in the Debug environment of the Setup menu Switches whether to enable or disable monitoring The each variable which is registered user sets ON or OFF of monitoring User distinguishes between ON and OFF by a color of square ICON A blue means on a red means off Display the memory window and setup bookmark Displays watch properties Closes watch window When selected the following two submenus are opened Jump To display memory window by using selected address of variable Add bookmark By using selected variable address bookmark will be added to memory window Property 1 Click the right button of the mo
11. 16 Creating Workspace in Opening Project 16 Creation of New Workspace 110 Creation of 16 Deleting Project Stored in Workspace 19 Opening the existing workspace file 115 Recent Workspace File 121 Setting of Workspace 30 Setup Workspace 198 Shortcut menus Click the right button of the mouse on a workspace name 43 Storing Existing Projects in Workspace 19 Storing New Project in Currently Opened Workspace 18 When the currently open workspace file is not edited at 116 When the workspace is opened 122 Workspace er 291 CM71 00328 3E FUJITSU SEMICONDUCTOR CONTROLLER MANUAL FR FAMILY SOFTUNE M WORKBENCH OPERATION MANUAL for V6 July 2006 the third edition Published FUJITSU LIMITED Electronic Devices Edited Business Promotion Dept
12. 345 Registering in Customize Bar 348 What is Customize Bar 345 Customize Build function Customize Build function 247 Cut E ails ee tit oum pe 125 D Data Operators Usable in Data and Address Formulas M A 12 Data breakpoint Data 265 Details of data breakpoint for MB2198 271 Setting of data breakpoint 265 Data formula Data formula 6 Debug Debug start and termination 258 Debugger control when SOFTUNE Workbench is in the debug session 258 Details of code breakpoint Debug type Hardware count 269 Details of code breakpoint Debug type Hardware datawatch 270 Migrating SOFTUNE Workbench to debug SOSSION pe itia en i oe eed 29 Selection procedure of the debug function debug mode 316 Setting debug 244 Setting method when debug information existence check for library file module inhibited itm ded 231 Shortcut menus Click the right button of the mouse on a Debug category 48 Version information display when SOFTUNE Workbench is in
13. 409 viii CHAPTER 1 OUTLINE OF SOFTUNE WORKBENCH SOFTUNE Workbench integrates language tools and debuggers into one to provide the integrated development environment that totally supports processing from programming and debugging to creation of data to be written to ROM Language tools include a C C compiler assembler and linkage kit etc Debuggers are a simulator debugger emulator debugger and monitor debugger 1 1 Outline 1 2 What is SOFTUNE Workbench 1 3 Procedure for Developing Programs with SOFTUNE Workbench CHAPTER 1 OUTLINE OF SOFTUNE WORKBENCH 1 1 Outline This section gives an outline of the development tools integrated by SOFTUNE Workbench E Language tools In the past language tools e g C C compiler assembler and linkage kit were started and used from command lines However SOFTUNE Workbench can use these tools as they area An option setting dialog box for each tool opens thereby enabling the easy use of the tools E Debuggers SOFTUNE Workbench has integrated the simulator debugger emulator debugger and monitor debugger into one The optimum debugger can be selected and used as required BB Others Installing an REALOS configurator option enables cooperative operation without complicated setting CHAPTER 1 OUTLINE OF SOFTUNE WORKBENCH 1 2 What is SOFTUNE Workbench This section explains the basic configuration of SOFTUNE Workbench i SOFTUNE Workbench configu
14. 4 Starting debugging 31 288 Default library Setting when the default library is not used PEE 231 Delete Delete siete nv 125 To delete files stored in the project 20 Dependencies Shortcut menus Click the right button of the mouse on a Dependencies 47 Dialog Box Items in Dialog Box 348 Memory map setup Note The memory map setup dialog box is displayed only at simulator debugger 319 New creation dialog 110 Open dialog 112 Save dialog 117 Setting of MCU change dialog box 208 Directory Executing Directory 249 Storing Created File with Directory in Project EET 20 Disassemble Window Disassemble 73 Display Display non display the window switching using the aD 151 Display color Customization procedure display color selection ere cern 64 Display error Display error at loading monitor program to 386 Display error at emulator debugger 386 Display function Customization procedure display function selection 64 Disposition Setting disposition connection
15. SEJE 0008040 read write sample c 72 Break address In this field the address that sets a breakpoint is specified 265 CHAPTER 4 MENUS Remain In this field the remaining count of settable breakpoint types currently being selected is displayed Pass count In this field the count of times access with the specified attribute is to be made to that point a particular point before causing a break is set This field is only enabled for the simulator debugger Attribute In this field read access write access or both is specified Breakpoint list A list of data breakpoints currently being set is displayed Status Enable or disable is displayed Address The set address is displayed Attribute The attribute of the breakpoint is displayed Pass count The set pass count is displayed In the count of times the PC has passed that point by the present time is displayed Symbol The symbol given to that address is displayed Jump button Displays data at the breakpoint selected from the break list in the memory window Set button These buttons are used to set a breakpoint at the specified address When an address that is already set in the breakpoint list is specified the set data of the breakpoint at this address is changed Detail button This button is used to set the details of a breakpoint at the specified address For details see Section 4 6 4 1 Breakpoint det
16. E Creating source file and document files etc To create a source file and document file etc select Text File from the new creation dialog box The editor is started in the status in which a new file is created 111 CHAPTER 4 MENUS 4 2 2 Open Open opens existing files Selecting Open from the file menu opens the open dialog box asking the file you want to open Figure 4 2 4 il Open dialog box Selecting Open from the file menu opens the open dialog box The open dialog box displays a workspace file project file load module file source file binary file alias file batch file and text file If SOFTUNE Workbench is not in the debug session the binary file alias file and batch file are not displayed Figure 4 2 4 Open Dialog Box ideis Cancel E Opening the load module file 112 When the project file is already opened and SOFTUNE Workbench is already in the debug session The file dialog box for selecting the name of the load module to be debugged opens To load debug information only set a check box for Only debug Information To set a memory map automatically during simulator debugger set a check box for Auto mapping If this check box is not set set the memory map before opening the load module file When ondemand loading place a check mark in the Ondemand Load check box When the project file is already opened but SOFTUNE Workbench is not in the debug s
17. 106 Message Error Message eese 370 Error 355 Warning Message 355 Mode Performance Mode 184 Selection procedure of the debug function debug 316 Setting the debugger mode environment 289 Monitor Procedure when the monitor debugger is 318 When monitor debugger cannot be controlled 385 Monitor program Automatic downloading of monitor program m 29 Display error at loading monitor program 386 Monitoring Monitoring 99 INDEX N Non display Display non display the window switching using tlietab iei 151 Nonview Window view nonview eene 151 Object Shortcut menus Click the right button of the mouse on library file object file and relative format file 50 Online help Online help 338 Operating conditions Setting SOFTUNE Workbench operating conditions c iio rt 4 Optimization Setting of Options Included in Detail Definition in 215 Optimize Setting Optimize options 214 Option Automati
18. An address 15 displaved A machine code is A mnemonic is An operand is displayed displayed displayed 73 CHAPTER 3 WINDOWS B Shortcut Menu There are ten menus below Inline Assemble See Section 4 4 3 Assembly Jump Displays jump dialog box Goto Current Displays current PC location e Breakpoint Set Reset This function is to set or to cancel the breakpoint pointed by cursor e Breakpoint Enable Disable To make breakpoint in the instruction pointed by cursor enable or disable e Break See Section 4 6 4 Break Point e Watch See Section 4 4 7 Watch Stack See Section 4 6 7 Stack Activate when stop Specify whether the window should set to active or not when the program is stopped Close Closes disassemble window Jump Specifies the position to display in the disassemble window Perform this operation in the following procedure 1 Click the right button of the mouse in the disassemble window to display the shortcut menu then select Jump from the menu The jump diolog box opens See Section 4 3 6 2 Select a specification format 3 Specify a cursor display position 4 Click the OK button Breakpoint Set Reset After moving cursor to the instruction where you want to set or to cancel a breakpoint click the right button to see shortcut menu Then please select Breakpoint Set Reset Breakpoint Enable Disable After moving cursor to the
19. ssssssseeeeneeen enne 32 2 14 Moving Project File cte e een cele ap aee eee E ete ce ee eps 34 CHAPTER 3 gt WINDOWS 1 cere riti pin deinde noo 35 3 1 Window Configuration 1 2 2 eroi eei a RR T aia 36 3 2 Nr 37 3 3 SICWIENICIRR MED 39 3 4 Project WINGO Wai uim dioi eer PERI in tre ee 40 3 4 1 sud Lu x Lc D EL MS Kr Ee uet 41 39 4 2 ABS Tab uiuit urat it nant er Pctri E etr o Eel ase tate 53 3 5 Output itte e AED ste ierat abr tite iet 56 3 6 Edit Window Standard Editor 59 3 6 1 Setting Standard Editor eni dnd a cd sre de Erie dra e eva deg aa ata 63 3 7 Source WINDOW eee 67 3 8 Symbol Window x Mids de et edad trt tet ated 71 3 9 Disassemble WIndOW 4 pe fa ie tap o eei tao i ces 73 3 10 Register WIndOW e ete ei rere se eto SEL He Editer eset ue epoca eeu mee ee ae 75 3 10 1 Setting Register Display 77 3A Memory WIndOW niet ater aac tit heen tet edd Dee ti efe te ed rete eg 79 3 12 Local Variable Window nn sn nennen iter nlsi nnne nennen 81 3 19 Watch WIDndOW ita ettet Ee st e te tradi
20. The register edit dialog shown in Figure 4 4 3 opens Select a register name 3 Input the value to set Click the OK button Figure 4 4 3 Register Edit Dialog Box Register name RO Register value 00070007 Cancel Register name Specify a register name Register value Specify the value set in a register 157 CHAPTER 4 MENUS 4 4 5 Memory Memory displays the memory window E Displaying memory data When the memory window is opened memory data dump is displayed starting from the specified address Memory data can also be modified using the shortcut menu This function command can be used only when SOFTUNE Workbench is in the debug session When the memory window is already opened The memory window is activated When the memory window is not opened The dialog for specifying the display start address Figure 4 4 4 opens Figure 4 4 4 Dialog for Specifying Display Start Address Type Address Position 0001 40 0 Cancel Window Memory z Type Specify the type of display start position Line number Address Frame Position Display disassembling from the position specified in the above type Window To specify the window where jump is implemented For details see Section 4 3 6 Jump If it is a disassemble window default will be shown as Assembly E Changing memory data 158 Memory data can be changed by rewriting the displayed
21. To fill memory with data open the Fill tag then set the start address end address data type and filling data Start Address Specifies start address of memory area to be filled with data Data filling is started at this address End Address Specifies end address of memory area to be filled with data Data filling is continued to this address Type Specifies type of filled data Byte Halfword Word Doubleword Ascii Fill Data Specifies filling data to fill specified memory area Several filling data can be specified delimited by a comma 161 CHAPTER 4 MENUS Copy Figure 4 4 9 Memory Operation Dialog Copy Memory operation NM cen To copy data to memory open the Copy tag then set the copy source start address copy source end address and copy destination start address Start Address Specifies start address of copy source area Data copy is started at this address End Address Specifies end address of copy source area Data copy is continued to this address Target Address Specifies start address of copy destination area 162 CHAPTER 4 MENUS E Comparing memory blocks To compare memory blocks click the right button of the mouse in the memory window to display the menu then select Compare from the menu The comparison dialog shown in Figure 4 4 10 opens Start Address Specifies start address of comparison source area Memory block
22. 7 2 1 2 Data and Address Formulas Symbols Line Numbers Character Constants 9 2 1 3 Data and Address Formulas Register name Flag name 11 2 1 4 Operators Usable in Data and Address Formulas sse 12 2 1 5 Address Formula Specification enne 13 2 1 6 FileName Specificato ie edet aient eene 14 2 2 Starting and Terminating SOFTUNE Workbench 15 2 3 Creating Workspace ue aae deed Eve epe daga ra ee ege an enu peu de ele es eee 16 2 4 Storingiof Project xim ee Mm ERO SRL La ders 18 2 5 Creating and Registering Source File in Project sse 20 2 6 Definition of SubproJect z ire ie bet ere etre av eei dedi 21 2 7 Creation of Project Configuration sssssssssssseseseeeeee nennen enne nri trente nennen nnns 22 2 8 Setting 5 EE 24 2 9 Setting Linker Options iiber Rees 25 240 Make Bulld 5 apad dee ee ue eee 27 2 10 1 Making or Building of Project nennen 28 2 41 Debugging 29 242 Executing Debugging Only eite HE aet e up Po ea a EE rae ete 30 2 13 Reading SOFTUNE Project Files of Old Versions
23. Section Name DATA Set Address Contents Type Data z Section Name List Delete Bee Up o tees Cancel STACK Stack INIT Data IDPORT Data Down CHAPTER 4 MENUS E When a section is allocated to the specified ROM RAM area 1 7 Define the ROM RAM area See defining ROM RAM area Select the ROM RAM area you want to set from ROM RAM Area List Click the Set Section button The section setup dialog box shown in Figure 4 5 34 opens Specify the name of the section to be allocated to the selected area A wild card character can also be used Select and set a content type from the drop down list as required None Code Data Stack Const IO Click the Set button The set section is added to the end of Section Name List When all settings are completed click the OK button The order in which sections are allocated to the specified ROM RAM area is the same as the order in Section Name List For how to change this order see changing the section allocation order E When a section is allocated to the specified starting address 1 7 Click the Set Section button The section setup dialog box shown in Figure 4 5 34 opens Select Specify in Address from the drop down list for ROM RAM Area List Specify the name of the section to be allocated to the ROM RAM area A wild card can also be used Specify the starti
24. fiel it eiu ede REDE Nas 27 257 Subproject Changing Subproject Configuration at Making or BUANG eee er 28 Defining Subproject between Existing Projects ana bee sue DO 21 Definition of 21 Deleting Subproject from Project 21 Shortcut menu Click the right button of the mouse on a subproject name 46 Support information Support information 340 Symbol 9 153 Symbol definition Resetting symbol definition 228 Setting symbol definition 228 Symbol Window Symbol Window sees 71 Syntax Syntax deletion procedure 328 Syntax modification procedure 329 T Tab ABS tabis rero betta aet 53 ABS tab bitmap image list 53 Customization procedure tab size 64 Display non display the window switching using totes 151 SAO AD oe 41 SRC tab bitmap image list 42 179 Loading the target 287 Setting Target sess 248 Setup 200 Target ripe 124 126 127 Target ll
25. td eis 175 i atis E rit be tue 168 Trace Detail 0503 176 Trace setup 169 Trace Window Trace Window 84 U Update Update x ree Ee ees 168 USB driver Installation of USB 380 INDEX V Variable Canceling display of unnecessary variable dasa E E IRUR 167 Environment variable 290 Local Variable Window 81 165 Modifying a variable value 165 167 Variable ini nter etes 89 Vector Display and setting vectors 285 Atv eser hi ea ee eee eek 285 Version Version 338 Version information display when SOFTUNE Workbench is in the debug session TE 341 Version information display when SOFTUNE Workbench is not in the debug session MERE NM 341 Vertical Muere LM 332 Viewer Startup of the 103 Warning Method of outputting warning when ROM RAM area specified outside range of internal ROM RAM 237 Method of outputting warning when section placed outside specified ROM RAM area range iiiter tinent 237 Warning
26. 2 Set a focus in New Assign then specify the key to be assigned to the function from the keyboard press the key 3 Click the Set button E Displaying the current setup state list Click the Definition List button to display the key definition list E Restoring all the set keys to the initial state Click the Reset button Note Once the Set or Reset button is clicked the set or reset key cannot be canceled If the Set or Reset button is clicked by mistake set the key again For the keys that can be set see Table 4 7 2 Several keys can be assigned to one function In this case the assigned keys have the same function 323 CHAPTER 4 MENUS Figure 4 7 29 Key Setup Dialog Box Key Definition SHIFT CTRL FAZ SHIFT 324 CHAPTER 4 MENUS 4 7 6 Editor Editor enables any editor to be registered and used as the standard editor E Registering an editor Register the editor to be used instead of the standard editor built into SOFTUNE Workbench in advance Set the registered editor as the SOFTUNE Workbench editor before editing the file actually Of the registered editors the editor set in Available Editor is used to edit the file Figure 4 7 30 Editor Setup Dialog Box Setup Editor 325 CHAPTER 4 MENUS E Editor registration procedure 1 6 Select Editor from the Setup menu The editor setup dialog box shown in Figure 4 7 30 open
27. 387 Simulator external I F specification 388 Icon Icon 334 Identifier Id ntifiGE 3 dritte eere 6 Include Include Dependencies 256 Shortcut menus Click the right button of the mouse on an include file and other user s registration file 50 Include path Changing the include path retrieval order RIEN TE 213 223 Resetting an include path 213 223 Setting an include path 212 222 Inline assemble Inline 155 In line Expansion Canceling In line Expansion of Specified TUnclions 216 414 Setting In line Expansion of Specified functions ELE EE 215 Input port Resetting an input 295 Setting an input 294 Integer Integer x cedente erepta ee 7 Interrupt Resetting an 298 Setting an 298 J Jump Error jump function 123 JU p ecc testes CORE 286 Jump function 123 K Key Procedure for changing an assigned key guten sie tae uet dr 323 Procedure for deleting an assigned key 323 Restoring al
28. Read data count void data Data storage area Return value Count of data completely read If the return value is different from the read data count length an error occurs Explanation Reads data from memory The type of the data storage area data differs depending on the access size Byte 1 byte unsigned char Word 2 bytes unsigned short Long 4 bytes unsigned long Remarks In this access the reading of data is not posted 399 APPENDIX G 12 SSDI Write Memory Write to Memory Format int SSDI Write Memory unsigned long addr int size int length void data Argument unsigned long addr Access address int size Access size 1 Byte 2 Word 4 LONG int length Write data count void data Data storage area Return value Count of data completely written If the return value is different from the write data count length an error occurs Explanation Writes data to memory The type of the data storage area data differs depending on the access size Byte 1 byte unsigned char Word 2 bytes unsigned short Long 4 bytes unsigned long Remarks In this access the writing of data is not posted 400 APPENDIX G External I F DLL for Simulator G 13 SSDI Read Register Read from Register Format int SSDI Read Register int reg no unsigned long data Argument int reg no Register number unsigned long data Data storage area
29. Return value 0 Normal end 0 Error Explanation Reads data from registers Remarks The register number is defined in the include file SSDI_REGISTER H SSDI_REGISTER H is installed X NY Y Y LIB 91 INSSDI folder XNYYY Itis the drive amp folder which it installed SOFTUNE in 401 APPENDIX G 14 SSDI Write Register Write to Register Format int SSDI Write Register int reg no unsigned long data Argument int reg no Register number unsigned long data Data storage area Return value 0 Normal end 0 Error Explanation Writes data to registers Remarks The register number is defined in the include file SSDI_REGISTER H SSDI_REGISTER H is installed X NY Y Y LIB 91 INSSDI folder XNYYY Itis the drive amp folder which it installed SOFTUNE in 402 APPENDIX G External I F DLL for Simulator G 15 SSDI Set Interrupt Set Interrupt Source Format int SSDI Set Interrupt int int no int sw Argument int int no Interrupt number int SW Interrupt state 0 OFF Z1 ON Return value 0 Normal end 0 Error Explanation Sets the interrupt state If an interrupt is accepted the call back SSDI_Interrupt_Event is called Remarks If the interrupt state is set ON an interrupt request always occurs Set the interrupt state OFF in the timing in which the interrupt source flag is cleared 403 APPENDIX G 16 SSDI Set Timer Set Timer 404
30. Syntax Zh Set Comment Syntax List SYSTEM Ttt amp 1 h J gi nte SYSTEM h SYSTEM 2 951 tL F Macro define XE File Name Line Number h Help Keyword Any String Char Some Characters Char t or Syntax deletion procedure 1 Select Error from the Setup menu The error jump setup dialog box shown in Figure 4 7 31 opens 2 Select the syntax you want to delete from the syntax list 3 Click the Delete button 328 CHAPTER 4 MENUS Syntax modification procedure Modify a set syntax in the following procedure 1 Select Error from the Setup menu The error jump setup dialog box shown in Figure 4 7 31 opens 2 Select the syntax you want to modify from the syntax list The syntax and comment are displayed in the associated fields 3 Modify the syntax and comment then click the Set button The modified syntax and comment are newly set 4 Delete an unnecessary syntax syntax used before modification Analysis order change and application ON OFF Analysis order change Error messages are analyzed from the patterns registered in the upper part of the syntax list To assure correct analysis the analysis order may have to be changed The analysis order can be changed in the following procedure 1 Select Error from the Setup menu The error jump setup dialog box shown in Figure 4 7 31 opens 2 Select th
31. The Setup Project dialog is opened The option selected in the Setup Project dialog box is applicable to two or more projects The applicable project configuration can be limited For example the settings of project configurations A and B can be changed The same setting can also be specified for all project configurations Specify the project configuration in the Setting Target box the project set in tree view and select the tool tab When the compiler assembler and linker librarian are selected the category can be selected in the top tab of the setting dialog box for each tool After the drop down list is opened select a category When a category was selected the contents in the display are changed and the options included in each category can be set In most cases compiler and assembler options need not be set except when output of list file make or build is executed under specific conditions Set only linker options For how to set linker options see Section 2 9 Setting Linker Options Bi Click the OK button to complete tool setting When setting all necessary tool options is completed click the OK button All the set options are registered in the project they become valid when make or build is executed Clicking the Cancel button cancels all the set options Note When the Update button is clicked during tool option setting the previously set options cannot be restored 24 CHAPTER 2 OPERATION
32. Access address Access size 1 Byte 2 Word 4 LONG Total cycle count Count of cycles from beginning of instruction Read data Count of cycles taken for access Posts the occurrence of a read access event by instruction execution When read data is enabled the ISS operates assuming read data info data as read data When read data reflected in ISS memory data must be written by using SSDI Write Memory When read data is disabled data is read from ISS memory Set the count of cycles taken for read access as the count of cycles taken for access info cycle If this access cause an error use SSDI_Request_Abort to stop instruction execution Remarks The count of cycles from the beginning of the instruction inst_cycle is always posted as 0 394 APPENDIX G External I F DLL for Simulator G 7 SSDI Write Event Post Write Format int SSDI Write Event WRITE EVENT info Argument typedef struct unsigned long addr Access address int size Access size 1 Byte 2 Word 4 LONG unsigned long data Write data unsigned long total_cycle Total cycle count unsigned long inst_cycle Count of cycles from beginning of instruction unsigned long cycle Count of cycles taken for access WRITE_EVENT Return value 0 Write data enables 0 Write data disabled Explanation Posts the occurrence of a write access event by instruction execution When write data is
33. Bookmark Bookmark dialog as shown in Figure 4 3 6 will be opened This dialog is to indicate the list of bookmark set in source window Figure 4 3 6 Bookmark dialog Source window Source Memory Bookmark position L Prejecthsample c 65 Add Bookmark list D All delete sort val L Project sample c main L Project sample c sample c 65 L Project sample c Jump e Bookmark position This is a field to specify the position to set a bookmark Entering relative path function name or label name into the field can specify position of bookmark e Bookmark list The list of bookmark which is currently set in a source window will be displayed Name Name of bookmark will be displayed Name of bookmark will be appeared as line number or symbol name Position File name of which bookmark is set will be displayed Line Line number where bookmark is set will be displayed Symbol Symbol which is allocated to bookmark name will be displayed If a symbol is allocated Bookmark position will be updated based on debug information although the line number of symbol changes along with the change in file Please refer to Note for allocatable symbol Add button Seta bookmark to a location specified by Bookmark position 132 CHAPTER 4 MENUS Delete button Delete selected bookmark from a list All delete button Delete all bookmarks from a bookmark list Jump button Move a
34. Comparison condition The data comparison condition is specified Disable No data specified for the trigger condition Data agreement Data agreement data agrees with the specified data is specified for the trigger condition Data NOT Data mismatch data does not agree with the specified data is specified for the trigger condition Data Data to be used for the trigger condition is set Data mask The mask value for the specified data is specified This function can be used only when the FR6OLite is used For details refer to SOFTUNE Workbench USER s MANUAL Trace 174 CHAPTER 4 MENUS Search Trace Select Find from the shortcut menu Address Figure 4 4 20 Trace Search Dialog Address Address Search address 000 Find next Address mask HFFFFFFFF Close Searching start number D2 Search address Specifies start address of search range Address mask Specifies end address of search range Searching start number Specifies number of frame where starts the search E Example of address mask The relationship among search address address mask and the actual address to be found is shown in Table 4 4 1 Table 4 4 1 Relationship among Search Address Address Mask and Actual Address to be Found Search address Address mask Actual address to be found H FFFFFFFF H F000F0CA H F000F0CA Any address from H F0000000 to 000FFFF 175 CHAPTER 4 MEN
35. E Configuration 1 External I F module The microcontroller resource simulator is read only when the Simulator Debugger for SOFTUNE Workbench is started The interface between the ISS and the microcontroller resource simulator is called in the following timing When the Debugger is started When the Debugger is terminated When the target is reset Immediately before data is read from memory I O Immediately after data is written to memory I O Immediately before fetching is performed When an interrupt occurs When a timer event occurs 387 APPENDIX There are the following functions for operating the ISS from the microcontroller resource simulator e Reads writes data from to memory e Reads writes data from to registers Sets interrupt sources Requests abort of instruction execution B Simulator external I F specification Function List ISS 2 DLL 1 SSDI_Entry Startup 2 SSDI_Init Initialize 3 SSDI_Ready Ready 4 SSDI_End End 5 SSDI_Reset_Event Post Reset 6 SSDI_Read_Event Post Read 7 SSDI_Write_Event Post Write 8 SSDI_Execute_Event Post Execute Instruction 9 SSDI_Interrupt_Event Post Interrupt 10 SSDI_Timer_Event Post Timer DLL gt ISS 11 SSDI_Read_Memory Read from Memory 12 SSDI_Write_Memory Write to Memory 13 SSDI_Read_Register Read from Register 14 SSDI_Write_Register Write to Register 15 SSDI_Set_Interrupt Set Interrupt Sou
36. Format int SSDI Set Timer int no unsigned long cycle int sw int id Argument int no Timer setting number unsigned long cycle Cycle count int SW Condition 0 Repeat 1 Only once int id Always set 0 Return value Timer setting numbers 0 to 31 1 Error Explanation Generate a timer event after an elapse of the set cycle count after the timer is set There are two timer setting conditions repeat and only once To clear the timer setting set the cycle count cycle to 1 If the timer setting number is set to 1 it is set to an unassigned number Remarks APPENDIX G External I F DLL for Simulator G 17 SSDI Request Abort Request Abort Format void SSDI Request Abort char message Argument char message Abort message Return value None Explanation Requests the ISS to abort When an abort is requested the ISS aborts processing when the current instruction execution is terminated The abort message message is displayed as the abort message for the debugger Remarks 405 APPENDIX G 18 SSDI Set Area Set Area 406 Format int SSDI Set Area int no unsigned long start unsigned long size int attribute int id Argument int no Area setting number unsigned long start Starting address of area unsigned long size Area size unsigned long attribute Attribute int id Always set 0 Return value Area setting numbers 0 to 31 1
37. 168 CHAPTER 4 MENUS Trace setup Select Setup from the shortcut menu Trace Figure 4 4 16 Trace Setup Dialog Setup trace Status Specifies control status Buffer Full Break Specifies whether or not to break trace buffer full Trace stop caused due to trace buffer full Specifies whether or not to trace stop caused due to trace buffer full Note In single trace and multi trace items are individually set 169 CHAPTER 4 MENUS Data Trace Area DSU3 DSU4 Figure 4 4 17 Trace area Setup trace 00000000 Acquisition data Specify the attribute of the data access subject to trace measurement Code is enable only DSUA Status The trace data acquisition state is specified Enable only DSU4 Address The address for which filtering is to be performed is specified Address mask The mask value for the address for which filtering is to be performed is specified 170 CHAPTER 4 MENUS Note Trace data is acquired as follows by MCU mode and DSU Type MCU mode Full trace DSU type Code Read Write Code Read Write Real time External trace Code Read Write Code Read Write Code Read Write Adapter board connection Code Read Write Cable connection Code Read Write Internal trace Code Read Write Code Read Write The data of the
38. 3 4 Setup wizard is started Click the Next button Select a debugger type then click the Next button Setting of the subsequent items depends on the Debug Type To reset an item click the Return button The immediately preceding setup screen is redisplayed Bi Procedure when the emulator debugger is selected 1 2 3 A fF 9 Select the emulator debugger Click the Next button Select RS232C LAN or USB as the device type When RS232C is selected set a port and baud rate When LAN is selected set a host name Click the Next button Set whether or not to automatically load the monitor program at debugging start Click the Next button Set whether to load the target file automatically during debugging Specify the batch files used before and after load as required Clicking the Browse button to the right of each input field enables batch file selection Click the Next button 10 Select the item to be set in the setup file When Specification is selected click the Setup button to open the item selection dialog box select the item to be set from the dialog box then click the OK button 11 Click the Next button 12 Click the Finish button Emulator debugger setup has now been completed 317 CHAPTER 4 MENUS Bi Procedure when the simulator debugger is selected 1 2 Set whether to load the target file automatically du
39. B 4 Source Files E sample c startup asm None 0 0 0 0 gm The following options can be set from the optimize option setup dialog Select the optimize option to set from the drop down list e General purpose optimization level O None Level1 4 speed priority size priority e Code area of external symbol size 20 bits 32 bits Data area of external symbol size 20 bits 32 bits Note If Speed priority or Size priority is selected as an optimization level Code Area of External Symbol Size and Data Area of External Symbol Size are changed automatically to 20 bits Each symbol size should be changed after changing the optimization level 214 CHAPTER 4 MENUS E Setting of Options Included in Detail Definition in Optimization Figure 4 5 19 Optimize Details Setup Dialog Optimization x Loop unrolling In line expansion of standard library functions or replacement to equivalent function Optimization of changing the evaluation method of arithmetic operation Instruction scheduling v Control optimization of pointer aliasing IV In line expansion of function below the specified number of lines 30 n line expansion of specified functions Function name List of function Set Jelete Minimum alignment boundary for external and static variables 1 Byte z Method of allocation of argument area Static reserve m Cancel
40. Bi Deleting debugger setup 1 Click Debug tab from the project setup dialog box 2 Select Setup category 3 Select the setup name to be deleted from Setup Name List 4 Click the Delete button E Changing debugger setup 1 Click Debug tab from the project setup dialog box 2 Select Setup category 3 Select the setup name to be changed from Setup Name List 4 Click the Change Setup button Setup wizard is started See Section 4 7 2 5 Setup Wizard il Changing setup name Click Debug tab from the project setup dialog box Select Setup category Select the setup name to be changed from Setup Name List Enter Setup Name a A N Click the Change Setup Name button 246 4 5 6 CHAPTER 4 MENUS Setting Customize Build This section explains how to start a different tool before or after executing the language tool during make or build BB Customize Build function Setup Customize Build Ea Target of setting sample prj Y TreeView In SOFTUNE Workbench it is possible to make a different tool operate automatically before or after executing the language tool during compile assemble make or build Using this function makes it possible to make a customer tool operate before the compiler is executed make the object module conversion tool operate after the linker is executed This setting is stored on a project by project basis Figure 4 5 4
41. Break at main H 000801B6 by hardware breakpoint DEBUG MB81V240 PON IP 000801B6 7 DEBUG is displayed when SOFTUNE WorkBENCH enters the debug session An MCU number e g MB91V240 is displayed when SOFTUNE is in the debug mode The type of the debugger is displayed when SOFTUNE WOonkKBENCRH is in the debug mode The debugger status e g execute break is displayed when SOFTUNE Worksencu is in the debug mode The function of power on debug is enable displays e g PON is displayed when SOFTUNE Worksencu is in the debug mode The current IP instruction address value is displayed when SOFTUNE Worxsencu is in the debug mode 39 CHAPTER 3 WINDOWS 3 4 Project Window The Project Window displays information about the project and load module E Project window Figure 3 4 1 shows an example of the project window Figure 3 4 1 Project Window Workspace Sample E Sample abs Sample prj Debug Source Files EI Include Files Dependencies Debug To select the window display contents use the tab on the bottom of the project window The project window has the following tabs SRCtab Displays information on the project Refer to Section 3 4 1 SRC tab for details e ABS tab Displays information on the source file acquired from the debug information Refer to Section 3 4 2 ABS tab for details 40 CHAPTER 3 WINDOWS 3 4 1 SRC
42. Directory Figure 4 7 19 Debug Environment Setup Dialog Box Directory Setup debug environment Source file search path Display Path Information Specifies the path information to be displayed Append Path Sets the path to be added Directory Displays the currently set directory Directory setup procedure 1 Select the Display Path Information to be displayed 2 Setthe Append Path Clicking the Browse button to the right of the Append Path setup field enables path selection 3 Click the Append button 4 When there is no other item to be set click the OK button Directory reset procedure 1 Select the directory you want to delete from Directory 2 Click the Delete button 3 When there is no other item to be set click the OK button 309 CHAPTER 4 MENUS Tab Figure 4 7 20 Debug Environment Setup Dialog Box Tab Setup debug environment or wah Ra Emin Tab Specifies the tab D 4 D 8 310 CHAPTER 4 MENUS Error output Figure 4 7 21 Debug Environment Setup Dialog Box Error m Setup debug environment Seas In GUI Operation Specifies an error output type at GUI operation In Command Operation Specifies an error output type at command operation In Batch Operation Specifies an error output type at batch operation Error Output Level Sets the output type when sever
43. Logical AND Logical OR Reference When the comparison result is true the relational operator becomes H 1 When false it becomes H 0 The SOFTUNE Workbench does not support the conditional operator comma operator increment operator and decrement operator of C C language CHAPTER 2 OPERATION 2 1 5 Address Formula Specification Address formula specification is divided into the full addressing and address range specification E Full addressing The full addressing format is as follows 32 bit addressing 32 bit addressing Expression for addressing E Address range specification Address range specification representing a memory range consists of two addressings it has any of the following two formats Addressing addressing from starting address to ending address Addressing offset from starting address to starting address offset offset Value relative to addressing starting address E Bit addressing The notation below is used to represent a bit address Symbols for bit address attributes can also be used Bit addressing is valid when BIT is specified in the command qualifier addressing bit offset bit offset Value used to specify a bit position When addressing is omitted address 0 is assumed CHAPTER 2 OPERATION 2 1 6 File Name Specification File name specification complies with Windows rules File name specification drive n
44. Project Setup Project Menu PETERE 24 Setting Active 19 Setting Active Project Configuration 22 Setup Project 199 Shortcut menu Click the right button of the mouse on space in the project window EU A 55 Storing Created File with Directory in Project 20 Storing Existing Projects Workspace 19 Storing New Project in Currently Opened 18 Storing of Project 18 To delete files stored in the project 20 When the currently open project file is being edited eee 116 Project bar Project Dar oe errer 37 Project file Saving the project file 118 Project Window Project 40 152 Property Property 4 ise e n e e Ia 140 Property function sees 123 Property 5 143 Property General 141 146 147 148 149 150 Property Input iet 144 Property Output sssseeeeene 145 R Radix Setting a 165 166 RAM Defining the ROM RAM 237 Deleting a ROM RAM 237 Method of outputting warning when ROM RAM area specified outside range of internal ROM RAM
45. Reset ci JE 248 ROM Defining the ROM RAM area 237 Deleting a ROM RAM 237 Method of outputting warning when ROM RAM area specified outside range of internal ROM RAM ect eit 237 Method of outputting warning when section placed outside specified ROM RAM area range eet 237 When a section is allocated to the specified ROM RAM 235 Run FUA soe e rar c 259 S Sample files Sample files sess 383 417 INDEX Sample Program Explanation of Sample Program 383 Save SEE 177 Search Search procedure 129 Section Changing the section allocation order 236 Method of outputting warning when section placed outside specified ROM RAM area cde orc adeste 237 Setting of the 25 When a section is allocated to the specified ROM RAM area 235 When a section is allocated to the specified starting address 235 Sequence Start sequence change procedure 250 Session Debug session 130 When SOFTUNE Workbench is in the debug SOSSION sd er pde tete 122 Setup Changing debugger setup 246 Changing setup
46. The following options can be specified Loop unrolling K UNROLL In line expansion of standard library functions or replacement to equivalent function K LIB Optimization of changing the evaluation method of aithmetric operations K EOPT Instruction scheduling K SCHEDULE Control optimization of pointer aliasing K NOALIAS In line expansion of function below the specified number of lines xauto In line expansion of specified functions x Minimum alignment boundary for external and static variables K A4 A1 1 byte 4 bytes Method of allocation of argument area K SARG DARG static reserve dynamic reserve Setting In line Expansion of Specified functions 1 Select the Optimization category The set optimization dialog Figure 4 5 18 is opened Set General purpose Optimization level to any values other than O and click Detail button 3 Specify Function name Click the Set button 215 CHAPTER 4 MENUS E Canceling In line Expansion of Specified functions 1 Select the Optimization category The set optimization dialog Figure 4 5 18 is opened 2 Sets General purpose Optimization level to any values other than 0 and click Detail button 3 Select the function name to be deleted from List of function 4 Click the Delete button Note If an optimization level is changed options set in the detail definition dialog are initialized according to the optimi
47. This chapter describes the FLASH loader of the SOFTUNE Workbench 5 2 1 Overview 5 2 2 Menu 5 2 2 1 Load Target file 5 2 2 2 Load after make 5 2 2 3 Load after build 5 2 2 4 Load specified file 5 2 2 5 FLASH erase 5 2 2 6 Setting of Environment to load 5 2 3 Restrictions 5 2 4 Error Message 357 CHAPTER 5 Add in Module 5 2 1 Overview This section describes an overview of the FLASH loader BB Overview The FLASH loader is a program which downloads files to FLASH memory with the target MCU from the SOFTUNE Workbench The program downloads project s target files Motorola S format files Intel HEX files and binary files to all FLASH memory areas sector areas or consecutive sector areas 358 CHAPTER 5 Add in Module 5 2 2 Menu The FLASH Memory menu has the menu items such as Load Target File Load after make or build and Erase FLASH E Flash Memory Menu Installation of the FLASH loader adds the FLASH Memory menu to the SOFTUNE Workbench see Figure 5 2 1 Figure 5 2 1 FLASH Memory Menu ga SOFTUNE Workbench sample Debug File Edit View Project Debug Setup FLASH Memory Window Help 5 22 Load Target file Bi ps EE d Load after make Sele leo Bl Eum toad after buia Load specified file FLASH erase ii sample abs sample prj E Source Files 28 Include Files f Dependencies H Debug Setting of Environment to load The FLAS
48. When Batch File is selected in Kind Enter the batch file name to be registered in the customize bar To select from a list specify with the Open File Dialog Box Figure 5 1 5 displayed when you click the reference button on the right 2 When Menu is selected in Kind Enter the Workbench menu to be registered in the customize bar Specify with the Menu List Dialog Box Figure 5 1 7 displayed when you click the reference button on the right Parameter Enabled only when Batch File selected in Kind Input the parameter for executing a batch file Parameter Setting Dialog Enabled only when Batch File selected in Kind Displays Parameter Setting Dialog Fig 5 1 6 that can set change parameters with the customize bar when executing a batch file Iconic Enabled only when Batch File selected in Kind This makes Workbench an icon when executing a batch file with the customize bar Function Explain Enabled only when Menu selected in Kind Displays a description of the Workbench menu to be registered in the customize bar Up Changes the order of the registered contents displayed in the File List to one above Switches that order when there is already one registered to a number one above Down Changes the order of the registered contents displayed in the File List to one below Switches that order when there is already one registered to a number one below Add Adds batch files or Workbench to the custo
49. in SOFTUNE Workbench Users Manual and Section 4 4 8 Trace in SOFTUNE Workbench Operation Manual 98 CHAPTER 3 WINDOWS 3 18 1 Checker setting This section describes settings of the RAM Checker Bi Setting To set each setting use the shortcut menu of the RAM Checker window or enter commands Setting by the shortcut menu is explained here For setting by commands refer to the command reference E Shortcut menu Figure 3 18 3 Shortcut menu of the RAM Checker window B Monitoring address On shortcut menu Setup open the setting dialog Figure 3 18 4 Setting dialog 0003 00 0003 008 Halfword H ODO3COD4 Halfword H ODO3CODO Halfword H ODO3COCC Halfword 0003 0 8 Halfword H ODO3COC4 Halfword Word m IJGWIT 99 CHAPTER 3 WINDOWS The RAM Checker displays the set monitoring addresses on the RAM Checker window in the order they are listed in the check address list When a new monitoring address is set it is added to the end of the list The order in the list can be changed The sampling interval 1ms and the monitoring interval 100ms cannot be changed 1 Setting of monitoring address Input a monitoring address in the form of symbol or address Select the data size of the monitoring address from among byte halfword or word Setthe access attribute of the monitoring address Click the Add button The monitoring address is re
50. name and click the OK button When the setup name is entered the Select File dialog is opened Select the file and click Open button Information is read from the specified file Property Information on folders is displayed see Section 4 3 9 Property Figure 3 4 12 Create New setup Create New setup Setup Name CHAPTER 3 WINDOWS Shortcut menus Click the right button of the mouse on a source file name Figure 3 4 13 shows a shortcut menu Figure 3 4 13 Shortcut menu on a source file name Open Compile samplel c Set Delete Property Open List File Open Assemble File Open When SOFTUNE WORKBENCH is in the debug session the specified source file is displayed in the Source Window When SOFTUNE WORKBENCH is not in the debug session the specified source file is displayed in the edit window Compile Assemble The specified source file is automatically judged whether it is the C C or assembler source and then compiled or assembled Set When selected the following two submenus are displayed Individual Setting A project is set See Section 4 5 5 Setup Project Return to Common Setting All individual options in the specified folder are returned to common options Delete The specified file is released from the project member The file itself is not deleted Property File information is displayed See Section 4 3 9 Proper
51. procedure 1 Select a vector number 2 Click the Jump button If the starting address of the program set in the vector table is incorrect the source cannot be displayed disassemble display Note The jump function merely displays the jump destination program it does not update the program counter to move control to the address set in the vector table 286 CHAPTER 4 MENUS 4 6 12 Load Target File This section explains how to load the target file to be debugged by SOFTUNE Workbench Target file An ABS format target file is to be debugged This file is registered as a project target file Debugging can be started after the ABS format target file has been created Use SOFTUNE Workbench to create a source program and execute compile assemble and link Creation of the ABS format target file is enabled when the program is free from compile assemble and link errors Loading the target file Before loading the target file select Start debug from the Debug menu to place SOFTUNE Workbench in the debug session When SOFTUNE Workbench enters the debug session select Load target file from the Debug menu to load the target file The target file load state display dialog box shown in Figure 4 6 21 opens when the target file is being loaded Figure 4 6 21 Target File Load State Display Dialog Box Processing When loading the target file terminates an entry point is set in the PC the source line of the module
52. routine I O driver and vector table e train inc Definition of I O addresses of FR CPU u init asm Initialization Communication timer Setting of stack area u io asm Driver Communication timer e intv asm Interrupt vector table e link opt Input file to linker e flag911 inc Setting of FR resource select flag etc e mod911 rel FR monitor unit B Sample files Refer the following files provided as samples the user builds into the target system The files to be built into the target system should be rewritten as required Some symbol names are fixed because they are externally referred from the debugger body Such symbol names are suffixed by an asterisk Use these names as they are train inc File for defining labels used by io asm This file defines I O addresses etc u init asm u init Initializes communication and timer etc used by debugger When using abort and timer processing set the 1 byte _abtflg and _timflg flags to 1 When not using them set the flags to 0 io asm inithrd Initializes target system and sets CPU e g memory interface setup Note Do not set these in the user program to be debugged Depending on the user program to be re set the debugger may not operate normally e 10105 Initializes communication ports Polling control applies to reception and transmission e clr abrt When an Abort switch is available write the processi
53. 2 Select Macro etc from the shortcut menu The character string replacement setting dialog box shown in Figure 3 15 2 opens 3 Click the Macro tag The macro setting dialog box shown in Figure 3 15 4 opens 4 Seta macro name Specify a macro name that does not conflict with the macro names that are already registered 5 Write the commands to be assigned to the specified macro name Aliases variables and other macros can also be written 6 Click the Append button 90 CHAPTER 3 WINDOWS Deleting a macro 1 2 Click the right button of the mouse in the command window to display the shortcut menu Select Macro etc from the shortcut menu The character string replacement setting dialog box shown in Figure 3 15 2 opens Click the Macro tag The macro setting dialog box shown in Figure 3 15 4 opens Select the macro name to be deleted from the macro list 5 Click the Delete button Figure 3 15 4 Macro Setting Dialog Box Replace command ump 10000 19FFF d dump 10000 19FFF 91 CHAPTER 3 WINDOWS 3 15 2 Logging This section explains SOFTUNE Workbench logging E Logging To record a command execution log in the command window in a file is called logging To control logging click the right button of the mouse in the command window to display the shortcut menu then select Logging Selecting Logging from the shortcut menu displays the following subme
54. 2 7 REP ca 118 4 2 8 Saye All ELE 119 4 2 9 a 120 4 2 10 Recent Text File Recent Workspace File sssseeeenm nennen 121 AQAA 2d E a 122 4 3 eee 123 4 3 1 Undo REO dti tiet Mee ata 124 4 3 2 Gut Copy Paste Delete vaa aaa a Yep ad va ER Yea dedu Tras 125 4 3 3 All SelecL there cad cca HR eet bdo se e er nt e S e Sein ed 126 4 3 4 Find Fleplace e et e ten ette 127 4 3 5 a EE MC UE EMT 129 4 3 6 Nero c 130 4 3 7 Bookmark 131 4 3 8 Previous error Next error Top of Error Bottom of Error 139 4 3 9 peer 140 4 4 MIA PIE 151 4 4 1 Project OUutput eb fel Dite S e a ide dre A cs 152 4 4 2 ue e 153 4 4 3 ASSOIMDIY vei Tc 154 4 4 4 Regis 156 4 4 5 MEMON estt teilte estet s Ate 158 4 4 6 165 166 4 4 8 TRACE d ceca a ete bete P t 168 4 4 9 erento rer 178 vi 44 10 Tool Bar Status Bar TaD eh e cena P e Te
55. 2 9 Setting Linker Options When creating a program with SOFTUNE Workbench be sure to set a memory allocation with a linker option Automatic Setting of Linker Options In SOFTUNE Workbench the following linker options are automatically set on the basis of information on the MCU selected when a new project is created Specify the internal ROM RAM address of the MCU in the memory area option Internal ROM is output under an area name of INROMXxx and internal RAM under area name of _INRAMxx where xx is numbered consecutively starting with 01 Setthe automatic disposition mode to mode 2 optimum automatic disposition by linker When creating a program in a mode other than the single chip mode or when customizing the disposition of sections set the Disposition Connection option as the linker option E Setting of Linker Options In SOFTUNE Workbench memory mapping is basic to the disposition of each section in the memory area Therefore set a memory area and set each section in the memory area E Setting of Memory Area Click the Set button enter a ROM RAM area name start address and end address then select an area attribute ROM or RAM This setting is displayed in the ROM RAM area list Assign a unique ROM RAM area name so that it does not match other area names The number of areas that can be set is not limited set all the areas necessary to configure the memory map of the program to be developed In Auto Dispos
56. 30 Clicking the Add Setup or Change button starts the setup wizard for debuggers Once setup wizard has been started set items according to instructions from setup wizard For how to set items with setup wizard see Section 4 7 2 5 Setup Wizard When all settings with setup wizard are completed click the Complete button When the Setup dialog box is redisplayed click the OK button When all the above steps are completed save the project then close it once CHAPTER 2 OPERATION E Starting debugging When steps from Creating a project to Setup Wizard are already completed open the project SOFTUNE Workbench automatically migrates to the debug session enabling the immediate start of debugging Select Open from the File menu and specify the load module file to load the target program 31 CHAPTER 2 OPERATION 2 13 Reading SOFTUNE Project Files of Old Versions The SOFTUNE project files of old versions can be read B Procedure 32 The project files created in V3 V5 version needs the following setting 1 Select Open Workspace from the File menu then specify the project file created 2 Select Project file from File type and specify the project file made by an early SOFTUNE Workbench version If the specified file is one made by an early SOFTUNE Workbench version a dialog asking whether to convert the file to a workspace project format is opened Yes button The project file is converted
57. 36 CHAPTER 3 WINDOWS 3 2 Tool Bar Command buttons to be used often are assigned to the tool bar for each group The groups that can be selected and the command buttons in the groups are shown below E Common bar New Open Save Cut Copy Past Undo Redo Jump to Next error Jump to Previous error Jump to Top error Jump to Bottom error E amp 5 0 5 5 8 w Project window Docking Output window Docking Open Project window Open Output window E Project bar The active project and its active configuration name are set and displayed sample v Debue v 37 CHAPTER 3 WINDOWS Build bar Compile Assembly Make Ez Build x Stop Make Build E Debug bar Go Step In Step Over Step Out Run Until Cursor Reset of MCU Abort Breakpoint Set Reset Register window Watch window Memory window gt d pe OR OR Disassembly window B Flag bar Display and setting of MCU condition flag status I EX NE EN EN EN E 38 CHAPTER 3 WINDOWS 3 3 Status Bar The current status of the SOFTUNE Workbench is displayed The status bar is displayed in the last part of the main window Status bar The status bar has the areas in which information is displayed Information and the areas in which is displayed are simply shown in Figure 3 3 1 Figure 3 3 1 Status Bar The current status of SOFTUNE Worxsencu is displayed
58. ABORT switch 381 Abort JAO A ertet eterne 260 ABS tab ABS tab mien tet tut ftus 53 ABS tab bitmap image list 53 Absolute format Setting absolute format assemble list options n 230 Active Project Setting Active Project Configuration 22 Address Monitoring address 99 Address formula Address 6 Operators Usable in Data and Address Formulas UON 12 Address range Address range specification 13 Addressing Bit addressing sss 13 Full addressing sssess 13 Notes in 236 Alias Alla tect iecit tret eta d tus 88 Analysis Analysis order change and application ON OFF M w n 329 Application Analysis order change and application ON OFF S ennt dde cif ED a 329 Assemble Inline 5 1 155 Setting absolute format assemble list options 230 Assembler options Setting assembler options 219 Assembly ceirnin 154 Automatic downloading Automatic downloading of monitor program 29 Automatic Setting Automatic Setting of Linker Options 25 410 B Back tra
59. Add and Delete Project Configuration dialog E Setting Active Project Configuration 22 The active project configuration is a project configuration that undergoes Make Build Compile Assemble Start Debug and Include Dependence at default 1 Select Project Project Configuration Add and Delete 2 Select the project configuration that is made active When the Add and Delete Project dialog is opened select the name of the project configuration that is made active 3 Click the Active button Click the Active button The specified configuration and its project become active 4 Click the OK button CHAPTER 2 OPERATION Deleting Specific Project Configuration from Project 1 Select Project Project Configuration Add and Delete 2 Select the project configuration that is deleted from the project When the Add and Delete Project dialog is opened select the project configuration name to be deleted 3 Click the Delete button Click the Delete button The specified project configuration is deleted When all project configurations in a project are deleted the project itself is also deleted 4 Click the OK button 23 CHAPTER 2 OPERATION 2 8 Setting Tools When make or build is executed by SOFTUNE Workbench appropriate options must be set in such tools as a compiler assembler and linker Set these options as follows E Select the Project Setup Project Menu
60. E Details of code breakpoint For MB2198 MB2197 Figure 4 6 4 Code breakpoint details dialog for MB2198 and MB2197 Break point details x Break address 000807 Remain 5 Cancel Break kind Watch condition C Software C Hardware Data watch condition Break address In this field the address that sets a breakpoint is specified Remain n this field the remaining count of settable breakpoint types currently being selected is displayed Break kind n this field the type of the breakpoint is selected Watch condition When the check mark is entered in the box for Data watch condition will be enabled Data watch condition The data watch condition is set The dialog given in Figure 4 6 5 is displayed 267 CHAPTER 4 MENUS Figure 4 6 5 Data watch condition setting dialog Break address 000807 BA Watch condition 4 mode Indirect condition Address Register Register number A Y Offset D O Size Byte Data 00000000 Cancel The data watch condition is set Only 1 point can be set Break address The set breakpoint address is displayed Compare mode The condition for data watch is specified Indirect condition Either address indirect or register indirect is specified Register number RO R15 The register number is specified when
61. Processor status PS Table base register TBR Return pointer RP System stack pointer SSP User stack pointer USP Multiplication and division result registers MDH MDL Flag registers CCR S I N Z V C System Condition registers SCR D1 DO T Interrupt level register ILM Virtual accumulato AC Frame pointer FP Stack pointer SP When an address is specified can be written before these register names Note The T flags of the system condition registers are used by the emulator The values modified by the register command are invalid 374 APPENDIX B Downloading Monitor Program APPENDIX B Downloading Monitor Program To use the emulator debugger the monitor program corresponding to the chip to be used must be written to the emulator This processing is called monitor program download In the MB2198 emulator Data in the emulator can be checked at the beginning of debugging to automatically load the appropriate emulator monitoring program and version data into the emulator B When the emulator is an MB2197 The downloading monitor program procedure is described below 1 Connect the emulator to a personal computer PC with an RS 232C or LAN interface When connecting the emulator to the LAN see APPENDIX C Setting LAN Interface 2 Press the reset switch then turn on the emulator Check that the READY LED of the emulator body come on 3 Execute the Monitor Loader menu from SO
62. Project Configuration The project configuration is set E Project Configuration There are the following two menus to set the project configuration Add and Delete The project configuration is added and deleted and the active configuration is changed Configuration at build The configuration as a subproject is made or built is set 252 CHAPTER 4 MENUS 4 5 8 1 Project Configuration Add and Delete The project configuration is added and deleted E Project Configuration Add and Delete Figure 4 5 43 Add and Delete Project Configuration Dialog Box Add and delete project Configuration x Project and Configuration l sample prj Add 1 154 MB31301 Delete sub pri Active Project and Configuration All projects in workspace and their configurations are displayed Add Click this button to open the Add Project Configuration dialog shown in Figure 4 5 44 This dialog enables the addition of the project configuration Delete Click this button to delete the selected project and its configuration Active Click this button to make the selected project and its configuration active 253 CHAPTER 4 MENUS Figure 4 5 44 Add Project Configuration Dialog Box Add project Configuration x Project name pri Cancel Configuration name p copy of setting Debug Project name The name of the project
63. Register when the register window is already opened activates the Window E Changing register values The values saved by the registers displayed in the register window can be changed directly by the following procedures Full change 1 Doubleclick a register name or display value The register name or display value is reversely displayed 2 Specify the values to set in turn using a hexadecimal number starting from the highest order digit leftmost digit The register value is set automatically when the digit in the lowest order bit rightmost digit is changed Partial digit bit field change 1 Click the digit to be changed in the register value display The cursor appears at the left of the clicked digit 2 Set the new value as a Idigit hexadecimal number The cursor automatically moves to the right digit If the changed digit is the lowest order digit the register value is updated automatically 3 When changing of the required number for digits is completed click another register name or register value display If the register window is closed without clicking another register name or register value display the changed value is not set in the register This operation is not necessary when the change to the lowest order bit is completed 156 CHAPTER 4 MENUS Selected register name change 1 Click the right button of the mouse in the register window to display the shortcut menu then select Edit
64. SOFTUNE Workbench USER s MANUAL Real time Monitoring 94 CHAPTER 3 WINDOWS 3 17 Performance Window The performance window display performance measurement result E Performance window For the performance function see Section 4 4 13 Performance Examples of the performance window are given in Figure 3 17 1 and Figure 3 17 2 The performance window is used to display the result of performance measurement at the debugging This window is only displayed for the emulator debugger and the performance mode at the event mode Figure 3 17 1 Performance Window Measurement Count fe Performance OF Display type Measuring count Measuring results Event No 1 2 3 4 95 CHAPTER 3 WINDOWS Figure 3 17 2 Performance Window Measurement Time 3 Performance OP x Display type Measuring time Display event Interval 1 m Measuring results Minimum Maximum Average 44 500 45 500 45 300 Time 0 000 40 000 41 000 42 000 43 000 44 000 45 000 46 000 47 000 48 000 43 000 50 000 e ooooossoooool Display Type Select measurement time or measurement count as the display type Display Event A display event is displayed only when measurement time is selected Select a measurement interval Measurement Result The measurement result is totalized and displayed The minimum measurement result maximum measurement resu
65. SOFTUNE Workbench User s Manual To specify the FLASH memory area to which the target file is downloaded use the Load Environment Setting Dialog box see 5 2 2 6 Setting of Environment to load E Caution Always create a target file in accordance with the FLASH memory area to which the file is loaded The program downloads only the data within the FLASH memory 361 CHAPTER 5 Add in Module 5 2 2 3 Load after build Builds a project s source program to download the created target file to FLASH memory B Function E Caution 362 This menu builds the project s source program to download the created target file to FLASH memory For details of the Build function of the SOFTUNE Workbench refer to 1 4 Make Build Function in the SOFTUNE Workbench User s Manual To specify the FLASH memory area to which the target file is downloaded use the Load Environment Setting Dialog box see 5 2 2 6 Setting of Environment to load Always create a target file in accordance with the FLASH memory area to which the file is loaded The program downloads only the data within the FLASH memory 5 2 2 4 CHAPTER 5 Add in Module Load specified file Selects a file from the dialog Figure 5 2 2 to download the file to FLASH memory B Function This menu specifies to download the file to FLASH memory To download any files other than the project s target file to FLASH memory select this item Selection of the Load speci
66. Viewer TEMP_001 SRL Me Fie View Search Help E BO Bt 5 ae Re cho symbol 1 Ox0003CODC Value 0 20 O O O O O O Ch3 Xsymbol 4 Ox0003CO0D0 Value 0 2000 OO 0O 0O 0O D Time View Cursor Ready 1ms sample 4304 Or select Windows Start menu SOFTUNE V6 FR Family SOFTUNE Workbench Tool to execute the RAM Checker Viewer menu For the RAM Checker Viewer refer to FswbRView pdf and online help information 104 CHAPTER 4 MENUS This chapter explains the SOFTUNE Workbench menu configuration and the dialog boxes to be started from each menu 4 1 Menu Configuration Tree 4 2 File Menu 4 3 Edit Menu 4 4 View Menu 4 5 Project 4 6 Debug 4 7 Setup 4 8 Window 4 9 Help 105 CHAPTER 4 MENUS 4 1 Menu Configuration Tree This section explains the SOFTUNE Workbench menu configuration Bi Menu Configuration The following menus are displayed in the SOFTUNE Workbench main window File Edit View Project Debug Setup Window Help The following functions are assigned to each menu item File New Open Close Open Workspace Close Workspace e Save Save As Save All Print Recent Text File Recent Workspace File Exit Edit Undo Redo Cut Copy Paste Delete All Select Find Replace Find in Files Jump Previous Error Next Error Top of Error Bottom of Error Prop
67. Window A check mark is not set When the dir command is registered Title Dir Execute Filename command com Option c dir Executing Directory Designate Additional Option when Executing A check mark is not set Use Output Window A check mark is set CHAPTER 4 MENUS 4 7 5 Keyboard Keyboard enables definition of shortcut keys B Keyboard setup procedure 1 Select a type Functions are displayed in Function List 2 Select the function you want to set from Function List The explanation of the selected function is displayed in the explanation field lower part of the keyboard setup dialog box When an assigned function is selected the currently assigned keys are displayed in Assign key 3 Set a focus in New Assign then specify the key to be assigned to the selected function from the keyboard press the key 4 Click the Set button E Procedure for deleting an assigned key 1 Select the function corresponding to the key you want to delete see 1 and 2 in the keyboard setup procedure above The currently assigned keys are displayed in Assign key 2 Select the key you want to delete from the key list displayed in Assign key 3 Click the Delete button The dialog box for checking that you are sure to want to delete the key opens 4 Click the OK button E Procedure for changing an assigned key 1 Delete an assigned key see the procedure for deleting an assigned key above
68. Workbe sample Debug Project CHD os Farce mple Symbol Assembly Register Memory Local Watch Trace Performance Command Realtime memory Tool bar v Status Bar Font Customize bar Setting v View 347 CHAPTER 5 Add in Module 5 1 3 Registering in the Customize Bar This section describes registering in the customize bar E Registering in Customize Bar You can registers batch files and Workbench menus in the customize bar Register using the Customize Bar Setting Dialog Figure 5 1 4 displayed in View Customize Bar Setting For details on how to register see section 5 1 3 1 Registering Batch File and 5 1 3 2 Registering Workbench Menu Figure 5 1 4 Customize Bar Setting Dialog Customize bar Setting Dialog x File List Parame 4 C SSoftuneB nitialize prc RunBreak SetupDbgenv A CD CH Number fi 7 Kind Batch File Down Entry c Softune6 Initialize pre El Batch File Parameter Delete Parameter Setting Dialog Close t PES Iconic ezpan E Items in Dialog Box File List The settings registered in the customize bar are displayed Number Specify the number to register in the customize bar Numbers from 1 to 10 can be specified Kind Select either Batch File or Menu to register in the customize bar 348 CHAPTER 5 Add in Module Entry 1
69. address of the FLASH memory area to be written or erased Internal RAM area Displays the area for internal RAM used by the FLASH loader Cannot be changed DATA Start address Displays the start address of the area temporarily storing data to be downloaded to FLASH memory DATA End address Displays the end address of the area temporarily storing data to be downloaded to FLASH memory 367 CHAPTER 5 Add in Module CODE Start address Displays the start address of the area temporarily storing the program to be downloaded to FLASH memory CODE End address Displays the end address of the area temporarily storing the program to be downloaded to FLASH memory 368 CHAPTER 5 Add in Module 5 2 3 Restrictions There are the following restrictions when using the FLASH loader E Restrictions There are the following restrictions when using the FLASH loader 1 Creation of intermediate file When downloading a project s target file or load module file the program creates a Motorola S format file and binary file as intermediate files On the other hand when downloading a Motorola S format file or Intel HEX file the program creates only a binary file These intermediate files are created in the same directory as the directory containing the specified file but are not deleted If the file size is large be careful about the intermediate file size Disabling of breakpoints The FLASH loader temporarily disable
70. administrator when setting the IP address and a port address etc E Setting LAN interface at PC side 1 Install the TCP IP protocol in network setting dialog on Windows 98 Windows Me Windows NT 4 0 or Windows 2000 Windows XP Install the TCP IP protocol Click Control Panel Network to set a TCP IP protocol in Windows 98 Windows Me or Windows NT 4 0 Click Control Panel Network and Dial up Connections Local Area Connection to set a TCP IP protocol in Windows 2000 Windows XP Add the IP address assigned to the emulator to the HOSTS file Add the following items IP address Host name For Windows 98 or Windows Me the IP address and host name are in the Windows directory For Windows NT 4 0 or Windows 2000 Windows XP the IP address and host name are in SYSTEM32 DRIVERS ETC Users with administration authority must set the address and name Register the emulator port address and service name in the SERVICES file At the default 5001 is the emulator port address and fjicesv is the service name Register the following items fjicesv 5001 For Windows 98 or windows Me the port address and service name are in the Windows directory For Windows NT 4 0 or Windows 2000 Windows XP the port address and service name exist in SYSTEM32 DRIVERS ETC Users who possess an administrator authority must set these address and name 377 APPENDIX E Setting LAN interface at emulator
71. be set vary depending on the selected items When two or more items are selected they can be changed at a time If the items of different types are selected only overlapped items can be set Project The General items MCU items common options Compiler Assembler Linker Librarian and Debug items can be set C C source file The General items and individual options C C Compiler can be set Assembler source file The General items and individual options Assembler can be set Library file The General items can be set Object file The General items can be set Relative file The General items can be set Folder All files in the folder are set Figure 4 5 7 Multiple Configuration Dialog Project Configuration 200 CHAPTER 4 MENUS E Setting Items The following items can be set or changed in tab form General The project type target name output directory and file building are set MCU The items regarding the MCU such as the chip type and target MCU are set C C Compiler The C C compiler options are set Assembler The assembler options are set Linker The linker options are set Librarian The librarian options are set Converter The converter start and converter options are set Debug The debug options and debug setup information are set 201 CHAPTER 4 MENUS 4 5 5 1 General This section explains the items
72. bit Intel HEX format f2hs Converts the absolute format load module of linker output to an HEX format Data at addresses 0 to OXFFFFFFFF is converted Set the following items as required Common Options Outputs start message V Control of default option file Xdof Options for Motorola S format f2ms Output file format None Outputs data in mixed S1 S2 and S3 records according to the data address Output file format S1 record 16 bit address S1 Outputs data in an S1 record in an allowable output range of 0x0000 to OxFFFF Output file format S2 record 24 bit address S2 Outputs data in an S2 record in an allowable output range of 0x000000 to OxFFFFFF Output file format S3 record 32 bit address S3 Outputs data in an S3 record in an allowable output range of 0x00000000 to OxFFFFFFFF Adjust adjust Automatically calls the Format Adjuster to adjust a data output format 241 CHAPTER 4 MENUS 242 Output range ran Specifies the range to be adjusted by an address when selecting the option adjust for adjusting an output file Selecting Auto will obtain the starting ending address for adjustment from the absolute format load module to set automatically Padding data p When selecting the option adjust for adjusting an output file the area of the file where no data exists is packed with data having a specified value Options for 32 bit Intel HEX format f2hs Output
73. can be set when the project file is selected singly The project type cannot be set for each configuration Target File Name Set the main file name of the target file This item can be set when only project two or more items may be set is selected Target File Directory Set the directory of the target file This item can be set when only project two or more items may be set is selected Object File Directory Set the output directory of the object file output in compiling or assembling This item can be set when only project two or more items may be set is selected List File Directory Set the output directory of the list file output in compiling assembling or building This item can be set when only project two or more items may be set is selected 203 CHAPTER 4 MENUS 4 5 5 2 MCU This section explains the items that can generally be set in the Setup Project dialog Setting of MCU 1 Click the MCU tab in the Setup Project dialog 2 Set the following items as needed Chip Classification Target MCU Mode pin Bus mode Bus width MCU change Set CPU Information Figure 4 5 9 Setup Project Dialog MCU Setup Project MB31301 v sample prj MBS1V240 v automatic xl Intemal ROM external bus r jor 0 g _ ome Chip Classification Selects the type of chip Target MCU Select the target MCU of the ch
74. comparison is started from this address End Address Specifies end address of comparison source area Memory block comparison is continued up to this address Target Address Specifies start address of comparison destination area Figure 4 4 10 Comparison Dialog Start address 0000000 End address 0000058 Close Target address 0 0000 Split window horizontally For example when 4 is specified as the skip byte count addresses are skipped for each 4 bytes like address 4 and address 8 and the search range is searched Example Suppose the data in memory is 00000000 01 02 03 01 02 01 02 03 04 01 01 02 03 When Data Type is Byte Search Data is 01 and Skip Byte Count is 1 all search data is found However when Skip Byte Count is 2 only 01 search data at address 00000000 and 00000004 is found 01 search data at other addresses is not found When Data Type is Byte Search Data is 01 and 02 and Skip Byte Count is 3 only 01 and 02 search data at address 00000000 and address 00000003 is found 01 and 02 search data at address 00000005 and address 00000004 is not found 163 CHAPTER 4 MENUS B Edit To edit memory data click the right button of the mouse in the memory window to display the menu then select Edit from the menu The edit dialog shown in Figure 4 4 11 opens Address Specifies address to edit Data Specifies memory data to rewrite Type Specifies size
75. configuration of the currently selected project to create a target file Delete The selected folder and all files in the folder are deleted from the project The files themselves are not deleted If the files RCR files that cannot be deleted are included the folder is not deleted Property Information on folders is displayed see Section 4 3 9 Property Shortcut menus Click the right button of the mouse on a Dependencies category Figure 3 4 10 shows a shortcut menu Figure 3 4 10 Shortcut menu on a Dependencies category Make Build Property e Make Build Making or building is performed in the active configuration of the currently selected project to create a target file Property Information on folders is displayed see Section 4 3 9 Property 47 CHAPTER 3 WINDOWS E Shortcut menus Click the right button of the mouse on a Debug category 48 Figure 3 4 11 shows a shortcut menu Figure 3 4 11 Shortcut menu on a Debug category Add Setup gt Property When selected the following two submenus are displayed Add Setup New When selected the Create New Setup dialog Fig 3 4 5 is opened Enter the setup name and click the OK button When the setup name is entered the setup wizard is started For details about the setup wizard See Section 4 7 2 5 Setup Wizard Reference When selected the Create New Setup dialog Figure 3 4 12 is opened Enter the setup
76. created under a default name of Debug In SOFTUNE Workbench the project configuration is created as follow Creating project configuration on settings of existing project configuration A new project configuration is created on the settings of the selected existing project configuration In the new project configuration the same files as those in the original project configuration are always used E Creating Project Configuration on Settings of Existing Project Configuration 1 Select Project Project Configuration Add and Delete 2 Select the project to which a project configuration is added When the Add and Delete Project dialog is opened select the project to which a project configuration is added 3 Click the Add button Click the Add button Then the Add Project Configuration dialog is opened 4 Enter the project configuration name Enter the unique name of a new project configuration The characters that can be used to form a name are a to z to Z 0 to 9 5 Select the project configuration to which settings are copied Select the initial settings of a project configuration to be added The selected settings of the project configuration such as tool options file configurations and configurations of subprojects to be built are copied as they are 6 Click the OK button Click the OK button in the Add Project Configuration dialog and the OK button in the
77. customize bar the button of the registered number is enabled when the Debugger is started Also currently registered items are displayed by moving the mouse cursor over any button in the tool bar B installing Customize Bar Apply a check mark to the Customize Bar in the dialog box Fig 5 1 2 that is displayed when installing SOFTUNE Workbench to install the customize bar Note that you can also install only the customize bar if it was not installed when you installed SOFTUNE Workbench 345 CHAPTER 5 Add in Module Figure 5 1 2 Dialog Box Displayed When Installing FR Family SOFTUNE Workbench Setup Select Components Choose the components Setup will install El SOFTUNE Workbench oo SOFTUNE Workbench Ev Customize Bar When the customize bar is installed the Customize is added to the SOFTUNE Workbench View menu Figure 5 1 3 and a tool bar Figure 5 1 1 for the customize bar is displayed 346 CHAPTER 5 Add in Module 5 1 2 Customize Bar Menu This section describes the customize bar menu B Customize Bar Menu There are two submenus in the Customize Bar Setting View Registers batch files and Workbench menus in the customize bar This menu is enabled when opening a workspace to start debugging Switches to view hide the tool bar for the customize bar This menu is always enabled when SOFTUNE Workbench is running Figure 5 1 3 Customize Bar Menu SOF ur NE
78. debugging after project creation Start SOFTUNE Workbench in the debugger mode that is already set To change the type of the debugger select the Debug End Debug menu to terminate debugging once then change the type with the Project Setup Project menu Automatic downloading of monitor program In case the MB2198 emulator is used the debugging environment is determined from the emulator type and version etc of the downloaded monitor program when proceeding to the debug session to download the optimum monitor program automatically Appendix B Downloading Monitor Program Loading the target program When SOFTUNE Workbench enters the debug session select Load target file from the Debug menu to load the target program The created program is loaded to the debugger and all debugging preparations are now completed il Operating the debugger For how to operate the debugger see CHAPTER 3 WINDOWS and CHAPTER 4 MEN US in this manual For debugger commands and debugger output error messages refer to the SOFTUNE Workbench Command Reference Manual For the debugger functions MCU common function and MCU chip dependency function refer to the SOFTUNE Workbench Users Manual 29 CHAPTER 2 OPERATION 2 12 Executing Debugging Only SOFTUNE Workbench can be used as the conventional debuggers E Creating a project In SOFTUNE Workbench projects are a basis of all work This is not an exception also at debuggin
79. dialog box 208 1 Click MCU change button The MCU change dialog box shown in Figure 4 5 14 opens From Current file choose the CPU information to be used If a CPU information file to be used is not found add it with the Add button for CPU information file list The MCU list for the selected CPU information file appears in Chip and Target MCU Choose the MCU to be changed from the Chip and Target MCU and click OK button The change you specified takes effect Figure 4 5 14 MCU change dialog box MCU change x Curent file _ D Softune6 Lib 9114911 csv Chip Target MCU EU FR weswvoe v CPU information file list D Softune6 Lib 9114911 csv Current file Choose the CPU information file to be used The MCU list for the selected CPU information file appears in Chip and Target MCU Chip Choose a chip type Target MCU Choose a target MCU for the chip type that is chosen from the Chip area CPU information file list Lists the registered CPU information files Add Adds a CPU information file Delete Deletes a CPU information file that is chosen from the CPU information file list Note that the files are retrieved default cannot be deleted 4 5 5 3 CHAPTER 4 MENUS Setting C C Compiler Options This section explains how to set C C compiler options E Setting C C compiler options 1 2 Click the Compiler tab fr
80. dump value directly When a character string is entered from the ASCII character string display field the ASCII code of each character is set automatically in the corresponding address The address where the memory dump is to be started can be changed by changing the address field display CHAPTER 4 MENUS Add bookmark Please click on the right button on memory window to display shortcut menu Then select Add bookmark Add bookmark Dialog will be displayed Figure 4 4 5 Figure 4 4 6 Figure 4 4 5 Add Bookmark Dialog Address Add bookmark pomum me oi s H 00014090 H 00014090 Figure 4 4 6 Add Bookmark Dialog Symbol Add bookmark z E target 0 Bookmark name To specify the name of bookmark Default will be changed as follows depending on setup made in Area If the Area is Address Start address If the Area is Symbol Variable name Color To specify the color of background in bookmark Area To specify the method for determining the address range of bookmark Address Specify with start address or end address Symbol Specify the address range with the name of symbol 159 CHAPTER 4 MENUS Start address To specify the start address of bookmark End address To specify the end address of bookmark Variable name To specify the name of symbol for setting a bookmark il Searching memory data Click the r
81. eeeeneennnn 237 INDEX When a section is allocated to the specified ROM RAM 235 RAM Checker RAM Checker teer eie tar teris 188 RAM Checker 97 Realtime memory window Realtime memory window 93 182 Recent Text File Recent Text 121 Recent Workspace File Recent Workspace File 121 Refresh all windows Refresh all windows 336 Refresh window Refresh 335 Register Adding registers 77 Changing register values 156 Deleting registers 78 Register epo 156 amp iieri acticin 374 Restoring registers to the initial status 78 Register batch file How to register batch file 351 Register display Setting register 77 Register name Register name flag name 11 Register Window Register 75 Register Workbench Menu How to Register Workbench Menu 353 Replace Replace uis aae 128
82. error message Figure 5 1 12 is displayed when you click Add without entering a machine name in the Entry when registering the Workbench menus in the customize bar See section 5 1 3 2 Registering Workbench Menus Figure 5 1 12 Error Message 2 Softune911 Ed IN Please select Function on the list 355 CHAPTER 5 Add in Module 5 1 5 Note This section describes the precautions for using the customize bar B Note 356 The customize bar cannot be used when the Debugger is not running When starting the Debugger the previous settings are restored and the customize bar buttons are enabled The registered contents of the customize bar are saved for each setup information If the kind of Debugger is changed you must reregister items in the customize bar When quitting the Debugger and the setup file was not saved the registered contents of the customize bar will not be saved For that reason when restarting the Debugger the registered contents of the customize bar will not be restored When registering batch files in the customize bar input the relative path or the absolute path from the current directory project directory for the batch files When registering batch files in the customize bar always use a comma to separate parameters when specifying multiple parameters This is the same for the Parameter Setting dialog box Figure 5 1 6 CHAPTER 5 Add in Module 5 2 FLASH Loader
83. file format None Outputs data in mixed HEX8 HEX16 and HEX32 according to the data address Output file format HEX8 16 bit address 116 Outputs data in HEX8 format in an allowable output range of 0x0000 to OXFFFF Output file format HEX16 20 bit address I20 Outputs data in HEX16 format in an allowable output range of 0x00000 to OXFFFFF Output file format HEX32 32 bit address I32 Outputs data in HEX32 format in an allowable output range of Ox00000000 to OxFFFFFFFF Adjust adjust Automatically calls the Format Adjuster to adjust a data output format Start address record output entry Outputs the starting address record The starting address record will be used as a starting address for loading at the time of debugging Output range ran Specifies the range to be adjusted by an address when selecting the option adjust for adjusting an output file Selecting Auto will obtain the starting ending address for adjustment from the absolute format load module to set automatically Padding data p When selecting the option adjust for adjusting an output file the area of the file where no data exists is packed with data having a specified value CHAPTER 4 MENUS Figure 4 5 37 Converter Option Setup Dialog Box Setup Project Iv HEX32 32 bitaddress Em The macro description can be used to describe options For the macro description refer to Section 1 11 Mac
84. file using the existing file name Save dialog box The save dialog box is used to save the file using the existing file name The text file workspace file binary file alias file or setup file can be selected from this dialog box as the type of file If SOFTUNE Workbench is not in the debug session the binary file alias file and setup file are not displayed Figure 4 2 5 Save Dialog Box iss Cancel 117 CHAPTER 4 MENUS 4 2 7 Save As Save As stores the previously saved file under a new file name E Save As Save As stores the previously saved file under a new file name The text file output window project file binary file alias file or setup file can be selected as the type of file If SOFTUNE Workbench is not in the debug session the binary file alias file and setup file are not displayed Figure 4 2 6 Save As Dialog Box der Output Window Cancel Saving the project file Save the active project file Select the format for saving the project file from the File Type combo box For the project formats refer to Section 1 2 Management Function for Project of SOFTUNE Workbench User s Manual If you select workspace project format prj it saves all project information in workspace project format compatible to workspace When the project file opened in old project format is overwritten in workspace project format conversion is performed and restrictions on old project files
85. instruction where breakpoint is set to be enable or disable click right button to see the shortcut menu Then please select Breakpoint Enable Disable This enables to switch the breakpoint which is pointed by cursor enable or disable Activate when stop Specify whether the disassemble window should set to active or not when the program is stopped However if a disassemble window is displayed as new it should always be activated Please operate with following procedure 1 Click a right button of the disassemble window to display the shortcut menu 2 Please make sure Activate when stop 74 CHAPTER 3 WINDOWS 3 10 Register Window This window is displayed only when SOFTUNE Workbench is in the debug session The register window is used to display and modify MCU register values during debugging E Register Window Figure 3 10 1 is an example of the register window When debugging register values can be displayed The register values can be rewritten directly To rewrite values using expressions and symbols etc select Edit from the shortcut menu for the register window Arrange registers according to the size of the register window To select the registers to be displayed select Setup from the shortcut menu for the register window Figure 3 10 1 Example of Register Window ee Register fife X Register names and values are 00070007 R1 000F02F4 R2 000F82F4 00000000 R4 0000EEEE R5 CF40BE8 000000CC R7
86. is to be started then click the OK button Figure 4 4 1 Dialog Box for Specifying Display Start Address Type Address Position main Cancel Window assembly Y Specify the type of display start position Line number Address Frame Position Display disassembling from the position specified in the above type Window To specify the window where jump is implemented For details see Section 4 3 6 Jump If it is a disassemble window default will be shown as Assembly CHAPTER 4 MENUS B Inline assemble Selecting Inline Assemble from the shortcut menu opens the line assemble dialog shown in Figure 4 4 2 Figure 4 4 2 Inline Assemble Dialog Box ue B Code data 0000 Mnemonic 0 R13 A0 R0 Writing a mnemonic in the Mnemonic edit box and clicking the Update button assembles and sets the mnemonic starting from the start address The start address subsequently advances to the next address To change the address where the mnemonic is to be written change Start Address When mnemonic change is completed click the Close button 155 CHAPTER 4 MENUS 4 4 4 Register Register displays the register window E Register When the register window is opened the selected target MCU register name and each register retention value are displayed This function command can be used only when SOFTUNE Workbench is in the debug session Selecting
87. l ETE AE EE EE EE O EES TE 284 4 06 11 CVOCIOI Sres redii A E e E E resi rid e A O 285 4 6 12 Load Target File einen i ueste eee de Dep d pedet eee EA deine 287 4 6 13 Start Debug End Debug 288 4 7 SIME E 289 4 7 1 Development te ree tate ea ten de Date dtes bo eee ter ue 290 4 7 2 Debug Environment io ene og iet tnit eae 293 4 7 8 Memory je 319 ATA iinet sn ntti E eum he ge Ag mime uestem dita 320 4 7 5 Keyboard M 323 4 7 6 cei UC 325 4 7 7 e EIL MIELE IE 328 4 7 8 ees 330 4 8 VIFICOWA 331 4 8 1 Cascade Vertical HorizOr d eee a re ee dne dre Ev el a n e a 332 4 8 2 S eI II MEM 333 4 8 3 Arrange ICONS mins nep eet et eee Eea a eee edie eine 334 4 8 4 Retresh WindOoW iret oe ete petit edo erg tdeo haec un etg eg eade tle 335 4 8 5 auc EE 336 4 8 6 Close AIL WIDdOWS eoe eter ee eec pet eren 337 4 9 Help snnm L eu cn 338 vii 4 9 1 a 339 4 9 2 Support Informiatioti oerte dt e detinent 340 4 9 3 oe cp 341 CHAPTEH 5 Add in Module teure urina bn Yan nana na naga nasus 343 5 1 Gustomlize Bat ibt o e
88. memory area menu is displayed CHAPTER 4 MENUS Setup display To set the display format for the realtime memory window click the right button of the mouse on the realtime memory window to display the menu and then select Setup to display the display setting dialog Figure 4 4 28 Display format The display format for the window is specified Select from bit byte halfword word and doubleword ASCII Whether or not to display ASCII characters on the right side of the window is selected Figure 4 4 28 Setup Display Dialog Setup display Byte v Iv 501 Cancel E Area setting To set the display area for the realtime memory window click the right button of the mouse on the realtime memory window to display the menu and then select Setup Area to display the Setup Debug Environment Realtime memory area menu Note In this function the modifiers that can be specified vary depending on the emulator or its connection conditions For details refer to SOFTUNE Workbench USER s MANUAL Real time Monitoring 183 CHAPTER 4 MENUS 4 4 13 Performance Performance displays the Performance Window E Performance Window Open the Performance Window to display the performance measurement result The Performance Window is used to control and set the performance BB Performance Mode Set Select Setup from the shortcut menu of the performance window Figure 4 4 29 Per
89. memory when data is written to memory by a command TRIG Input Specifies whether to enable or disable TRIG pin input MCU Mode Specifies an MCU operation mode When the debugging system does not have any MCU operation mode it does not appear on this dialog box Specify instruction cache size Sets whether to automatically flush instruction cache When the evaluation chip does not have this cache this control does not appear Auto Flush Data Cache Sets whether to automatically flush data cache When the evaluation chip does not have this cache this control does not appear CHAPTER 4 MENUS Break Only Emulator debugger Figure 4 7 13 Debug Environment Setup Dialog Box Break Setup debug environment e Default Break Point Specifies the default type of the code breakpoint Alignment Error Break Specifies whether to suspend MCU execution when an alignment error occurs 303 CHAPTER 4 MENUS RFCR DSU2 Figure 4 7 14 Debug Environment Setup Dialog Box RFCR Setup debug environment RFCR Register Auto Control Specifies whether to set the RFCR register value automatically Set Value Before Specifies the value to be set in the RFCR register during execution Set Value After Break Specifies the value to be set in the RFCR register during break 304 CHAPTER 4 MENUS Frequency DSU3 DSU4 Figure 4 7 15 Debug Environment Setup Dialog Box Fre
90. of a breakpoint at the specified address This button is only enabled for FR60Lite For details see Section 4 6 4 1 Breakpoint details setting Event List button This button is used to display the event list for checking the setting of all events This button is enable for FR60Lite when Hardware datawatch is selected for breakpoint type Enable button This button is used to enable the breakpoints in the breakpoint list currently being selected Disable button This button is used to disable the breakpoints in the breakpoint list currently being selected The breakpoints are simply disabled that is the setting itself of the breakpoints is not cancelled Delete button This button is used to delete the setting of the breakpoints in the breakpoint list currently being selected All delete button This button is used to delete the setting of all the breakpoints in the breakpoint list Change button This button is used to change the setting of the breakpoints in the breakpoint list currently being selected This button is not displayed for MB2197 CHAPTER 4 MENUS E Data breakpoint A breakpoint to stop the program when data at the set address is accessed is called the data breakpoint The data breakpoint is not supported for MB2198 and MB2197 This function can be used only when the FR60Lite is used E Setting of data breakpoint Figure 4 6 3 Break Dialog Box Data Emulator Debugger s
91. of data to rewrite Byte Halfword Word DoubleWord Figure 4 4 11 Memory Edit Dialog Edit memory data x Address 00000018 Data H FF Close Type Byte E Display setup To set the display format of the memory window click the right button of the mouse in the memory window to display the menu then select Setup from the menu The display setup dialog shown in Figure 4 4 12 opens Display format Specifies display format of memory window Bit byte halfword word Doubleword can be selected Display Format Selects whether to display ASCII characters at right of memory window Columns To specify the number of bytes display in a line The number of bytes can be chosen from Automatic 4byte 8byte 16byte 32byte or 64byte Figure 4 4 12 Display Setup Dialog Box Le Columns Automatic Cancel ASCII 164 CHAPTER 4 MENUS 4 4 6 Local Local displays the local variable window Local Variable Window The local variable window displays in tree format the local variables of the function where the current instruction pointer exists using the function name as the root The displayed variables cannot be added nor can the displayed variables be canceled The variable values modified as a result of program execution are updated automatically For this reason the user can observe how variable values change as a result of program execution Variable values can als
92. options For the macro description refer to Section 1 11 Macro Descriptions Usable in Manager of SOFTUNE Workbench User s Manual 219 CHAPTER 4 MENUS E Setting General Options 220 Figure 4 5 22 General Option Setup Dialog Box Setup Project west i mes Source Files 0 sample c E startup asm The following options can be set from the general option setup dialog box Outputs start message V Outputs debug information g Control of default option file Xdof Warning Level w Level 0 to 3 Select Warning Level from the drop down list In Other Option all assembler options can be written like start up options from command lines Write the options that do not belong to any assembler option setup categories directly in Other Option CHAPTER 4 MENUS E Setting a macro name Figure 4 5 23 Macro Name Setup Dialog Box General MCU C C Compier Assembler Linker LL Category Define Macro Common Value 10 Macro Name List Set Delete TEN 10 Target of setting 1 01 1 55 Source Files sample c 8 startup asm If there are two or more items to be set the macro name found in some item is grayed 1 Select the Define Macro category The macro name setup dialog box shown in Figure 4 5 23 opens 2 Specify a macro name 3 Specify a
93. project start up the setup wizard Select emulator by emulator type click Next button Check displayed monitoring program automatic loading check box 5 a Execute the debug menu in the Start debug The emulator debugger will startup Monitoring program automatically downloads in Installation Directory VLIBV911V This will automatically load the monitor program to the emulator at the beginning of debugging When load quits message dialog boxes Load quit correctly is displayed If click OK button then start debug 3 b Execute the Monitor Loader menu in the SOFTUNEV6 FR Family SOFTUNE Workbench Tool in your Windows start menu The monitor loader program will startup 4 b Select the monitor program to be loaded Select the monitor program corresponding to the chip to be used 5 b Specify a communication type To use the RS 232C interface specify a communication port and a baud rate Touse the LAN interface specify the host name of the emulator 6 b Click on Start Load This will load the monitor program to the emulator 7 b Select Exit from the File Menu to quit the monitor program Note Monitor program increase in the MB2198 emulator For further details see release note in CD root directory 376 APPENDIX C Setting LAN Interface APPENDIX Setting LAN Interface To enable LAN communication the LAN interface must be set at the PC and emulator sides Consult the LAN
94. register indirect is selected Address In this field the address condition at the time of data watch is set The offset value is specified when register indirect is specified Size byte halfword word The data size at the time of data access is specified Data In this field compare data at the time of data watch is set Note When using the monitoring function do not set Data watch condition The error message Command error MCU is busy appears when the monitoring function is used after setting the data watch condition 268 CHAPTER 4 MENUS E Details of code breakpoint Debug type Hardware count Figure 4 6 6 Code breakpoint details dialog Hardware count Code break point details x Break address 00000000 Address mask HFFFFFFFF Cancel Pass count o Watch condition Data watch condition i e Break address In this field the address that sets a breakpoint is specified Address mask In this field the mask value for specified address is specified Pass count In this field the count of times access with the specified attribute is to be made to that point a particular point before causing a break is set Watch condition When the check mark is entered in the box for Data watch condition will be enabled Data watch condition The data watch condition is set The dialog given in Fig 4 6 5 is displayed Note This function can be used only when the FR60Li
95. selectable project types and their explanation 5 Select the chip type and target MCU Selectable values are indicated in the drop down list Select the chip and target MCU from the list 6 Enter the project name Enter the project name This name can be used as a project file name At default it is also used as a target file name and project directory the target file name and project directory can be changed 7 Set project dependence When defining a project as a subproject in another project place a check mark in the Project Dependence check box and select the project name from the list in the Project Dependence check box 8 Click the OK button e Debug Debug ABS Debug OBJ Debug LST or Debug OPT is created as subdirectory in the project directory Debug A directory to store information for each project configuration The default configuration name as a new project is created is Debug ABS Directory in which the target file is stored OBJ Directory in which the object file is stored LST Directory in which the list file is stored OPT Directory in which the option file to start the language tool is temporarily stored CHAPTER 2 OPERATION When REALOS is selected as the project type the Setup Wizard of the configurator opens For details refer to the manual accompanying SOFTUNE REALOS Table 2 4 1 Project Types Project type Explanation Absolute format ABS An ordinary p
96. setup dialog box from the Setup Development menu and set environment variables and projects For details on how to set environment variables and projects see Section 4 7 1 Development The environment variables set from this dialog box are referred by language tools such as the C C compiler B Designing a project Set information for the program to be developed in a project When developing a new project open the new creation dialog box from the File New menu and select Workspace Project File from the dialog box The new project creation dialog box opens When the project already exists the existing project file can be opened from the File Open Workspace menu When using the SOFTUNE VO1 or V02 project file see Section 2 13 Reading SOFTUNE Project Files of Old Versions E Creating a program source and executing make build Open the new creation dialog box from the File New menu and select Text File When the editor is started write the source program and save it to the file with the File Save As menu When a necessary source file is created register it in the project with the Project Add Member menu When registering the source file in the project is completed execute make with the Project Make menu or execute build with the Project Build menu If a syntax error occurs during compilation or assembling double click the error display location in the Output Window with the lef
97. side In case of MB2197 emulator this procedure is following 378 1 2 3 8 9 Connect the emulator to the PC with the RS 232C interface Turn on the emulator Execute the LAN Address menu from SOFTUNE V6 FR Family SOFTUNE Workbench Tool of the start menu The LAN address setup program is started Click Set Communication to set the RS 232C interface Click Read to read the current emulator setting status Set IP Address and Port Address The IP address and port address set at the PC side are displayed Usually Universal is used as MAC Address However when using Local as MAC Address consult the LAN administrator Select Exit from the Setup menu to exit the LAN address setup program Press the emulator reset button button on rear to reset the emulator In case of MB2198 emulator this procedure is following 1 2 3 Connect the emulator to PC with the RS 232C or USB interface Turn on the emulator Execute the LAN Address menu from SOFTUNE V6 FR Family SOFTUNE Workbench Tool of the start menu The LAN address setup program is started Click Set Communication to set the RS 232C or USB interface Click Read to read the current emulator setting status Set IP Address SubNet Mask and Port Address The IP address SubNet mask and port address set at the PC side are displayed Usually Universal is used as MAC Address However when usin
98. start address of the specified write area 365 CHAPTER 5 Add in Module 5 2 2 5 FLASH erase Erases FLASH memory E Function This menu erases FLASH memory To specify the area to be erased use the Load Environment Setting Dialog Box see 5 2 2 6 Setting of Environment to load 366 CHAPTER 5 Add in Module 5 2 2 6 Setting of Environment to load Specifies the FLASH memory area where data is downloaded or erased is specified B Function This menu specifies the FLASH memory area where data is downloaded or erased It also displays the area for the resource used by the FLASH loader Figure 5 2 4 Load Environment Setting Dialog Box MCU MBSIFV150 FLASH memory Area Start Address 0080800 End Address OxOFFFFF r Internal RAM Area DATA Start Address p 000 End Address oxerrr CODE Start Address ox80000 End Address Ox807FF i Cancel MCU Displays the selected MCU Cannot be changed FLASH memory area Specify the FLASH memory area to be written or erased The area selected here becomes effective for all functions other than Load specified file The combobox displays all the start or end addresses of the sector area in FLASH memory At default it displays all FLASH memory areas This information is restored when the Debugger is restarted Start address Specify the start address of the FLASH memory area to be written or erased End address Specify the end
99. start position for displaying a source window to location of bookmark selected in bookmark list Setup or cancel of a bookmark 1 Please put a cursor to line where you want to set or cancel a bookmark 2 Please execute any of following operations Select Edit Bookmark Setup cancel bookmark Click on Setup cancel bookmark at toolbar Find Add or delete bookmark to from Source tab in dialog bookmark E Move the caret to the next bookmark 1 Please make sure that there is a cursor in a source window 2 Please execute any of following operations Select Edit Bookmark Subsequent bookmark Click on Subsequent bookmark at toolbar Find 3 If no subsequent bookmark is exist on a window proceed to the subsequent bookmark located on the next file Bi Move the caret to the previous bookmark 1 Please make sure that there is a cursor in a source window 2 Please execute any of following operations Select Edit Bookmark Previous bookmark Click on Previous bookmark at toolbar Find 3 If no previous bookmark is existed on a window proceed to previous bookmark located on the last file E Move the caret to the next bookmark in the current window 1 Please make sure that there is a cursor in a source window 2 Please execute any of following operations Select Edit Bookmark Next bookmark in the current window Click on Next bookmark in the current window at toolbar Find Bi Mov
100. that can generally be set in the Setup Project dialog E Setting of General 202 1 Click the General tab in the Setup Project dialog 2 Set the following items as needed Remove this file from target of Build Project type Targetfile Name Output Directory Figure 4 5 8 Setup Project Dialog General Setup Project LX General mcu C C Compiler Assembler Linker 01 Target of setting 831301 Remove this fle from terget of build Sy Source Files Project 5 sample c D Softune6 sample 91 1 Project sample prj startup asm Project Type Loadmodule AB5 ba Targetfile Name sample abs Dutput Directory Targetfile Directory Mest 301548655 Browse Objectfile Directory ves 301 0BJ Browse Listfile Directory MBSISONLSTN Browse Cancel Apply Remove this file from target of build The file selected in the tree view is removed from the make build target This item can be set when C C source file assembler source file library file object file or relative format file is selected Project The full path to the project file is displayed CHAPTER 4 MENUS Project Type Set the type of project file selected in the tree view absolute format ABS relative format REL library LIB If the REALOS ABS type is selected the project type cannot be changed This item
101. the debug session Version information display when SOFTUNE Workbench is not in the debug session 341 When SOFTUNE Workbench is the debug 858 122 Window display debug session 151 Debug bar Debug Darii trei Saiten 38 Debug environment Debug environment setup procedure 299 Debug mode Selection procedure of the debug function debug mode 316 Debug session Debug session 130 412 Debugger Changing debugger setup 246 Debugger control when SOFTUNE Workbench is in the debug session 258 DebUgGgoetrs ette epe eur etate une 2 Deleting debugger setup 246 Display error at emulator debugger 386 Operating the 29 Procedure when the emulator debugger is selected en 317 Procedure when the monitor debugger is selected en 318 Procedure when the simulator debugger is selected en 318 Setting the debugger mode environment CRM MERE EUR 289 Settings related to the debugger 30 When monitor debugger cannot be controlled CERES 385 Debugger mode Setting the debugger mode environment mI 289 Debugging End debugging 288 Executing debugging
102. the file dialog box for asking the operator to enter the name of the file to be saved opens Specify a file name from this dialog box 119 CHAPTER 4 MENUS 4 2 9 Print Print prints file data E Data to be printed 120 Print prints data in the file currently open in the edit window it cannot print other window file data Print output window data in any of the following two procedures Copy output window data to the edit window and print it Copy output window data to the edit window in the following procedure then select Print from the File menu 1 Select all output window data 2 Click the right button of the mouse to display the menu then select Copy 3 Open the edit window then select Paste from the Edit menu Q Save output window data once then print it For how to save output window data see Section 4 2 7 Save As Open the saved file with the edit window then select Print from the File menu CHAPTER 4 MENUS 4 2 10 Recent Text File Recent Workspace File Of the text files opened in the source window in the debugger Recent Text File stores up to five most recently opened text files Of the used workspace files Recent Workspace File stores up to five most recently opened workspace files E Recent Text File Of the text files opened in the source window in the debugger Recent Text File stores up to five most recently opened text files This enables you to o
103. the mouse on a function name Figure 3 4 22 shows a shortcut menu Figure 3 4 22 Shortcut menu on a function name Jump Order by name Order by address Break Property Jump Opens the selected function in the source window Order by name Sort items in the tree in alphabetical order Order by address Sort functions in the tree in address order Break Opens a break dialog box to set a break point at the selected function Property Display the properties of the symbol information of the selected function Shortcut menu Click the right button of the mouse on space in the project window Figure 3 4 23 shows a shortcut menu Figure 3 4 23 Shortcut menu on space in the project window v Docking View Hide Docking View The project window is docked with the frame in the check status Hide The project window enters the nondisplay status 55 CHAPTER 3 WINDOWS 3 5 Output Window The output window displays compiler version information and error messages etc when make or build is executed Bl Output window Figure 3 5 1 is an example of the output window As shown in this example when the left button of the mouse is doubleclicked on the line to which an error message was output control automatically jumps to the source line where the error occurred Figure 3 5 1 Example of Output Window Tool start message e g version and copyright startup dsm sample c Now lin
104. to which the configuration is added is displayed Configuration name Setthe name of the project configuration to be added Acopy of setting Select the configuration to which settings are copied E Setting Procedure For the setting procedure see Section 2 7 Creation of Project Configuration 254 CHAPTER 4 MENUS 4 5 8 2 Project Configuration Configuration at Build The configuration as a subproject is make or build is set E Project Configuration Configuration at Build Figure 4 5 45 Set Configuration when Building Dialog Box Set Configuration when building x Project sub prj Configuration Debug EE Configuration of sub project when make build E sub prj E E sample prj 1 154 9 MB91301 Project Select the parent project of a subproject Configuration Select the configuration of the parent project selected in Project Configuration of sub project when make build Select the configuration of the subproject as the configuration of the parent project selected in Configuration is made or built E Setting Procedure For the setting procedure see Section 2 10 1 Making or Building of Project 255 CHAPTER 4 MENUS 4 5 9 Include Dependencies Include Dependencies updates include file dependency Bi Include Dependencies This command function checks all the source files in the project file and registers all the include files being used b
105. trigger hit is specified Address mask The mask value for the specified address is specified Size byte halfword word The data size at the time of data access is specified Attribute The attribute at the time of data access is specified Don t care size A sequencer transition condition is applied when the specified address is accessed regardless of the access data length Comparison condition The data comparison condition is specified Disable No data is specified for the transition condition Data agreement Data agreement data agrees with the specified data is specified for the transition condition Data NOT Data mismatch data does not agree with the specified data is specified for the transition condition CHAPTER 4 MENUS Data In this field data at time of data access is specified Data mask In this field the mask value for the specified data is specified Note This function can be used only when the FR6OLite is used For details refer to SOFTUNE Workbench USER s MANUAL Control by Sequencer 279 CHAPTER 4 MENUS 4 6 7 Stack This section explains a SOFTUNE Workbench call stack E Call stack Usually a program is a set of several subroutines For this reason as debugging advances function calls of several stages occur For example one routine calls another and the called routine further calls another The call stack retains the relationship between function calls C
106. user NMI is issued by pressing the ABORT switch on the user hardware This design enables the running program to be aborted externally Prepare this hardware 381 Target system creation procedure The target system creation procedure is given below Figure E 2 shows the flow for creating the target system Create and assemble the initialization routine I O drivers and vector table according to the specifications of the hardware to be used 2 Link the object file created in 1 to the debugger body mod91 1 rel 3 Convert the absolute format debugger file created in 1 in the Motorola S format or Intel HEX format 4 Transfer the Motorola S or Intel HEX file created in 3 to the ROM writer When it receives the file the ROM writer writes it to ROM The monitor debug mod91 1 rel is in the following directory Installation Directory LIB 911 Figure E 2 Flow for target system creation Initialization routine source u_init asm I O driver source u_io asm vector table source 1ntv asm Version information source u_inf asm Assemble Debugger body Object file mod 911 library format Absolute format debugger file abs Convert Motorola S format or Intel HEX format ROM programmer Mounting on target system APPENDIX E Creating ROM on Monitor Debugger Target Explanation of Sample Program The SOFTUNE Workbench provides the following files as samples for the initialization
107. 0 Setup Customize Build Dialog Box Title 2 5 Execute Filename 4 Assembler 1 amp Before Option es a s Executing Directory 4 amp BSPATH Browse 4 ompiler v Enable 3 Linker Designate additional option when executing re Use output window er a Contents of the temporary file efore E After LOADMODULEFILE NAME mhx ran 5 Converter D SoftuneBABin M2B Browse f Z TEMPFILE gt OxF0000 0 FFFFF amp Before Sy After P M2BS EXE Tool button list NEW DELETE UP DOWN 247 CHAPTER 4 MENUS E Setting Target There are two types of setting targets in Target of setting default and project name See Target of setting for which one is currently set e Default When the customize build is set if no project is opened the default setting can be changed The customize build setting is referred when creating a new project and is copied to that project Default is displayed in Target of setting Note When a project created in an older version is opened this setting is also referred and copied to that project Project Name Customize build is set for the project The tool operates at compile assemble make or build for the opened project B Export The Export button is clicked to open the expo
108. 00070007 8 00070007 FBEF FDE R1O BFCASEBB R11 7FCFFEDF entering a new value 00000BD R13 000F0000 R14 784AD7736 00000008 MDH FFFFFFFF MDL FFFFFEDF FFFFFFFF PS 000F0000 PC 000801C6 FFFFFEDF SSP 00000008 CCR 0 I 0 W 0 2 0 0 displayed it can also be D1 0 Do0 0 T 0 ILM OOOFFCOO displayed A displayed register Each condition flag status is changed Note There are some registers which become inaccessible according to the value of PSR When they are inaccessible their contents are expressed by 75 CHAPTER 3 WINDOWS E Shortcut Menu There are three menus below Setup See Section 3 10 1 Setting Register Display Edit Displays register edit dialog box Close Closes register window Edit Edits register values Beside this operation the numerical values displayed in the register window can be directly edited see Section 4 4 4 Register 1 Click the right button of the mouse in the register window to display the shortcut menu then select Edit from the menu The register edit dialog box opens 2 Select a register name 3 Enter the value you want to set 4 Click the OK button 76 3 10 1 Setting Register Display This section explains how to set register display CHAPTER 3 WINDOWS E Setting register display Set the registers to be displayed in the register window in the following procedure Figure 3 10 2 Display Register Setting Dial
109. 267 When the emulator is an MB2197 375 INDEX MB2198 Details of code breakpoint For 2198 2197 267 Details of data breakpoint for MB2198 A 271 When the emulator is an 2198 376 MCU MCU reset function 261 Setting of 204 Setting of MCU change dialog box 208 When initializing Disposition Connection option based on MCU information 238 Measurement Time 281 Member Add Member seeseeee 195 Add Member 197 Add Member 196 Memory Changing memory 158 Comparing memory blocks 163 Displaying memory 158 Searching memory 160 Setting of Memory Area 25 Memory blocks Comparing memory blocks 163 Memory map Memory map setup Note The memory map setup dialog box is displayed only at simulator debugger 319 Memory Window Memory Window sss 79 Menu Menu
110. 3 9 3 Property Source Window This section explains the property in the source window E Property General Figure 4 3 16 Property Source Window General Source file x General File name sample c Directory Ds oftune6 sample 91 1 Project Browse Tab D S hd Size 1551 Byte Modified 16 03 44 Wednesday September 11 2002 File name The name of the selected file is displayed Directory Displays the directory in which the source file exists valid only when Source Window information is displayed When changed the directory is searched and the found source file is redisplayed Tab When this value is changed new value is redisplayed e Size Displays the file size Modified Displays the date and time of the last file update 147 CHAPTER 4 MENUS 4 3 9 4 Property Symbol Window This section explains the property in the symbol window E Property General Figure 4 3 17 Property Symbol Window General General Symbol struct table value 15 Scope main Storage class auto Address H 00000044 Symbol The name of the selected symbol is displayed Scope The scope position of the selected symbol is displayed Storage class The storage class of the selected symbol is displayed Address The address of the selected symbol is displayed 148 CHAPTER 4 MENUS 4 3 9 5 Property Local Window This section explains the property
111. 8888863H 0808888654H 88008865H 809008866H 000 __ n ATIU RARRAARTOU RARARATEU annnna7cu RARARATAU AR Output Port List Displays the currently specified ports E Resetting an output port 1 Select the output ports you want to reset from Output Port List 2 Click the Delete button 3 When resetting all the selected ports is completed click the Close button 297 CHAPTER 4 MENUS 4 7 2 2 Interrupt This section explains the interrupt setup procedure Bi Setting an interrupt 1 When the interrupt setup dialog box shown in Figure 4 7 8 opens set an interrupt number 2 Select a Request timing One Time or Interval can be selected 3 Set the cycle count 4 Click the Append button The set interrupt number Request timing and interrupt cycle count are displayed in Interrupt List 5 When setting all the items is completed click the Close button E Resetting an interrupt 1 When the interrupt setup dialog box shown in Figure 4 7 8 opens set an interrupt number 2 Select the interrupt you want to reset from Interrupt List 3 Click the Delete button 4 When resetting all the selected interrupts is completed click the Close button Figure 4 7 8 Interrupt Setup Dialog Box Interrupt number D 16 Request timing one time Cycle count D i Close m Interrupt list Number Request timing cycle gelere 298 CHAPTER 4 MENUS 4 7 2 3 D
112. AM Checker requires free disk space of 500MB or greater When free disk space is less than 500MB logging stops Logging start The logging status of the RAM Checker is controlled When the shortcut menu is checked the logging status is enabled When execution of the program is started with the logging status enabled log data is obtained and the monitoring is displayed on the RAM Checker window Figure 3 18 6 Enabled Logging Status Setup File Viewer v Logging Close CPU stop during logging Power on debug can be performed during execution of RAM Checker Notes 1 Set the operating lower limit voltage of your microcomputer as the lower voltage 2 The emulator outputs undefined values during the period from return from power on debug to data access During this period the Viewer does not display data 102 CHAPTER 3 WINDOWS 3 18 2 Startup of the RAM Checker Viewer This section describes how to startup the RAM Checker Viewer Startup of the Viewer The Viewer s startup dialog see Figure 3 18 7 is started up on the shortcut menu Viewer Select the log file that opens when the RAM Checker Viewer starts and click the Execute button to start up the RAM Checker Viewer see Figure 3 18 8 Figure 3 18 7 Viewer s startup dialog Base log file name TEMP SRL File list TEMP_001 SRL EET 103 CHAPTER 3 WINDOWS Figure 3 18 8 RAM Checker Viewer RAM Checker
113. APTER 4 MENUS Data In this field data at the time of data access is specified Data mask In this field the mask value for the specified data is specified Note This function can be used only when the FR6OLite is used For details refer to SOFTUNE Workbench USER s MANUAL Break Bi Details of data breakpoint for MB2198 Figure 4 6 8 Data breakpoint details dialog Data break point details x Break address H 0003CBE8 Size Byte v Data agreement Dus 00000002 Data mask H FFFFFFFF Cancel e Break address In this field the address that sets a breakpoint is specified Size byte halfword word The data size at the time of data access is specified Attribute The attribute at the time of data access is specified Data agreement When specifying the data and the data mask enter the check mark in the box for Data agreement Data In this field data at the time of data access is specified e Data mask In this field the mask value for the specified data is specified Note This function can be used only when the FR6OLite is used For details refer to SOFTUNE Workbench USER s MANUAL Break 271 CHAPTER 4 MENUS 4 6 5 Event This section explains how to set SOFTUNE Workbench events Bi Setting events Events can be set from the event dialog box shown in Figure 4 6 9 This function can be used only in the emulator debugger Code
114. Click the Delete button E Changing the include path retrieval order Include paths are retrieved in turn from top of Include Path List The order in which include paths are registered in the list can be changed in the following procedure 1 Select the Include Path category The include path setup dialog box shown in Figure 4 5 24 opens 2 Select the include path whose order is to be changed from Include Path List 3 Click the Up or Down button to move the cursor to a relevant position 223 CHAPTER 4 MENUS Bi Setting list output 224 Figure 4 5 25 List Output Setup Dialog Box Setup Project x Linker 41 x dua 2 Bern B Source Files Iv M M 1 Select the Output List category The list output setup dialog box shown in Figure 4 5 25 opens 2 To output a list file set a check mark to the left of Creates a list file When the list file is not output no other item need be set Execute Step 3 and after only when outputting the list file 3 Select the list file s you want to output Items with check marks are selected Outputs information list Outputs source list Outputs section list Outputs cross reference list Outputs include list 4 Specify whether to suppress page change When a check mark is set to the left of Control of changing page page change is suppressed When page change is suppressed the line coun
115. Click the Delete button E Setting an include path Figure 4 5 17 Include Path Setup Dialog Setup Project Assembler Include Path GI rae NV S3115Ssyslib Nm 1 Select the Include Path category The include path setup dialog shown in Figure 4 5 17 opens 2 Specify the include path Clicking the Brows button to the right of the input field enables directory selection 3 Click the Add button The specified include path is added to the end of the Include Path List 212 CHAPTER 4 MENUS E Resetting an include path 1 Select the Include Path category The include path setup dialog shown in Figure 4 5 17 opens 2 Select the include path to reset in the Include Path List 3 Click the Delete button E Changing the include path retrieval order Include paths are retrieved in turn from top of the Include Path List The order in which include paths are registered in the list can be changed as follows 1 Select the Include Path category The include path setup dialog shown in Figure 4 5 17 opens 2 Select the include path whose order is to be changed from Include Path List 3 Click the Up or Down button to move the cursor to a relevant position 213 CHAPTER 4 MENUS E Setting Optimize options Figure 4 5 18 Optimize Option Setup Dialog Setup Project x Assembler Linker Le MB91301 F Optimize Dorin
116. Delete Subproject Delete Subproject The subproject in the specified project is deleted To define a subproject again see Section 4 5 7 Project Dependencies Shortcut menus Click the right button of the mouse on a folder 46 Figure 3 4 9 shows a shortcut menu Figure 3 4 9 Shortcut menu on a folder Create new folder Add Member to folder gt Set Make Build Delete Property Create New Folder When selected the Create New Folder dialog Figure 3 4 5 is opened Enter the folder name and click the OK button When the folder name is entered a folder is inserted into the selected folder The folders are listed in the order in which they are created CHAPTER 3 WINDOWS Add Member to Folder When selected the following two submenus are displayed File A member is added in files to the currently selected project See Section 4 5 3 Add Member At default a member is inserted into the selected folder Directory A member is added in directories to the currently selected project See Section 4 5 3 Add Member At default a member is inserted into the selected folder e Set When selected the following two submenus are displayed Individual Setting A project is set See Section 4 5 5 Setup Project Return to Common Setting All individual options in the specified folder are returned to common options e Make Build Making or building is performed in the active
117. Error Explanation Sets the area where a read event write event or execute instruction event occurs An event occurs only upon access to the area in which an area is set Set an area by using SSDI Init Initialize If the area setting number is set to 1 the area setting address area size is valid In other cases set the attributes for the settings in the area setting numbers Set the attributes as follows attribute Write 1 Enabled 0 Disabled Read 1 Enabled 0 Disabled Execute 1 Enabled 0 Disabled To delete the area settings set the number of the area to be deleted in the area setting number and the attribute to 0 Up to 32 areas can be set If the maximum value is exceeded an error occurs Remarks APPENDIX G External I F DLL for Simulator G 19 SSDI Clear Cycle Clear cycle count Format int SSDI Clear Cycle void Argument None Return value None Explanation Initialize total cycle number managing with ISS Instruction Set Simulator Remarks 407 APPENDIX G 20 SSDI Execute MCU Execute target program Format void SSDI Execute MCU void Argument None Return value None Explanation Starts execution of program When execution of program starts it already it is ignored Remarks 408 INDEX INDEX The index follows on the next page This is listed in alphabetic order 409 INDEX Index A ABORT Program suspension
118. FR60Lite 263 CHAPTER 4 MENUS 264 Remain In this field the remaining count of settable breakpoint types currently being selected is displayed Regarding the hardware breakpoints for FR60Lite this field is displayed when the remaining count of settable breakpoint types has become 10 or fewer Also this field is not displayed for some debugger types Pass count In this field the count of times the PC passes that point a particular point before causing a break is set Breakpoint list A list of code breakpoints currently being set is displayed Status Enable or disable is displayed Type The breakpoint type is displayed Address The set address is displayed D address The set address for which data monitoring is displayed Attribute The breakpoint attribute is displayed Pass count The set pass count is displayed In the count of times the PC has passed that point by the present time is displayed Symbol The symbol or the number of the source file assigned to the address are displayed Jump button Moves a starting position for displaying the source window to the code position at the breakpoint selected from the break list Set button These buttons are used to set a breakpoint at the specified address When an address that is already set in the breakpoint list is specified the set data of the breakpoint at this address is changed Detail button This button is used to set the details
119. FTUNE V6 of FR Family SOFTUNE Workbench Tools of the start menu The monitor loader program is started 4 Select the monitor program to be loaded Select the monitor program corresponding to the chip to be used 5 Specify a communication type To use the RS 232C interface specify a communication port and a baud rate Touse the LAN interface specify the host name of the emulator 6 Click Start Load The selected monitor program is downloaded to the emulator 7 Select Exit from the File Menu to exit the monitor program Chip type Corresponding chip Monitor program MB91171 FR30 DSUI type MB91172 20DSU1 HEX MB91173 MB91V101 FR30 DSU2 type MB91174 20DSU2 HEX MB91191 FR30 DSU3 type MB91110 20DSU3 HEX 375 APPENDIX il When the emulator is an MB2198 The downloading monitor program procedure is described below Setting the monitoring program automatic loading is described 3 a 5 a setting the monitor loader procedure is described 3 b 5 b 1 Connect the emulator and personal computer using RS 232C LAN or USB interface When connecting the emulator to the LAN see APPENDIX C Setting LAN Interface 2 Press the reset switch then turn on the emulator Check that the READY LED of the emulator body come on 3 a Execute the FR Family SOFTUNE Workbench menu from SOFTUNE V6 in your Windows start menu The SOFTUNE Workbench will startup 4 a Create workspace and
120. FUJITSU SEMICONDUCTOR CONTROLLER MANUAL CM71 00328 3E FR FAMILY SOFTUNE WORKBENCH OPERATION MANUAL for V6 co FUJITSU FR FAMILY SOFTUNE WORKBENCH OPERATION MANUAL for V6 FUJITSU LIMITED PREFACE E What is the SOFTUNE Workbench SOFTUNE Workbench is support software for developing programs for the FR family of Fujitsu microcontrollers It is a combination of a development manager simulator debugger emulator debugger monitor debugger and an integrated development environment for efficient development E Purpose of this manual and target readers This manual explains how to operate the SOFTUNE Workbench and design the product This manual is intended for engineers designing several kinds of products using the SOFTUNE Workbench Be sure to read this manual completely Trademarks SOFTUNE is a trademark of FUJITSU LIMITED Microsoft Windows is registered trademarks of Microsoft Corporation in the U S and other countries The names of products and systems appearing in this manual are trademarks or registered trademarks of their respective companies Organization of Manual This manual consists of four chapters and appendix CHAPTER 1 OUTLINE OF SOFTUNE WORKBENCH This chapter gives an outline of SOFTUNE Workbench CHAPTER 2 OPERATION This chapter describes the basic operation method and development procedure of SOFTUNE Workbench CHAPTER 3 WINDOWS This chapter explains SOFTUNE W
121. File New When the New dialog is opened select Workspace Project File in Type of File and click the OK button 2 Select the Workspace tab When the New dialog is opened select the Workspace tab 3 Select the type of workspace Select Blank Workspace as the type of workspace 4 Enter the workspace name Enter the workspace name This name is used as a workspace file name At default it is also used as a workspace directory the workspace directory can be changed 5 Click the OK button CHAPTER 2 OPERATION 2 4 Storing of Project A project is needed to develop and debug software in SOFTUNE Workbench To store a project in workspace follow the steps below E Storing of Project SOFTUNE Workbench uses the following methods to store a project in workspace To store a new project is the active project of workspace Storing new project in currently opened workspace A new project is stored in currently opened workspace Storing existing projects in currently opened workspace Existing projects are stored in currently opened workspace Storing New Project in Currently Opened Workspace 1 Open workspace to be stored a project 2 Select Project Add Project New 3 Select Add to Current Workspace Click the Add to Current Workspace check button 4 Select Project Type Select the type of file last created in the project Project Type Table 2 4 1 indicates the
122. H Memory menu has the following menu items Load Target file Load after make Load after build Load specified file FLASH erase Setting of Environment to load E Use Conditions These functions are enabled only when the target MCU corresponding to the FLASH loader is selected at the start up of the emulator debugger For details of how to set the target MCU refer to 4 5 5 2 MCU in the SOFTUNE Workbench Operation Manual For more information about applicable products to the FLASH loader contact Fujitsu s Sales Department or Support Department 359 CHAPTER 5 Add in Module 5 2 2 1 Load Target file Downloads the project s target file to FLASH memory B Function This menu downloads the project s target file to FLASH memory To specify the FLASH memory area to which the target file is downloaded use the Load Environment Setting Dialog box see 5 2 2 6 Setting of Environment to load E Caution Always create a target file in accordance with the FLASH memory area to which the file is loaded The program downloads only the data within the FLASH memory 360 CHAPTER 5 Add in Module 5 2 2 2 Load after make Makes the project s source program to download the created target file to FLASH memory E Function This menu makes the project s source program to download the created target file to FLASH memory For details of the Make function of the SOFTUNE Workbench refer to 1 4 Make Build Function in the
123. HAPTER 2 OPERATION Make Build SOFTUNE Workbench can create a program in two methods make and build B Make B Build B Stop Compiles or assembles only the modified source file and then links all objects to the library to generate an object program SOFTUNE Workbench recognizes the dependency of the include files registered in the Dependencies category of the SRC tab of project window to compile or assemble the source file Use the Project Make menu to execute make Not only modified source file but compiles or assembles all the source files registered in the project and then links all objects to the library to generate a target file Use the Project Build menu to execute build Stop is the function that forcibly suspends processing during make build compilation or assembling Execute stop with the Project Stop menu during make build compilation or assembling 27 CHAPTER 2 OPERATION 2 10 1 Making or Building of Project SOFTUNE Workbench enables making or building for each project configuration B Making or Building of Project Make or Build in the menu applies to the active configuration of an active project Ifa subproject is defined priority is given to making or building of the subproject For details about how to change the active project and active configuration see Section 2 4 Storing of Project and Section 2 7 Creation of Project Configuration E Making or Building Speci
124. List dialog box Figure 5 1 7 displayed when you click the reference button on the right Add Check the input contents of 2 to 4 If they are correct click Add This completes the registration of Workbench menus The registered contents are displayed in File List and are restored when the Debugger is restarted 353 CHAPTER 5 Add in Module 354 Figure 5 1 9 Setting Dialog Box Menu Customize bar Setting Dialog C Softune6 Initialize pre RunBreak SetupDbgenv RunBreak Parameter Setting 19721007 Is CHAPTER 5 Add in Module 5 1 4 Warning and Error Messages This section describes the warning and error messages displayed when using the customize bar E Warning Message 1 The following warning message Figure 5 1 10 is displayed when you click Add regardless of whether an input batch file does not exist in the Entry when registering a batch file in the customize bar See section 5 1 3 1 Registering Batch Files Figure 5 1 10 Warning Message Softune911 This batch file does not exist Register in the list B Error Messages 1 The following error message Figure 5 1 11 is displayed when you click Add without entering a batch file in the Entry when registering a batch file in the customize bar See section 5 1 3 1 Registering Batch Files Figure 5 1 11 Error Message 1 Softune911 x N Please input batch file 2 The following
125. MB2198 DSUA itis required to stop MCU once to read a contents of memory and replay the program Real time memory area MB2198 Figure 4 7 17 Debug Environment Setup Dialog Box Real time memory area Setup debug environment x Tab Error output Access size Load External memory emulation Execution Watch Radix Emulation Break Monitoring Directory Realtime memory area Frequency Event Inaccessible area Area number E Start address Honor 000 Size v Memory copy Set amp rea no Address range 00005000 000040FF Cancel Area Number Specifies an area number 1 2 Starting Address The starting address of the real time memory area is specified The lower 8 bits are masked Memory copy The contents of real memory are displayed at opening of the window 307 CHAPTER 4 MENUS Inaccessible area Figure 4 7 18 Debug Environment Setup Dialog Box Inaccessible area Setup debug environment H OOOOLFFF 00001000 00001000 00001 This function inhibits access to debugger memory Up to 16 areas can be set by increments of one byte Start Address Specifies the start address to be set End address Specifies the end address to be set List Displays an regions being currently set When the check mark of the area is removed that the area is invalidated 308 CHAPTER 4 MENUS
126. S 4 4 12 Realtime Memory The realtime memory window is displayed E Realtime memory window The window to display the mirror memory is opened The memory contents are dumped displayed from the specified address This window can only be used for the debug session for the MB2198 emulator The location accessed by the user program is color coded The value which is not accessed may be different from that of real memory The value of memory accessed by the user program is only valid but that of memory accessed by operating debugger is not valid Invalid memory contents The contents of the displayed mirror memory are undefined displayed in blue Q Valid memory contents The contents of the displayed mirror memory are same as those of the real memory displayed in black or red Only memory contents at locations accessed at execution are valid and they are displayed in black Locations where memory contents are changed are displayed in red When memory window already opened This window is activated When memory window not opened yet B Area 182 The area specified using Setup Debug Environment Realtime memory area menu is displayed To move the display area for the realtime memory window click the right button of the mouse on the realtime memory window to display the menu then specify Area and select Area 1 or Area 2 Then the area specified using Setup Debug Environment Realtime
127. US BB Back trace Select Back Trace from the shortcut menu Figure 4 4 21 Back Trace Window Frame number D 2 Previous Next gt gt Frame Number Specifies frame number corresponding to trace window E Trace Detail 0503 Select Detail from the shortcut menu The detailed trace data is displayed per branch range Figure 4 4 22 Detailed Trace Dialog Box Trace detail Mode instruction M Close Source List lt lt Previous Next gt gt 00018 OO3SFFFF6 LD RIO R4 00017 e FFFDFFFD at 02820180 FFFF8 LD G RI3RA RI3 QUSFFFFA LD GRIURA 00015 read FFFDFFFD at 02820180 OO3FFFFO LD GRISRORIS MEET Mode Specify whether to display trace data in the instruction or source mode Source Enables the mixed display of trace data and source line information in the instruction mode Previous Displays the trace data just before the trace data of the current branch range Next Displays the trace data just after the trace data of the current branch range 176 CHAPTER 4 MENUS Save Select Save from the shortcut menu Save the trace data to the specified file Figure 4 4 23 Save Trace Data Dialog Save in C3 Project er Ee sample log Save as type log Cancel 2 When specifying a file name specify an existing file and select whether to save or not Figure 4 4 24 Trace Data Save Dialog AN L S
128. ace to store the project is also created In this case the name and position of workspace are the same as those of the project Q Creating workspace in opening project When File Open Workspace is selected to open a project workspace to store the project is also created In this case the name and position of workspace are the same as those of the project If any workspace file already exists however it is opened instead of the project file Creating blank workspace Blank space that has no project is created Projects must be stored separately In this case projects can be stored different in name and position from workspace Creating Workspace in Creating New Project 1 Select File New When the New dialog is opened select Workspace Project File in Type of File and click the OK button 2 Select the Project tab When the New dialog is opened select the Project tab 3 Select Create New Workspace Click the Create New Workspace check button to create project Create workspace in the same way that a new project is created E Creating Workspace in Opening Project 1 Select File Open Workspace 2 Select Project File in Type of File When the Open Workspace dialog is opened select Project File in Type of File 3 Select the project file to be opened Select the project file to be opened 4 Click the Open button CHAPTER 2 OPERATION E Creating Blank Workspace 1 Select
129. ails setting Enable button This button is used to enable the breakpoints in the breakpoint list currently being selected Disable button This button is used to disable the breakpoints in the breakpoint list currently being selected The breakpoints are simply disabled that is the setting itself of the breakpoints is not cancelled Delete button This button is used to delete the setting of the breakpoints in the breakpoint list currently being selected All delete button This button is used to delete the setting of all the breakpoints in the breakpoint list Change button This button is used to change the setting of the breakpoints in the breakpoint list currently being selected This button is not displayed for MB2197 E Setting and resetting a breakpoint In the source or assembly window a breakpoint can be easily set at the address indicated by the cursor The breakpoint set at the address indicated by the cursor can also be reset easily Set and reset this breakpoint as follows 266 Select Breakpoint Set Reset from the Debug menu The breakpoint is alternately set and reset each time Breakpoint Set Reset is selected Click the left button of the mouse in the breakpoint display field of each window The breakpoint is alternately set and reset each time the left button is clicked CHAPTER 4 MENUS 4 6 4 1 Breakpoint details setting Setting of breakpoint details is explained here
130. al errors occur 311 CHAPTER 4 MENUS Access Size Figure 4 7 22 Debug Environment Setup Dialog Box Access Setup debug environment Eumenes rose 0 00100000 H OOLFFFFF Hal fwore It is a function to set access size when the debugger accesses memory When this setting is not done the debugger does memory access by a command qualifiers or the most suitable size Because it is set automatically about a built in resource setting is unnecessary by this function However the debugger does memory access by byte size on FILL MOVE COMPARE commands 312 Start Address Specifies the start address to be set End Address Specifies the end address to be set Access Size Specifies the access size to be set Byte halfword word List Displays the currently set area CHAPTER 4 MENUS Load Figure 4 7 23 Debug Environment Setup Dialog Box Load Setup debug environment This sets the environment when loading a target file registered in the project Specification batch file before after load Before This specifies the batch file to execute prior to the loading of the target file This can be changed using the debugger s setup wizard After This specifies the batch file to execute after the loading of the target file This can be changed using the debugger s setup wizard Only Debug Information This specifies whether or not to load onl
131. al window Memory window When selected the following two submenus are opened Jump To display memory window by using selected address of variable Add bookmark By using selected variable address bookmark will be added to memory window Property Information for the variable is displayed For details see Section 4 3 9 Property 81 CHAPTER 3 WINDOWS 3 13 Watch Window This window is displayed only when SOFTUNE Workbench is in the debug session The watch window is used to display and modify the values of the specified variables Variables are displayed in the tree format E Watch Window The Watch Window can be opened independent 4 windows When being registered a variable user select watch window no 1 2 3 or 4 Because the Watch Window can be registered the variables for each window Figure 3 13 1 is an example of the watch window B Function e Drag and Drop Character string which was dropped from source window will be registered to watch window as variable Figure 3 13 1 Example of Watch Window 71 Watch1 A normal variable is displayed H 00000009 0000000 08010 0 val H 00090000 16 A structure variable is displayed B cip Structure members are displayed target 16 D 0 struct The value of a pointer variable is E DNN struct displayed D 2 w ruct
132. alog Box Setup Project LX General MCU C C Compiler Assembler Linker L 215 Target of setting west 301 z Category Control Library 3 43 Source Files sample c 8 startup asm Don t retrieval the default library Don t check debug infomation existence in library Search Path ae NV FETOOL Mib 911 Search Path List Add Delete UG Down Z ENV FETOOL Mib4911 Library Option AL 2 INRAMOT O D0003COO00 0 0003FFFF INROMUT 0x00080000 0x000FFFFF E Setting when the default library is not used 1 Select the Control Library category The library control setup dialog box shown in Figure 4 5 31 opens 2 Seta check mark to the left of Don t retrieval the default library E Setting method when debug information existence check for library file module inhibited 1 Select the Control Library category The library control setup dialog box shown in Figure 4 5 31 opens 2 Seta check mark to the left of Don t check debug information existence in library 231 CHAPTER 4 MENUS E Setting a library retrieval path 1 Select the Control Library category The library control setup dialog box shown in Figure 4 5 31 opens 2 Set Search Path Clicking the Browse button to the right of the input field enables path reference 3 Click the Add button The set library retrieval path is added to the end of Searc
133. alue Replace with data Replace Direction Position Match whole word only C Up Cursor All Replace Match case Down Top Regular Expressions Cancel C Bottom Ambiguous Table 4 3 2 Character String Search Conditions Match whole word only Does not search partial character strings of words Effective in searching for independent words that may become parts of other words such as able Match case Distinguishes uppercase characters from lowercase characters or vice versa Regular Expression Specifies a search character string in regular expression Enables use of a wildcard etc Direction Specifies a search direction Up or Down Up searches the file upward Down searches the file downward Specifies a search start position cursor top bottom 128 CHAPTER 4 MENUS 4 3 5 Find in Files This section explains how to search specified file for the specified character string E Search procedure 1 Select the Edit Find in Files menu Dialog box Figure 4 3 3 opens Specify a character string The dialog box showing the character strings in the clipboard opens Specify the file to be searched wild card can also be used to specify the file to be searched Specify the directory to be searched Click the button to the right of the specified field to open the directory search dialog box Specify Match whole word only and Match case as req
134. ame directory path name file name extension When drive name is omitted the current drive is selected CHAPTER 2 OPERATION 2 2 Starting and Terminating SOFTUNE Workbench This section explains how to start and terminate SOFTUNE Workbench Starting SOFTUNE Workbench With SOFTUNE V6 to start SOFTUNE Workbench double click the FR family SOFTUNE Workbench icon in SSOFTUNE V6 group When this program is started for the first time with SOFTUNE Manager V01 or V02 installed the dialog box is displayed which asks whether to take over information for Setting editor Setting tools and Setting error jump set in the previous version To take over the information click the Yes button Not to take over it click the No button E Terminating SOFTUNE Workbench To terminate SOFTUNE Workbench select Exit from the File Menu or click the x button above and to the right of the window SOFTUNE Workbench cannot be terminated when compile assemble make build or tool is being executed Be sure to terminate SOFTUNE Workbench after compile assemble make build or tool has been terminated or suspended CHAPTER 2 OPERATION 2 3 Creating Workspace Workspace is needed to store projects in SOFTUNE Workbench to create project follow the steps below E Creation of Workspace SOFTUNE Workbench uses the following methods to create workspace Creating workspace in creating new project When a new project is created worksp
135. ameter for a specified batch file Use a comma to separate multiple parameters Display the Parameter Setting dialog box Figure 5 1 6 To set a parameter when executing a batch file with the customize bar apply a check mark to this This is convenient when you want to specify change parameters each time you execute a batch file Iconic To make Workbench an icon when executing a batch file with the customize bar apply a check mark to this Add Check the input contents of 2 to 7 If they are correct click Add This completes the registration of a batch file The contents of the registration are displayed in Settings and are restored when restarting the Debugger 351 CHAPTER 5 Add in Module 352 Figure 5 1 8 Setting Dialog Box Batch File Customize bar Setting Dialog C Softune6 nitialize pre RunBreak SetupDbgenv Batch File C Softune6 Initialize pre oa COUT _ _ 5 1 3 2 CHAPTER 5 Add in Module Registering Workbench Menu This section describes how to register the Workbench in the customize bar E How to Register Workbench Menu 1 Display the dialog box Select View Customize Bar Setting to display the Customize Bar Setting dialog box Fig 5 1 9 Number Select the number to be registered in the customize bar Kind Select Menu Entry Enter the Workbench menu to register in the customize bar Specify with the Menu
136. anation Operator response The specified sector address is out of the FLASH memory area The version of the information file for the FLASH loader may be old Install the latest version of the SOFTUNE Workbench again Motorola S Format File not found Explanation Operator response The Motorola S format file is not found in the directory containing the project s target file The program may have failed to convert the load module file to a Motorola S format file Check if f2ms exe exists below the SOFTUNE installation directory BIN Binary File not found Explanation Operator response The binary file with the same name as the project s target file is not found in the directory containing the target file The program may have failed to convert the Motorola S format file or Intel HEX file to a binary file Check if m2bs exe or h2bs exe exists below the SOFTUNE installation directory BIN Erase error at FLASH memory Explanation Operator response The program failed to erase FLASH memory Check if errors occur in FLASH memory Write error at FLASH memory Explanation Operator response The program failed to download to FLASH memory Check if error occur in FLASH memory CHAPTER 5 Add in Module File access error Explanation Operator response The file cannot be accessed Check the condition of the disk in the host Invalid file format Explanation Ope
137. and opened in the workspace project format No button The project file is not converted and is opened in the old project format In this case some functions cannot be used For details of functions that can be used in the old project format refer to Section 1 2 Management Function for Project of SOFTUNE Workbench User s Manual Cancel button Opening of the project file is cancelled The project files created in V01 V02 version needs the following setting 1 Select Open Workspace from the File menu then specify the project file created 2 Select Project file from file type and specify the project file made by SOFTUNE Manager If the specified file is one made by SOFTUNE Manager a dialog asking whether to convert the file to a workspace project format is opened Click the Cancel button to cancel opening of the project file 3 Click the OK button to start conversion When you click the Cancel button it cancels the opening of the project file 4 When the new project creation Window opens set the chip type and target MCU then click the OK button 5 When conversion is completed the dialog box showing the end of conversion opens Click the OK button to close the dialog box CHAPTER 2 OPERATION B Backup file In SOFTUNE Workbench when a project file is converted to a workspace project format a backup file is made automatically The extension of backup file varies with the type of project file Th
138. ands to be used often can be started simply by specifying their names Set and delete aliases in the following procedures Q Adding an alias 1 Click the right button of the mouse in the command window to display the shortcut menu 2 Select Macro etc from the shortcut menu The character string replacement setting dialog box shown in Figure 3 15 2 opens 3 Set an alias Specify the alias that does not conflict with command names and the aliases that are already registered 4 Write the command to be assigned to the specified alias The command can be written including its parameters 5 Click the Append button Deleting an alias 1 Click the right button of the mouse in the command window to display the shortcut menu 2 Select Macro etc from the shortcut menu The character string replacement setting dialog box shown in Figure 3 15 2 opens 3 Select the alias to be deleted from the alias list 4 Click the Delete button 88 E Variable CHAPTER 3 WINDOWS Figure 3 15 2 Character String Replacement Setting Dialog Box Replace command x Alias Variable Macro Alias Append Command dump Alias list Alias name command Delete di0 Close The name assigned to the address range to be referred often can be used for command input Add and delete a variable in the following procedures Adding a variable 1 2 5 6 Click the right button of the mouse in th
139. are cleared Subsequent saving is performed in workspace project format If you select old project format prj it saves information on active project configurations in old project format incompatible to workspace The project file opened in workspace project format cannot be overwritten in old project format In this case save the file as a different name Saving the binary file Specify a save start address in Start Address When the binary file is already loaded the start address at that time is set Specify a save end address in End Address When the binary file is already loaded the end address at that time is set Note If you save the project file in a different directory from the original one the members described in a relative path may not be referred In this case move the members with the original directory configuration kept unchanged 118 CHAPTER 4 MENUS 4 2 8 Save All Save All saves all the files currently being edited Files to be saved The files to be saved include text files such as the source file open in the edit window Data in the workspace project file and output window is not saved Even the text file open in the edit window is not saved if it is not edited When SOFTUNE Workbench is in the debug session the binary alias or setup file that was edited even once is to be saved E Processing a newly created text If there is a newly created text that is not yet saved once
140. ark to the left of Control of changing page When page change is suppressed the line count cannot be set 3 Set line count and column count to the right of Line and Column as required B Starting Librarian If the project type is a library the librarian is started To change the project type see 4 5 5 1 General 240 4 5 5 8 CHAPTER 4 MENUS Setting Converter Options This section explains how to set converter options Setting converter options 1 2 Click the Converter tab from the project setup dialog box To start the load module converter marks the Absolute module converter is started check box Select a conversion format Motorola S format f2ms Converts the absolute format load module of linker output to an S format Data at addresses 0 to OXFFFFFFFF is converted Intel HEX format f2is Converts the absolute format load module of linker output to an HEX8 format Data at addresses 0 to OXFFFF is converted This format is left to maintain compatibility with the previous version The 32 bit Intel HEX format f2hs should be used for conversion to an HEX8 format Intel Extend HEX format f2es Converts the absolute format load module of linker output to an HEX16 format Data at addresses 0 to OXFFFFF is converted This format is left to maintain compatibility with the previous version The 32 bit Intel HEX format f2hs should be used for conversion to an HEX16 format 32
141. ark to the left of this item enables the display of the options specified when the C C compiler or assembler is started in the output window Inquiry for save at close workspace When a check mark is set to the left of this item SOFTUNE Workbench asks you whether to save the currently opened workspace to the workspace file when the workspace is closed Inquiry for save at compile assemble When a check mark is set to the left of this item SOFTUNE Workbench asks you whether to save the file currently being edited before compile assemble Figure 4 7 2 Development Environment Setup Workspace Dialog Box Environment Variable Workspace Output tool option at compile assemble Inquiry for saves at close workspace Inquiry for saves at compile assemble Termination messages are highlighted at make build Detail optimize Close the edit window when debugging Cancel Apply 291 CHAPTER 4 MENUS Q Termination messages are highlighted at make build When this item is checked the display color of termination messages abort no error warning error fatal error or fail during start during compile assemble make or build can be changed To change the display color click the Detailed optimize button at the right of this field the termination message display color dialog is displayed Figure 4 7 3 Change the display color Figure 4 7 3 Display Color of Messages Dialog Box Display color of
142. at is also to set the BUS MODE and the external bus mode It becomes to select the Bus width MCU change Opens MCU change dialog box 205 CHAPTER 4 MENUS Setting of CPU Information Q Setup CPU information DSU Figure 4 5 10 CPU Information Setup Dialog DSU Setup CPU Information IRQ and ICR Delayed nterupt 0 Select DSU Select a DSU type DSU1 DSU2 DSU3 DSU4 Setup CPU information IRQ and ICR Figure 4 5 11 CPU Information Setup Dialog IRQ and ICR Setup CPU Information Relationship between Vector and ICR The correspondence between external interrupts Vector and the interrupt control register ICR varies with the target MCU This correspondence is specified by the simulator debugger Setting Correspondence between External Interrupts and ICRs Set the interrupt control registers ICRs corresponding to vector numbers When a vector number is selected and the Change button is clicked the dialog shown in Figure 4 5 12 opens 206 CHAPTER 4 MENUS Figure 4 5 12 Correspondence between External Interrupts and ICRs Correspond Interrupt E3 Setup CPU Information Delayed Interrupt Figure 4 5 13 CPU Information Setup Dialog Delayed Interrupt Setup CPU Information n Vector Number Sets vector number of delayed interrupt Note There are no functions with some CPUs 207 CHAPTER 4 MENUS E Setting of MCU change
143. attribute to which parentheses attach can specify whether to acquire it 171 CHAPTER 4 MENUS 172 Trace Trigger FR6OLite Figure 4 4 18 Trace Trigger Setup trace H 0001 0000 Data Ra Address In this field the address or symbol that sets a trigger point is specified Type In this field the type code data of the trace trigger is specified Trace control The trace operation to be performed when the trace trigger is hit is specified Remain In this field the remaining count of settable trace trigger types currently being selected is displayed List The data of the trace trigger currently being set are displayed Set button This button is used to set the trace trigger at the set address Detail button This button is used to display the trace trigger details setting dialog used to set the detailed condition other than address Event List button This button is used to display the event list dialog used to check the setting of all events CHAPTER 4 MENUS Enable button This button is used to enable the trace triggers in the trace trigger list currently being selected Disable button This button is used to disable the trace triggers in the trace trigger list currently being selected The trace triggers are simply disabled that is the setting itself of the trace triggers is not cancelled Delete button This button is used to delete the setting
144. bit style and byte half word word style 97 CHAPTER 3 WINDOWS The RAM Checker window displays the logging status and the monitoring When the logging status is set to Disable monitoring is also disabled The data update interval at monitoring display time is fixed at 100ms Data is displayed in two formats bit format and byte or word format Data whose content has been changed in memory after the previous update is displayed in red Memory content cannot be edited Note Monitoring When the logging status on the RAM Checker window is set to Enable the monitoring on other windows memory window and watch window etc is disabled irrespective of the setting status Debug mode When using the RAM Checker window set debug mode to RAM Checker mode Otherwise the RAM Checker window cannot open If debug mode is set to other than RAM Checker mode with the RAM Checker window opened the RAM Checker window closes automatically To set debug mode select the menu Environment Debug environment Select debug function When debug mode cannot be set to RAM Checker mode the RAM Checker function cannot be used in the emulator environment For details refer to RAM Checker section in SOFTUNE Workbench User s Manual Event mode Event mode cannot be set to performance mode When using the RAM Checker event mode is automatically set to trace mode Event function For how to use the event function refer to Section 2 3 7 Trace
145. c Setting of Linker Options 25 options sessssessssse 218 Designate additional option when executing TRETEN 249 ODO RERUM 249 Setting absolute format assemble list options 230 Setting assembler options 219 Setting C C compiler options 209 Setting converter options 241 Setting debug 244 Setting General Options 210 220 227 Setting librarian options 239 Setting linker options 226 Setting of Linker Options 25 Setting of Options for Library Control 231 Setting of Options Included in Detail Definition in 215 Setting of Options Included Language PETENS 217 Setting Optimize options 214 Setting Options in General 244 239 Setting Options in Setup 245 Target Depend options 225 When initializing Disposition Connection option based on MCU information 238 Output port Resetting an output port 297 Setting an output port 296 Output Window Output Window
146. ccurrence of an interrupt event by instruction execution Set the count of cycles generated during processing as the count of cycles delayed info cycle In the ISS this value is added to the cycle count If this event causes an error stop instruction execution by using SSDI Request Abort Remarks The cycle count of interrupt processing int cycle is always posted as 0 397 APPENDIX G 10 SSDI Timer Event Post Timer Format void SSDI Timer Event TIMER EVENT info Argument typedef struct unsigned long unsigned long int unsigned long TIMER EVENT Return value None Explanation total cycle inst cycle time id cycle Total cycle count Differential cycle count from previous event Set timer ID Count of cycles delayed Posts the occurrence of a timer event set in the ISS Set the count of cycles generated during processing as the count of cycles delayed info cycle In the ISS this value is added to the cycle count If this event causes an error stop instruction execution by using SSDI Request Abort Remarks Set the timer event conditions in SSDI Set Timer 398 APPENDIX G External I F DLL for Simulator G 11 SSDI Read Memory Read from Memory Format int SSDI Read Memory unsigned long addr int size int length void data Argument unsigned long addr Access address int size Access size 1 Byte 2 Word 4 LONG int length
147. ce Back TACE s eee dt Rte attt here 176 Backup file Backup edens 33 Bar est 38 Common 37 Debug 38 FAGAN ioter tete 38 Project Daria uec teme ete dette 37 EN D 39 Batch file How to register batch file 351 Opening the batch file 113 Binary file Opening the binary file 113 Saving the binary file 118 Bit addressing Bit addressing sess 13 Blank Creating Blank 17 Bookmark Add bookmark 159 131 Bookmark 123 Bookmark menu 131 Clear all bookmarks in the current window Vestes 134 136 138 Move the caret to the next bookmark 133 Move the caret to the next bookmark in the current window 133 136 138 Move the caret to the previous bookmark 133 Move the caret to the previous bookmark in the current window 133 136 138 Setup or cancel of a bookmark 133 136 137 To display a dialog Bookmark ENNER di 135 137 132 Breakpoint Breakpolnt re eet
148. cel bookmark Click on Setup cancel bookmark mark at toolbar Find Setup a bookmark with shortcut menu Add a bookmark For details refer to 4 4 5 memory Add or delete a bookmark at tab Memory in the Bookmark dialog E Move the caret to the next bookmark in the current window 1 Please make sure that there is a cursor in a memory window 2 Please execute any of following operations Select Edit Bookmark Next bookmark in the current window Click on Next bookmark in the current window at toolbar Find Bi Move the caret to the previous bookmark in the current window 1 Please make sure that there is a cursor in a memory window 2 Please execute any of following operations Select Edit Bookmark Previous bookmark in the current window Click on Previous bookmark in the current window at toolbar Find E Clear all bookmarks in the current window 1 Please make sure that there is a cursor in a memory window 2 Please execute any of following operations Select Edit Bookmark Clear all bookmarks in the current window Click on Clear all bookmarks in the current window at toolbar Find Click on delete at tab Memory in the Bookmark dialog Note Symbol which can not be allocated to the name of bookmark will be member of automatic variables structure union and class If some symbols with the same name are defined other symbol than assumed one may be used To s
149. ch work files exist Figure 4 7 1 Development Environment setup Environment Variable Dialog Box Setup Development x Environment Variable Workspace Value of Environment Variable Environm New Value PATH D Softune6SBIN D WINDOW S system32 D WINDC FETOOL D Softune6 INCS11 D SoftuneBALIBS911 3INCLUDE LIB311 D SoftuneBALIB 311 FELANG ASCII OPT911 D SoftuneBLIB 311 OPT IR of Environment Variable PATH Change Value D Softune amp XBIN D NwWINDOW Browse Explanation of the Environment Variable Specify PATH Execute file of language tool existence in installed BlNdirectory 290 CHAPTER 4 MENUS Set the development environment in the following procedure 1 Select the name of the environment variable whose setting is to be changed from the Value of Environment Variable list The current setting value is displayed in the Value field Simple explanation of the environment variable is displayed in Explanation of the Environment Variable 2 Change the description of the Value field 3 Click the Change button E Workspace Workspace sets the following SOFTUNE Workbench operations Open the last workspace at starting Setting a check mark to the left of this item enables the opening of the previously opened workspace file when SOFTUNE Workbench is started Output tool option at compile Assemble Setting a check m
150. chip See Section 4 4 8 Trace Find See Section 4 4 8 Trace Save See Section 4 4 8 Trace Clear Clears display mode trace buffer Close Closes trace window Instruction cycle source This cannot be selected in the DSU3 chip Click the right button of the mouse to display the shortcut menu Select Instruction Cycle or Source from the shortcut menu The trace result is displayed in the selected mode and a check mark is displayed of the selected submenu CHAPTER 3 WINDOWS 3 15 Command Window This window is displayed only when SOFTUNE Workbench is in the debug session The command Window displays the execution result of the directly entered debugger command Command Window Figure 3 15 1 is an example of the command window Figure 3 15 1 Example of Command Window Command address 0 1 2 3 4 5 6 7 8 49 B 4D 4E The execution result of 00000000 00 00000010 00 00 the entered command is displayed The entered command is executed Enter a debugger command from here 85 CHAPTER 3 WINDOWS Shortcut Menu Command input field There are six menus below 86 3 Paste 1 2 Delete 1 2 3 Undo Cancels the immediately preceding editing Cut Moves the selected character string to the c
151. ck View2 tab to choose the keyword type to be changed from the combo box Click Detail button The keyword dialog box shown in Figure 3 6 4 opens Click Reset button Click the OK button The keyword files is changed When not setting other items click the OK button When selecting a display function set all related items then click the OK button Figure 3 6 2 Standard Editor Dialog Box Standard Editor x View View2 ltem View w Ret i Tab Bookmark wjLine Number Error wiRuler te Mesh m Emphasis Characters 1 Keywor VC Keyword C C 1 Assembly Tab Size 4 25 j Font 65 CHAPTER 3 WINDOWS Figure 3 6 3 Standard Editor Dialog Box View2 Standard Editor 66 CHAPTER 3 WINDOWS 3 7 Source Window The source window displays the source program at debugging E Source Window Figure 3 7 1 is an example of the source window E Function Breakpoint setting releasing A breakpoint can be set or released by left clicking gt of at the left edge of the source window Instruction execution to specified line address An instruction can be executed at the specified line address by left clicking of gt O of gt at the left edge of the source window Step execution step into is also enabled by clicking at the PC location Pop up display of variable valu
152. d register is deleted from Current Display Register lower part 3 Set all the registers you want to delete by repeating the above operation 4 Click the OK button Restoring registers to the initial status 78 Restore the registers in Current Display Registers to the initial status status when SOFTUNE Workbench was installed in the following procedure 1 Click the right button of the mouse in the register window to display the shortcut menu then select Setup from the menu The display setting dialog box shown in Figure 3 10 2 opens 2 Click the Reset button The registers in Current Display Registers lower part of display register setting dialog box are restored to the initial status 3 Click the OK button CHAPTER 3 WINDOWS 3 11 Memory Window This window opens only when SOFTUNE Workbench is in the debug session The memory window is used to display and modify memory data at the specified address E Memory Window Figure 3 11 1 is an example of the memory window When debugging memory values can be displayed The register values can be directly rewritten To modify by specifying the expression and symbol in the memory values select Edit from the shortcut menu for the memory window B Function Display the change The location where was changed from the previous contents will be shown in red while program execution is stopped or monitoring This function is only valid in a range
153. d setup changes from Start Debug to End Debug When End Debug is selected debugging is ended Change The setup wizard for changing the setup setting is started see Section 4 7 2 5 Setup Wizard Delete Debugger setup information is deleted from the project Valid setup information cannot be deleted To delete change the valid setup temporarily Property Setup information is displayed see Section 4 3 9 Property 51 52 CHAPTER 3 WINDOWS Shortcut menus Click the right button of the mouse on a space in the project window Figure 3 4 18 shows a shortcut menu Figure 3 4 18 Shortcut menu on space in the project window Docking View Hide The project window is docked with the frame in the check status Hide Docking View The project window enters the nondisplay status CHAPTER 3 WINDOWS 3 4 2 ABS tab The name of the current project and the file names registered in the project are displayed in the tree view format ABS tab Figure 3 4 19 shows examples of displayed contents of the ABS tab Figure 3 4 19 ABS tab Load module name Source file name Function name El Sampleabs 51 1 sample c main sort val A startup asm The source filename and functionname acquired from the debug information are listed E Function Display the following information form the debug information Load module name Source filename Double click the source file name to op
154. ddition of a member see Section 2 5 Creating and Registering Source File in Project 196 CHAPTER 4 MENUS 4 5 3 2 Add Member Directory A directory is specified to store its file and folder in the project Add Member Directory Figure 4 5 4 Add Member Dialog Directory Add Member Directory x Directory D SoftuneB Lib S11 include OK Y Cancel Sub directory also targeted Filetype CDD CC c asm Mem Type Automatic Insertion Folder sample Source Files Directory Specifies the directory having the file to be stored e Sub directory also targeted When turned on the file in the sub directory in the specified directory is stored A sub directory is hierarchically created as a folder in the project File type Only the file having a specified extension is stored in the project Mem Type The file is stored as the type of the specified member in the project If Auto is selected the type of member is determined by the extension Insertion Folder Specify the project in which a file is stored and the folder into which the file is inserted The character string enclosed between and is the project name BB Procedure for Addition For the procedure for addition of a member see Section 2 5 Creating and Registering Source File in Project 197 CHAPTER 4 MENUS 4 5 4 Setup Workspace The basic setting regarding workspace is per
155. ditionally sets watch point See Section 4 6 7 Stack Displays source window properties Switches whether to display or not disassemble list Specify whether the window should set to active or not when the program is stopped Closes source window Opens the edit window to modify the current source file See Section 3 6 Edit Window Standard Editor Find Searches the text in the current source file Perform this operation in the following procedure d UC N select Find from the menu Click the right button of the mouse in the source window to display the shortcut menu then The search dialog box shown in Figure 3 7 2 opens Set a search direction Set the character string you want to search If necessary display a check mark to Match case Click the Find Next button The fond character string is displayed in reverse video To terminate search click the Cancel button CHAPTER 3 WINDOWS Figure 3 7 2 Search Dialog Box in Source Window Find what e irecti Pd Position 6 C Bottom Match whole Match case Regular Expressions Ambiguous Jump Specifies the position to display in the source window Perform this operation in the following procedure 1 Click the right button of the mouse in the source window to display the shortcut menu then select Jump from the
156. dows NT amp ccessorieswordp Add Parameter Cancel 330 CHAPTER 4 MENUS 4 8 Window Window controls window display Control related to window display Cascade Vertical Horizon Split Arrange Icons Refresh Window Refresh All Windows Close All Windows Window name display Up to 9 currently opened window names are displayed including icon windows If ten windows or more are opened the tenth and subsequent windows are displayed in Other Windows 331 CHAPTER 4 MENUS 4 8 1 Cascade Vertical Horizon Cascade Vertical and Horizon specify the display formats of subwindows e g source window register window and assembly window Cascade Cascade displays currently displayed subwindows in cascade B Vertical Vertical arranges currently displayed subwindows vertically and fully displays them in the main window ii Horizon Horizon arranges currently displayed subwindows horizontally and fully displays then in the main window 332 CHAPTER 4 MENUS 48 2 Split Split specifies where a window is vertically split Split Split specifies where a window is vertically split The following windows can be vertically split Source Window Assembly Window Trace Window Memory Window 333 CHAPTER 4 MENUS 4 8 3 Arrange Icons Arrange icons arranges the locations of the minimized window icons E Icon arrangement Arrange icons arrang
157. e cies ileal 287 Target Depend Target Depend options 225 Target name Shortcut menus Click the right button of the mouse on a target name 44 Target program Loading the target 29 Target system Target system configuration 381 Target system 381 Target system creation procedure 382 Temporary file Contents of the temporary file 249 Time measurement Time 281 Title TIO S ie HE ovi etd m cedes 248 Tool Example of tool 322 Language 2 Setting other tools 289 Starting an external tool 330 Tool change procedure 322 Tool deletion procedure 321 Tool setup procedure 321 TOOS e aE aaa 320 Tool Bar TOO B8t atii eto o preterea eec 179 Tool bar status 151 Tool button Tool button list sess 247 Trace Back trace 176 Search Trace
158. e By placing cursor of mouse on the name of variable that variable value can be viewed as pop up Bookmark setup function By setting a bookmark it enables to view the specified line using search bar or key operation Please refer to 4 3 7 Bookmark for details Drag and Drop It is possible to drag a character string selected at source window and drop it to memory disassemble and watch windows Please refer to description about drag and drop at each window for operation done after dropping character string Line number The position of the Figure 3 7 1 Example of Source Window E sample c OF x main int i current instruction struct table value 16 pointer is displayed for 0 1 lt 16 i sort_val value ji t The breakpoint position is displayed 67 CHAPTER 3 WINDOWS E Shortcut Menu There are fourteen menus below 68 Edit Edit Inline Assemble Find Jump Go to Current Breakpoint Set Reset Breakpoint Enable Disable Break Watch Stack Property Mix Display Activate when stop Close Opens the edit window See Section 4 4 3 Assembly Opens the character string search dialog box Figure 3 7 2 Displays jump dialog box Displays current PC location This function is to set or to cancel the breakpoint pointed by cursor To make breakpoint in the line pointed by cursor enable or disable See Section 4 6 4 Break Point Ad
159. e OK button Figure 4 4 15 Variable Edit Dialog Cancel max 00070007 E Canceling display of unnecessary variable Display of a set variable that is no longer needed can be canceled from the watch window using the following procedure 1 Click the right button of the mouse in the line displaying the variable to cancel The shortcut menu is displayed 2 Select Delete from the shortcut menu Note Display of each array element or each member e g structure cannot be canceled When delete is executed in each element or member line display of the array or structure is canceled 167 CHAPTER 4 MENUS 4 4 8 Trace Trace displays the trace window B Trace This function retroactively displays addresses and instructions executed so far Enable can be switched to Disable or vice versa during debugging Display per machine instruction cycle display display per source can be selected as trace result display E Update The trace window display is not updated in realtime according as debugging progresses Consequently to display the latest trace click the right button of the mouse in the trace window to display the shortcut menu then select Refresh from the menu Buffer size Trace data is buffered in the trace buffer The trace buffer becomes full some time during debugging because its size is finite When the trace buffer becomes full the program being executed can be stopped
160. e command window to display the shortcut menu Select Macro etc from the shortcut menu The character string replacement setting dialog box shown in Figure 3 15 2 opens Click the Variable tag The variable setting dialog box shown in Figure 3 15 3 opens Set a variable Specify the variable name that does not conflict with the variable names that are already registered Write the character string to be assigned to the specified variable name Click the Append button Deleting a variable 1 2 Click the right button of the mouse in the command window to display the shortcut menu Select Macro etc from the shortcut menu The character string replacement setting dialog box shown in Figure 3 15 2 opens Click the Variable tag The variable setting dialog box shown in Figure 3 15 3 opens Select the variable name to be deleted from the debug variable list Click the Delete button 89 CHAPTER 3 WINDOWS Figure 3 15 3 Variable Setting Dialog Box Replace command x Alias Variable Macro Variable top20 String fOOOFOO0 fOOOFO1 F Variable list Variable name command Delete top20 fODOFOOD fOO0FO1 f E Macro A combination of the special commands to be used often can be named and used as a macro Add and delete a macro in the following procedures Adding a macro 1 Click the right button of the mouse in the command window to display the shortcut menu
161. e is valid Data Specifies the data to be set as the event occurrence condition Valid only when the DSU type is DSU2 Data Mask Specifies data mask Only the data items whose bits are 1 are to be compared Valid only when the DSU type is DSU2 Data NOT Specifies the condition when the data values do not match Valid only when the DSU type is DSU2 Size Specifies a data access size byte halfword word Attribute Specifies a data access attribute read write Mode In the DSU3 chip whether display is enabled or disabled depends on the trace sampling mode When the trace sampling mode is the full mode display is enabled When the trace sampling mode is the trigger mode however display is disabled to inhibit selection because the event mode is nullified events are triggered when the event 2 condition is established OR Mode Events are triggered when the event 1 condition or the event 2 condition is established Sequential Mode Events are triggered when the event 1 condition and event 2 condition are established in this order Event List Displays the current event setup state Note This function cannot be used when the FR60Lite is used because of the enhanced function of a sequencer or a trace trigger For details refer to SOFTUNE Workbench USER s MANUAL Control by Sequncer or Trace 274 CHAPTER 4 MENUS B Event List A list of events currently being set is displayed This
162. e method for opening the backup project file is also different depending on the extension SOFTUNE Workbench V3 V5 Old project file prj gt p03 Old option data file dat gt d03 SOFTUNE Workberch V01 V02 Old project file prj gt V01 SOFTUNE Workbench V3 V5 p03 Change the extension of the backup project file p03 and the option data file d03 to prj and dat respectively SOFTUNE Manager V01 V02 v01 e Change the extension of the backup project file v01 to prj Note e Tool options are not passed to projects of SOFTUNE Manager V01 V02 Reset these options after read has terminated e Be sure to reset User Include File Directory set by Set Environment Variable of the SOFTUNE Manager V01 V02 as the Include Path option of the C C compiler or assembler Also be sure to reset Library File Search Path set by Environment Variable Setup of the SOFTUNE Manager V01 V02 as the Control Library option of the linker fthe workspace file having the same name as that of the specified project file is in the same directory the workspace file is opened instead of the project file and no project file is converted 33 CHAPTER 2 OPERATION 2 14 Moving Project File This section explains how to move a project file to another directory or a personal computer B Procedure 34 1 Set the path to the member stored in the project file to the relative path from the project file I
163. e specified function in the specified module class symbol Symbol in class valid only for static class function symbol Symbol in class function CHAPTER 2 OPERATION B Line number The line numbers to be generated by the C C compiler or assembler can be used to refer addresses For the C C language a line number indicates the starting address when one line file name 1ine number When referring an address with a line number prefix to the line number A line number can is compiled be specified only in a decimal number Specify the line number in the following format If the extension of the source file name is c line number specification can be omitted If the source file name is not alphanumeric characters enclose the line number in double quotes Character constant A character constant is the character value enclosed in a single quote it cannot include a single quote and V Instead of these characters single quote and back slash escape characters can be used as character constants Characters that can constitute character strings can be used as escape characters i Mangled name C generates a mangled name for implementation of duplicated function The C workbench can use a mangled name to specify a symbol name A mangled name should be used to distinguish duplicated function with identical names For example the functions func int 1 and func short s have the mangled names func Fi and
164. e syntax whose order is to be changed from the syntax list 3 Click the UP or Down button to move the cursor to the position where error jump is to be set Application ON OFF When the check mark to the left of Apply is reset error messages are not analyzed according to the registered syntax When a check mark is set to the left of Apply ON is displayed in the syntax list When a check mark is not set OFF is displayed in the syntax list B Example of error jump setup When the error format is error message line number file name Syntax 96 1 f Comment sample Note The syntax for which SYSTEM is displayed in the syntax list cannot be deleted 329 CHAPTER 4 MENUS 4 7 8 Tool Startup This section explains how to start a registered external tool Bi Starting an external tool The tools set by Section 4 7 4 Tool are registered in the submenu A tool can be started by selecting it from this submenu Setting a check mark to the left of Designate Additional option when Executing in tool setup opens the additional option setup dialog box shown in Figure 4 7 32 before the tool is started Set an additional option from this dialog box then click the OK button The parameter specified from this dialog box is added after the parameter specified in tool setup and the tool is started Figure 4 7 32 Specify Other Parameter Dialog Box Specify Other Parameter x Execute String Program Files Win
165. e t en det ide n te 179 Scot hats heh od Meee mete 180 4 4 12 Realtime Metmory o ptr ecrit erg tiere Gre tet thee each eet 182 4 4 13 Performance irte i o i e dd ia itus ebd un 184 4 4 14 RAM CHECKE uicit a Ha i antec det rede dade Lad ra X heh Ha E 188 4 5 gie M LE 189 4 5 1 Active ECC c 190 4 5 2 Add PEOJeGt tah Ee ath lite t tta eim tbi 191 4 5 8 Add Merib6et tetti ues e ive bnsnen ee en 195 4 5 4 Setup WOrFkSDaCe ih ten t ebrei ttr apad eet e e eee 198 4 5 5 Setup Project cuit Le EH SUR hat oe Ee s Neue onm d fautes suis 199 4 5 6 Setting Customize Build sssssssssssssssseseeneeenne 247 4 5 7 RE 251 4 5 8 Project Configuration uter es Euren A sede cede 252 4 5 9 Include Dependencies niter ned Drei e s 256 4 5 10 Compile Make Build and Stop 257 4 6 BU mc cc 258 4 6 1 P ase 259 4 6 2 Dna EE 260 4 6 3 Reset of MCU m S 261 4 6 4 Break th cara e tea Mind LL M IDEE 262 4 6 5 Event c eee n stt thes 272 4 6 6 Te E M Hr RR 276 4 6 7 idu E 280 4 6 8 Time Measurement 281 4 6 9 TA A 282 CRN O Clear O
166. e the caret to the previous bookmark in the current window 1 Please make sure that there is a cursor in a source window 2 Please execute any of following operations Select Edit Bookmark Previous bookmark in the current window Click on Previous bookmark in the current window at toolbar Find 133 CHAPTER 4 MENUS E Clear all bookmarks in the current window 1 Please make sure that there is a cursor in a source window 2 Please execute any of following operations Select Edit Bookmark Clear all bookmarks in the current window Click on Clear all bookmarks in the current window at toolbar Find Click on All delete at tab Source in a dialog Bookmark Note Symbol which can not be allocated to the name of bookmark will be member of automatic variables structure union and class If some symbols with the same name are defined other symbol than assumed one may be used To specify a symbol with the same name please determine the name of module and function name first then specify a symbol 134 CHAPTER 4 MENUS 4 3 7 2 Bookmark Memory window This section explains the operation when memory window is activated To display a dialog Bookmark By selecting Edit Bookmark Bookmark dialog as shown in Figure 4 3 7 will be opened This dialog is to indicate the list of bookmark set in memory window Figure 4 3 7 Bookmark dialog Memory window Bookmark x Source Memor
167. e the display area use Area on By dropping variable name function name label or address from source window to disassemble window display will be jumped to a location where an address of dropped character Figure 3 16 1 Realtime Memory Window Realtime memory 0 2 3 4 95 6 7 8 9 A C D E F Ascii 10 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 M 0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 OO 10 00 00 00 O 00 00 00 00 0 00 00 00 10 00 7D 82 7 08 91 FF 53 82 3D 87 79 FF El 00 FF 5 00 7D 82 7 08 07 00 00 00 OE 00 00 00 00 00 00 1 41 82 41 6E 41 EB 41 BE 41 5A 41 22 42 41 22 AnA A 41 D2 41 OE 42 96 41 FA 41 46 41 0A 41 F6 40 00 10 00 00 m 93 CHAPTER 3 WINDOWS Shortcut menu Area Displays data from the beginning of area specified using Realtime Area tab of Debug Environment on Setup menu Display setting See section 4 4 12 Realtime Memory Area specification Calls Realtime Area tab of Debug Environment on Setup menu Monitoring Switches between monitoring enabling and monitoring disabling Close Closes realtime memory window Note In this function the modifiers that can be specified vary depending on the emulator or its connections For details refer to
168. ebug Environment This section explains the debug environment setup procedure E Debug environment setup procedure Execution Figure 4 7 9 Debug Environment Setup Dialog Box Execution Tab Error output Access size Load External memory emulation Realtime memory area Frequency Event Inaccessible area Execution Watch Radix Emulation Break Monitoring Directory Step mode Automatic Source line C Machine language Watchdog C Enable Disable m Setting break point while running C Enable Disable Pj Cancel Step mode Specifies a step unit for step execution Automatic Automatically sets the step unit according to the window display state Source Line Executes the step in units of source lines Machine Language Executes the step in units of machine languages Watchdog Specify whether to enable or disable the watchdog timer at program execution Setting breakpoint while running If Setting breakpoint while running is enabled it is also possible to Break settings even when executing a user program This function is available only when a DSU4 evaluation chip in the MB2198 299 CHAPTER 4 MENUS Watch Figure 4 7 10 Debug Environment Setup Dialog Box Watch Setup debug environment Watch Mode Automatic Sets the watch mode automatically according to the analysis result CLanguage Sets the C C language
169. ecified e sub ii When variable ii is specified CHAPTER 4 MENUS E Description Execute the specified functions to display the return values The return value is set to the built in variable CALL Evaluate the argument of the specified function in dummy argument format and execute it If the count of specified actual arguments is more than the count of dummy arguments evaluate as many counts of actual arguments as that exceeds the dummy arguments in an int type When the program hits a break point while the CALL command is executing a function a break occurs at that position To execute the call command continuously use the GO command To terminate the execution of the CALL command use the CLEAR CALL command Note that it is not possible to nest this command The CALL command sets the break point for the current PC and sets the return address so as to return to that point calling a function Therefore if the function called by the CALL command passes through the current PC a break occurs in the middle of executing the function In such cases the following message is displayed Break at address by Invalid call termination Break at address by Invalid call termination Re starts execution using the GO command to continue the execution of the CALL command Note The CALL function may change the resources such as the registers memory or I O from the state prior to the function call To restore registers hold conte
170. ect Such a recursive definition that the parent project itself serves as a subproject is impossible E Defining Subproject between Existing Projects 1 Select Project Project Dependence 2 Select the parent project in which a subproject is defined When the Project Dependence dialog is opened select the name of the parent project in which a subproject is defined from the Project Name box 3 Select the project that is defined as a subproject Check the project that is defined as a subproject from those in the Dependent Project list 4 Click the OK button Bi Deleting Subproject from Project 1 Select Project Project Dependence 2 Select the parent project from which a subproject is deleted When the Project Dependence dialog is opened select the name of the parent project from which a subproject is deleted form the Project Name box 3 Select the subproject to be deleted Deselect the subproject that is deleted from the Dependent Project list 4 Click the OK button 21 CHAPTER 2 OPERATION 2 7 Creation of Project Configuration This section explains how to create a project configuration E Creation of Project Configuration The project configuration is a series of settings for specifying the characteristics of the target file By creating a new project configuration two or more tool settings can be stored in the project When a new project is created the project configuration is
171. ect the title of the tool to delete When a category is selected all tools in the category are deleted Two or more tools can also be selected Click the DELETE button E Start sequence change procedure 250 1 2 Select Project Customize Build The customize build setting dialog is displayed Figure 4 5 40 Use the tree view to select the tools for which the start sequence is to be changed Tools in the Before After category are executed sequentially from the top 3 Click the UP and DOWN buttons to arrange in the start sequence Tools can be moved only within the category to which the tools belong CHAPTER 4 MENUS 4 5 7 Project Dependencies A subproject is defined in the project E Project Dependencies Figure 4 5 42 Dependency of project Dialog Box Dependency of project x Project name i sub prj m Project to be depended upon sample pr Project name The name of the project which a subproject is defined in or deleted from is displayed Project to be depended upon The name of the project on which the project selected in Project name can depend is displayed The project name indicated by check mark is the subproject in the project selected in Project E Procedure for defining Project dependence For the procedure for defining project dependence see Section 2 6 Definition of Subproject 251 CHAPTER 4 MENUS 4 5 8
172. ectual property right or other right by using such information FUJITSU assumes no liability for any infringement of the intellectual property rights or other rights of third parties which would result from the use of information contained herein The products described in this document are designed developed and manufactured as contemplated for general use including without limitation ordinary industrial use general office use personal use and household use but are not designed developed and manufactured as contemplated 1 for use accompanying fatal risks or dangers that unless extremely high safety is secured could have a serious effect to the public and could lead directly to death personal injury severe physical damage or other loss i e nuclear reaction control in nuclear facility aircraft flight control air traffic control mass transport control medical life support system missile launch control in weapon system or 2 for use requiring extremely high reliability i e submersible repeater and artificial satellite Please note that FUJITSU will not be liable against you and or any third party for any claims or damages arising in connection with above mentioned uses of the products Any semiconductor devices have an inherent chance of failure You must protect against injury damage or loss from such failures by incorporating safety design measures into your facility and equipment such as redundancy fire protection and preven
173. ecuting This specifies whether or not to display a dialog in which additional options can be specified at executing the tool When adding options at executing the tool check the check box The option set in the set dialog of additional parameter is added as it is to the end of the character string specified for Option E Use Output window To display the tool execution result in the output window check the check box There are some precautions to follow when using the output window For details refer to Section 1 11 Macro Descriptions Usable in Manager in the SOFTUNE Workbench User s Manual Contents of the temporary file When the TEMPFILE macro is specified for Option SOFTUNE Workbench creates a new temporary file at executing the tool and deletes it at ending the tool execution In this field specify the data to be written to this temporary file For example when the tool option becomes very long it is possible to specify TEMPFILE for Option and specify that option in this field However this is only valid when the tool to be executed permits specifying the option in the file Macros can be input in this field For the macros refer to Section 1 11 Macro Descriptions Usable in Manager in the SOFTUNE Workbench User s Manual 249 CHAPTER 4 MENUS E Setting procedure 1 8 9 Select Project Customize Build The customize build setting dialog is displayed Figure 4 5 40 Select the to
174. ed in the combo box the project to be stored is defined as a subproject in the specified project E Procedure for Addition For the procedure for addition of a project see Section 2 4 Storing of Project 194 4 5 3 Add Member Add Member adds a file to the project CHAPTER 4 MENUS E Add Member There are the following two menus to add a member File A file is specified and stored in the project Directory A directory is specified to store its file and folder in the project 195 CHAPTER 4 MENUS 4 5 3 1 Add Member File A file is specified and stored in the project E Add Member File The file dialog box for file selection is displayed Two or more files can be selected at a time Figure 4 5 3 Add Member Dialog File Look in a Project e er E3 2 154 MB91301 File name startup asm sample c Files of type Source File cpp cc css c asm Cancel Automatic Insertion Folder sampie Source Files Mem Type The file to be stored is stored as the type of specified member in the project If Auto is selected the type of member is determined by the extension nsertion Folder The project in which a file is stored and the folder into which the file is inserted are specified The character string enclosed between and is the project name BB Procedure for Addition For the procedure for a
175. ed to the left of Mix Display mixed display is not set 3 Select Mix Display When it is already set mixed display is reset and the check mark is deleted When it is not set mixed display is set and a check mark is displayed Activate when stop Specify whether the source window should set to active or not when the program is stopped However if a source window is displayed as new it should always be activated Please operate with following procedure 1 Click the right button of the source window to display the shortcut menu 2 Please make sure Activate when stop If a check mark is placed on the left side of Activate when stop source file which corresponds to break address while halting program execution should be activated On the other hand if the source file is not displayed open a source file that corresponds to break address regardless of specification CHAPTER 3 WINDOWS 3 8 Symbol Window The symbol window displays the target file name of the current project and the symbol names e g variable name and function name being used by the file in the tree view format E Symbol Window Figure 3 8 1 is an example of the symbol window Figure 3 8 1 Example of Symbol Window ETT L OL x Class Information H table Global Symbol main Di value sort val exit start target startup end LO Ll L2 LE stack top start main sample
176. editor is registered as another editor Click the Setup button The dialog box asking you whether to change the editor opens Click the Yes button E Setting the editor to be used 326 1 2 3 Register the external editor to be used according to the editor registration procedure Click the V button to the right of the Available Editor field The drop down list showing registered editor titles is displayed Select the editor title you want to use from the drop down list CHAPTER 4 MENUS B Example Example of Fujitsu Power EDITOR setup Title Power EDITOR Execution File Name c Powered powered exe Option 1 RunTime Directory x Entering the above and clicking the Setup button registers Fujitsu Power EDITOR in the editor list After registering Fujitsu Power EDITOR select Power EDITOR from Available Editor and click the OK button 327 CHAPTER 4 MENUS 4 7 7 Error Error registers error message patterns of various tools to enable error jump B Error jump setup procedure 1 Select Error from the Setup menu The error jump setup dialog box shown in Figure 4 7 31 opens 2 Enter a syntax For details on syntaxes refer to Section 1 7 Error Jump Function in SOFTUNE Workbench User s Manual 3 Enter a comment as required Acomment can be added to each syntax 4 Click the Set button Figure 4 7 31 Error Jump Setup Dialog Box Setup Error Jump
177. eing edited is not yet saved the dialog box asking you whether to save the window opens The file opened by the external editor cannot be closed by this function Even if all windows are closed the SOFTUNE Workbench state remains unchanged For this reason register values etc are not affected even during debugging 337 CHAPTER 4 MENUS 4 9 Help Help displays online help Bi Online help Help Topics Support Information Bi Version information About Fs911s 338 CHAPTER 4 MENUS 4 9 1 Help Topics Help Topics retrieves help items according to keywords E Contents Contents hierarchically displays online help contents It is used to search the contents for the item you want to see B Keyword SOFTUNE Workbench searches the help file for the directly specified item 339 CHAPTER 4 MENUS 4 9 2 Support Information Support Information opens the attached support information file in the edit window E Support information Support information provides the information not written in the attached manual You should read through support information once before using SOFTUNE Workbench 340 CHAPTER 4 MENUS 4 9 3 About Fs911s About Fs911s displays SOFTUNE Workbench version information E Version information display when SOFTUNE Workbench is not in the debug session About 9115 opens the version information dialog box showing the SOFTUNE Workbench logo mark and version numb
178. en the source window Function name Double click the function name to jump to the source window of the function definition position ABS tab bitmap image list Load module C source file C source file Assembler source file EJ Function name 53 CHAPTER 3 WINDOWS Shortcut menus Click the right button of the mouse a load module name Figure 3 4 20 shows a shortcut menu Figure 3 4 20 Shortcut menu on a load module name Open Order by name Order by address Property Open Cannot be selected Order by name Sort items in the tree in alphabetical order Order by address Sort functions in the tree in address order and sort other items in the tree in alphabetical order Property Information on the load module file is displayed See Section 4 3 9 Property Shortcut menus Click the right button of the mouse on a source file name 54 Figure 3 4 21 shows a shortcut menu Figure 3 4 21 Shortcut menu on a source file name Open Order bv name Order by address Property Open Opens the selected source file in the source window Order by name Sort items in the tree in alphabetical order Order by address Sort functions in the tree in address order and sort other items in the tree in alphabetical order Property Display the properties of the source file CHAPTER 3 WINDOWS Shortcut menus Click the right button of
179. enabled the ISS does not write data to memory Therefore when write data is reflected in ISS memory data must be written by using SSDI_Write_Memory When write data is disabled data is written to ISS memory Set the count of cycles taken for write access as the count of cycles taken for access info cycle If this access cause an error use SSDI_Request_Abort to stop instruction execution Remarks The count of cycles from the beginning of the instruction inst_cycle is always posted as 0 395 APPENDIX G 8 5501 Execute Event Post Execute Instruction Format void SSDI Execute Event EXECUTE EVENT info Argument typedef struct unsigned long addr Access address unsigned long total_cycle Total cycle count EXECUTE_EVENT Return value None Explanation Posts the occurrence of a fetch access event by instruction execution This event posts only the starting address of the instruction immediately before instruction execution Remarks 396 APPENDIX G External I F DLL for Simulator G 9 SSDI Interrupt Event Post Interrupt Format void SSDI Interrupt Event INTERRUPT EVENT info Argument typedef struct int int number Interrupt number unsigned long total cycle Total cycle count unsigned long int cycle Cycle count of interrupt processing unsigned long cycle Count of cycles delayed INTERRUPT EVENT Return value None Explanation Posts the o
180. end The project file can be opened instead of the workspace file For details see Section 2 3 Creating Workspace 115 CHAPTER 4 MENUS 4 2 5 Close Workspace Close Workspace closes the currently open workspace file E When the currently open workspace file is not edited at all When the workspace file is closed the dialog box for asking the operator whether to save the current workspace information opens Yes button Saves the current workspace file information and closes the project No button Closes the project file without saving the current workspace information Cancel button Cancels workspace file close processing In the following cases however the above dialog box does not open The workspace and project are not modified When the workspace file is closed inquiry for save is not set E When the currently open project file is being edited 116 The dialog box for asking the operator whether to save the current workspace information opens When the Yes or No button is clicked to continue processing the dialog box for asking the operator whether to save the file being edited subsequently opens Yes button Saves the file being edited and then closes the workspace file No button Closes the workspace without saving the file being edited Cancel button Workspace is closed with the file being edited opened CHAPTER 4 MENUS 4 2 6 Save Save saves the currently open
181. er E Version information display when SOFTUNE Workbench is in the debug session About 9115 opens the version information dialog box showing the SOFTUNE Workbench logo mark version number type of the currently selected debugger and type of the target MCU being debugged Reference Be sure to let us know the displayed version information when asking our company about SOFTUNE Workbench 341 CHAPTER 4 MENUS 342 CHAPTER 5 Add in Module This chapter explains SOFTUNE WORKBENCH Add in module 5 1 Customize Bar 5 2 FLASH Loader 343 CHAPTER 5 Add in Module 5 1 Customize Bar This chapter describes the Customize Bar of the SOFTUNE Workbench 5 1 1 What is Customize Bar 5 1 2 Customize Bar Menu 5 1 3 Registering in the Customize Bar 5 1 3 1 Registering Batch File 5 1 3 2 Registering Workbench Menu 5 1 4 Warning and Error Messages 5 1 5 Note 344 CHAPTER 5 Add in Module 5 1 1 What is Customize Bar This section describes the customize bar and how to install it B What is Customize Bar The customize bar registers batch files and Workbench menus used while running the Debugger in a tool bar This function enables you to call them up easily by clicking one of the buttons You can register up to ten objects Items that have been set once are restored when the Debugger is restarted Figure 5 1 1 Customize Bar Al 2A AA AA By registering batch files or Workbench menus in the
182. erty 106 View Project Project Output Symbol Assembly Register Memory Local Watch Trace Performance Command Realtime Memory RAM checker Tool Bar Status Bar Fonts Active Project Add Project Add Member Setup Workspace Setup Project Setting Customize Build Project Dependencies Project Configuration Include Dependencies Compile Make Build Stop Run Abort Reset of MCU Break point Breakpoint Set Reset Event Sequence Stack CHAPTER 4 MENUS 107 CHAPTER 4 MENUS Time Measurement Call Clear Call e Vector Load Target File Start Debug End Debug Development Debug Environment Memory Map Tool Keyboard Editor Error e Tool execution Window Cascade Vertical Horizon Split Arrange Icons Refresh Window Refresh All Windows Close All Windows Help Help Topics Support Information About Fs911s 108 CHAPTER 4 MENUS 4 2 File Menu File Menu of SOFTUNE Workbench has the following functions Workspace and file accessing Printing e End of SOFTUNE Workbench E Functions related to project and file accessing The project and file accessing functions are as follow New Open Close Open Workspace Close Workspace Save Save As Save All Recent Text File Recent Workspace File E Other functions Other functions are as follows Print Exit 109 CHAPTER 4 MENUS 4 2 1 Ne
183. es all the minimized windows in the SOFTUNE Workbench main window Figure 4 8 1 However unminimized windows are not affected Figure 4 8 1 Main Window State After Icon Arrangement ga SOFTUNE Workbench sample Debug File Edi View Project Debug Setup Window Help w ex B55 e ies sample masta 1 Sl e resa es Ear Workspace sample Fsample abs sample pr B Source Files Pf sample c E startup asm E143 Include Files 00H smpt h 0 HH smp2 h Dependencies Debug B MB2198 sup sf Simulator sup fes 7 ea x ig Command 151 BT soklen enx 1 Symbol Edie Ea Assembly ain x BS gi wm IE DEBUG MBS1 240 EML IP ODDFABDE 7 334 CHAPTER 4 MENUS 4 8 4 Refresh Window This command updates information on an active window to the latest B Refresh window Information on the current active window is updated 335 CHAPTER 4 MENUS 4 8 5 Refresh All Windows This command updates information on all the open windows to the latest E Refresh all windows Information on all the open windows except the SRC tab of project and output windows is updated 336 CHAPTER 4 MENUS 4 8 6 Close All Windows Close all windows closes all open windows Close all windows Close all windows closes all currently opened windows other than the project and output windows If the file edit window b
184. ession The dialog box asking the operator to make SOFTUNE Workbench enter the debug session opens When the OK button is clicked SOFTUNE Workbench automatically enters the debug session Clicking the Cancel button cancels file open operation CHAPTER 4 MENUS When the workspace file is not opened The dialog box for checking whether to create a new projects or whether to open the existing workspace project opens Tocreate a new projects click the Yes button Toread the existing workspace project click the No button Clicking the Cancel button cancels file open operation E Opening the binary file Specify the start address for binary data read in Start Address Bl Opening the batch file Setting Iconic starts batch processing in the icon state 113 CHAPTER 4 MENUS 4 2 3 Close Close closes open files and windows B Close Close closes the files open in the edit window or debug windows e g register window Edit Window When an unsaved modified file is in the edit window the dialog box for asking the operator whether to save the file opens Yes button Saves the file using the existing file name No button Does not save the file and closes the edit window Cancel button Cancels the close operation Debug windows e g Register Window SOFTUNE Workbench closes debug windows immediately 114 CHAPTER 4 MENUS 4 2 4 Open Workspace Open Workspace opens the exi
185. event Figure 4 6 9 Event Dialog Box Code 00000000 ini Tem l enable 00000000 FEFFFFFF Event Number Specifies an event number 1 or 2 e Address Specifies the address at which the event occurrence condition is to be set Address Mask Specifies address mask Only the addresses whose bits are 1 are to be compared Pass Count Specifies an event occurrence count 1 to 255 272 CHAPTER 4 MENUS Mode In the DSU3 chip whether display is enabled or disabled depends on the trace sampling mode When the trace sampling mode is the full mode display is enabled When the trace sampling mode is the trigger mode however display is disabled to inhibit selection because the event mode is nullified OR Mode Events are triggered when the event 1 condition or the event 2 condition is established Sequential Mode Events are triggered when the event 1 condition and event 2 condition are established in this order EventList Displays the current event setup state Data event Figure 4 6 10 Event Dialog Box Data oo g 00000000 H FFFFFFFF IJ etes 273 CHAPTER 4 MENUS Event Number Specifies an event number 1 or 2 Address Specifies the address at which the event occurrence condition is to be set Address Mask Specifies address mask Only the addresses whose bits are 1 are to be compared This item is ignored when the data valu
186. fied Assembler source file in which individual options specified not subject to making or building Include file Include file with dependence Library file Library file not subject to making or building Object file r Object file not subject to making or building 42 CHAPTER 3 WINDOWS Relative format file Relative format file not subject to making or building REALOS configuration file Other user s registration files Simulator Debugger setup name Valid setup name for Simulator Debugger Emulator Debugger setup name Valid setup name for Emulator Debugger Monitor Debugger setup name Valid setup name for Monitor Debugger Shortcut menus Click the right button of the mouse on a workspace name Figure 3 4 3 shows a shortcut menu Figure 3 4 3 Shortcut menu on a workspace name Add Project gt Property e Add Project When selected the following two submenus are displayed New A new project is added to workspace See Section 4 5 2 Add Project Existing Project An existing project is added to workspace See Section 4 5 2 Add Project Property Information on the workspace file is displayed See Section 4 3 9 Property 43 CHAPTER 3 WINDOWS E Shortcut menus Click the right button of the mouse on a target name Figure 3 4 4 shows a shortcut menu Figure 3 4 4 Shortcut menu on a target name Set acti
187. fied Project Select the project to be made or built in the SRC tab of project window Select Make or Build in the shortcut menu The active configuration of the specified project is made or built If a subproject is defined priority is given to making or building of the subproject E Changing Subproject Configuration at Making or Building 1 Select Project Configuration Set Build Configuration 2 Select the parent project and configuration When the Set Configuration when building dialog is opened select the project and its configuration to be set from the Project box The configuration of a subproject to be made or built is displayed 3 Select the configuration of a subproject Select the configuration to be made or built from Configuration of Sub project when Make Build 4 Click the OK button 28 CHAPTER 2 OPERATION 2 11 Debugging The absolute file created as a result of normal termination of make build can be debugged immediately after SOFTUNE Workbench has migrated to the debug session E Migrating SOFTUNE Workbench to debug session To enable SOFTUNE Workbench to debug the absolute file migrate it to the debug session To migrate SOFTUNE Workbench to the debug session select Start Debug from the Debug menu First debugging after project creation Setup Wizard for debuggers is started Set the type of the debugger and others Section 4 7 2 5 Setup Wizard Second or subsequent
188. fied file menu opens the dialog box in Figure 5 2 2 Figure 5 2 2 File Open Dialog Open HEI Look in 5 e ex E3 sample abs File name sample abs Files of type LoadModule File abs Cancel File Style Automatic Write AREA Start Address End Address oxorrrrF File name Displays the selected file name Filetype Limit the types of files to be displayed according to extensions Load module file abs Displays only the files with extension abs Motorola S format file ahx mhx Displays only the files with extension ahx or mhx Intel HEX file hex ihx ehx Displays only the files with extension hex ihx or ehx Binary file bin Displays only the files with extension bin All files Displays all files regardless of extension type 363 CHAPTER 5 Add in Module 364 File format The file format may not always agree with the file extension Specify the format of a selected file Auto Determines the file format according to specified file extensions as follows Extension abs Load module file Extension ahx or mhx Motorola S format file Extension hex ihx or ehx Intel HEX file Extension bin Binary file Extension other than above Binary file Load module file Specifies the load module file for a file format regardless of a specified file extension Motorola S format file Specifies the Motorola S format f
189. formance Control Dialog Buffer full break Specifies whether or not to break performance buffer full 184 CHAPTER 4 MENUS E Performance Interval Set Select Setup from the shortcut menu of the performance window Figure 4 4 30 Performance Interval Set Dialog Code m Code gt af omen sj AREAT enable Code 000802 Code 00080312 START is the performance measurement start condition END is the performance measurement end condition Enter both the start condition and the end condition e Attribute Specify the attributes of the start end condition Select code or data as an attribute Address Specify the addresses or symbols to set the start end condition Details You can set the details of the start end condition When you click the button the event details setting dialog box appears 185 CHAPTER 4 MENUS 186 Figure 4 4 31 Performance Interval Set Dialog Detail Event details H 00010000 iv H FFFFFFFF 72 Address Specify the addresses or symbols to set the start end condition The following items can be set only when the attributes of the event setting the performance section setting dialog box are data Address mask Specify the mask value for specified address Size byte halfword word Specify the data access time data size Attribute Specify the data access time attribute Don t care size A start end condition is applied when
190. formed E Setup Workspace Figure 4 5 5 Setup Workspace Dialog Setup Workspace x Setting Has Debug when workspace is open 9 Not Start Debugger Start Debugger Start Wizard CEs Save debug setup file debug environment when debug ends Q NoSave 9 Save Q Inquiry Save 493 Auto load the targeted file after make build debug session 9 MoLoad Q Load Q Inquiry Load Cancel Debug when workspace is opened Specifies the debug action just after the workspace opens Not Start Debugger Start Debugger Start Wizard Save debug setup file debug environment when debug ends Specifies whether to save setup information upon completion of debug session Not Save Save Inquiry Save e Auto load the targeted file after make build debug session Specifies whether to reload target file after make build executed in debug session No Load Load Inquiry Load 198 CHAPTER 4 MENUS 4 5 5 Setup Project Setting regarding the project is performed B Setup Project The setup project dialog has the part where the target item is set and the part where setting is performed The set values are enabled when the Apply or OK button is clicked The directory can be described in a relative path from the project If two or more target items are set the values are displayed as follows e Edit Ifthe values are equal in all target items they are displayed as they are If the values are not equal in at leas
191. func Fs respectively When CALL func Fs 10 is executed the functions defined as func short s are called CHAPTER 2 OPERATION 2 1 3 Data and Address Formulas Register name Flag name The SOFTUNE Workbench provides register and flag names as the terms of data and address formulas E Register name flag name Register and flag names can be specified in data formulas they represent register values at that point of time Specify the register name and flag name following Usable register names differ for each MCU see Appendix A Register Names CHAPTER 2 OPERATION 2 1 4 Operators Usable in Data and Address Formulas Table 2 1 2 lists the operators that can be used in data and address formulas and their priorities E Operators Usable in Data and Address Formulas Table 2 1 2 Operators Usable in Data and Address Formulas Priority Explanation Type of operator Priority change Linear expression Subscript representation Structure Structure pointer Minus sign Unary operator Address Logical NOT Bit NOT Memory indirect reference sizeof Size byte type Type cast Ea Pointer to member C Binary operator Pointer to member C Multiplication Division Remainder Addition Subtraction Left shift Right shift Less than Binary operator Less than or equal to Relational operator Greater than Greater than or equal to Equal to Not equal to Bit AND Binary operator Bit EOR Bit OR
192. function can only be used for FR60Lite Figure 4 6 11 Event List Dialog Box WATCH BREAK 00080186 main SEQUENCE OO03CBE8 LEVEL1 SEQUENCE 00081 LEVEL2 Eventlist In the event list events currently being set are displayed Delete button This button is used to delete the setting of the events in the event list currently being selected delete button This button is used to delete the setting of all the events in event list 275 CHAPTER 4 MENUS 4 6 6 Sequence Sequence displays the sequence dialog E Sequence The window that displays the sequence setting state opens This function can be used only in the FR60Lite E Setting the sequence Figure 4 6 12 Sequence setting dialog Sequence Sequencer RESTART Code END T LEVEL1 LEVEL2 Data m Code m Code Address Tn ODO3CBES B a Detail Tess Status Enable Disable START Attribute m List ps enable 003 8 Code enable 000801 1 Code enable 0008007 Event list Delete 276 CHAPTER 4 MENUS Sequencer The transition condition for the sequencer is set A maximum of 3 levels from LEVELI to LEVELS can be set Also RESTART to return control to the starting state of the sequencer can be set Setting must be performed in sequence starting wit
193. g For this reason executing debugging only requires the creation of a project for debugging First create the project for debugging and the workspace to store the project in the following procedure 1 Select New from the File menu 2 Select Project Workspace File from the file open dialog box Selectthe absolute format ABS from the new creation dialog box Specify a project name Specify a project directory Selecta target MCU name and chip type E Setting of Workspace Perform setting common to projects to be stored in workspace Select Setup Workspace from the Project menu 2 When the Setup Workspace dialog is opened perform the following setting Debug when workspace opened Start debugging Save setup information Save E Settings related to the debugger 1 Select Setup Project from the Project menu 2 When the setup dialog box opens open the Debug tag and select Setup category 3 Seta setup name A project name is set both in Setup Name List and Valid Setup Name as the default setup name Usually setup names are identified by the type of the debugger to be used However if only one debugger is used the default name may be set as it is When the default name is used as it is select the default name already set in Setup Name List then click the Change button When another name is used specify the Setup Name and click the Add Setup button Setup Wizard
194. g Local as MAC Address consult the LAN administrator Select Exit from the Setup menu to exit the LAN address setup program Press the emulator reset button button on rear to reset the emulator APPENDIX C Setting LAN Interface Note MB2198 emulator have following interface to set IP address subnet mask and port address LCD of status display on emulator and three setting switch button This procedure is following 1 Push ENTER button on emulator to change parameter input mode 2 Select LAN menu with up or down button and push ENTER button 3 Select IP Address menu with up or down button and push ENTER button Select the digit to change with up or down button and push ENTER button Change number with up or down button and push ENTER button To finish input IP address select OK with up button and push ENTER button after input least significant address 4 Select Subnet Mask menu with up or down button and push ENTER button The procedure to input data is same as IP Address 5 Select Port Address menu with up or down button and push ENTER button The procedure to input data is same as IP Address 6 Select Exit menu with up or down button and push ENTER button 379 APPENDIX APPENDIX D Setting USB Interface Communication via USB requires installation of the USB driver in the personal computer B installation of USB driver Windows 98 and Windows 2000 Windows XP connect the emula
195. g box opens see Section 4 2 9 Print Q Add to Project 1 Click the right button of the mouse to display the shortcut menu then select Add to Project from the menu e SOFTUNE Workbench adds the file being edited to the project Find Replace 1 Click the right button of the mouse to display the shortcut menu then select Find or Replace from the menu e SOFTUNE Workbench sets the clipboard character string in Find What and opens the find or replace dialog box see Section 4 3 4 Find Replace Find in files 1 Click the right button of the mouse to display the shortcut menu then select Find in Files from the menu e SOFTUNE Workbench sets the clipboard character string in Find What and opens the Find in Files dialog box see Section 4 3 5 Find in Files 61 CHAPTER 3 WINDOWS Jump 1 Click the right button of the mouse to display the shortcut menu then select Jump from the menu The dialog box for specifying the jump destination line opens see Section 4 3 6 Jump Set the jump destination line number Click the OK button Status Bar Status bar switches status bar display nondisplay for each edit window Click the right button of the mouse to display the shortcut menu then select Status Bar from the menu When the status bar is already displayed SOFTUNE Workbench switches status bar display to nondisplay and deletes the check mark from the menu When the statu
196. ght button of the mouse to display the shortcut menu then select Move from moves it to the clipboard see Section 4 3 2 Cut Copy Paste Delete CHAPTER 3 WINDOWS Copy 1 Select the character string you want to copy 2 Click the right button of the mouse to display the shortcut menu then select Copy from the menu e SOFTUNE Workbench copies the selected character string to the clipboard see Section 4 3 2 Cut Copy Paste Delete Paste 1 Move the cursor to the position into which the character string is to be inserted 2 Click the right button of the mouse to display the shortcut menu then select Paste from the menu e SOFTUNE Workbench inserts the character string in the clipboard into the cursor position see Section 4 3 2 Cut Copy Paste Delete Delete 1 Select the character string you want to delete 2 Click the right button of the mouse to display the shortcut menu then select Delete from the menu e SOFTUNE Workbench deletes the selected character string see Section 4 3 2 Cut Copy Paste Delete Select all 1 Click the right button of the mouse to display the shortcut menu then select Select all from the menu e SOFTUNE Workbench selects all the texts in the edit window and displays them in reverse video see Section 4 3 3 AII Select Print 1 Click the right button of the mouse to display the shortcut menu then select Print from the menu The print dialo
197. gistered in the list Checker window 2 Deletion of monitoring address Select the monitoring address you wants to delete from the list multiple addresses can be selected Click the Delete button The selected monitoring address is deleted from the list window 3 Change of display position Select the monitoring address you want to change from the list multiple addresses can be selected Select a display position using the Up or Down button window Note 100 When the data size is halfword lower 1 bit of the monitoring address is ignored When the data size is word lower 2 bits of the monitoring address are ignored Click the OK button The content of the setting dialog is reflected in the RAM Click the OK button The content of the setting dialog is reflected in the RAM Checker Click the OK button The content of the setting dialog is reflected in the RAM Checker CHAPTER 3 WINDOWS E Log file On the shortcut menu File open the file setting dialog Figure 3 18 5 File setting dialog File name TEMP SRL Refer File format SOFTUNE format CSV format File overwriting control When written to same file name existing file is automatically saved as new file filename srl gt filename O1 srl Cancel Specify the log file that stores sampling data and the data storage format etc 1 File name Specify the name of the log file that stores sampli
198. h LEVEL1 When correct setting is not performed or when the setting is deleted the subsequent setting will be entirely deleted Attribute The attribute of the transition condition is specified The attribute is selected from between code and data Address The address or symbol for which the transition condition is to be set is specified Details The details of the transition condition are set The dialog given in Figure 4 6 13 is displayed Status Enabling or disabling of the set sequencer is set Set button The transition condition for the specified sequencer is set List The transition condition currently being set for the sequencer is displayed Event List button This button is used to display the event list dialog used to check the setting of all events Delete button This button is used to delete the setting 277 CHAPTER 4 MENUS il Sequence details setting 278 Figure 4 6 13 Sequence detail dialog Sequence details x LEVEL Address H o003C000 Pass count D Attribute IV Read Address mask HrFFFFFFF Write Size yte Don t care size Comparison condition Disable Data agreement Data not Data 00000008 Data mask H FFFFFFFF LEVEL LEVEL for which the transition condition is to be set is set Address The address or symbol for which the transition condition is to be set is specified Pass count The access count at the time of
199. h Path List E Resetting a library retrieval path 1 Select the Control Library category The library control setup dialog box shown in Figure 4 5 31 opens 2 Select the path you want to reset from Search Path List 3 Click the Delete button E Changing the library retrieval path retrieval order Library retrieval paths are retrieved in turn from top of Search Path List The order in which library retrieval paths are registered in the list can be changed in the following procedure 1 Select the Control Library category The library control setup dialog box shown in Figure 4 5 31 opens 2 Select the library retrieval path whose order is to be changed from Search Path List 3 Click the Up or Down button to move the cursor to a relevant position 232 CHAPTER 4 MENUS 4 5 5 6 Specifying Disposition Connection This section explains how to set the section allocation link option linker option E Specifying disposition connection 1 Click the Linker tab from the project setup dialog box 2 Select the Disposition Connection category The disposition connection setup dialog box shown in Figure 4 5 32 opens 3 Select Auto Disposition from the drop down list None Mode1 Mode2 NONE The linker does not allocate the sections automatically Model If any absolute sections exist when allocating sections in a ROM RAM area specified in the ROM RAM Area List the linker allocates relocatable sections to a
200. he current window 1 Please make sure that there is a cursor in a edit window 2 Please execute any of following operations Select Edit Bookmark Next bookmark in the current window Click on Next bookmark in the current window at toolbar Find Bi Move the caret to the previous bookmark in the current window 1 Please make sure that there is a cursor in a edit window 2 Please execute any of following operations Select Edit Bookmark Previous bookmark in the current window Click on Previous bookmark in the current window at toolbar Find E Clear all bookmarks in the current window 1 Please make sure that there is a cursor in a edit window 2 Please execute any of following operations Select Edit Bookmark Clear all bookmarks in the current window Click on Clear all bookmarks in the current window at toolbar Find 138 CHAPTER 4 MENUS 4 3 8 Previous error Next error Top of Error Bottom of Error Previous error Next error Top of Error Bottom of Error moves the cursor in the edit window to the source line where a make build compilation or assembler error occurred E Previous error The cursor jumps to the error line immediately before the cursor position in the output window If there is no error line before the cursor position the cursor loops back and jumps to the bottom error line E Next error The cursor jumps to the error line immediately after the cursor posit
201. he file dialog box for specifying the alias file Macro etc Displays command replacement dialog box Logging Sets log start log status display and log end Close Closes command window Load Batch File Click the right button of the mouse to display the shortcut menu Select Load Batch File from the shortcut menu The Open File file dialog box opens Select a batch file from the dialog box then click the Open button Load Alias File Click the right button of the mouse to display the shortcut menu Select Load Alias File from the shortcut menu The Open each File file dialog box opens Select an alias file from the dialog box then click the Open button Macro etc Click the right button of the mouse to display the shortcut menu Select Macro etc from the shortcut menu The Command Replacement dialog box opens For details see Section 3 15 1 Setting Character String Replacement Logging For logging see Section 3 15 2 Logging Close 1 Click the right button of the mouse to display the shortcut menu 2 Select Close from the shortcut menu 87 CHAPTER 3 WINDOWS 3 15 1 Setting Character String Replacement This section explains how to set character string replacement in the command window E Setting Character String Replacement The aliases variables and macro names of the commands used in the command window can be defined B Alias The comm
202. he following debugger windows valid only when SOFTUNE Workbench is in the debug session e Symbol Assembly Register Memory Local Watch Trace Command Realtime memory Performance RAM checker Tool bar status bar The view menu can set the tool bar and status bar to view or nonview The set of tool buttons displayed in the tool bar can also be selected using the view menu Tool bar Status bar E Display non display the window switching using the tab This function enables to choose whether the tab is displayed or non displayed for switching By using the switching tabs it enable to switch edit source memory or watch windows easily Tab E Font related items The fonts for each window can be changed Fonts 151 CHAPTER 4 MENUS 4 4 1 Project Output Project switches the project window to view or nonview or vice versa Output switches the output window to view or nonview or vice versa E Project Window When the project window is displayed a check mark is set to the left of Project in the view menu Even if the project window is switched to nonview the project is not closed When it is switched to display again the project window is displayed at the previously displayed position E Output Window When the output window is viewed a check mark is set to the left of Output in the view menu Even if the output window is switched to nonview data in the output window is not c
203. he project is displayed e Size Displays the file size Modified Displays the date and time of the last file update 141 CHAPTER 4 MENUS Figure 4 3 10 Property Project Window General 2 File Property Eg Source Files Oe Folder name The name of the selected folder is displayed If editing is enabled folder name can be changed Position The place of the selected folder is displayed Figure 4 3 11 Property Project Window General 3 File Property Inl Emulator Debugger 7 E m ED Setup name The selected setup name is displayed Debuggertype The debugger type set in debugger setup is displayed Information The device type host port baud rate batch file before performing load batch file after performing load etc are displayed The displayed information depends on the device type etc 142 CHAPTER 4 MENUS E Property Conditions Figure 4 3 12 Property Project Window Dependence File Property C compiler Tool Displays the language tool to be executed File Displays a dependency file list Selecting a file name from this list displays the update date and time of the file Modified Displays the date and time of the last file update 143 CHAPTER 4 MENUS E Property Input Figure 4 3 13 Property Project Window Input File Property D SoftuneBSsample 31 1 Project MB91301 0BJ start
204. he project within workspace the project dependence is also deleted Note If SOFTUNE REALOS is not installed REALOS is not displayed as the project type CHAPTER 2 OPERATION 2 5 Creating and Registering Source File in Project This section explains the procedure for creating a new source file with SOFTUNE Workbench and registering the file in the project E Creating the new source file 1 Select the File New menu When the New dialog box opens select Text File from Types of Files then click the OK button 2 Select the File Save As menu When the Save As dialog box opens select Text File from Types of Files then click the OK button When the file dialog box for specifying the directory to which the created file is to be saved and the file name opens select the directory specify the file name then click the Save button E Registering the created file in the project Select the Project Add Member File menu The file dialog is opened to select the file to be added to the member Select the created source file followed by the folder inserted into the SRC tab of project window and click the Open button The file is stored in the project and its name is displayed in the specified folder in the SRC tab of project window Storing Created File with Directory in Project Select the Project Add Member Directory menu The Add Member Directory dialog is o
205. he subproject The subproject in the project is displayed below the parent project e Display of the project target file name e Display of all the source file names registered in the project When a source file name is double clicked the editor opens to enable the editing of the source file e Display of the include files that are in dependency When an include file name is double clicked the editor opens to enable the editing of the include file 41 CHAPTER 3 WINDOWS Displaying Debugger setup name When the Debugger setup name is double clicked debugging is started based on the setup information Drug and drop The member in the SRC tab can be moved in the Project window and stored from the explorer B SRC tab bitmap image list Er Workspace file name Target file name Subproject name Folder Category C source file C source file not subject to making or building C source file in which individual options specified C source file in which individual options specified not subject to making or building C source file C source file not subject to making or building C source file in which individual options specified C source file in which individual options specified not subject to making or building IJ EN ABAR Assembler source file w J EX EJ FF Assembler source file not subject to making or building Assembler source file in which individual options speci
206. he watch window The shortcut menu is displayed 2 Click Setup The watch setup dialog shown in Figure 4 4 14 opens 3 Input a variable name from the dialog Also select a mode as required 4 Click the OK button Figure 4 4 14 Watch Setup Dialog Variable name Made Automatic Watch 1 v di Variable name Specify the name of a variable to be displayed Mode Specify the mode C or assembler language in which a variable is displayed For automatic operation the variable is displayed in the predetermined language mode Automatic C language Assembler Watch Specify the Watch Window Number E Setting a radix 166 The radix when a variable value is displayed can be set for each variable using the following procedure 1 Click the right button of the mouse in the line containing the variable of the radix to modify The shortcut menu is displayed 2 Move the mouse cursor to Radix The list showing selectable radix is displayed in the submenu 3 Select the radix to modify from the list CHAPTER 4 MENUS Modifying a variable value The variable value can be modified using the following procedure 1 Click the right button of the mouse in the line containing the variable to modify The shortcut menu is displayed 2 Select Edit from the shortcut menu The variable edit dialog shown in Figure 4 4 15 opens 3 Set a variable value then click th
207. hed to the windows Thus this makes easy to switch windows 179 CHAPTER 4 MENUS 4 4 11 Fonts The fonts for each window are changed Setting fonts The font information font name and size currently set for each window can be displayed and the setting can be changed Also all font settings can be reset to the defaults During debugging the fonts for debug related windows such as source window can be changed E Changing fonts Change fonts as follows 1 Select the View Font menu The font setting dialog is displayed Figure 4 4 26 Select the window with the font to be changed and click the Font button The font setting dialog is displayed Figure 4 4 27 Specify the font name and size and click the OK button The font type that can be selected depends on the window When the OK button in the font setting dialog Figure 4 4 26 is clicked the window fonts are changed E Resetting fonts Reset fonts as follows 180 1 Select the View Font menu The font setting dialog is displayed Figure 4 4 26 Click the Reset button 3 The fonts for the window displayed in Window are all reset to the defaults When the OK button is clicked the window fonts are returned to the defaults CHAPTER 4 MENUS Figure 4 4 26 Set Font Dialog Terminal O Times New Roman O Trebuchet MS Tunga O Verdana 181 CHAPTER 4 MENU
208. ight button of the mouse in the memory window to display the shortcut menu then select Find from the menu The search dialog shown in Figure 4 4 7 opens Figure 4 4 7 Search Dialog Start address 00000000 End address 00000058 Close Byte Find data H 01 Skip data count 07 Start Address Specifies start address of search range End Address Specifies end address of search range Type Selects data type Byte Halfword Word DoubleWord Ascii Find Data Specifies matching data type When ASCII is selected as the data type specify a character string To search for several data items continuously when the data type is not ASCII write each item delimited by a comma Skip Data Count To search the search range continuously set 1 When a value greater than or equal to 2 is set as the skip byte count addresses are skipped for each set count and the search range is searched 160 CHAPTER 4 MENUS E Special operation To fill memory with data or to copy data to memory start debugging click the right button of the mouse in the memory window to display the menu then select Special from the menu The memory operation dialog opens Clicking the OK button from this dialog starts the function of the open tab e Fill Figure 4 4 8 Memory Operation Dialog Fill Fil Copy Start address 00000000 End address 00000058 Byte M Fil data HTF
209. ile for a file format regardless of a specified file extension Intel HEX file Specifies the Intel HEX file for a file format regardless of a specified file extension Binary file Specifies the binary file for a file format regardless of a specified file extension Write area Specify the FLASH memory area to which the selected file is downloaded This area does not include the area specified in the Load Environment Setting Dialog Box see 5 2 2 6 Setting of Environment to load This information is restored when the Debugger is restarted Start address Specify the start address of the FLASH memory area to be written or erased End address Specify the end address of the FLASH memory area to be written or erased E Caution CHAPTER 5 Add in Module The program downloads file as follows according to the item specified in File format Load module Motorola S format or Intel HEX file The program automatically checks whether the specified FLASH memory area contains data in the file If the specified area is out of the FLASH memory area the following message dialog is opened see Figure 5 2 3 Figure 5 2 3 Message Dialog Box N There are data in FLASH memory area outside Do you continue processing OK button Downloads only the data within the specified write area Therefore the program after downloading may not run normally Cancel button Stops downloading Binary file The program downloads data from the
210. iled without being saved source file before editing 257 CHAPTER 4 MENUS 4 6 Debug Debug starts and terminates debugging and controls the debugger when SOFTUNE Workbench is in the debug session E Debug start and termination Loading Target File Start Debug End Debug E Debugger control when SOFTUNE Workbench is in the debug session e Run e Abort Resetof MCU e Breakpoints e Breakpoint Set Reset Event Sequence Stack Time Measurement Call Clear Call Vector 258 CHAPTER 4 MENUS 4 6 1 Run This section explains the debugger program execution function B Run Run provides the following six functions Go When Go is clicked the debugger continuously executes the program from the current PC position When a breakpoint is reached or when Abort is selected from the Debug menu the debugger stops program execution Step In When Step In is clicked the debugger executes the step moves the PC to the address of the next instruction and stops When a function call instruction is executed the debugger stops at the beginning of the function Step Over When Step Over is clicked the debugger executes the step moves the PC to the beginning of the next instruction and stops When a function call instruction is executed the debugger executes all the functions moves the PC to the next instruction address of the function call instruction and stops S
211. in the check box for When a ROM RAM area is specified beyond the internal ROM RAM range the warning is issued When an area outside the internal ROM RAM area is specified in the dialog a warning dialog is displayed When an area outside the internal ROM RAM area is set a warning is output at linking Bi Method of outputting warning when section placed outside specified ROM RAM area range 1 Put a check mark in the check box for When sections are arranged beyond the range that the ROM RAM area is specified the warning is issued When a section is placed outside the specified ROM RAM area ro and ra options or outside the internal ROM RAM area in the MCU a warning is output at linking 237 CHAPTER 4 MENUS E When initializing Disposition Connection option based on MCU information 238 1 Click the The Disposition Connection option is reset button The Disposition Connection option is reset When this reset is performed the Disposition Connection option is set as follows Auto Disposition AL 2 Mode 2 optimum automatic Disposition by linker is set ROM RAM area ro ra The ROM RAM area is all cleared and the currently selected MCU internal ROM RAM address is set Section information sc Section information is all cleared When a ROM RAM is specified beyond the internal ROM RAM range the warning is issued check rora Setting is performed so as to output a warning However
212. in the local window E Property General Figure 4 3 18 Property Local Window General Variable x General Expression max Value 00070007 Radix Hexadecimal Type Address H 784D 7742 Expression The selected item is displayed Value The value of the selected expression is displayed Radix The base in which the value is given is displayed Type The type of the selected expression is displayed Address The symbol address of the selected expression is displayed 149 CHAPTER 4 MENUS 4 3 9 6 Property Watch Window This section explains the property in the watch window E Property General Figure 4 3 19 Property Watch Window General Variable x General Expression name Value 15 Radix Hexadecimal Type Address H 0003C1EC Expression The selected item is displayed Value The value of the selected expression is displayed Radix The base in which the value is given is displayed Type The type of the selected expression is displayed Address The symbol address of the selected expression is displayed 150 CHAPTER 4 MENUS 4 4 View Menu The view menu displays each window It also sets the tool bar and status bar to view or nonview E Window view nonview The view menu can set the following windows to view or nonview Project window Output window E Window display debug session The view menu displays t
213. including the entry point is displayed and the program stops Execute Step and Go etc subsequently to continue debugging 287 CHAPTER 4 MENUS 4 6 13 Start Debug End Debug This section explains how to start and end debugging E Starting debugging Start debug places SOFTUNE Workbench in the debug session to enable the subsequent use of debugger commands When SOFTUNE Workbench enters the debug session first load the target file see Section 4 6 12 Load Target File E End debugging End debug terminates the SOFTUNE Workbench debug session 288 CHAPTER 4 MENUS 4 7 Setup Setup sets SOFTUNE Workbench execution environment debugger mode environment and other tools E Setting the SOFTUNE Workbench execution environment Development E Setting the debugger mode environment Debug Environment Memory Map E Setting other tools Tool Keyboard Editor Error ToolStartup 289 CHAPTER 4 MENUS 4 7 1 Development Development sets SOFTUNE Workbench operation and the environment variables required by language tools e g compiler E Environment variable Figure 4 7 1 shows the environment variable setup dialog box The environment variables listed in Table 4 7 1 are set in this section Table 4 7 1 Environment Variable Names FELANG Character code system switching in the messages output by language posee tools SJIS Japanese language shift JIS ASCII English Directory in whi
214. ing of the monitoring address In addition the shortcut menus can be used to set the monitoring address and turn on off of logging 188 CHAPTER 4 MENUS 4 5 Project Project sets project related items and executes make build E Project related item setup Active Project Add Project Add Member Setup Workspace Setup Project Setting Customize Build Project Dependencies Project Configuration Include Dependencies B Make build execution Compile Make Build Stop Note No selection can be made during debug session Quit the debugger 189 CHAPTER 4 MENUS 4 5 1 Active Project The active project is replaced E Active Project When the names of all projects in workspace are displayed in the submenu click the name of the project that is made active A check mark is placed at the left side of the active project name in the menu 190 CHAPTER 4 MENUS 4 5 2 Add Project A project is added to workspace Add Project There are the following two menus to add a project New A new project is created and stored in workspace Project An existing project is stored in workspace Note If any project having the same name as that of the project to be stored is in workspace it cannot be stored in workspace 191 CHAPTER 4 MENUS 4 5 2 1 Add Project Create A new project is created and stored in workspace E Add Project Create Figure 4 5 1 Create Pro
215. initialization Remarks Now an external I F module can be called 390 APPENDIX G External I F DLL for Simulator G 3 SSDI Ready Ready Format void SSDI Ready void Argument None Return value Return NORMAL 0 Returning any value other than NORMAL 0 causes a failure to start debugger starting to fail Explanation When debugger activation was completed it is called Remarks It is called after having done batch file execution and an automatic road in debugger start 391 APPENDIX G 4 SSDI End End Format void SSDI End void Argument None Return value None Explanation A call is made when the debugger is ended Perform necessary end processing Remarks 392 APPENDIX G External I F DLL for Simulator G 5 SSDI Reset Event Post Reset Format void SSDI Reset Event void Argument None Return value None Explanation Posts a reset of the debugger by a command or the issue of a reset Initializes resources Remarks Sets all the interrupt states OFF 393 APPENDIX G 6 SSDI Read Event Post Read Format int SSDI Read Event READ EVENT info Argument typedef struct unsigned long int unsigned long unsigned long unsigned long unsigned long READ EVENT Return value 0 120 Explanation addr size total cycle inst cycle data cycle Read data enabled Read data disabled
216. ion in the output window If there is no error line after the cursor position the cursor loops back and jumps to the top error line Top of error The cursor jumps to the top of error line displayed in the output window Bottom of error The cursor jumps to the bottom of error line displayed in the output window 139 CHAPTER 4 MENUS 4 3 9 Property Property displays information for the specified file Property PROPERTY displays file information module information and symbol information The information to be displayed depends on the currently active window There are six windows below Project window Edit window Source window Symbol window Local window Watch window 140 CHAPTER 4 MENUS 4 3 9 1 Property Project Window This section explains the property in the project window E Property General Figure 4 3 9 Property Project Window Dialog Box General 1 General Input Filename e S11 Project MBS1301 ABS sample abe Directory Browse Filetype Target File Size 3118 bytes Modified 17 22 28 Tuesday August 10 2004 File name The fullpath to the selected file is displayed Directory The directory of the selected file is displayed If editing is enabled the file to reference can be changed If given in a relative path the directory is described in a relative path in the project file File type The type of file managed in t
217. ion or detection of characters and lines Note This function is valid only for the edit window Note that the value changed in the memory or register window when SOFTUNE Workbench is in the debug session cannot be undone Undo Redo function may not always work for a large amount of edits 124 CHAPTER 4 MENUS 4 3 2 Cut Copy Paste Delete Cut cuts the selected character string and Copy copies it to the clipboard Delete deletes the selected character string Paste inserts the cut or copied character string into the cursor position or replaces it with the selected character string B Cut CUT cuts the character string selected from the edit window and moves it to the clipboard This command can be executed only in the edit window The character string cut here can be pasted later B Copy COPY copies the character string selected from the edit window or the symbol window assembly window register window memory window local window watch window trace window or command window valid in debug session to the clipboard The character string copied here can be pasted later B Paste PASTE inserts the cut character string or the character string copied to the clipboard into the current cursor position in the edit window If the selected character string is in the edit window this command also replaces it with the character string in the clipboard Delete DELETE deletes the character string selected f
218. ions that do not belong to any C C compiler option setup categories directly at specification in Other option 210 CHAPTER 4 MENUS E Setting a macro name Setup Project x Target MB91301 Bd Figure 4 5 16 Macro Name Setup Dialog General MCU Compiler Assembler Linker 410 Category Define Macro animan of setting lt Q Source Files Macro Name TEN Value fi 0 Macro Name List Set TEN 10 sample c 8 startup asm D TEN 10 Cancel Apply If there are two or more items to be set the macro name found in some item is grayed 1 Select the Define Macro category The macro name setup dialog shown in Figure 4 5 16 opens 2 Specify the macro name 3 Specify the setting value as required 4 Click the Set button The specified macro name is set as a define D option 5 To set the specified macro name as an undefine U option reset the check mark of the macro name from Macro Name List Note When undefine is set both the define and undefine options are output for the same macro name This causes no problem because the undefine option precedes the define option 211 CHAPTER 4 MENUS E Resetting a macro name 1 Select the Define Macro category The macro name setup dialog box shown in Figure 4 5 16 opens 2 Select the macro name to reset from Macro Name List 3
219. ip type selected in Chip Classification Setup CPU Information The set CPU information dialog is opened 204 CHAPTER 4 MENUS Mode pin With some CPU series the emulator cannot refer the mode pins when the RESET command is done In this case please select either internal or external vector area with this function Automatic The emulator refers automatically the suitable vector reset area when the RESET command is done Internal vector The emulator refers the internal vector area when the RESET command is done External vector The emulator refers the external vector area when the RESET command is done Bus mode Some CPU series have access inhibited memory area The emulator debugger has the function to check whether specified address exists in the access inhibited area or not when using the command of accessing memory Please select the bus mode in this list because of different access inhibited area in each bus mode If the specified CPU doesn t have access inhibited memory area this list doesn t appear Invalid The emulator doesn t compare to the access inhibited area Single chip mode The emulator refers the access inhibited area on single chip mode Internal ROM external bus mode The emulator refers the access inhibited area on internal ROM external bus mode External ROM external bus mode The emulator refers the access inhibited area on external ROM external bus mode Bus width Select the target MCU th
220. items then click the OK button Customization procedure tab size 1 Click the right button of the mouse in the edit window to display the shortcut menu then select Customize from the menu The standard editor dialog box shown in Figure 3 6 2 opens 2 Modify the value displayed in the Tab Size field 3 When not setting other items click the OK button When selecting a display function set all the related items then click the OK button 64 CHAPTER 3 WINDOWS Customization procedure deletion of keyword 1 Click the right button of the mouse in the edit window to display the shortcut menu then select Customize from the menu The standard editor dialog box shown in Figure 3 6 2 opens Click View2 tab to choose the keyword type to be changed from the combo box Click Detail button The keyword dialog box shown in Figure 3 6 4 opens Choose the keyword to be deleted from the Keyword List field Click Delete button Click the OK button The keyword files is changed When not setting other items click the OK button When selecting a display function set all related items then click the OK button Customization procedure initialization of keyword 1 Click the right button of the mouse in the edit window to display the shortcut menu then select Customize from the menu The standard editor dialog box shown in Figure 3 6 2 opens Cli
221. ition Mode2 the linker automatically allocates sections unspecified for allocation in a ROM RAM area The linker searches an available ROM RAM area beginning at the top of the ROM RAM Area List Click the Up button or the Down button to change the desired number E Setting of the Sections Selecting the area from the ROM RAM area list and clicking the Setup Section button open the Setup Section dialog box enabling the sections to be allocated to the selected area When selecting an area click the start address of the area When the Setup Section dialog box opens specify section names in the order the sections are allocated to the area Specify section names one by one When section name specification is completed click the Setup button to register the section names in the section name list When make or built is executed the sections are allocated to the area in the order the section names were registered in the section name list When setting the sections to be allocated to one area is completed click the OK button to redisplay the linker option setting dialog box Also set other areas in the same way 25 CHAPTER 2 OPERATION Reference Allocating sections to several areas can be continuously set by changing ROM RAM area name display in the uppermost part of the Setup Section dialog box The linker option setting dialog box need not be redisplayed each time sections are allocated to an area 26 2 10 C
222. ject Dialog Ee MB91101 v E D Softune6 sample4911 Pr _ Project Type Select the project type For details about the project type see Section 2 4 Storing of Project Create new workspace New workspace is created for storage of a project This item cannot be selected e Add to the current workspace A project is stored in the currently opened workspace Chip Classification Selects the chip classification Target MCU Selects the target MCU Project Name Specifies the project name 192 CHAPTER 4 MENUS Target File Name Specifies the target file name e Project Directory Specifies the directory of the project Dependencies When the project name is specified in the combo box the project to be stored is defined as a subproject in the specified project MCU Change Opens MCU Change dialog box E Procedure for Addition For the procedure for addition of a project see Section 2 4 Storing of Project 193 CHAPTER 4 MENUS 4 5 2 2 Add Project Existing Project An existing project is stored in workspace B Add Project Existing Project Figure 4 5 2 Add Project Dialog Add Project x Lookin SYPriect Eee MBS1F154 MB91301 sample prj File name Files of type Project File pri Cancel V Dependencies sample Dependencies 2 When the project name is specifi
223. kbench Building dir into the system for example enables the output of the result obtained as a result of executing the dir command at the DOS prompt to the SOFTUNE Workbench output window Figure 4 7 28 Tool Setup Dialog Box Setup Tool D Softune6 Bin M2B5 D Softune6 Bin M2BS EXE 320 CHAPTER 4 MENUS Tool setup procedure 1 7 Select Tool from the Setup menu The tool setup dialog box shown in Figure 4 7 28 opens Set a title that differs from the registered names Specify the execution file name of the tool to be registered Clicking the Browse button to the right of this field opens the file selection dialog box The execution file name of the tool can be selected from this dialog box Set an option Macro description can be used in this field For macro description refer to Section 1 11 Macro Descriptions Usable in SOFTUNE Workbench User s Manual Write an executing directory This description may be omitted if control need not be moved to any specific executing directory Clicking the Browse button to the right of this field opens the file selection dialog box A runtime directory can be selected from this dialog box Set a check mark to the left of Designate Additional Option when Executing and Use Output Window as required When a check mark is set to the left of Designate Additional Option when Executing SOFTUNE Wo
224. king DASoftune6 sample 91 1 ProjectMB91301 ABS sample abs Now starting load module converter DASoftune6 sample 91 1 ProjectMB91 301 ABS sample mh gt Emm No Error 4 gt Tool error message example of C compiler 4 S Shortcut menu There are seven menus below 56 Copy Copies the selected character string to the clipboard Clear Clears all the items displayed in the output window Docking View Sets or resets the docking view Nondisplay Places the output window in the nondisplay status Set Font Selects a display font in the output window Keyword Coloring Whether or not to highlight the error number of the error message is set Logging The result of output to the output window is stored in a file CHAPTER 3 WINDOWS E Operation Copy 1 Select the character string you want to copy 2 Click the right button of the mouse in the output window to display the shortcut menu 3 Select Copy from the shortcut menu See Section 4 3 2 Cut Copy Paste Delete 1 Click the right button of the mouse in the output window to display the shortcut menu 2 Select Clear from the shortcut menu Docking View 1 Click the right button of the mouse in the output window to display the shortcut menu 2 Select Docking View from the shortcut menu The output window is docked with the frame in the check status Display 1 Click the right button of the mouse in the output window to display the
225. l the set keys to the initial state Ip 323 Keyboard Keyboard setup procedure 323 Keyword Customization procedure deletion of keyword A E E eek 65 Customization procedure initialization of keyword 65 Customization procedure keyword addition edades esce 64 339 L LAN interface Setting LAN interface at PC side 377 Setting LAN interface at emulator side 378 Language Language 2 LCD display LCD display at normal state 386 Librarian Starting Librarian 240 Setting librarian 239 Library Control Setting of Options for Library Control 231 Library file Setting method when debug information existence check for library file module inhibited 231 Library retrieval path Changing the library retrieval path retrieval order 232 Resetting a library retrieval 232 Setting a library retrieval 232 Line number Line 10 Linker Automatic Setting of Linker Options 25 Setting linker 226 Set
226. lains the MCU reset function of the debugger Bi MCU reset function The MCU reset function resets the MCU Emulator debugger The MCU reset function issues the reset signal to the emulator Simulator debugger As with the actual chip set the initial values of the registers to be initialized by reset and zero clear other registers In reset of MCU breakpoints watch points map setting and program variables are not modified Note The monitor debugger does not provide the MCU reset function 261 CHAPTER 4 MENUS 4 6 4 Break Point This section explains how to set reset and modify a breakpoint and how to display a break list B Breakpoint The position where program execution by the debugger is to be stopped when the PC passes an address or the program accesses data at an address is called a breakpoint Code breakpoint The breakpoint where program execution is to be stopped when the PC passes the set address when the address is executed is called a code breakpoint 262 CHAPTER 4 MENUS E Setting of code breakpoint Figure 4 6 2 Break Dialog Box Code Emulator Debugger H ODOFODODO Hardware data watch uem NN 000801 1 0 main enable 000801 1 0 sample c 74 e Break address In this field the address that sets a breakpoint is specified Type In this field the type of the breakpoint is selected This field is only enabled for
227. leared When it is switched to display again the output window is displayed at the previously displayed position If make build compile assemble update of dependencies or stop is executed when the output window is set to nonview the output window automatically enters the view status Even if the output window is set to nonview when make build compile or assemble is being executed error messages are never lost These messages are all displayed when the output window is redisplayed 152 CHAPTER 4 MENUS 4 4 2 Symbol Symbol views the symbol window B Symbol When the symbol window is opened all the symbols used in the target file are displayed in the tree format This function command can only be used when SOFTUNE Workbench is in the debug session Selecting Symbol when the symbol window is already opened activates the Window 153 CHAPTER 4 MENUS 4 4 3 Assembly Assembly displays the Assembly Window Assembly 154 When the assembly window is opened the assembly is displayed starting at the specified address Inline disassembly from the shortcut menu is also possible This function command can be used only when SOFTUNE Workbench is in the debug session When the assembly window is already opened The assembly window is activated When the assembly window not open The dialog for specifying the display start address Figure 4 4 1 opens Specify the address where display
228. lease terminate debugging and turn on the emulator again In case of RS 232C communication error please check the breaking of wire RS 232C Communication Error RS232C error Check Parameter Illegal interrupt error System error Illegal INT REALOS founds abnormal state SYSTEM DOWN Please RESET E Display error at loading monitor program to emulator The following error is displayed please turn on the emulator and load monitor program again Erase Flash Memory Error erase error Call to FUJITSU Write Flash Memory Error WRITE error Call to FUJITSU Error Occurs at Check RAM at start up RAM error Call to FUJITSU 386 APPENDIX G External I F DLL for Simulator APPENDIX G External I F DLL for Simulator Fast version of simulator debugger supports the external I F to create peripheral simulation modules This section describes external I F function E Outline of External I F DLL The Simulator Debugger for SOFTUNE Workbench supports the I O simulation function ports interrupts for aiding in debugging applications using microcontroller resources However this function is simple so that it cannot cover the simulation of complicated microcontroller resources therefore providing interface between the instruction set simulator ISS and a microcontroller resource simulator that the user describes in the C language This microcontroller resource simulator is created by the dynamic link library DLL file for Windows
229. led editing Moves the selected character string to the clipboard Copies the selected character string to the clipboard Pastes the character string in the clipboard to the cursor position Deletes the selected character string Selects all characters in the buffer Prints the file Adds the file being edited to the active project Opens the character string find dialog box Opens the character string replacement dialog box See Section 4 3 5 Find in Files Opens the jump line number specification dialog box See Section 4 3 7 Bookmark See Section 3 6 1 Setting Standard Editor Switches status bar display for each window Display file information properties Window from the menu When SOFTUNE Workbench is in the debug session the Source Window is displayed See Section 3 7 Source Window When SOFTUNE Workbench is not in the debug session this menu cannot be selected the menu SOFTUNE Workbench cancels the last editing and undoes the status before the editing see Click the right button of the mouse to display the shortcut menu then select Undo from Section 4 3 1 Undo Redo the menu Click the right button of the mouse to display the shortcut menu then select Redo from SOFTUNE Workbench cancels the cancel of the last editing the menu SOFTUNE Workbench deletes the selected character string from the edit window and Select the character string you want to cut Click the ri
230. licking a function name from the function name list immediately displays information for the function in the source window Figure 4 6 14 Call Stack Dialog Box Call stack Function name Cancel v Parameter The function written in the lowermost line of the function name list is the main function This di main function calls the function above it The called function further calls a function above it In this way the function written in the uppermost line is the function in which the current PC exists When return is executed functions are deleted in turn from the function name list starting from the uppermost line Argument Display When a check mark is set to the left of argument display an argument value is displayed after each function name as shown in Figure 4 6 14 When no check mark is set to the left of argument display only parentheses are displayed after each function name 280 CHAPTER 4 MENUS 4 6 8 Time Measurement This section explains SOFTUNE Workbench time measurement BB Time measurement Figure 4 6 15 Time Measurement Dialog Box Measurement time x From Initialize Oh0Om03s224ms874us900ns T ime From Last Executed Oh00m00s001ms845us350ns T ime From Initialize 6450279 Cycle Close 6450278 6450296 From Last Executed 3691 Cycle 3590 3708 Comment Items to be displayed xe x _ www 9 w
231. lipboard Copy Copies the selected character string to the clipboard Paste Pastes the character string in the clipboard Delete Deletes the selected character string All select Selects all the entered character strings Click the right button of the mouse on the command input field to display the menu Select Undo from the shortcut menu Select the character string you want to cut Click the right button of the mouse on the command input field to display the menu Select Cut from the shortcut menu Select the character string you want to copy Click the right button of the mouse on the command input field to display the menu Select Copy from the shortcut menu Click the right button of the mouse on the command input field to display the menu Select Paste from the shortcut menu Select the character string you want to delete Click the right button of the mouse on the command input field to display the menu Select Delete from the shortcut menu All select 1 2 Click the right button of the mouse on the command input field to display the menu Select All select from the shortcut menu shortcut shortcut shortcut shortcut shortcut shortcut CHAPTER 3 WINDOWS E Shortcut Menu Other than the command input field There are five menus below Load batch file Opens the file dialog box for specifying the batch file Load alias file Opens t
232. list are as follows sec 1 H 00001000 sec2 sec3 H 0000F000 sec4 The following sections are generated sc 1 5 2 00001000 sc sec3 sec4 H 0000F000 Example 2 When the sec4 allocation order is changed as follows sec 1 H 00001000 sec2 sec4 sec3 H 0000F000 The following sections are generated sc secl sec2 sec4 H 00001000 sc sec3 H 0000F000 CHAPTER 4 MENUS E Defining the ROM RAM area 1 Click the Add button The Setup ROM RAM area name dialog Figure 4 5 34 is opened Figure 4 5 34 ROM RAM Area Name Setup Setup ROM RAM Area Name Ed ROM RAM Area Name NRAMOI Area Attribute RAM X Start Address H o003C000 End Address H 0003F FFF Cancel 2 Specify a ROM RAM area name Specify the ROM RAM name that differs from the set names 3 Select ROM or RAM as Area Attribute 4 Specify a start address and end address starting address and end address of ROM RAM area 5 Click the OK button The specified ROM RAM area is registered in ROM RAM Area List In Auto Disposition Mode2 the linker searches an available ROM RAM area beginning at the top of the ROM RAM Area List Click the Up button or the Down button to move to a proper position E Deleting a ROM RAM area 1 Select the ROM RAM area you want to delete from ROM RAM Area List 2 Click the Delete button E Method of outputting warning when ROM RAM area specified outside range of internal ROM RAM 1 Put a check mark
233. lt and average measurement result are displayed only when measurement time is selected as the display type E Shortcut menu Update Updates performance window display Set See section 4 4 13 Performance Display Range See section 4 4 13 Performance Clear Clear performance buffer Close Closes the performance window Notes 1 This function can not use except the FR60Lite For details refer to SOFTUNE Workbench USER s MANUAL Measuring Performance 2 This function can not be used when the trace mode is set as the event mode 96 CHAPTER 3 WINDOWS 3 18 RAM Checker Window This window can be displayed for debug session This window displays the logging status and the monitoring RAM Checker window To open the RAM Checker window select the main menu View RAM Checker Figure 3 18 1 RAM Checker menu selection File Edit view Project Debug Setup v Project v Output Symbol Assembly Register Memory Local Watch Performance Command Realtime memory RAM Checker Tool bar v Status Bar v Tab Font B Function Drag and drop Registers the character string dropped on the window in the RAM Checker window as the monitoring address Figure 3 18 2 RAM Checker window Changes in data which are made during the updating of display 1011 288 are indicated in read Data for monitoring points are displayed by
234. m top to down To change the link order select the configuration to be set from the Setting Target box followed by the file name and use the Up or Down button to move the file to a desired position The Export dialog Figure 3 4 7 allows the current order to affect other configurations The files not subject to link are displayed in gray Figure 3 4 6 Set Linkage order Dialog Set linkage order MB91301 v startup asm Export MBS1F154 45 CHAPTER 3 WINDOWS Make Build Making or building is performed in the active configuration of the currently selected project to create a target file Executing linker or librarian The linker or librarian is started in the active configuration of the currently selected project to create a target file Delete Project The specified project is deleted from workspace The project file itself is not deleted Property File information is displayed See Section 4 3 9 Property Open List File Select the list file you want to open from the submenu If the list file you want to open is not created no submenu item can be selected Open HEX File Select the HEX file you want to open from the submenu If the HEX file you want to open is not created no submenu item can be selected Bi Shortcut menu Click the right button of the mouse on a subproject name Figure 3 4 8 shows a shortcut menu Figure 3 4 8 Shortcut menu on a subproject name
235. mark dot 133 Move the caret to the previous bookmark in the current window 133 136 138 Cascade Cascade iot pes eee 332 Character constant Character 10 Character String Character string search function 123 Setting Character String Replacement 88 Close all windows Close all 337 Code breakpoint Code 262 Details of code breakpoint For MB2198 MB2197 267 Details of code breakpoint Debug type 269 Details of code breakpoint Debug type Hardware datawatch 270 Setting of code breakpoint 263 INDEX Command eiiis erae e 178 Shortcut Menu Command input field 86 Shortcut Menu Other than the command input 87 Command Window Command 85 Common bar COMMON Dar ete eee nne erase eet dada eua 37 Communication Communication with host system 381 Compile COMPING e 257 Compiler Setting C C compiler options 209 Complete tool Click the OK butto
236. menu See Section 4 3 6 Jump 2 Specify a specification format 3 Select a display position 4 Click the OK button Breakpoint Set Reset After moving cursor to the line where you want to set or to cancel a breakpoint click the right button to see shortcut menu Then please select Breakpoint Set Reset Breakpoint Enable Disable After moving cursor to the line where breakpoint is set to be enable or disable click right button to see the shortcut menu Then please select Breakpoint Enable Disable This enables to switch the breakpoint which is pointed by cursor enable or disable Watch Specifies the variable to watch and opens the watch window Perform this operation in the following procedure 1 Click the right button of the mouse in the source window to display the shortcut menu then select Watch from the menu See Section 4 4 7 Watch 2 Specify a variable name 3 Select a mode as required 4 Click the OK button Property Click the right button of the mouse to display the shortcut menu then select Property from the menu File information is displayed see Section 4 3 9 Property 69 CHAPTER 3 WINDOWS 70 Mix Display 1 Click the right button of the mouse in the source window to display the shortcut menu 2 Check Mix Display When a check mark is displayed to the left of Mix Display mixed display is already set When check mark is not display
237. messages m Display color Abort I No Error mm Warning Ll Fetal Error I Fail During Start I Cancel Close the edit window when debugging By checking this item on a box edit window which opens as debugger is started will be closed 292 CHAPTER 4 MENUS 4 7 2 Debug Environment Debug Environment sets the debug environment it is valid only when SOFTUNE Workbench is in the debug session Items to be set Select and set the following items from the submenu e T O Port Interrupt e Debug Environment e Selecting Debug Function e Setup Wizard 293 CHAPTER 4 MENUS 4 7 2 1 Port This section explains the I O port setup procedure E Setting an input port Figure 4 7 4 Input Port Setup Dialog Box Setup 1 0 port Port Address Specifies a port address Mask Data Specifies address mask Only the addresses whose bits are 1 are to be compared Data Size Specifies a data input type If binary is given select the size Byte halfword word 294 CHAPTER 4 MENUS Input Type Specifies a port data input source Input terminal When an input request is issued during program execution with Input Type set to Terminal in input port setting the input terminal dialog box opens Specifying ASCII as Data Type in input port setting enables ASCII input Specifying Binary as Data Type enables binary input Figure 4 7 5 Input Te
238. mize bar If an item has already been registered in the specified number that number will be rewritten and registered Delete Deletes the contents registered in the customize bar Specify the number to delete in the File List 349 CHAPTER 5 Add in Module Figure 5 1 5 Dialog Box for Open File Open 2 Tx Look in 2X Softune amp zx oe E3 BIN Files of type Cancel Figure 5 1 6 Parameter Setting Dialog Parameter Setting Dialog x Batch File c Softune6 Initialize pre Parameter Cancel Figure 5 1 7 Menu List Dialog Menu List x Kind Function List Set Edit FileNewPrj View FileNewSrc Project FileOpen Setup Filel dPrj Cancel DEBUG FileLdSrc FileSave FileSvPrj FileSaveAs FileSaveAll FilePrint gt Explain New 350 5 1 3 1 CHAPTER 5 Add in Module Registering Batch File This section describes registering a batch file in the customize bar How to register batch file 1 Display dialog box Select View Customize Bar Setting to display the Customize Bar Setting dialog box Figure 5 1 8 Number Select the number to be registered in the customize bar Kind Select Batch File Entry Enter the batch file name to register in the customize bar You can specify using the Open File dialog box Figure 5 1 5 displayed when you click the reference button on the right Parameter Input here when specifying a par
239. mode interpretation as C C language expressions Assembler Sets the assembler mode interpretation as assembler expressions Data Size Sets the display size in the assembler mode Byte halfword word Memory Buffering Enable In case of variables as arrays or structures memory of whole variables is read They are accessed by size of the top variable Disable In case of variables as arrays or structures the memory of each element and member unit is read The default of this control is Enable If Disable is selected the watch window and the local window may be displayed slowly Specified number of array element Enable Debugger displays a warning dialog in case of big array element than the number of array element that you limited when you register or expand on array with a watch variable Element You specify number a default is D 256 of array element 300 CHAPTER 4 MENUS Note If memory buffering is set as valid correct value such as I O to request lead of fixed size can not be displayed Radix Figure 4 7 11 Debug Environment Setup Dialog Box Radix Setup debug environment Radix Sets the base number for numerical value display and analysis 301 CHAPTER 4 MENUS 302 Emulation Only Emulator debugger Figure 4 7 12 Debug Environment Setup Dialog Box Emulation Setup debug environment Memory Verify Operation Specifies whether to verify
240. n SOFTUNE Workbench files in the same drive as that of the project file are usually stored in a relative path To check whether the files are stored in a relative path check file property in the SRC tab of project window For the file property see Section 4 3 9 Property Set the path to the target file directory object file directory and list file directory to the relative path from the project file In SOFTUNE Workbench when a new project is created the output directory is set to the relative path from the project file To make a change and check open the Set Project dialog For details see Section 4 5 5 Setup Project Set the directories such as the include path and library path specified in the tool option to the relative path or macro description For the macro description see Section 1 11 Macro Descriptions Usable in Manager of SOFTUNE Workbench USER S MANUAL For the tool option see Section 4 5 5 Setup Project After the completion of the setting in steps 1 to 3 store the project Move the project file without changing the directory structure in steps 1 to 3 CHAPTER 3 WINDOWS This chapter explains SOFTUNE Workbench windows 3 1 Window Configuration 3 2 Tool Bar 3 3 Status Bar 3 4 Project Window 3 5 Output Window 3 6 Edit Window Standard Editor 3 7 Source Window 3 8 Symbol Window 3 9 Disassemble Window 3 10 Register Window 3 11 Memory Window 3 12 Local Variable Wind
241. n the debug session 258 Migrating SOFTUNE Workbench to debug SESSIO t 29 Setting the SOFTUNE Workbench execution 289 SOFTUNE Workbench configuration 3 Starting SOFTUNE Workbench 15 Terminating SOFTUNE Workbench 15 Version information display when SOFTUNE Workbench is in the debug session tended desti Piceno ps ERR Die dere 341 Version information display when SOFTUNE Workbench is not in the debug session 341 When SOFTUNE Workbench is in the debug SESSION iier terii intet 122 Source file Checking source file saving 257 Creating source file and document files etc e 111 Creating the new source file 20 Shortcut menus Click the right button of the mouse on a source file name 49 54 Source Window Source 67 Special operation Special 161 Split Slit ten Ata cen eub dimos 333 SRC tab SRG tabs rn oe ee e t 41 SRC tab bitmap image list 42 Stack en Rente ei 280 Standard editor Setting the standard editor 63 Status Bar i datu des 39 179 Tool bar status 151 Stop
242. n to complete tool setting ME ah ed Lm 24 Compliant window Compliant 131 Connection Setting disposition connection 227 Specifying disposition connection 233 Converter options Setting converter options 241 Copy CODY er tait eder aba 125 286 CPU CPU stop during logging 102 Setting of CPU Information 206 Created File Registering the created file in the project Une 20 Storing Created File with Directory in Project s 20 Current setup state list Displaying the current setup state list 323 Currently Opened Workspace Storing New Project in Currently Opened Workspace 18 Customization procedure Customization procedure deletion of keyword eus ge de dee Ren d 65 Customization procedure display color selection M Qa 64 Customization procedure display function selection 64 Customization procedure initialization of keyword 65 Customization procedure keyword addition n E 64 Customization procedure tab size 64 Customize Bar Customize Bar 347 INDEX Installing Customize Bar
243. ng All individual options in the specified folder are returned to common options Delete The specified file is released from the project member The file itself is not deleted Property File information is displayed See Section 4 3 9 Property 50 CHAPTER 3 WINDOWS Shortcut menus Click the right button of the mouse on a file in the Dependencies category Figure 3 4 16 shows a shortcut menu Figure 3 4 16 Shortcut menu on a file in the Dependencies category Open Property Open When SOFTUNE WORKBENCH is in the debug session the specified source file is displayed in the Source Window When SOFTUNE WORKBENCH is not in the debug session the specified source file is displayed in the edit window Property File information is displayed See Section 4 3 9 Property Shortcut menu Click the right button of the mouse on setup name Figure 3 4 17 shows a shortcut menu Figure 3 4 17 Shortcut menu on a setup name Start Debug Change Delete Property Start End Debug During debugging session the confirmation dialog Is the current session ended to start debugging is displayed Select Yes The current debugging is ended and then debugging is started based on the specified setup information During non debugging session debugging is started without displaying the confirmation dialog Debugging can be started only in the active project In debug session only the vali
244. ng a list output Figure 4 5 29 List Output Setup Dialog Box Setup Project MB31301 a sample prj B Source Files E sample c R startup asm 1 Select the Output List category The list output setup dialog box shown in Figure 4 5 29 opens 2 Set check marks to the left of the list s to be created Creates a link map list file Creates a external symbol mutual reference information list Creates a local symbol list Creates a section details map list When none of the above lists is output no other item need be set from the list output setup dialog box Execute Step 3 and after only when outputting any of the lists 3 Check Output memory usage information list as needed 4 Seta check mark to the left of A long name is not omitted as required Even symbol names exceeding one list file line are fully output 5 Specify whether to suppress page change When a check mark is set to the left of Control of changing page page change is suppressed When page change is suppressed the line count cannot be set 6 Set line count and column count to the right of Line and Column as required 229 CHAPTER 4 MENUS E Setting absolute format assemble list options 230 Figure 4 5 30 Absolute Format Assemble List Setup Dialog Box General MCU Compiler Assembler Linker Absolute Assembly List ba IV Creates an absolute assembly list Output m
245. ng address to which the section is to be allocated Select and set a content type from the drop down list as required Click the Set button The specified section is added to the end of Section Name List When all settings are completed click the OK button To continuously allocate several sections to the specified address execute step 6 set section name and content type only then click the Set button Repeat this operation the number of sections to be allocated Sections are allocated in the specified order For how to change this order see changing the section allocation order 235 CHAPTER 4 MENUS E Changing the section allocation order 1 Click the Set Section button The section setup dialog box shown in Figure 4 5 34 opens 2 Specify the area you want to change in ROM RAM Area Name When an address is directly specified select Addressing The sections to be allocated to the area or address are displayed in Section Name List 3 Select the section name whose order is to be changed then click the Up or Down button to move the cursor to a relevant position For addressing also see notes in addressing E Notes in addressing 236 Examples of relationship between descriptions in Section Name List and the linker options to be generated are given below Pay special attention when changing the section allocation order Example 1 When descriptions in Section Name
246. ng data When extension is omitted an extension appropriate to the selected file format is added automatically For SOFTUNE format SRL is added For CSV format CSV is added 2 File format Select the data storage file format from SOFTUNE format and CSV format SOFTUNE format When displaying data using the RAM Checker Viewer recommended CSV format When displaying data using other than the RAM Checker Viewer Note The CSV format requires about four times the data size required for the SOFTUNE format 3 Hile overwrite control This function is used to get data without overwriting the log file made once When this function is enabled the log file is saved automatically using save as To enable this function check the appropriate check box Operation example When the specified log file filename srl exists the log file is made as filename srl gt filename 001 srl and Similarly when filename 001 srl also exists the log file is made as filename srl gt filename 002 srl and Similarly when filename 002 srl also exists the log file is made as filename srl gt filename 003 srl and 101 CHAPTER 3 WINDOWS the log file is made as filename srl gt filename xxx srl Notes 1 Only internal HDD is supported for the log file storage destination Network external HDD and external disk such as CD DVD and MO are not supported for the log file storage destination 2 Storing the log file of the R
247. ng here when factor clear by software is required e jnittime Initializes measurement timer valid when execution time measurement function SHOW TIMER command used If this function is not used write RET only 383 APPENDIX e clrtim Clears measurement timer and starts measurement If the timer function is not used write RET only e readtim Reads measurement timer When not using the timer function write RET only e getchr Passes 1 byte receive data to debugger e _putchr Transmits 1 byte data passed from debugger intv asm Interrupt vector table used by debugger The debugger operates when the value of register TBR is u_inf asm user version information Defines the user individual character string to display in the SOFTUNE Workbench version information V50L02 or later can be used Up to 31 characters can be defined Input O null at the end of the character string If display is unnecessary input only O null link opt Sample file to be input to linker This file is used the sample program object is linked to the debugger body mod91 1 rel Note Always link the STACK section area and DATA section area in this order The debugger clears these areas to zero 384 APPENDIX E Creating ROM on Monitor Debugger Target E When monitor debugger cannot be controlled There are cases communication between host system and target whe
248. nt function is used for measuring performance The function related to performance is enabled Note This function can be used only when the FR60Lite is used For details refer to SOFTUNE Workbench USER S MANUAL Break 315 CHAPTER 4 MENUS 4 7 2 4 Selecting Debug Function This section describes how to select the debug function debug mode Selection procedure of the debug function debug mode 1 Select the function you want to use from List of functions 2 Click the OK button or double click the function name Debug function debug mode switches Figure 4 7 26 Selecting debug function Select debug function x List of functions TIBET Cancel Note Selectable debug mode varies with the emulator or its connection configuration When there is no selectable debug function the menu Select debug function is disabled always treating debug mode as RealTimeMemory mode For the function of each debug mode refer to the Debug mode section in SOFTUNE Workbench User s Manual Changing a mode clears all the trace and performance data At startup time debug mode is set to RealTimeMemory mode 316 4 7 2 5 CHAPTER 4 MENUS Setup Wizard This section explains how to operate the debugger s setup wizard Setup Wizard operation procedure 1 Select Setup Name from Startup Selection then click the OK button The check dialog box opens 2 Click the OK button
249. nts prior to the function call and execute the functions or use Clear Call function Other resources are not restored 283 CHAPTER 4 MENUS 4 6 10 Clear Call This section explains the SOFTUNE Workbench call clear function E Clear Call Clear Call is used to restore the original state without executing the function call see Section 4 6 9 Call to the end This function is used after program execution has been stopped by Breakpoints etc When Clear Call is executed control returns from the immediately called function In this case the function call result is not displayed because the called function is not executed to the end 284 CHAPTER 4 MENUS 4 6 11 Vector This section explains how to display and modify SOFTUNE Workbench vectors E Vector When the MCU is reset or when an interrupt processing request is issued for a variety of factors the MCU sets the data set in the address determined in advance according to the type of the interrupt in the PC as the address of the interrupt processing routine The address at which this interrupt processing routine is set is called a vector Vectors are determined in advance according to the kind of the MCU E Display and setting vectors Display Figure 4 6 18 shows the vector display dialogs Figure 4 6 18 Vector Display Dialog Box Vector table The start address of a 00080000 start reset 1 00000000 00000000 System re program is
250. nus e Start State Exit Start 1 Click the right button of the mouse to display the shortcut menu 2 Select Start from the shortcut menu The file dialog box for selecting a logging file opens 3 Specify a logging file name then click the Save button Status 1 Click the right button of the mouse to display the shortcut menu 2 Select Status from the shortcut menu The logging state display dialog box shown in Figure 3 15 5 opens 3 If necessary change the state and output message control 4 Click the OK button End 1 Click the right button of the mouse to display the shortcut menu 2 Select End from the shortcut menu Figure 3 15 5 Logging State Display Dialog Box Setup output LX Logging name C sample_make log log Enable C Disable Cancel Control output message Display C Undisplay 92 CHAPTER 3 WINDOWS 3 16 Realtime Memory Window This window is displayed only for the debug session It is used to display the contents of the mirror memory from the specified address in the realtime area E Realtime memory window An example of the realtime memory window for MB2198 emulator is shown in Figure 3 16 1 This window is used to display the contents of the mirror memory specified using Realtime Area tab of Debug Environment on Setup menu at debugging The memory contents cannot be rewritten directly the shortcut menu B Function Drag and Drop To chang
251. o be modified to continue debugging E Setting a Radix The radix when a variable value is displayed can be set for each variable using the following procedure 1 Click the right button of the mouse in the line containing the variable of the radix to be modified The shortcut menu is displayed 2 Move the mouse cursor to Radix The list showing selectable radix is displayed in the submenu 3 Select the radix to modify from the list Modifying a variable value The variable value can be modified by the following procedure 1 Click the right button of the mouse in the line containing the variable to be modified The shortcut menu is displayed 2 Select Edit from the shortcut menu The variable edit dialog shown in Figure 4 4 13 opens 3 Set a variable value then click the OK button Figure 4 4 13 Variable Edit Dialog Edit variable x c H 00070007 Cancel 165 CHAPTER 4 MENUS 4 4 7 Watch Watch displays the watch window E Watch Window The watch window displays the values of the specified variables in tree format The variable values modified as a result of program execution are updated automatically For this reason the user can observe how variable values change as a result of program execution The shortcut menu can be used to modify the displayed variable values Setting of displayed variable is performed in the following procedure 1 Click the right button of the mouse in t
252. odule control Output File Name List ROM RAM ARRAY List sample startup Target of setting 831301 3 43 Source Files P sample c 8 startup asm sample All Check All Clear All Check All Display Position of Symbol and Address In Order Symbol Address ta_INRAMO1 0x0003C000 0x0003F FFF _INROMO1 0x00080000 0x000FFFFF 1 Select the Absolute Assemble List category The absolute format assemble list setup dialog box shown in Figure 4 5 30 opens 2 Set a check mark to the left of Creates an absolute assemble list When the absolute format assemble list file is not output no other item need be set from the absolute format assemble list setup dialog box Execute Step 3 and after only when outputting the absolute format assemble list file 3 Select the module to which the absolute format assemble list is to be output from Output File Name List then set a check mark to the left of the selected module 4 Select the module to which the ROM RAM ARRAY List is to be output from ROM RAM ARRAY List then set a check mark to the left of the selected module 5 Select display position of symbol and address from the drop down list In Order Address Symbol In Order Symbol Address CHAPTER 4 MENUS E Setting of Options for Library Control Figure 4 5 31 Library Control Setup Di
253. of the trace triggers in the trace trigger list that are currently selected All delete button This button is used to delete the setting of all the trace triggers in the trace trigger list Change button This button is used to change the setting of the trace triggers in the trace trigger list currently being selected Note This function can be used only when the FR60Lite is used For details refer to SOFTUNE Workbench USER s MANUAL Trace Trace trigger details setting dialog FR6OLite Figure 4 4 19 Trace trigger details setting dialog Trace trigger details x Trace control Trace start C Trace stop Address 000 Attribute Address mask H FFFFFFFF v Read Sie El Write C Disable Data agreement Data not Comparison condition Data 00000010 Data mask H FFFFFFFF Cancel Trace control The trace operation to be performed when the trace trigger is hit is specified 173 CHAPTER 4 MENUS Note Address The address that sets a trace trigger is specified Address mask The mask value for the specified address is specified Size byte halfword word The data size of at the time of data access is specified Attribute The attribute of at the time of data access is specified Don t care size A trigger condition is applied when the specified address is accessed regardless of the access data length
254. oftune6 sample 91 1 Project sample log already exists Do you want to replace it Select whether to add and save when selecting Yes Save Selecting No does not save trace data to the file Figure 4 4 25 Trace Data Save Dialog AN Do you want to append open in L Softune6 sample 91 1 Project sample log File Selecting Yes Add Save adds and saves trace data to the file Selecting No saves trace data to in the file 177 CHAPTER 4 MENUS 4 4 9 Command Command displays the command window il Command A debugger command can be entered and executed directly from the displayed command window The command execution result is also displayed in the command window For the supported debugger commands refer to SOFTUNE Workbench Command Reference Manual 178 CHAPTER 4 MENUS 4 4 10 Bar Status Bar Tab Tool bar sets display items Status bar or tab switches display to nondisplay or vice versa E Tool Bar Any of the following tool button sets displayed in the tool bar can be selected Common bar Find Build Debug Hlag Project For the buttons included in the above sets see Section 3 2 Tool Bar Status Bar Status Bar can only switch display to nondisplay or vice versa For status bar display items see Section 3 3 Status Bar B Tab This function enables to choose whether the tab is displayed or non displayed for switching By selecting tab function tab will be attac
255. og Setup display register Ed Register list R14 USP H1 R8 R15 55 C R2 R9 MDH CCR SCR R3 10 MDL D1 R4 R11 RP D 5 12 PS T FC z Current display register R14 USP Delete H1 R8 R15 SSP C Delete R2 R9 MDH CCR SCR R3 RIO MDLS DI Reset A4 All 00 R5 R12 PS WN T FC Z ILM gt Adding registers Add the register you want to display in the following procedure 1 then select Setup from the menu setting dialog box then click the Append button Cancel Click the right button of the mouse in the register window to display the shortcut menu The display setting dialog box shown in Figure 3 10 2 opens Select the register you want to display from Register List upper part of display register The selected register is set in Current Display Register lower part Set all the registers you want to display by repeating the above operation Click the OK button 77 CHAPTER 3 WINDOWS E Deleting registers Select the register you want to delete in the following procedure 1 Click the right button of the mouse in the register window to display the shortcut menu then select Setup from the menu The display setting dialog box shown in Figure 3 10 2 opens 2 Select the register you want to delete from Register List upper part of display register setting dialog box then click the Delete button The selecte
256. og box is displayed only at simulator debugger Allocate the same memory map as the debug target system to the debugger An address range an access attribute for the range and contents program code or data can be set from the memory map setup dialog box The memory map is automatically set when the ABS format file of the program to be debugged is read It can also be set from this dialog box Figure 4 7 27 Memory Map Setup Dialog Box Setup memory map x Start address H o0001 000 Append End address FFF Attribute v Read Write Code Map list Address range attribute O001FFFF 000201BF O003BFFF OOO3FFFF OOOTFFFF read write undefined read write undefined code read write undefined coda v4 Delete Reset bi Start Address Specifies the start address to be set End Address Specifies the end address to be set Attribute Specifies a memory space attribute Read Write or Code MapList Displays the currently set area 319 CHAPTER 4 MENUS 4 7 4 Tool Tool sets the tools to be directly started by SOFTUNE Workbench B Tools Tool is not a tool that takes charge of basic SOFTUNE Workbench functions such as a C C compiler and assembler It is a function that builds auxiliary tools e g simple filters into the system so that they can be started directly from SOFTUNE Wor
257. ol registered position from the tree view and then press the NEW button When a category is selected and the NEW button is pressed a tool entitled NEWTOOL is created at the end of the category When a tool is selected and the NEW button is pressed a tool entitled NEWTOOL is created immediately after the selected tool Tools in the Before After category are executed sequentially from the top Set the title of the tool to be registered Set the execution file name to be registered When the Browse button at the right of this field is clicked the file selection dialog is displayed and the tool execution file name can be selected from this dialog Set the option as necessary Set the execution time directory as necessary When the Browse button at the right of this field is clicked the directory selection dialog is displayed and the execution time directory can be selected from this dialog Set Enable Designate additional option when executing and Use Output window as necessary Select a category or two or more tools from the tree view to batch change Enable Designate additional option when executing and Use Output window Set the temporary file data as necessary Click the OK button to complete setting Bi Deletion procedure 1 2 3 Select Project Customize Build The customize build setting dialog is displayed Figure 4 5 40 Use the tree view to sel
258. om the project setup dialog Select category General Define Macro Include Path Optimize C or Language can be selected as category Even though any category is selected all the C C compiler option currently being set is displayed at the bottom of the dialog If the individual option is set the Common Option button can be clicked to return to the common option The macro description can be used to describe options For the macro description refer to Section 1 11 Macro Descriptions Usable in Manager of SOFTUNE Workbench User s Manual 209 CHAPTER 4 MENUS E Setting General Options Figure 4 5 15 General Option Setup Dialog Setup Project Assembler Linker 14 gt MB91301 El fGenera eun B sample prj 2 3 Source Files E sample c E startup asm The following options can be set from the normal option setup dialog Checked options are on enabled Outputs start message V Outputs debug information g Outputs warning message or warning level w Outputs used stack information file INF STACK Creates assembly list file INF LIST Control of default option file Xdof Depending on CPU classification Output warning level levels 0 to 3 may be selected instead of Output warning message At Specification in Other Option all C C compiler options can be written like start up options from command lines Write the opt
259. on are ignored Zero division results in an error E Address formula B identifier An address formula is an extension of the data formula it represents a memory location Like the data formula the address formula consists of a term and an operator The terms and operators usable in address formulas are the same as those in data formulas Alphabetic characters numbers and can be used as identifiers Each identifier must begin with a character other than numbers Uppercase characters are distinguished from lowercase characters or vice versa File name specification File name specification complies with Windows rules CHAPTER 2 OPERATION 2 1 1 Data and Address Formulas Numerical constant The SOFTUNE Workbench provides numeric constants as the terms of data and address formulas An integer or floating point number can be written as a numerical constant B Integer When writing an integer specify a specifier B Q D H 0x representing the base number of the numerical value If no specifier is specified the base number specified by the default is used The default base numbers are determined for each of the locations from which values must be entered For details see each dialog box The numerical value representation range is from 0 to H FFFFFFFF However this range is further restricted depending on the values to be entered The minus values are represented such as D 1 Example Binary constant B 1010 Oc
260. only when SOFTUNE Workbench is in the debug session The disassemble window displays the result obtained by executing disassembling at the specified address Disassemble Window Example of the disassemble window displays at Figure 3 9 1 E Function Breakpoint setting releasing A breakpoint can be set or released by left clicking gt of O at the left edge of the disassemble window Instruction execution at specified line address An instruction can be executed at the specified line address by left clicking of gt O of O at the left edge of the disassemble window Step execution step into is also enabled by clicking the left mouse button at the PC location Drag and Drop By dropping function name label or address from source window to disassemble window display will be jumped to a location where an address of dropped character string is shown Figure 3 9 1 Disassemble Window n Assembly Jol x The position of the 00040000 BHI D 00040000 S 00040002 AFFC MUL R15 R12 current instruction ma 00040004 0013 LD B R13 R1 R3 pointer is displayed 00040006 4222 LDUH R14 68 R2 00040008 7 MULUH R7 R15 em F77F BP D 00040104 The position at which 0004000 0860 DMov 180 R13 emm 5600040010 displayed 00040012 J00040014 000400 R0 B R14 72 0003FFDO the breakpoint is set is
261. orkbench windows in detail CHAPTER 4 MENUS This chapter explains in detail the SOFTUNE Workbench menu configuration and the dialog boxes to be started from each menu APPENDIX The appendixes describe the register names downloading monitor program setting LAN interface setting USB interface creating ROM on monitor debugger target display on emulator external I F DLL for simulator The contents of this document are subject to change without notice Customers are advised to consult with FUJITSU sales representatives before ordering The information such as descriptions of function and application circuit examples in this document are presented solely for the purpose of reference to show examples of operations and uses of FUJITSU semiconductor device FUJITSU does not warrant proper operation of the device with respect to use based on such information When you develop equipment incorporating the device based on such information you must assume any responsibility arising out of such use of the information FUJITSU assumes no liability for any damages whatsoever arising out of the use of the information Any information in this document including descriptions of function and schematic diagrams shall not be construed as license of the use or exercise of any intellectual property right such as patent right or copyright or any other right of FUJITSU or any third party or does FUJITSU warrant non infringement of any third party s intell
262. ot o ap E e p EE qp ec ae ette rte dior etes 344 5 1 1 Whatis Customize Bar a a niei o HU n HERRERA cana CRETAE en CX aL ERE Rigo Peng 345 5 1 2 Customize Bar Menu 3 ot Ete et i i oce Dee ERE a aede ure tn 347 5 1 3 Registering in the Customize Bar 348 5 1 4 Warning and Error Messages ameen o eriet iiei eee trennen enin tenes enn tenen E iA 355 5 1 5 pcs 356 5 2 FEASH Eoader 2 catia Ignea qe IH ed teed Pie HORE NE eite 357 5 2 1 358 5 2 2 bode del B Tie SD E 359 5 2 3 Restrictions su ene eet e Ade ere le ES 369 5 2 4 Error trat 370 APPENDIX eee X 373 APPENDIX A Register RED ete i e ee De EE RAPERE ed 374 APPENDIX B Downloading Monitor Program sess enne nennen nnns 375 APPENDIX C Setting LAN Interface en sn nennen 377 APPENDIX D Setting USB Interface 380 APPENDIX E Creating ROM on Monitor Debugger Target sssssssseeeeeeenmeneen nnne 381 APPENDIX F Display on Em lator 5 rhet dne nt eb neto n Poet epa esee i ea RARE eain dees 386 APPENDIX External I F DLL for Simulator esses eene 387 INDEX qum
263. ow 3 13 Watch Window 3 14 Trace Window 3 15 Command Window 3 16 Realtime Memory Window 3 17 Performance Window 35 CHAPTER 3 WINDOWS 3 1 Window Configuration Each SOFTUNE Workbench window consists of a menu bar tool bar window screen and status bar Menus are explained in CHAPTER 4 E Main Window Figure 3 1 1 shows the SOFTUNE Workbench Main Window As shown in this figure child windows e g project window and output window and the tool bar can be docked with the main window and displayed Figure 3 1 1 The SOFTUNE Workbench Main Window gs SOFTUNE Workbench sample Debug D Softune6 sample 911 Projec Ea E File Edit View Project Debug Setup Window Help e 218 ees es d zlej zie EE Tool Bar sample ue sample sample abs sampl 1 29 Source Files FR Family Softune C C Compi 3 ALL RIGHTS RESERVED COPYRIG 4 LICENSED MATERIAL PROGRAM I Project sample c 5 Window 0 startup asm 6 Sample program for initialize E Include Files Gs PNE eee ee Dependencies 8 51 5 Debug ML Edit Window Simulator sup Pop0 export start b sexport __ 5 NEM NS EM MM DEBUG MB31301 EML Z Status Bar Output Window
264. pecify a symbol with the same name please determine the name of module and function name first then specify a symbol 136 CHAPTER 4 MENUS 4 3 7 3 Bookmark Edit window This section explains the operation when edit window is activated To display a dialog Bookmark By selecting one of following menus dialog as shown in Fig 4 3 8 will be opened This dialog is to display the list of bookmark that is set to an edit window 1 Edit Bookmark Bookmark 2 Shortcut menu of Edit window Bookmark Figure 4 3 8 Bookmark dialog Edit window L Project sample c 26 Bookmark list The list of a bookmark file name line number which is set currently to an edit window will be displayed e Add button Setup of a bookmark to location of an edit window where cursor is put Delete button Delete selected bookmark from a list When more than one bookmarks are selected delete all items Jump button Move a start position for displaying a edit window to location of bookmark selected in bookmark list Setup or cancel of a bookmark 1 Please move a cursor to line where you want to set or cancel a bookmark 2 Please execute any of following operations Select Edit Bookmark Setup cancel bookmark Click on Setup cancel bookmark mark at toolbar Find Click Add or Delete button at the Bookmark dialog 137 CHAPTER 4 MENUS E Move the caret to the next bookmark in t
265. pen the desired text file immediately by selecting it E Recent Workspace File Of the used workspace files Recent Workspace File stores up to five most recently opened workspace files This enables you to open the desired workspace file immediately by selecting it Note If a text or workspace file is already deleted or moved to another directory it cannot be opened even if it is listed here 121 CHAPTER 4 MENUS 4 2 11 Exit Exit terminates SOFTUNE Workbench E When a file is being edited The dialog box for asking the operator whether to save the file being edited opens Yes Saves the file being edited and terminates SOFTUNE Workbench No Terminates SOFTUNE Workbench without saving the file being edited e Cancel Does not terminate SOFTUNE Workbench E When the workspace is opened The dialog box for asking the operator whether to save the current workspace information opens Yes Saves the current workspace information in the file No Does not save the current workspace information in the file Cancel Does not terminate SOFTUNE Workbench If no file is being edited SOFTUNE Workbench terminates immediately If there is a file being edited processing explained in When a file is being edited is performed E When SOFTUNE Workbench is the debug session 122 As in processing explained in When the workspace is opened the dialog box for asking the operator whether
266. pened to select the folder to be added to the member Select the directory having the created source file followed by the folder to be inserted into the SRC tab of project window and click the OK button The file and directory are stored in the project and the file and folder below the specified directory are displayed in the specified folder in the SRC tab of project window The type of file to be stored can be restricted by setting Type of File in the dialog Bi To delete files stored in the project 20 Select a file s to be deleted in the SRC tab of project window Multiple file can be selected Select Delete from the shortcut menu The selected file is deleted from the project member but the file itself is not deleted Users cannot delete files in the Dependencies category and Debug category files CHAPTER 2 OPERATION 2 6 Definition of Subproject This section explains how to define a subproject E Definition of Subproject The subproject is a project on which other projects depend SOFTUNE Workbench uses the following methods to define a subproject Defining project as subproject in storing it When created a new project is defined as a subproject in another project For the setting method see Section 2 4 Storing of Project Defining subproject between existing projects A subproject is defined between projects in workspace Another project is defined as a subproject in the subproject in the parent proj
267. quency Setup debug environment es CPU frequency Sets the maximum operating frequency of the CPU This is to set the maximum operating frequency so it does not cause the operating frequency to be changed 305 CHAPTER 4 MENUS Monitoring Figure 4 7 16 Debug Environment Setup Dialog Box Monitoring Setup debug environment D 1000 00 _ Control realtime Sets monitoring control Monitoring Pseudo on the fly monitoring is performed Real time monitoring Pseudo on the fly monitoring is inhibited and only the mirror memory is monitored When real time monitoring is selected the memory window is not monitored only the real time area is monitored on the watch window Control Window Memory window Specifies whether to monitor the memory window Watch window Specifies whether to monitor the watch window Real time Memory Window Specifies whether to monitor the real time memory window Control Sampling Sampling Time Specifies sampling time MB2197 Min 1000ms MB2198 DSU4 Min 100ms 306 CHAPTER 4 MENUS Note 1 The real time monitoring function may not be used depending on the emulator or connection format For details refer to SOFTUNE Workbench USER s MANUAL Real time Monitoring 2 This function can t be used only when MB2198 DSU3 chip that has the evaluation chip is used 3 In order to monitor the program with MB2197 and pseudo on the fly of
268. ration Figure 1 2 1 shows the basic configuration of SOFTUNE Workbench Figure 1 2 1 Basic Configuration of SOFTUNE Workbench SOFTUNE WORKBENCH body Language tool As shown in Figure 1 2 1 SOFTUNE Workbench consists of three parts body debugger and manager The debugger part contains the simulator debugger emulator debugger and monitor debugger These debuggers can be switched and used as required The manager part enables users to code and make programs without full knowledge of language tool e g C C compiler and assembler start and option specification The configurator is not built into SOFTUNE Workbench because it is an option Installing this option however enables cooperative operation on SOFTUNE Workbench SOFTUNE Workbench manages all processing from programming to debugging in units of projects Projects contain all program files options of tools e g C C compiler and debugger environment setup etc CHAPTER 1 OUTLINE OF SOFTUNE WORKBENCH 1 3 Procedure for Developing Programs with SOFTUNE Workbench The procedure for developing programs with SOFTUNE Workbench consists of the following 1 Setting SOFTUNE Workbench operating conditions 2 Designing a project 3 Creating a program source and executing make build 4 Executing debugging E Setting SOFTUNE Workbench operating conditions When developing a program with SOFTUNE Workbench first open the development environment
269. rator response The format of the file to be loaded is illegal Check the file Invalid address specifying Explanation Operator response Verify error Explanation Operator response An error is detected in addressing of the FLASH sector area The start address of the FLASH sector area is larger than its end address Specify the correct address range A memory verify error occurred during writing to FLASH memory Check if FLASH memory is provided or if errors occur in FLASH memory Target File open error Explanation Operator response The target file cannot be opened The target file may not be created Create a target file 371 CHAPTER 5 Add in Module 372 APPENDIX The appendixes describe the register names downloading monitor program setting LAN interface setting USB interface creating ROM on monitor debugger target display on emulator external I F DLL for simulator Appendix A Register Names Appendix B Downloading Monitor Program Appendix C Setting LAN Interface Appendix D Setting USB Interface Appendix E Creating ROM on Monitor Debugger Target Appendix F Display on Emulator Appendix G External I F DLL for Simulator 373 APPENDIX APPENDIX A Register Names Register names are displayed E Registers The registers that can be operated by SOFTUNE Workbench differ for each MCU type as follows General purpose registers RO to R15 Program counter PC
270. rce 16 SSDI_Set_Timer Set Timer 17 SSDI_Request_Abort Request Abort 18 SSDI_Set_Area Set Area 19 SSDI_Clear_Cycle Clear cycle count 20 SSDI_Execute_MCU Execute target program 388 APPENDIX G External I F DLL for Simulator SSDI Entry Start Format int SSDI Entry int id HINSTANCE hInstance Argument int id DLL ID HINSTANCE hInstance External I F module handle Return value Return NORMAL 0 Returning any value other than NORMAL 0 causes a failure to start debugger Explanation A call is made when the debugger is started Perform necessary initialization Remarks DLL ID id always indicates 0 The external I F module handle hInstance is used to obtain an ISS entry At this point no external I F module can be called Example typedef int WINAPI LPFNREADMEMORY LPFNREADMEMORY Read Memory extern C int WINAPI SSDI Entry int id HINSTANCE if int my dll id id FARPROC pF Read Memory GetProcAddress if SSDI Read Memory Read Memory LPFNREADMEMORY pF Read Memory int func if ReadMemory addr size len data len error 389 APPENDIX G 2 SSDI Init Initialize Format int SSDI Init void Argument None Return value Return NORMAL 0 Returning any value other than NORMAL 0 causes a failure to start debugger starting to fail Explanation A call is made when the debugger is started Perform necessary
271. re the monitor debugger cannot be controlled The possible causes are Execution is in progress the debugging state is Execute The target program is running away In such cases restart the debugger as follows 1 Select Debug D Abort A or click the Stop button 2 Click Abort A in the abort dialog In this case the MCU cannot be reset Ignore the error message even if it appears several times 3 When the warning Abort command error appears click OK 4 Stop the debugger and reset the target system 5 Restart the debugger 385 APPENDIX APPENDIX F Display on Emulator MB2198 emulator has the LCD to display emulator state LCD display at normal state The following character strings display at normal state Before Debugging NO CONNECT Enter Menu NO CONNECT is shown by no connection with host At the location the spinning animation is displayed for waiting for communication In the second line beginning ENTER the working to push Enter button is displayed While Debugging STATUS Vol Enter Menu In the first line beginning STATUS the target status is displayed at location The status is shown by EXEC or BREAK At the location the spinning animation is displayed for waiting for communication In the second line beginning ENTER the working to push Enter button is displayed E Display error at emulator debugger The following error is displayed p
272. ring debugging Specify the batch files used before and after load as required Clicking the Browse button to the right of each input field enables batch file selection Click the Next button Select the item to be set in the setup file When Specification is selected click the Setup button to open the item selection dialog box select the item to be set from the dialog box then click the OK button Click the Next button Click the Finish button Simulator debugger setup has now been completed E Procedure when the monitor debugger is selected 318 1 Select RS232C as the device type When RS232C is selected set a port and baud rate Click the Next button 3 Set whether to load the target file automatically during debugging Specify the batch files used before and after load as required Clicking the Browse button to the right of each input field enables batch file selection Click the Next button Select the item to be set in the setup file When Specification is selected click the Setup button to open the item selection dialog box select the item to be set from the dialog box then click the OK button Click the Next button Click the Finish button Monitor debugger setup has now been completed 4 7 3 Memory Map Memory Map sets the debugger s memory map CHAPTER 4 MENUS E Memory map setup Note The memory map setup dial
273. rkbench asks you to enter additional options when a tool is started When a check mark is set to the left of Use Output Window SOFTUNE Workbench displays tool output output to the standard output device or standard error output device in the output window Click the Setup button Tool deletion procedure 1 2 3 Select Tool from the Setup menu The tool setup dialog box shown in Figure 4 7 28 opens Select the tool title you want to delete from the tool list Click the Delete button 321 CHAPTER 4 MENUS Tool change procedure 1 Select Tool from the Setup menu The tool setup dialog box shown in Figure 4 7 28 opens 2 Select the tool title you want to change from the tool list The values set in Title Execute Filename Option Executing Directory Designate Additional Option when Executing and Use Output Window are displayed 3 Change Execute Filename Option Executing Directory Designate Additional Option when Executing and Use Output Window When Title is changed the set tool is registered as another tool 4 Click the Setup button The dialog box asking you whether to change the tool opens 5 Click the Yes button E Example of tool setup 322 When notepad is used Title Memo pad Execute Filename note pad exe Option f Executing Directory x Designate Additional Option when Executing A check mark is not set Use Output
274. rminal Dialog Box Input request occurred Ascir Cancel Binary f 0 Input Port List Displays the currently specified ports E Resetting an input port 1 Select the input ports you want to reset from Input port List 2 Click the Delete button 3 When resetting all the selected ports is completed click the Close button 295 CHAPTER 4 MENUS E Setting an output port Figure 4 7 6 Output Port Setup Dialog Box Setup 1 0 poit Port Address Specifies a port address Mask Data Specifies address mask Only the addresses whose bits are are to be compared Data Size Specifies a data output type If binary is given select the size Byte halfword word 296 CHAPTER 4 MENUS Output Specifies a port data output destination Output terminal When an output request is issued during program execution with Output Type set to Terminal the terminal window is displayed The output type also depends on Data Type Figure 4 7 7 Output Terminal Window Binary Terminal CE X1 806888802H 88088803H 88600885H 88868008 88888812H 80088013H 66666614H 08008015H 888886016 00000022H 00000023H 00000025H 00000025H 000000269 90000032H 66066033H 00000034H 00000036H 888842H 88888843H 8888880544H 86888845H 8B888B88546H 8 00052H 00080853H 9888888554H 88000055H 00888856H 0862H 00
275. ro Descriptions Usable in Manager of SOFTUNE Workbench User s Manual 243 CHAPTER 4 MENUS 4 5 5 9 Setting Debug Options This section explains how to set debug options E Setting debug options 1 Click the Debug tab from the project setup dialog box The debug option setup dialog box shown in Figure 4 5 38 opens 2 Select category General or Setup can be selected as category E Setting Options in General 1 Set an alias file Clicking the Browse button to the right of the input field enables file reference 2 When setting other options write them in Other Parameter Figure 4 5 38 Debug Option Setup Dialog Box General B etup Project 244 CHAPTER 4 MENUS E Setting Options in Setup 1 Click the Debug tab from the project setup dialog box 2 Select Setup category 3 Set Setup Name Seta different name from registered setup names 4 Click the Add or Browse button Clicking the Add button starts the setup wizard and adds the new setup See Section 4 7 2 5 Setup Wizard Clicking the Browse button reads information from the set file for setup When the file selection dialog opens select a file from the dialog then click the Open button Figure 4 5 39 Debug Option Setup Dialog Box Setup Setup Project ey Source Files sample c R startup asm MB2198 E MB2198 MB2198 245 CHAPTER 4 MENUS
276. rogram file is created Relative format REL A relative format file is created Library file A library file is created REALOS ABS A program that uses a realtime operating system is created Storing Existing Projects in Workspace 1 Open workspace to store a project Open workspace to store a project 2 Select Project Add Project Project 3 Open the project to be stored Select the project to be stored in the Add Project dialog 4 Set project dependence When defining a project as a subproject in another project place a check mark in the Dependence check box and select the project name from the list in the Dependence check box 5 Click the Open button E Setting Active Project The active project is a project that undergoes Make Build Compile Assemble Start Debug and Include Dependence in the menu Make Build Compile Assemble Start Debug and Include Dependence affects the subprojects in the active project To set an active project select Project Set Active Project When the submenu is displayed select the name of a project to be made active project from the submenu E Deleting Project Stored in Workspace Select the project to be deleted in the SRC tab of project window Select Delete Project in the shortcut menu The specified project is deleted from workspace but the project file itself is not deleted If the deleted project is used as the subproject in t
277. rom the edit window This command can be executed only in the edit window The deleted character string cannot be pasted later Table 4 3 1 Relationship between Edit Functions and Windows Window o S Edit Window Project Window XO gt Output Window Symbol Window Assembly Window Register Window Memory Window Local Window Watch Window Trace Window P lt PA gt lt P lt gt lt P lt P lt P lt P lt gt lt P lt P lt P lt P lt P lt P lt OX x lt Command Window Lines other than the column title can be copied 2 Only the symbol name can be copied 125 CHAPTER 4 MENUS 4 3 3 All Select All Select selects all the character strings displayed in a window B Target This function operates only in the edit and output windows 126 4 3 4 CHAPTER 4 MENUS Find Replace Find searches the text file displayed in the edit window for any character string Replace replaces the found character string with the specified character string E Target B Find FIND and REPLACE can be executed only for the text files displayed in the edit window they cannot be executed in the output window and others When the find dialog box shown in Figure 4 3 1 opens specify the character string you want to find from this dialog box Character string
278. rt dialog shown in Figure 4 5 41 By specifying a project in this dialog tool information can be copied to other projects in workspace Figure 4 5 41 Export Dialog Box Target OK sample prj EEUU Le Bess sen All select B Reset To clear the currently set state and return to the default setting click Reset button The Reset button can be used when the setting target is Project B Title Input the tool name duplicated tool names do not cause a problem E Execution File name Input the file name of the executed tool 248 E Option CHAPTER 4 MENUS Specify the option for the executed tool A macro can be specified in this field For the macros refer to Section 1 11 Macro Description Usable in Manager in the SOFTUNE Workbench User s Manual When the button at the right of this field is clicked the list of usable macros is displayed For example when Build File Directory is clicked FILE PATH is inserted for the option at the cursor position E Executing Directory B Enable To execute the tool for a particular directory specify the executing directory If the executing directory is not specified the tool is executed for the project directory This specifies whether or not to execute the tool at compile assemble make or build The tool is not executed when the check box is unchecked To suspend execution of the tool uncheck the check box Bi Designate additional option when ex
279. s Set a unique title that differs from the registered names Specify the execution file name of the editor to be registered Clicking the Browse button to the right of this field opens the file selection dialog box The execution file name of the editor can be selected from this dialog box Set an option Macro description can be used in this field For macro description refer to Section 1 9 Storing External Editors in SOFTUNE Workbench User s Manual Write a runtime directory This description may be omitted if control need not be moved to any specific runtime directory Clicking the Browse button to the right of this field opens the file selection dialog box A runtime directory can be selected from this dialog box Click the Setup button E Editor deletion procedure 1 2 3 Select Editor from the Setup menu The editor setup dialog box shown in Figure 4 7 30 opens Select the title of the editor you want to delete from the editor list Click the Delete button E Editor change procedure 1 5 Select Editor from the Setup menu The editor setup dialog box shown in Figure 4 7 30 opens Select the title of the editor you want to change from the editor list The values set in Title Execute Filename Option and Executing Directory are displayed Change Execute Filename Option and Executing Directory When Title is changed the set
280. s all breakpoints including events being set during the program downloading The program enables the breakpoints upon completion of downloading In this case note that the disabled breakpoints are also enabled Use of internal RAM The FLASH loader uses the area displayed in the Load Environment Setting Dialog Box see 5 2 2 6 Setting of Environment to load to download data Consequently note that important data and programs are overwritten Use of registers The FLASH loader uses registers to download data Consequently note that important data is overwritten Initialization of operating environments The FLASH loader automatically optimizes the operating environments when starting downloading Therefore if the operating environments are set reset them after the completion of downloading Setup environment variables Please do not use following character string for full pass in file to be downloaded by FLASH loader File may not be downloaded correctly MODR GCR PCTR FWTC FSTR FETOOL CMDADRal CMDADRa2 FSADR FEADR DRAM SIZE IADR FILEOFFSET CNTNUEFLG QUITFLG 369 CHAPTER 5 Add in Module 5 2 4 Error Message This section describes the error messages displayed when using the FLASH loader B Error Message 370 File not found Explanation Operator response The specified file was not found Check for files in the specified directory FLASH memory does not have specified area Expl
281. s bar is not displayed SOFTUNE Workbench displays the status bar and adds a check mark to the left end of the menu Property 1 Click the right button of the mouse to display the shortcut menu then select Property from 62 the list SOFTUNE Workbench displays file information see Section 4 3 9 Property 3 6 1 Setting Standard Editor This section explains how to customize the standard editor CHAPTER 3 WINDOWS E Setting the standard editor Some standard editor functions can be customized Items that can be customized Display function Line feed mark display Tab code mark display EOF code mark display Line number display Fullsize space display Ruler display Automatic indent function Colored display of C C keyword Colored display of ASM keyword Colored display of user keyword Colored display of comment statement Font Tab count Display color Bookmark Error line C C keyword Assembly keyword User keyword Comment statement Line Feed Tab Fullsize Space Keyword to highlighted 63 CHAPTER 3 WINDOWS Customization procedure display function selection 1 Click the right button of the mouse in the edit window to display the shortcut menu then select Customize from the menu The standard editor dialog box shown in Figure 3 6 2 opens 2 Select the function item you want to set or reset from the Item list then click to the left of the item 3 When not
282. se on a folder 46 Shortcut menus Click the right button of the mouse on a function name 55 Shortcut menus Click the right button of the mouse on a load module name 54 Shortcut menus Click the right button of the mouse on an include file and other user s registration 50 Shortcut menus Click the right button of the mouse on library file object file and relative format file 50 Shortcut menu Click the right button of the mouse on a subproject name 46 Shortcut menu Click the right button of the mouse on setup 51 Shortcut menus Click the right button of the mouse on a source file name 49 54 Shortcut menu Click the right button of the mouse on space in the project window M 52 55 Shortcut menus Click the right button of the mouse on a target name 44 Shortcut menus Click the right button of the mouse on a workspace name 43 Shortcut Menu Command input field 86 Shortcut Menu Other than the command input field saccis 87 Simulator Procedure when the simulator debugger is 318 Simulator external I F specification 388 SOFTUNE Debugger control when SOFTUNE Workbench is i
283. search conditions Table 4 3 2 can also be specified from this dialog box The found character string is displayed in reverse video The find dialog box is not automatically closed irrespective of whether the character string is found For this reason when search terminates click the Cancel button to close the find dialog box When SOFTUNE Workbench is in the debug session the source window can also be searched Figure 4 3 1 Find Dialog Box Find what value M Position All Find Direction C Up Down Match whole word only Match case Regular Expressions Ambiguous Cursor C Top Cancel C Bottom 127 CHAPTER 4 MENUS B Replace When the replace dialog box shown in Figure 4 3 2 opens specify a search character string and a replacing character string In this case character string search conditions Table 4 3 2 can also be specified from this dialog box The found character string is displayed in reverse video Clicking the Replace button replaces the specified search character string with the specified replacing character string Clicking the All Replace button replaces all the character strings found before search terminates The replace dialog box is not automatically closed irrespective of whether the found character string was replaced For this reason when search terminates click the Cancel button to close the replace dialog box Figure 4 3 2 Replace Dialog Box Find what v
284. setting other items click the OK button When selecting a color set all the related items then click the OK button Customization procedure display color selection 1 Click the right button of the mouse in the edit window to display the shortcut menu then select Customize from the menu The standard editor dialog box shown in Figure 3 6 2 opens 2 Click the color button of Bookmark Error C C or Assembly From View2 tab you can set a Comment Ret Tab and User keyword The color dialog box opens 3 Select a color from the dialog box then click the OK button The color of the button changes to the selected color 4 When not setting other items click the OK button When selecting a font set all the related items then click the OK button Customization procedure keyword addition 1 Click the right button of the mouse in the edit window to display the shortcut menu then select Customize from the menu The standard editor dialog box shown in Figure 3 6 2 opens 2 Click View2 tab to choose the keyword type to be changed from the combo box Click Detail button The keyword dialog box shown in Figure 3 6 4 opens 3 Enter the keyword to be highlighted in New Item field Click Add button 4 Click the OK button The keyword files is changed 5 When not setting other items click the OK button When selecting a display function set all related
285. setting value as required 4 Click the Set button The specified macro name is set as a define D option 5 To set the specified macro name as an undefine U option reset the check mark of the macro name in Macro Name List Note When undefine is set both the define and undefine options are output for the same macro name This causes no problem because the undefine option precedes the define option 221 CHAPTER 4 MENUS E Resetting a macro name 1 Select the Define Macro category The macro name setup dialog box shown in Figure 4 5 23 opens 2 Select the macro name you want to reset from Macro Name List 3 Click the Delete button E Setting an include path Figure 4 5 24 Include Path Setup Dialog Box E etup Project Include Path GI wee ed ose uo ZIE NV S3115Ssyslib Include 1 Select the Include Path category The include path setup dialog box shown in Figure 4 5 24 opens 2 Specify an include path Clicking the Browse button to the right of the input field enables directory selection 3 Click the Add button The specified include path is added to the end of Include Path List 222 CHAPTER 4 MENUS E Resetting an include path 1 Select the Include Path category The include path setup dialog box shown in Figure 4 5 24 opens 2 Select the include path you want to reset from Include Path List 3
286. shortcut menu 2 Select Nondisplay from the shortcut menu The output window enters the nondisplay status Set Font 1 Click the right button of the mouse in the output window to display the shortcut menu 2 Select Set Font from the shortcut menu The font selection dialog box Figure 3 5 2 opens 3 Select Font and Size the click the OK button Figure 3 5 2 Font Setting Dialog Box Font Size s ystem fi 0 0 Small Fonts O Sylfaen O Symbol i Cancel O Tahoma Terminal O Times New Roman Sample AaBbYyZz 57 CHAPTER 3 WINDOWS 58 Highlight Keyword 1 2 Display the shortcut menu by clicking the right button on the output window Select Keyword Coloring In the check state the keyword error number of the error message is displayed in red Logging 1 2 Display the shortcut menu by clicking the right button on the output window Select Logging Start and then specify the file name of the record target file The result of output to the output window is recorded in the specified file To suspend logging select Logging Record and uncheck the check box Logging is restarted again when the check box is checked To stop logging select Logging Termination 3 6 CHAPTER 3 WINDOWS Edit Window Standard Editor The edit window is used to display and edit a source file and document file etc E Edit window An e
287. ss Frame The following can be selected as Window Source Window Memory Window e Disassemble Window Realtime Memory Window Figure 4 3 5 Jump Dialog Box Debug Address Position main Cancel Window Source 130 CHAPTER 4 MENUS 4 3 7 Bookmark It is convenience in setting a bookmark for referring the location specified for source memory and edit windows often Once a bookmark is set there will be a mark on specified location This enables to jump to the specified location by using menu or key operation Bookmark will be validated until it is canceled B Bookmark Bookmark is a function to specify the location in window and enable to jump to the location by using menu or key operation E Compliant window Bookmark is valid in following windows Source window Memory window Edit window il Bookmark menu Menu related to bookmark is located at Edit Bookmark in a menu Sub menu consists of 7 types as follows Menu becomes valid when it is in debug session or each window is activated Bookmark Setup cancel bookmark Next bookmark e Previous bookmark Next bookmark in the current window Previous bookmark in the current window e Clear all bookmarks in the current window 131 CHAPTER 4 MENUS 4 3 7 1 Bookmark Source window This section explains the operation when source window is activated To display a dialog Bookmark By selecting Edit
288. sting workspace file il Opening the existing workspace file The file dialog box for selecting the file you want to open opens When the existing workspace file is already opened and SOFTUNE Workbench is in the debug session The dialog box for asking the operator whether to terminate debugging opens e OK button Terminates the debugger and continues workspace open processing Cancel button Cancels workspace open processing When the existing workspace file is already opened but SOFTUNE Workbench is not in the debug session The file dialog box for selecting a workspace file opens When a workspace file name is specified correctly SOFTUNE Workbench closes the currently open workspace file and then opens the specified file If the open file registered is not saved although it is being edited the dialog box for asking the operator whether to save the file opens Yes button Saves the file using the existing file name and continues processing No button Continues processing without saving the file Cancel button Cancels workspace open processing When the existing workspace file is not opened The file dialog box for selecting a workspace file opens When a workspace file name is specified correctly SOFTUNE Workbench opens the specified file When a workspace file is opened the window used when the file was saved is redisplayed Cancel button Processing is continued with the file being edited op
289. system call development K REALOS If int type specified in bit field treat most significant bit as sign bit K SBIT Change order in which static variables stored in memory to order in which sources described verorder Treat items following as comments in C source B e Language specification level J al c e EC ANSI ANSI FUJITSU extensions 217 CHAPTER 4 MENUS B C options 218 Figure 4 5 21 C Setup Dialog Setup Project ea Source Files E sample c E startup asm The following options can be specified Automatically instantiated templates no auto instantiation Control instantiation of templates t nonelusedllocallall not generate generate local output all output e Use old for loop initialization scooping old for init Use alternative keywords alternative tokens 4 5 5 4 CHAPTER 4 MENUS Setting Assembler Options This section explains how to set assembler options E Setting assembler options 1 2 Click the Assembler tab from the project setup dialog box Select category General Define Macro Include Path Target Depend or Output List can be selected as category Specified options can be checked using Option at the bottom of the dialog If the individual option is set the Common Option button can be clicked to return to the common option The macro description can be used to describe
290. t button of the mouse The program jumps to the line where the error occurred Correct the source file then reexecute the Project Make menu E Executing debugging When a load module file is created after the error exists debugging can be executed CHAPTER 2 OPERATION This chapter explains the basic operation of SOFTUNE Workbench for each of the following items 2 1 Parameters to be Entered from Dialog Boxes 2 2 Starting and Terminating SOFTUNE Workbench 2 8 Creating Workspace 2 4 Storing of Project 2 5 Creating and Registering Source File in Project 2 6 Definition of Subproject 2 7 Creation of Project Configuration 2 8 Setting Tools 2 9 Setting Linker Options 2 10 Make Build 2 11 Debugging 2 12 Executing Debugging Only 2 13 Reading SOFTUNE Project Files of Old Versions 2 14 Moving Project File CHAPTER 2 OPERATION 2 1 Parameters to be Entered from Dialog Boxes When key entry is requested from a dialog box the following four elements can be written as parameters e Data formula Address formula Identifier e File name specification E Data formula A data formula consists of a term and an operator Data formulas comply with C C language formulas Almost C C language formulas are recognized Some points e g line number and register specification are extended Operations involving floating point numbers and character strings are not supported The overflows that occur during operati
291. t cannot be set 5 Select a Macro Development Department List from the drop down list No output SRC OBJ OBJ 6 Set line count column count and tab count to the right of Line Column and Tab as required CHAPTER 4 MENUS B Target Depend options Figure 4 5 26 Target Dependency Setup Dialog Box Setup Project Linker La MB31301 Target Depend omn Ba sample pr Ey Source Files E sample c E startup asm Optimization level O None Levell Level2 FPU channel number FPU No FPU Channel 0 to 15 225 CHAPTER 4 MENUS 4 5 5 5 Setting Linker Options This section explains how to set linker options Bi Setting linker options 1 Click the Linker tab from the project setup dialog box 2 Select category General Disposition Connection Define Symbol Output List Absolute Assembly List Control Library or Register Bank can be selected as category Specified options can be checked using Option at the bottom of the dialog The macro description can be used to describe options For the macro description refer to Section 1 11 Macro Descriptions Usable in Manager of SOFTUNE Workbench User s Manual 226 CHAPTER 4 MENUS E Setting General options Figure 4 5 27 General Option Setup Dialog Box Setup Project 1 lib311 lib libS11if lib The following options can be set from the general option set
292. t one target item they are blanked e Check button Ifthe values are equal in all target items they are displayed as they are Ifthe values are not equal in at least one target item they are dimmed Figure 4 5 6 Setup Project Dialog Setup Project LX General mcu C C Compiler Assembler Linker ale Target of setting MB91301 D Remove this fle fram target of build 3 43 Source Files Project P sample c DAs oftune6 sample491 1 Project sample prj 8 startup asm E ee Loadmodule AB5 m Targetfile Name sample abs Dutput Directory Targetfile Directory ves 30154655 Browse Objectfile Directory ves 3Q01 0BJ Browse Listfile Directory ves 30153LST Browse 199 CHAPTER 4 MENUS B Setup Target The items to be set in the combo box and tree view at the left side of the dialog are specified Target of setting combo box All the configuration names of projects in workspace are displayed Configuration name The selected configuration is set All Configuration All configurations are set Multiple Configuration The multiple configuration dialog Figure 4 5 7 is opened The two or more configurations specified in the dialog are set Target of setting Tree View All projects having the configuration names specified in the combo box are displayed The items that can
293. tab The name of the current project and the file names registered in the project are displayed in the tree view format B SRC tab Figure 3 4 2 shows examples of displayed contents of the SRC tab Figure 3 4 2 SRC tab Workspace sample Cf sample abs sample prj Debug E Source Files Target file name of project It is followed by the project name and ia miooo Bp active configuration name The active project is given in bold type io_mbxxxxx _timer c Folder that can be deleted When opened the files and folders D io mbxxxxx uart obj stored are displayed Source Files and Include Files are created i mondeb lib at default samplel c sample2 c Library file name minem startasm B AJ Include Files Include file name E samplet h sample2 h Dependencies category the names of the files in which dependencies F samp le3h are detected are displayed The category cannot be deleted 5 9 Dependencies File in the Dependencies catego H _io_mbxxxxx h P Se i io mbxoooox Debug category When opened the setup name stored is displayed IEEE Debug The category cannot be deleted EM emlsup sup simsup Setup name fan subprj prj h bproject H E subprjrel subpripri Debug Subproject name The files stored in the project for making or building are listed E Function e Display the workspace name e Display all projects stored in workspace e Display t
294. tal constant Q 1267 Decimal constant D 1800 Hexadecimal constant H 12AF or Ox12AF Note No blank is allowed between a specifier and a numerical value CHAPTER 2 OPERATION E Floating point number The following two floating point number are supported e Single precision floating point number S float e Double precision floating point number D double long double The internal format and size comply with the floating point number type handled by the C 11 14 911 145 1 11 d specifies an unsigned decimal number compiler Nearest value rounding applies to input values If the represented value is not a normalized number a warning message is displayed and the following value is input When an underflow occurs The values that can be represented as unnormalized numbers are changed to unnormalized numbers The values less than unnormalized numbers are changed to 0 e When an overflow occurs Values are changed to infinity A floating point number can also be specified in a hexadecimal number as follows H hexadecimal number S D Note If S and D are omitted D is assumed 2 1 2 CHAPTER 2 OPERATION Data and Address Formulas Symbols Line Numbers Character Constants The SOFTUNE Workbench provides symbols line numbers and character constants as the terms of data and address formulas B Symbol The symbols used in the source program can be referred as addresses the
295. te is used For details refer to SOFTUNE Workbench USER S MANUAL Break 269 CHAPTER 4 MENUS E Details of code breakpoint Debug type Hardware datawatch 270 Figure 4 6 7 Code breakpoint details dialog Hardware datawatch Code break point details Ed Break address 000 000 Watch condition m Attribute Address Hooor 0000 Iv Read Address mask HFFFFFFFF Write Size Word Don t care size Comparison condition b Disable Dataagreement Datanot Cancel Break address In this field the address that sets a breakpoint is specified Address In this field the address or symbol for which data monitoring is to be performed is specified Address mask In this field the mask value for the specified address is specified Size byte halfword word The data size at the time of data access is specified Attribute The attribute at the time of data access is specified Don t care size A data watch break condition is applied when the specified address is accessed regardless of the access data length Comparison condition The data comparison condition is specified Disable No data is specified for breakpoint condition Data agreement Data agreement data agrees with the specified data is specified for the breakpoint condition Data NOT Data mismatch data does not agree with the specified data is specified for the breakpoint condition CH
296. teet eee 262 Code 262 Data 265 Details of code breakpoint For MB2198 MB2197 267 Details of code breakpoint Debug type 269 Details of code breakpoint Debug type Hardware datawatch 270 Details of data breakpoint for MB2198 ert MEAE 271 Setting and resetting a breakpoint 266 Setting of code 263 Setting of data breakpoint 265 Buffer Butler size eed 168 Build Build sista Quetta dicts 27 257 Build Dar iet iur 38 Project Configuration Configuration at Build 255 Building Changing Subproject Configuration at Making or Building eee 28 Making or Building of Project 28 Making or Building Specified Project 28 C C 218 Setting C C compiler options 209 Call Mea ates nies 280 Cleat eei nei 284 Functlorn callz iani 282 Caret Move the caret to the next bookmark 133 Move the caret to the next bookmark in the current window 133 138 Move the caret to the previous book
297. tep Out When Step Out is clicked the debugger executes the current function to the end returns control to the function caller moves the PC to the next instruction address of the function call instruction and stops Run Until Cursor When Run Until Cursor is clicked the debugger executes the program to the instruction immediately before the address indicated by the cursor in the source or assembly window moves the PC to the address and stops Power On Debug When starting Power on Debug it is opened the Power supply voltage dialog It is able to set and to check the Lower limit voltage Figure 4 6 1 Power Supply Voltage Power supply voltage Ea Lower volt 20 Note The power on debug function may not be used depending on the type of evaluation MCU For details contact Fujitsu s sales department or support department 259 CHAPTER 4 MENUS 4 6 2 Abort This section explains the debugger program execution stop function E Abort Abort is used to forcibly interrupt the program being executed by the debugger When the program stops the PC moves to the next instruction address of the last executed instruction Source line display and disassemble display are also updated according to the PC value set when the program stopped Note The monitor debugger does not provide this stop abort function 260 CHAPTER 4 MENUS 4 6 3 Reset of MCU This section exp
298. the specified address is accessed regardless of the access data length Conditions for comparison Specify the condition for data comparison Invalid Data is not specified for the transition condition Data agreement The case where the data matches the specified data is the start end condition Data not The case where the data does not match the specified data is the start end condition Data Specify the data access time data Data mask Specify the mask value for the specified data CHAPTER 4 MENUS E Performance Display Setup Select Display Range from the shortcut menu of the Performance Window Figure 4 4 32 Performance Display Setup Dialog Cancel Unit 1ns Lower value Interval Display mode Select Auto or Manual When Manual is selected set Lower and Interval Lower Specify display start time for detailed measurement result display Interval Specify display interval time for detailed measurement result display Unit The measurement unit is fixed at Ins Notes 1 This function cannot use except the FR6OLite For details refer to SOFTUNE Workbench USER s MANUAL Measuring Performance 2 This function cannot be used when the trace mode is set as the event mode 187 CHAPTER 4 MENUS 4 4 14 RAM Checker The RAM Checker window is displayed RAM Checker Open the RAM Checker window to display the logging status and the monitor
299. ting of Linker 25 List output Selecting a list 229 Setting list output 224 Load module file Opening the load module file 112 Load module name Shortcut menus Click the right button of the mouse on a load module name 54 Local Variable Window Local Variable Window 81 165 Log file kog file neis 101 Logging CPU stop during logging 102 Logging citet deett ee 92 Logging 102 eR 90 Resetting a macro name 212 222 Setting a macro name 211 221 Main Window Main 36 Creating program source and executing make build ssssssssssss 4 tere eset Qr eeu ea ee ades tu dade 27 257 Make build 189 Making Changing Subproject Configuration at Making or Building 5 eere 28 Making or Building of Project 28 Making or Building Specified Project 28 Mangled name Mangled 10 Mask Example of address 175 MB2197 Details of code breakpoint For MB2198 MB2197
300. tion of over current levels and other abnormal operating conditions If any products described in this document represent goods or technologies subject to certain restrictions on export under the Foreign Exchange and Foreign Trade Law of Japan the prior authorization by Japanese government will be required for export of those products from Japan Copyright 2002 2006 FUJITSU LIMITED All rights reserved Reading This Manual E Product Names In this manual and this product product name is designated as follows The Microsoft Windows 98 operating system is abbreviated to Windows 98 The Microsoft Windows Millennium Edition operating system is abbreviated to Windows Me The Microsoft Windows 2000 Professional operating system is abbreviated to Windows 2000 The Microsoft Windows XP Professional operating system is abbreviated to Windows XP CONTENTS CHAPTER1 OUTLINE OF SOFTUNE WORKBENCH nnn 1 1 1 Nu ELLE 2 1 2 What is SOFTUNE Workbench sse nenne enne innere inns sin nnns 3 1 3 Procedure for Developing Programs with SOFTUNE Workbench see 4 CHAPTER 2 OPERATION 2 222 ace ccc oux yin exea a2 2a sats s Nace cec cep vu c En cura aanaeio adanadan 5 2 1 Parameters to be Entered from Dialog Boxes sese 6 2 1 1 Data and Address Formulas Numerical constant
301. to save the current workspace information opens Clicking Yes or No from this dialog box continues processing and automatically terminates the debug session If no file is being edited SOFTUNE Workbench terminates immediately If there is a file being edited processing explained in When a file is being edited is performed CHAPTER 4 MENUS 4 3 Edit Menu The edit menu provides such functions as file editing find string and error jump B File editing function The file editing function includes the following Undo Redo Cut Copy Paste Delete All Select Character string search function The character string search function includes the following Find Replace Findin Files B Jump function Enables to move to any place in a window quickly Jump E Bookmark function Enables to setup a bookmark or to jump to the bookmark Bookmark B Error jump function The error jump function includes the following Previous Error Next Error Top of Error Bottom of Error E Property function To display the information of activated window Property 123 CHAPTER 4 MENUS 4 3 1 Undo Redo Undo cancels the immediately preceding editing and undoes the status before the editing Further Redo can undo the deleted editing to the previous status B Target The function is available only for edits for the edit window It can also continuously cancel or undo a Series of actions for successive addit
302. tor to a personal computer via USB To install the USB driver proceed as follows 1 Connect the emulator to a personal computer with the USB cable 2 When the power supply of the emulator is turned on the OS requests installation of the USB driver Specify the directory Drivers on this product CD ROM Note The following emulator has USB interface MB2198 380 APPENDIX E Creating ROM on Monitor Debugger Target APPENDIX E Creating ROM on Monitor Debugger Target This appendix explains creation of the monitor debugger target ROM Target system configuration Target system creation procedure Explanation of sample program Target system creation To use the monitor debugger besides the debugger body mod91 1 rel the following must be added to create a target system Target system initialization routine e driver used to communicate with host system Vector table E Target system configuration The monitor debugger configuration is shown in the figure below Figure E 1 Configuration of monitor debugger Target system 5232 driver for communication Debugger body Target system Communication with host system The target system uses the RS 232C interface to communicate with the host system For this reason the target system must be provided with communication hardware il Program suspension ABORT switch The target system should be designed so that a
303. ty Open List File Select the list file you want to open from the submenu If the list file you want to open is not created no submenu item can be selected Open Assemble file This menu is opened when a C C source file is selected Of the specified C C source file the assembler source file output by a compiler is opened No file can be selected when not compiled 49 CHAPTER 3 WINDOWS Shortcut menus Click the right button of the mouse an include file and other user s registration file Figure 3 4 14 shows a shortcut menu Figure 3 4 14 Shortcut menu on a include file name Open Delete Property Open When SOFTUNE WORKBENCH is in the debug session the specified include file is displayed in the Source Window When SOFTUNE WORKBENCH is not in the debug session the specified include file is displayed in the edit window Delete The specified file is released from the project member The file itself is not deleted Property File information is displayed See Section 4 3 9 Property Shortcut menus Click the right button of the mouse on library file object file and relative format file Figure 3 4 15 shows a shortcut menu Figure 3 4 15 Shortcut menu on a library file name Set Delete Property Set When selected the following two submenus are displayed Individual Setting A project is set See Section 4 5 5 Setup Project Return to Common Setti
304. u D Softune6 sample 91 1 Project MB91301 0BJ samp Tool Displays the language tool to be executed File The file used in creating a target file is displayed in order Modified Displays the date and time of the last file update 144 CHAPTER 4 MENUS E Property Output Figure 4 3 14 Property Project Window Output File Property C compiler D SoftuneB Ssample 31 1 Project MB 91301 0BJ samp DAS oftune6 sample 91 1 Project MB913014 LST samp D Softune6 sample 91 1 Project MB913014LST samp Output name Main file name of all files outputted by the language tool of the selected file is displayed Tool Displays the language tool to be executed File The file outputted by the language tool of the selected file is displayed Update time Displays the date and time of the last file update 145 CHAPTER 4 MENUS 4 3 9 2 Property Edit Window This section explains the property in the edit window E Property General Figure 4 3 15 Property Edit Window General General Filename D Softune6 sample 311 Project sample c Size 1551 bytes Modified 16 03 44 Wednesday September 11 2002 TabSize 4 Close File name The fullpath to the selected file is displayed e Size Displays the file size Modified Displays the date and time of the last file update Tab size The size of tab code is displayed 146 CHAPTER 4 MENUS 4
305. uired Click the Find button The search result appears in the output window in real time To abort a search click Abort button The file search is aborted When search terminates click the Cancel button Figure 4 3 3 Find in Files Dialog Box Find in Files Ed Find what search X Find In files Gort s M Cancel In folder Match whole word only Match case 129 CHAPTER 4 MENUS 4 3 6 Jump Jump moves the cursor to any line in the text file being edited When SOFTUNE Workbench is in the debug session this function command specifies the display start position of a source line disassemble memory or trace B Edit window When the jump dialog box shown in Figure 4 3 4 opens specify a jump destination line number When the edit window is active the cursor in the edit window jumps to the specified line irrespective of whether SOFTUNE Workbench is in the debug session Figure 4 3 4 Jump Dialog Box Edit Jump line 20 Cancel E Debug session If a window other than the edit window becomes active when SOFTUNE Workbench is in the debug session the dialog box shown in Figure 4 3 5 opens Select TYPE then specify POSITION in the selected format If Address is specified in Type Window at source memory or disassemble window can be used to specify the window where jump is implemented The following can be selected as TYPE Line number Addre
306. up dialog box Outputs start message V Outputs debug information g Control of Default Option File Xdof Entry Point e Warning Level w Level 0 to 2 Other Option Entry Point is the address to be set in the PC when data is loaded by the debugger Be sure to specify this option with a global symbol Select warning level from the drop down list In Other option all linker options can be written like start up options from command lines Write the options that do not belong to any linker option setup categories directly in Other Option E Setting disposition connection See Section 4 5 5 6 Specifying Disposition Connection 227 CHAPTER 4 MENUS Bi Setting symbol definition Figure 4 5 28 Symbol Definition Setup Dialog Box Setup Project MB31301 E Define Symbol 7 Ey Source Files GSYMBOL E sample c 80 statu asm LEN If there are two or more items to be set the symbol name found in some item is grayed 1 Select the Define Symbol category The symbol definition setup dialog box shown in Figure 4 5 28 opens 2 Specify a symbol name 3 Specify a setting value 4 Click the Set button E Resetting symbol definition 1 Select the Define Symbol category The symbol definition setup dialog box shown in Figure 4 5 28 opens 2 Select the symbol name you want to reset from Symbol Name List 3 Click the Delete button 228 CHAPTER 4 MENUS Selecti
307. use on a displayed variable name to display the shortcut menu then select Property from the menu Information for the variable is displayed For details see Section 4 3 9 Property Click the Close button 83 CHAPTER 3 WINDOWS 3 14 Trace Window This section explains the trace window This window is displayed only when SOFTUNE Workbench is in the debug session B Trace Window The trace window displays the trace result For the trace function see Section 4 4 8 Trace Figure 3 14 1 is an example of the trace window Figure 3 14 1 Example of Trace Window address mnemonic 00999 00000 ooococl4 LDUB R13 R5 RO0 Column title 000 0 16 STB RO R13 R4 This line is not ooococls 0 R0 000 0 1 BNE D ooococl4a scrolled ooococlic ADD 1 R13 OOOCOCIE B Shortcut Menu 84 There are thirteen menus below Refresh Updates trace window display Jump See Section 4 3 6 Jump Back Trace See Section 4 4 8 Trace Instruction Displays trace result in instruction mode Valid when the emulator debugger is used Cycle Displays trace result in cycle mode Valid when the emulator or simulator debugger is used e Source Displays trace result in source mode Valid when the emulator or simulator debugger is used Task Displays trace result in task mode Setup See Section 4 4 8 Trace Detail This can be used only in the DSU3
308. usually set 2 00000000 00000000 System re anle eec 2 00000000 00000000 System re 4 00000000 00000000 System re 5 00000000 00000000 System re 5 00000000 00000000 System re 00000000 00000000 System re 8 00000000 00000000 System re 9 00000000 00000000 System re 10 00000000 00000000 System re 11 00000000 00000000 System re MOO Copy Edit Jump cose He om 285 CHAPTER 4 MENUS Q Setting an address Change the address set in a vector in the following procedure 1 Select vector table number then click the Edit button The vector edit dialog box shown in Figure 4 6 19 opens 2 Set an address then click the OK button Figure 4 6 19 Vector Edit Dialog Box Vector number p 0 H Factor reset Cancel di Address 00080000 B 1 Select a vector table number then click the Copy button The vector copy dialog box shown in Figure 4 6 20 opens Select the Copy Mode All copy vector Copy debugger reserve vector Copy select vector Set the Copy Source Vector Number Set the Copy Destination Base Address Click the OK button d N Figure 4 6 20 Vector Copy Dialog Box Copy vector LX Copy mode Copy select vector Copy source vector number 0 Cancel Copy destination base address E Jump Display the source of the program stored at the address set in the vector table in the following
309. ve project Create new folder Add Member to project Set Project Set Linkage order Make Build Executing linker or librarian Delete Project Property Open List File Open HEX File gt Set Active Project The currently selected project is set in the active project in workspace Create New Folder When selected the Create New Folder dialog Figure 3 4 5 is opened Enter the folder name and click the OK button When the folder name is entered the folder is inserted into the hierarchy immediately below the project The folders are listed in the order in which they are created Figure 3 4 5 Create New Folder Dialog Create New Folder Name of a new folder Add Member to Project When selected the following two submenus are displayed File A member is added in files to the currently selected project See Section 4 5 3 Add Member At default a member is inserted into the hierarchy immediately below the project Directory A member is added in directories to the currently selected project See Section 4 5 3 Add Member At default a member is inserted into the hierarchy immediately below the project Set Project A project is set See Section 4 5 5 Setup Project 44 CHAPTER 3 WINDOWS Set Linkage Order When selected the Set linkage Order dialog Figure 3 4 6 is opened The files displayed in the Link Order box are linked fro
310. void an overlap to each of the addresses to be allocated It will properly allocate the sections in a descending order of their alignment values and sizes so that empty area is minimized e Mode2 The linker determines whether to allocate sections unspecified for allocation in a ROM area or in RAM area based on the types of the sections and automatically allocates them in empty area in each area The subsequent setting depends how the section is concretely allocated 233 CHAPTER 4 MENUS 234 Figure 4 5 32 Disposition Connection Setup Dialog Box Setup Project x General MCU C C Compiler Assembler Linker JE Category Disposition Connection Auto Disposition 2 Target of setting MB91301 E E 1 5 Source Files sample c startup asm iuis Area List Delete Down 2 Start End Add Area 0002 000 OOO3FFFF RAM 00080000 OOOFFFFF ROM ROM RAM INRAMOl INROMOl The Disposition Connection option is reset Set Section Vv When a ROM RAM area is specified beyond the internal ROM RAM range the warning is issued Vv When sections are arranged beyond the range that the ROM RAM area is specified the warning is issued Option g AL 2 INRAM OT OxO0003CO00 0 0003FFFF INROM IT Ox00080000 0x000FFFFF Cancel Apply Figure 4 5 33 Section Setup Dialog R M RAM Area Name INRAM 01 Y
311. w New newly creates a workspace project and file Selecting New from the file menu opens the new creation dialog box asking the operator whether to create a workspace project or text file Figure 4 2 1 E New creation dialog box Figure 4 2 1 New Creation Dialog Box File type Eme Cancel Workspace Project file E Creation of New Workspace To create a new workspace select Workspace Project File When the New dialog for project is opened select the Workspace tab Figure 4 2 2 Set the basic items regarding workspace to be created For details about the setting procedure see Section 2 3 Creating Workspace Figure 4 2 2 Project New Creation Dialog Workspace Project Workspace Workspace Type Blank workspace Workspace Name Workspace Directory s oftune6 sample S11 Pr Browse E Cancel 110 CHAPTER 4 MENUS E Creation of New Project To create a new project select Workspace Project file When the New dialog for project is opened select the Project tab Figure 4 2 3 Set the basic items regarding project to be created When creating a new workspace in creating a new project see Section 2 3 Creating Workspace and when adding to an existing workspace see Section 2 4 Storing of Project _ Figure 4 2 3 Project New Creation Dialog Project E MB91101 v E D Softune6 sample 911 Pr v
312. w o From Initialize Indicates the cumulative total value of execution after the Clear button has been clicked From Last Executed Indicates the immediately preceding execution time Note The measurement results have errors For details refer to Measuring Execution Time in each chapter of the SOFTUNE Workbench User s Manual 281 CHAPTER 4 MENUS 4 6 9 Call This section explains the SOFTUNE Workbench function call function E Function call 282 The specified function can be started during debugging without reference to the flow of the program This function is known as function call Figure 4 6 16 Function Call Dialog Box Function Cancel When the function call dialog box shown in Figure 4 6 16 opens specify the function you want to call with a correct argument Display return value Compiles with C C arguments however next argument does not specify If you specify it debugger outputs error message Structure Union Class Figure 4 6 17 Function Call Result Dialog Box Result of call function x Function plus Result H 00000003 When processing of the called function is terminated and control is returned the function call result dialog box shown in Figure 4 6 17 opens Example When function definition is int sub int param specify the function call as follows sub 10 When a constant value is directly sp
313. when an MCU without single chip mode is selected setting is performed so as not to output a warning When sections are arranged beyond the range that the ROM RAM area is specified the warning is issued check locate Setting is performed so as to output a warning CHAPTER 4 MENUS 4 5 5 7 Setting Librarian Options This section explains how to set librarian options E Setting librarian options 1 Click Librarian tab from the project setup dialog box 2 Select category General Output List can be selected as category The specified options are displayed in the lower part option of the project setup dialog box Bi Setting Options in General Figure 4 5 35 Librarian Option Setup dialog Box General Setup Project The following options can be set Output start message v Output debug information g Control default option file Xdof 239 CHAPTER 4 MENUS E Setting the Output listing Figure 4 5 36 Librarian Option Setup dialog Box Output List Setup Project MB91301 E a sample prj 2 3 Source Files E sample c E startup asm 1 Select any of the following output types Outputs section name and size for the module Outputs external define symbol for the module Outputs external browse symbol for the module Outputs all external define symbol and unsolved external define symbol 2 To suppress page change set a check m
314. where currently displayed by memory window Display with 16 bytes fixed in size The number of bytes at one line can be chosen Auto which is corresponding to the size of window or 4byte 8byte 16byte 32byte and 64byte which the size of bytes are fixed In order to setup the number or bytes use Setup at shortcut menu Q Bookmark setting function Bookmark can be set by coloring the specified address range By setting a bookmark it enables to view the specified line using search bar or key operation Please refer to 4 3 7 Bookmark for details Drag and Drop By dropping variable name function name label or address from source window to memory window the address of dropped character string is shown and address range will be chosen Figure 3 11 1 Example of Memory Window zi Memory Of x Data display section Characters e g control codes Column title Displayed data can be other than ASCII characters are This line is not directly modified all represented in scrolled 79 CHAPTER 3 WINDOWS B Shortcut Menu There are fourteen menus below 80 Compare Find Special Inline Assemble Jump Bookmark Edit Setup Inaccessible area Break Event Watch Monitoring Close See Section 4 4 5 Memory See Section 4 4 5 Memory See Section 4 4 5 Memory See Section 4 4 3 Assembly See Section 4 3 6 Jump See Section 4 4 5 Memory See Section 4 4 5 Memor
315. xample of the edit window docked with the main window is given in Figure 3 6 1 As shown in this example the edit window docked with the main window can be displayed only when the standard editor built into SOFTUNE Workbench is in use SOFTUNE Workbench can register and use any external editor In this case however the edit window is not treated as a SOFTUNE Workbench screen Figure 3 6 1 Example of Edit Window L Ehsan eere IEEE Ruler 28 definition to stack area 22 define STRCK SIZE 2 1824 4 Line number display 24 section STACK stack ali 25 res b STRCK SIZ2E 26 stack top Text editing area 27 res w 1 28 1 8 i 2 Line selection field When a read only file is opened Protect is displayed When the Caps key is locked CAP 1s displayed When Softune Workbench is in the character overwrite editing mode Overwrite is displayed The cursor position is displayed in line column 59 CHAPTER 3 WINDOWS Shortcut menu There are eighteen menus below 60 Source Window Undo Redo Cut Copy Paste Delete Select All Print Add to Project Find Replace Find in Files Jump Bookmark Customize Status Bar Property Source Window 1 Click the right button of the mouse to display the shortcut menu then select Source Undo Redo Cut Opens the source window Cancels the last editing Redoes the cance
316. y Bookmark list 22255101 00010000 00010012 target 0 Bg 2202 00010014 00010027 target 1 m 000140D0 000140D2 All delete Jump Bookmark list The list of a bookmark which is currently set in memory window will be displayed Name Name of a bookmark and color of marking will be displayed Address or symbol name will be name of bookmark Address range Range of an address where bookmark is set is displayed Symbol Symbol allocated to a bookmark will be displayed If a symbol is allocated location of bookmark will be updated based on debug information although the line number of symbol changes along with the change in file Please refer to Note for allocatable symbol Add button Display dialog Add a bookmark to add a bookmark For details refer to 4 4 5 memory Change button Display Add a bookmark dialog and change the setup of selected bookmark in a bookmark list 135 CHAPTER 4 MENUS Delete button Delete a bookmark selected from the list of a bookmark All Delete button Delete all bookmarks from the list of a bookmark Jump button Move a start position for displaying a memory window to position of bookmark selected in bookmark list Setup or cancel of a bookmark 1 Please select a range of an address where you want to set or to cancel a bookmark 2 Please execute any of following operations Select Edit Bookmark Setup can
317. y See Section 4 4 5 Memory Displays the Inaccessible area tab in the Debug environment of the Setup menu See Section 4 6 4 Break Point See Section 4 6 5 Event See Section 4 4 7 Watch Switches whether to enable or disable monitoring Closes the memory window CHAPTER 3 WINDOWS 3 12 Local Variable Window This window is displayed only when SOFTUNE Workbench is in the debug session The local variable window is used to display and modify local variable values Local variables are displayed in the tree format function name root Local Variable Window Figure 3 12 1 is an example of the local variable window Figure 3 12 1 Example of Local Variable Window 71 Local IO xj ee sort val The local symbol names defined in the tblp 00000009 08010 0 00090000 H nameg 16 function and the current values are displayed 00000009 H 00000009 An array variable name is displayed Array data is displayed name 16 D 0 0 00000009 D 1 H OE Variables of floating point type are displayed val H 00000009 H 00000009 val 08010 0 c BOO He E Shortcut Menu There are five menus below Radix See Section 4 4 6 Local Edit See Section 4 4 6 Local Memory window Display the memory window and setup bookmark Property Displays symbol properties Close Closes loc
318. y have the type information generated by the C C compiler and other accessory information The type information generated by the assembler is label information Each symbol consists of a module name a function name and a symbol name Specify these names as follows module name function name symbol name C allows the following description using a scope resolution operator Class function name symbol name When the source program is written in the assembly language module name is the name written in the operand of the PROGRAM statement When it is written in the C C language module name is the name of the source file to be compiled Function name is a function name written in the C C language it is valid only when the source program is written in the C C language To distinguish a global symbol from others write it as symbol name or symbol name Table 2 1 1 shows symbol description No Japanese character strings can be used for symbols Table 2 1 1 symbol description Description Contents Local symbol in function gt Class members accessible by this pointer for C sta tic symbol in module global symbol V Symbol or Symbol Global symbol function symbol Local symbol in the specified function in the current module Module symbol Static symbol in the specified module or global symbol defined in the specified module Module function symbol Local symbol in th
319. y the debug information When checked only the debug information is loaded Auto Mapping This specifies whether or not to enable the Auto Map Setting When checked Auto Map Setting is enabled e Ondemand load Set whether to ondemand load debug information When a check mark is placed in the check box debug information is ondemand loaded 313 CHAPTER 4 MENUS Q External memory emulation 0504 MB2198 Figure 4 7 24 Debug Environment Setup Dialog Box external memory emulation Setup debug environment Enable disable Whether to enable or disable the external memory emulation function is specified Chip select The chip select number that can be output to the external bus is specified FR system CS1 to CS5 FRex system CSO to CS7 Memory type Whether to allow or inhibit write access to external memory is specified 314 CHAPTER 4 MENUS Event FR60Lite MB2198 Figure 4 7 25 Debug Environment Setup Dialog Box Event Setup debug environment x Tab Error output Access size Load External memory emulation Execution Watch Radix Emulation Break Monitoring Directory Realtime memory area Frequency Event Inaccessible area Event mode Trace C Performance Cancel Event mode Trace The event function is used for trace control The function related to sequence data monitoring break trace trigger is enabled Performance The eve
320. y the source files in the project The registered include files are displayed in the Dependencies category field of the SRC tab of project window 256 4 5 10 CHAPTER 4 MENUS Compile Make Build and Stop This section explains the functions of compile make build and stop B Compile B Make B Build B Stop Compile compiles only the specified source file irrespective of whether other source files and include files are corrected However compile does not link the specified source file This command also assembles the specified file when the file is an assembler source file Make checks all the source and include files in the project and compiles or assembles only the corrected file If some library and object files are modified make links them to create a target file Build compiles or assembles all the source files in the project irrespective of whether they are corrected It also links all object and library files to create a target file Use stop when you want to stop compile make or build execution for some reason E Checking source file saving When an unsaved file is being edited by the standard editor execute compile assemble make or build then save the file If a check mark is set to the left of Inquiry for Save at Compile Assemble in Setup Development workspace however the dialog box for asking whether to save the file opens When the No button is clicked the source file is comp
321. zation level 216 CHAPTER 4 MENUS E Setting of Options Included in Language Figure 4 5 20 Language Specification Option setup Dialog Setup Project LX General MCU C C Compiler Assembler Linker Lal gt Category Language Samo Language specification Target of setting 91 3 1 X Source Files sample c 8 startup asm Treat floating point numbers for which suffixes not specified In line expansion of the function which qualified by interru Treat as amp volatile the variable which qualified by io Treat most significant bit of amp char type as sign bit Incline of IT amp RON system call development If int type specified in amp bit field treat most significant bit as sii Change order in which amp static variables stored in memory to Treat items following as co amp mments in C source K gt Language specification level EC Option The following options can be specified Treat floating point numbers for which suffixes not specified as float type K FCONST DCONST In line expansion of the function which qualified by interrupt K NOINTLIB Treat as volatile the variable which qualified by io NOVOLATILE Treat most significant bit of char type as sign bit K SCHAR In line of ITRON

FR FAMILY SOFTUNE WORKBENCH OPERATION MANUAL

Contents

Download Pdf Manuals

Related Search

Related Contents