Cypress F2MC-8L Series Operation Manual
  1. Manuals
  2. Brands
  3. Cypress Manuals
  4. Microcontrollers
  5. F2MC-8L Series
  6. Operation manual

Cypress F2MC-8L Series Operation Manual

Softune workbench
Hide thumbs
1
2
3
4
Table Of Contents
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
Table of Contents

Advertisement

Quick Links

Download this manual
2
F
MC-8L/8FX Family
SOFTUNE™ Workbench Operation Manual
Doc. # 002-04536 Rev. *A
Cypress Semiconductor
198 Champion Court
San Jose, CA 95134-1709
www.cypress.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the F2MC-8L Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Cypress F2MC-8L Series

Summary of Contents for Cypress F2MC-8L Series

  • Page 1 MC-8L/8FX Family SOFTUNE™ Workbench Operation Manual Doc. # 002-04536 Rev. *A Cypress Semiconductor 198 Champion Court San Jose, CA 95134-1709 www.cypress.com...
  • Page 2 A critical component is any component of a device or system whose failure to perform can be reasonably expected to cause the failure of the device or system, or to affect its safety or effectiveness. Cypress is not liable, in whole or in part, and you shall and hereby do release Cypress from any claim, damage, or other liability arising from or related to all Unintended Uses of Cypress products.
  • Page 3 Preface  What is the SOFTUNE Workbench? SOFTUNE Workbench is support software for developing programs for the F MC-8L/8FX families of microprocessors / microcontrollers. It is a combination of a development manager, simulator debugger, emulator debugger, monitor debugger, and an integrated development environment for efficient development.
  • Page 4 Reading This Manual  Configuration of Page In each section of this manual, the summary about the section is described certainly, so you can grasp an outline of this manual if only you read these summaries. And the title of upper section is described in lower section, so you can grasp the position where you are reading now. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 5: Table Of Contents

    Contents CHAPTER 1 Outline of SOFTUNE Workbench ............11 Outline .............................. 12 What is SOFTUNE Workbench? ...................... 13 Procedure for Developing Programs with SOFTUNE Workbench ........... 14 CHAPTER 2 Operation ....................15 Parameters to be Entered from Dialog ..................... 16 2.1.1 Data and Address Formulas (Numerical Constant) ..............
  • Page 6 Contents Edit Window (Standard Editor) ......................73 3.6.1 Setting Standard Editor ....................... 77 Source Window ..........................82 Symbol Window ..........................87 Disassemble Window ........................89 3.10 Register Window ..........................92 3.10.1 Setting Register Display ......................93 3.11 Memory Window ..........................95 3.12 Local Variable Window ........................
  • Page 7 Contents 4.3.8 Previous Error, Next Error, Top of Error, Bottom of Error ............163 4.3.9 Property ............................. 164 4.3.9.1 Property-Project Window ....................... 165 4.3.9.2 Property-Edit Window ......................169 4.3.9.3 Property-Source Window ....................... 170 4.3.9.4 Property-Symbol Window ....................... 171 4.3.9.5 Property-Local Window ......................172 4.3.9.6 Property-Watch Window ......................
  • Page 8 Contents 4.5.5.9 Setting Debug Options ......................270 4.5.6 Setting Customize Build ......................273 4.5.7 Project Dependencies ....................... 277 4.5.8 Project Configuration ......................... 278 4.5.8.1 Project Configuration-Add and Delete ..................279 4.5.8.2 Project Configuration-Configuration at Build ................281 4.5.9 Include Dependencies ....................... 282 4.5.10 Compile, Make, Build, and Stop ....................
  • Page 9 Contents 4.8.3 Arrange Icons ..........................378 4.8.4 Refresh ............................379 4.8.5 Refresh All Windows ......................... 380 4.8.6 Close All Windows ........................381 Help ..............................382 4.9.1 Help Topics ..........................383 4.9.2 Support Information ........................384 4.9.3 Version Information ........................385 CHAPTER 5 Add-in Module ..................
  • Page 10 Contents F.19 SSDI_Clear_Cycle (Clear Cycle Count) ..................452 F.20 SSDI_Execute_MCU (Execute Target Program) ................ 453 F.21 SSDI_GetCurrentExecuteAddr (Get the Address in Execution) ..........454 APPENDIX G Major Changes ........................455 INDEX ...........................457 Revision History........................469 F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 11: Chapter 1 Outline Of Softune Workbench

    CHAPTER 1 Outline of SOFTUNE Workbench This chapter gives an 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 compiler, assembler, and linkage kit, etc.

  • Page 12: Outline

    Outline of SOFTUNE Workbench Outline This section gives an outline of the development tools integrated by SOFTUNE Workbench.  Language Tools In the past, language tools (e.g., C compiler, assembler, and linkage kit) were started and used from command lines. However, SOFTUNE Workbench can use these tools as they area.

  • Page 13: What Is Softune Workbench

    Outline of SOFTUNE Workbench What is SOFTUNE Workbench? This section explains the basic configuration of SOFTUNE Workbench.  SOFTUNE Workbench Configuration Figure 1.2-1 shows the basic configuration of SOFTUNE Workbench. Figure 1.2-1 Basic Configuration of SOFTUNE Workbench SOFTUNE Workbench Debugger part Manager part Configurator Language tool...

  • Page 14: Procedure For Developing Programs With Softune Workbench

    Outline of SOFTUNE Workbench Procedure for Developing Programs with SOFTUNE Workbench The procedure for developing programs with SOFTUNE Workbench consists of the followings: 1. Setting SOFTUNE Workbench operating conditions 2. Creating a project 3. Creating a program source and executing make/build 4.

  • Page 15: Chapter 2 Operation

    CHAPTER 2 Operation This chapter explains the basic operation methods of SOFTUNE Workbench. It is divided into the following items. 2.1 Parameters to be Entered from Dialog 2.2 Starting and Terminating SOFTUNE Workbench 2.3 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...

  • Page 16: Parameters To Be Entered From Dialog

    Operation Parameters to be Entered from Dialog When key entry is requested from a dialog, the following four elements can be written as parameters: - Data formula - Address formula - Identifier - File name specification  Data Formula A data formula consists of a term and an operator. Data formulas comply with C language formulas. Almost C language formulas are recognized.

  • Page 17: Data And Address Formulas (Numerical Constant)

    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.  Integer When writing an integer, specify a specifier (B', Q', D', H', 0x) representing the radix of the numerical value. If the specifier is omitted, follow setting of the [Radix] tab in the "Setting debug environment"...
  • Page 18 Operation 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. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 19: Data And Address Formulas (Symbols, Line Numbers, Character Constants)

    Operation 2.1.2 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.  Symbol The symbols used in the source program can be referenced as addresses; they have the type information generated by the C compiler and other accessory information.
  • Page 20 Operation  Line Number The line numbers to be generated by the C compiler or assembler can be used to reference addresses. For the C language, a line number indicates the starting address when one line is compiled. [source file-name]$line-number When referencing an address with a line number, prefix $ to the line number.

  • Page 21: Data And Address Formulas (Register Name, Flag Name)

    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.  Register Name, Flag Name Register and flag names can be specified in data formulas; they represent the register values at that point of time. Specify the register name and flag name, following %.

  • Page 22: Operators Usable In Data And Address Formulas

    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.  Operators Usable in Data and Address Formulas Table 2.1-2 List of Operators Usable in Data and Address Formulas Priority Operator Explanation...
  • Page 23 Operation Note: 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 language. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 24: Address Formula Specification

    Operation 2.1.5 Address Formula Specification Address formula specification is divided into the addressing and address range specification.  Addressing The addressing format is as follows: 16-bit-addressing 16-bit-addressing: ..Expression for addressing  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)

  • Page 25: File Name Specification

    Operation 2.1.6 File Name Specification File name specification complies with Windows rules.  File Name Specification [drive-name:] [directory-path-name] file-name [.extension] When drive-name is omitted, the current drive is selected. When directory-path-name is omitted, the project directory which is currently displayed is selected. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 26: Starting And Terminating Softune Workbench

    Operation Starting and Terminating SOFTUNE Workbench This section explains how to start and terminate SOFTUNE Workbench.  Starting SOFTUNE Workbench With SOFTUNE V3, to start SOFTUNE Workbench, double-click the [FFMC-8L Family SOFTUNE Workbench] icon in the [SOFTUNE V3] group. When this program is started for the first time with SOFTUNE Manager V01 or V02 installed, the dialog is displayed which asks whether or not to take over information for [Setting editor], [Setting tools], and [Setting error jump] set in the previous version.

  • Page 27: Creating Workspace

    Operation Creating Workspace Workspace is necessary to store projects in SOFTUNE Workbench to register project, follow the steps below.  Creating of Workspace SOFTUNE Workbench uses the following methods to create workspace. • Creating workspace in creating new project When a new project is created, 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.
  • Page 28 Operation  Creating Blank Workspace 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 [Workspace] tab. When the [New] dialog is opened, select the [Workspace] tab. 3.

  • Page 29: Storing Of Project

    Operation Storing of Project A project is necessary to develop and debug software in SOFTUNE Workbench. To store a project in workspace, follow the steps below.  Storing of Project SOFTUNE Workbench uses the following methods to store a project in workspace. To store a new project is as active project in workspace.
  • Page 30 Operation When REALOS is selected as the project type, the Setup Wizard of the configurator opens. For details, refer to the manual of SOFTUNE REALOS. Table 2.4-1 List of Project Types Project type Explanation Absolute format (ABS) An ordinary program file is created. Relative format (REL) A relative format file is created.

  • Page 31: Creating And Registering Source File In Project

    Operation 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.  Creating the New Source File 1. Select the [File]-[New] menu. When the [New] dialog opens, select [Text File] from [Types of Files], then click the [OK] button.

  • Page 32: Definition Of Subproject

    Operation Definition of Subproject This section explains how to define a subproject.  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.

  • Page 33: Creation Of Project Configuration

    Operation Creation of Project Configuration This section explains how to create a project configuration.  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.
  • Page 34 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.

  • Page 35: Setting Tools

    Operation 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:  Select the [Project]-[Setup Project] Menu The [Set Project] dialog is opened. The option selected in the [Set Project] dialog box is applicable to two or more projects. The applicable project configuration can be limited.

  • Page 36: Setting Linker Options

    Operation Setting Linker Options When creating a program with SOFTUNE Workbench, be sure to set a memory map 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;...
  • Page 37 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. The linker option setting dialog need not be returned each time sections are allocated to an area. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 38: Make/Build

    Operation 2.10 Make/Build SOFTUNE Workbench can create a program in two methods: make and build.  Make 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.

  • Page 39: Making Or Building Of Project

    Operation 2.10.1 Making or Building of Project SOFTUNE Workbench enables making or building for each project configuration.  Making or Building of Project [Make] or [Build] in the menu applies to the active configuration of an active project. If a subproject is defined, priority is given to making or building of the subproject.

  • Page 40: Debugging

    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.  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.

  • Page 41: Executing Debugging Only

    Operation 2.12 Executing Debugging Only SOFTUNE Workbench can be used as the conventional debuggers.  Creating a Project In SOFTUNE Workbench, projects are a basis of all work. This is not an exception also at debugging. For this reason, executing debugging only requires the creation of a project for debugging. First, create the project for debugging and the workspace which stores the project in the following procedure: 1.
  • Page 42 Operation  Starting Debugging When steps from [Creating a project] to [Setup Wizard] are 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. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 43: Opening Softune Project Files Of Old Versions

    Operation 2.13 Opening SOFTUNE Project Files of Old Versions The SOFTUNE project files of old versions can be opened.  Procedure  For project files of SOFTUNE Workbench V3 1. Select [Open Workspace] from the [File] menu. 2. Select 'Project file' from File Type and specify the project file made by the early version of SOFTUNE Workbench. If the specified file is one made by the early version of SOFTUNE Workbench, a dialog asking whether to convert the file to a workspace project format is opened.
  • Page 44 Operation  SOFTUNE Manager V01/V02 Old project file (.prj) → v01 • SOFTUNE Workbench V3 (.p03) Change the extension of the backup project file (.p03) and option data file (.d03) to '.prj' and '.dat,' respectively. • SOFTUNE Manager V01/V02 (.v01) Change the extension of the backup project file (.v01) to '.prj.' Notes: •...

  • Page 45: Moving Project Files

    Operation 2.14 Moving Project Files This section explains how to move a project file to another directory or a personal computer.  Procedure 1. Set the path to the member stored in the project file to the relative path from the project file. In SOFTUNE Workbench, files in the same drive as that of the project file are usually stored in the relative path.

  • Page 46: Useful Functions

    Operation 2.15 Useful Functions This section shows some useful functions to use in the SOFTUNE Workbench.  Tab Display of the Windows In the SOFTUNE Workbench, the displayed windows are tabbed. This makes it easier to find the desired window quickly when multiple windows are displayed. ...

  • Page 47: Chapter 3 Windows

    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 Window 3.13 Watch Window...

  • Page 48: Window Configuration

    Windows Window Configuration Each SOFTUNE Workbench window consists of a menu bar, tool bar, window screen, and status bar. Menus are explained in "CHAPTER 4 MENUS".  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.

  • Page 49: Tool Bar

    Windows 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.  Common Bar Open Save Copy Paste Undo Redo...
  • Page 50 Windows  Find Find Next Find Previous Find Find in files Setup/cancel bookmark Next bookmark Previous bookmark Next bookmark in the current window Previous bookmark in the current window Clear all bookmarks in the current window  Project Bar The active project and its active configuration name are set and displayed. ...
  • Page 51 Windows  Debug Bar Step In Step Over Step Out Run Until Cursor Reset MCU Abort Breakpoint Set/Reset Register window Watch window Memory window Disassembly  Flash (MB2146-09/MB2146-08/MB2146-07) Download Flash Memory Upload Flash Memory Erase Flash Memory  Flag Bar Display and setting of MCU condition flag status Note: You cannot select [Download Flash Memory] with the FRAM model.

  • Page 52: Status Bar

    Windows Status Bar The current status of the SOFTUNE Workbench is displayed.  Status Bar The status bar displays the current status of SOFTUNE Workbench. It is displayed at the very bottom of the main window. |----------------1----------------| |--2--| |-----3-----| |-4-| |-5-| |--6--| 1.

  • Page 53: Project Window

    Windows Project Window The Project Window displays information about the project and load module.  Project Window Figure 3.4-1 shows an example of the project window. Figure 3.4-1 Project Window To select the window display contents, use the tab on the bottom of the project window. The project window has the following tabs.

  • Page 54: Src Tab

    Windows 3.4.1 SRC Tab The name of the current project and the file names registered in the project are displayed in the tree view format.  SRC Tab Figure 3.4-2 shows examples of displayed contents of the SRC tab. Figure 3.4-2 SRC Tab Workspace name Target file name of project.
  • Page 55 Windows • 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. • Displaying Debugger setup name When the Debugger setup name is double-clicked, debugging is started based on the setup information. •...
  • Page 56 Windows Valid setup name (for Emulator Debugger) Monitor Debugger setup name Valid setup name (for Monitor Debugger)  Short-Cut Menus (Click the Right Button of the Mouse on a Workspace Name) Figure 3.4-3 shows a short-cut menu. Figure 3.4-3 Short-Cut Menu on a Workspace Name •...
  • Page 57 Windows 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 • Add Member to Project When selected, the following two submenus are displayed.
  • Page 58 Windows Figure 3.4-6 Set Linkage Order Dialog Figure 3.4-7 Export Dialog • 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. •...
  • Page 59 Windows • 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. •...
  • Page 60 Windows • 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. • Set When selected, the following two submenus are displayed: • Individual Setting A project is set (See Section "4.5.5 Setup Project").
  • Page 61 Windows • New When selected, the [Create New Setup] dialog (Figure 3.4-12 ) 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.4 Setup Wizard".
  • Page 62 Windows • 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 Property"). •...
  • Page 63 Windows  Short-Cut Menus (Click the Right Button of the Mouse on Library File, Object File and Relative Format File) Figure 3.4-15 shows a short-cut menu. Figure 3.4-15 Short-Cut Menu on a Library File Name • Set When selected, the following two submenus are displayed: •...
  • Page 64 Windows  Short-Cut Menu (Click the Right Button of the Mouse on Setup Name) Figure 3.4-17 shows a short-cut menu. Figure 3.4-17 Short-Cut Menu on a Setup Name • Start /End Debug During debugging session, the confirmation dialog 'Is the current session ended to start debugging?' is displayed. Select Yes.

  • Page 65: Abs Tab

    Windows 3.4.2 ABS Tab The load module name, source file name, and function name are used as the information acquired from the debug information, and 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...
  • Page 66 Windows  ABS Tab Bitmap Image List Load module name C source file Assembler source file Function name  Short-Cut Menus (Click the Right Button of the Mouse on a Load Module Name) Figure 3.4-20 shows a short-cut menu. Figure 3.4-20 Short-Cut Menu on a Load Module Name •...
  • Page 67 Windows  Short-Cut Menus (Click the Right Button of the Mouse on a Source File Name) Figure 3.4-21 shows a short-cut menu. Figure 3.4-21 Short-Cut Menu on a Source File Name • Open Opens the selected source file in the source window. •...
  • Page 68 Windows  Short-Cut Menus (Click the Right Button of the Mouse on a Function Name) Figure 3.4-22 shows a short-cut menu. Figure 3.4-22 Short-Cut Menu on a Function Name • Jump Opens the selected function in the source window. • Order by name Sort items in the tree in alphabetical order.
  • Page 69 Windows  Short-Cut Menu (Click the Right Button of the Mouse on Space in the Project Window) Figure 3.4-23 shows a short-cut menu. Figure 3.4-23 Short-Cut Menu on Space in the Project Window • Docking View The project window is docked with the frame in the check status. •...

  • Page 70: Output Window

    Windows Output Window The output window displays compiler version information and error messages, etc., when make or build is executed.  Output Window Figure 3.5-1 shows an example of the output window. As shown in this example, when the left button of the mouse is double-clicked on the line to which an error message was output, control automatically jumps to the source line where the error occurred.
  • Page 71 Windows  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 short-cut menu. 3. Select [Copy] from the short-cut menu. See Section "4.3.2 Cut, Copy, Paste, Delete". ...
  • Page 72 Windows  Highlight Keyword 1. Click the right button of the mouse in the output window to display the short-cut menu. 2. Select [Keyword Coloring]. In the check state, the keyword (error number) of the error message is displayed in red. ...

  • Page 73: Edit Window (Standard Editor)

    Windows Edit Window (Standard Editor) The edit window is used to display and edit a source file and document file, etc.  Edit Window An example 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.
  • Page 74 Windows  Short-Cut Menu • Source Window Opens the Source Window. • Undo Cancels the last editing. • Redo Redoes the canceled editing. • Cut Moves the selected character string to the clipboard. • Copy Copies the selected character string to the clipboard. •...
  • Page 75 Windows  1. Select the character string you want to cut. 2. Click the right button of the mouse to display the short-cut menu, then select [Move] from the menu. - SOFTUNE Workbench deletes the selected character string from the edit window and moves it to the clipboard. (See Section "4.3.2 Cut, Copy, Paste, Delete".) ...
  • Page 76 Windows  Find in files 1. Click the right button of the mouse to display the short-cut menu, then select [Find in files] from the menu. - Opens the [Find in Files] dialog. (See Section "4.3.5 Find in Files".)  Jump 1.

  • Page 77: Setting Standard Editor

    Windows 3.6.1 Setting Standard Editor This section explains how to customize the standard editor.  Setting the Standard Editor Some standard editor functions can be customized. • Items that can be customized • Display function • Line feed mark display •...
  • Page 78 Windows  Customization Procedure (Display Color Selection) 1. Click the right button of the mouse in the edit window to display the short-cut menu, then select [Customize...] from the menu. The standard editor dialog shown in Figure 3.6-2 opens. 2. Click the color button of [Bookmark], [Error], [C], or [Assembly]. From [View2] tab, you can set a [Comment], [Ret], [Tab], [User Keyword], and [Zenkaku Spc].
  • Page 79 Windows  Customization Procedure (Deletion of Keyword) 1. Click the right button of the mouse in the edit window to display the short-cut menu, then select [Customize...] from the menu. The standard editor dialog 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.
  • Page 80 Windows Figure 3.6-2 Standard Editor Dialog Figure 3.6-3 Standard Editor Dialog (View2) F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...
  • Page 81 Windows Figure 3.6-4 Keyword Dialog F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 82: Source Window

    Windows Source Window The source window displays the source program at debugging.  Source Window Figure 3.7-1 shows an example of the source window.  Function • Breakpoint setting/releasing A breakpoint can be set or released by left-clicking '==>' of '' at the left edge of the source window. •...
  • Page 83 Windows  Short-Cut Menu • Edit: Opens the edit window. • Refresh: Updates the contents of the source window. It is used when the source program is updated after the Flash memory is changed by the user program for instance. •...
  • Page 84 Windows Figure 3.7-2 Find Dialog in Source Window  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 short-cut menu, then select [Jump] from the menu.
  • Page 85 Windows  Breakpoint Enable/Disable After moving cursor to the line where breakpoint is set to be enable or disable, click right button to display the short-cut menu. Then, please select [Breakpoint Enable/Disable]. This enables to switch the breakpoint, which is pointed by cursor, enable or disable.
  • Page 86 Windows Note: The coverage display in the source window is not automatically updated. You need to update the display with the latest information using the short-cut menu [Update] or by selecting [Update window] or [Update all windows] from the main menu. ...

  • Page 87: Symbol Window

    Windows 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.  Symbol Window Figure 3.8-1 shows an example of the Symbol Window. Figure 3.8-1 Example of Symbol Window The load module name is displayed.
  • Page 88 Windows  Jump 1. Click the right button of the mouse on the function name to display the short-cut menu, then select [Jump] from the menu. The source window in which the function is defined opens.  Watch 1. Click the right button of the mouse on the variable or function name to display the short-cut menu, then select [Watch] from the menu.

  • Page 89: Disassemble Window

    Windows Disassemble Window This window is displayed 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 Figure 3.9-1 shows an example of the disassemble window. ...
  • Page 90 Windows  Short-Cut Menu Inline Assemble: See Section "4.4.3 Assembly". Jump: Displays jump dialog. Go to Current: Displays current program counter location. Breakpoint Set/Reset: This function is to set or to cancel the breakpoint in the instruction pointed by cursor. Breakpoint Enable/Disable: To make breakpoint in the instruction pointed by cursor enable or disable.
  • Page 91 Windows  Breakpoint Set/Reset After moving cursor to the instruction where you want to set or to cancel a breakpoint, click the right button to display short-cut menu. Then, please select [Breakpoint Set/Reset].  Breakpoint Enable/Disable After moving cursor to the instruction where breakpoint is set to be enable or disable, click right button to display the short-cut menu.

  • Page 92: Register Window

    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.  Register Window Figure 3.10-1 shows an example of the Register Window. When debugging, the Register Window displays the register values.

  • Page 93: Setting Register Display

    Windows 3.10.1 Setting Register Display This section explains how to set register display.  Setting Register Display Set the registers to be displayed in the Register Window in the following procedure: Figure 3.10-2 Display Register Setting Dialog  Adding Registers Add the register you want to display in the following procedure: 1.
  • Page 94 Windows  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 short-cut menu, then select [Setup] from the menu. The display setting dialog shown in Figure 3.10-2 opens. 2.

  • Page 95: Memory Window

    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.  Memory Window Figure 3.11-1 shows an example of the memory window. When debugging, memory values can be displayed. The register values can be directly rewritten.
  • Page 96 Windows Figure 3.11-1 Example of Memory Window Bookmark which can be marked in a specific color Data display section. Characters (e.g., control codes) Column title. This Displayed data can be other than ASCII characters are line is not scrolled. directly modified. all represented in ’.’.

  • Page 97: Local Variable Window

    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). ...
  • Page 98 Windows  Memory window When selected, the following two submenus are opened: • Jump Display memory window by using selected address of variable. • Add bookmark By using selected variable address, bookmark will be added to memory window. For details, See Section "4.3.7 Bookmark". ...

  • Page 99: Watch Window

    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.  Watch Window The watch window can be opened independent 4-windows.
  • Page 100 Windows  Function  Drag and Drop 1. Sort variables in the window If you register multiple variables in the window, you can change the order of the variables by dragging a variable and dropping it into a desired place. 2.
  • Page 101 Windows  Property 1. Click the right button of the mouse on a displayed variable name to display the short-cut menu, then select [Property] from the menu. - Information for the variable is displayed. For details, see Section "4.3.9 Property". 2.

  • Page 102: Trace Window

    Windows 3.14 Trace Window This section explains the Trace Window. This window is displayed only when SOFTUNE Workbench is in the debug session.  Trace Window The Trace Window displays the trace result. Figure 3.14-1 shows an example of the Trace Window. This function is available for simulator debugger and emulator debugger (MB2141/MB2146-09/09A/09B).
  • Page 103 Windows  Instruction/cycle/source 1. Click the right button of the mouse to display the short-cut menu. 2. Select [Instruction], [Cycle], or [Source] from the short-cut menu. - The trace result is displayed in the selected mode and a check mark is displayed to the left of the selected submenu. ...

  • Page 104: Command Window

    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 shows an example of the Command Window. Figure 3.15-1 Example of Command Window The execution result of the entered command is...
  • Page 105 Windows  1. Select the character string you want to cut. 2. Click the right button of the mouse on the command input field to display the short-cut menu. 3. Select [Cut] from the short-cut menu.  Copy 1. Select the character string you want to copy. 2.
  • Page 106 Windows  Load Alias File 1. Click the right button of the mouse to display the short-cut menu. 2. Select [Load Alias File] from the short-cut menu. The [Open File] file dialog opens. 3. Select an alias file from the dialog, then click the [Open] button. ...

  • Page 107: Setting Character String Replacement

    Windows 3.15.1 Setting Character String Replacement This section explains how to set character string replacement in the Command Window.  Setting Character String Replacement The aliases, variables, and macro names of the commands used in the Command Window can be defined. ...
  • Page 108 Windows Figure 3.15-2 Replace Command Dialog  Variable The name assigned to the address range to be referenced often can be used for command input. Add and delete a variable in the following procedures.  Adding a variable 1. Click the right button of the mouse in the Command Window to display the short-cut menu. 2.
  • Page 109 Windows Figure 3.15-3 Variable Setting Dialog  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 short-cut menu. 2.
  • Page 110 Windows  Deleting a macro 1. Click the right button of the mouse in the Command Window to display the short-cut menu. 2. Select [Macro etc] from the short-cut menu. The character string replacement setting dialog shown in Figure 3.15-2 opens. 3.

  • Page 111: Logging

    Windows 3.15.2 Logging This section explains SOFTUNE Workbench logging.  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 short-cut menu, then select [Logging]. Selecting [Logging] from the short-cut menu displays the following submenus: •...

  • Page 112: Object Window

    Windows 3.16 Object Window This window is displayed only when SOFTUNE Workbench is in the debug session. The Object Window displays the object information used by REALOS.  Object Window The Object Window displays the object information used by REALOS. Figure 3.16-1 shows an example of the Object Window.
  • Page 113 Windows  Short-Cut Menu • Task Executes task system calls • Semaphore Executes semaphore system calls • Event Flag Executes event flag system calls • Mail Box Executes mail box system calls • Ready Queue Executes ready queue system calls •...

  • Page 114: Coverage Window

    Windows 3.17 Coverage Window This window is displayed only when SOFTUNE Workbench is in the debug session. The Coverage Window displays the coverage measurement result.  Coverage Window Figure 3.17-1 shows an example of the Coverage Window. The Coverage Window displays the coverage measurement result at debugging.
  • Page 115 Windows  Function • Drag and Drop By dropping variable name, function name, label, or address from source window to window, display will be jumped to a location where an address of dropped character string.  Short-Cut Menu • Refresh Refresh Coverage Window display.

  • Page 116: Performance Window

    Windows 3.18 Performance Window The Performance Window displays the performance measurement result.  Performance Window The performance window is used to display the result of performance measurement at the debugging. This window is only displayed for the emulator debugger (MB2141) and the performance mode at the event mode. For the performance function and use conditions, see the relevant sections of "SOFTUNE Workbench User's Manual".
  • Page 117 Windows Figure 3.18-2 When Display Type is Selected to be "Measuring Count"  Short-Cut Menu • Refresh Updates the performance measuring results. • Setup Displays the performance setting dialog box. See Section "4.4.13 Performance". • Display Range See Section "4.4.13 Performance". •...

  • Page 118: Sequence Window

    Windows 3.19 Sequence Window This window is displayed only when SOFTUNE Workbench is in the debug session. The Sequence Window displays the sequence setting state.  Sequence Window For details on the sequence function, see Section "4.6.6 Sequence". An example of the sequence window is shown in Figure 3.19-1 . The sequence window is used to display the sequence setting state at debugging.

  • Page 119: Ram Monitoring Window

    Windows 3.20 RAM Monitoring Window The RAM Monitoring Window is used to monitor the content of the specified address.  RAM Monitoring Window The RAM monitoring window is used to monitor the content of a specific address. An example of the RAM monitoring window is shown in Figure 3.20-1 .
  • Page 120 Windows  Short-Cut Menus The RAM monitoring window has the following four types of short-cut menus. • Setup: Specify the monitoring address. • Monitoring: Enables or disables monitoring the specified monitoring address. • Radix: Select Decimal or Hexadecimal to display data. •...

  • Page 121: Chapter 4 Menus

    CHAPTER 4 MENUS This chapter explains the SOFTUNE Workbench menu configuration and the dialogs 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 F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 122: Menu Configuration (Tree)

    MENUS Menu Configuration (Tree) This section explains the SOFTUNE Workbench menu configuration.  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. ...
  • Page 123 MENUS Bookmark Previous Error Next Error Top of Error Bottom of Error Property  View Project Output Symbol Assembly Register Memory Local Watch Trace Coverage Performance Command Object Tool Bar Status Bar Bookmark Fonts  Project Active Project Add Project Add Member Setup Workspace Setup Project...
  • Page 124 MENUS Build Stop  Debug Abort Reset MCU Breakpoint Breakpoint Set/Reset Event Sequence Stack Time Measurement Call Clear Call Vector Load Target File Start Debug/Terminate Debug  Setup Development Debug Environment Memory Map Flash area control Tool Keyboard Editor Error Start Tool F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.
  • Page 125 MENUS  Window Cascade Vertical Horizon Split Arrange Icons Refresh Refresh All Windows Close All Windows  Help Help Topics Support Information About Fs896s F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 126: File Menu

    MENUS File Menu File Menu of SOFTUNE Workbench has the following functions: - Workspace and file accessing - Printing - End of SOFTUE Workbench  Functions Related to Project and File Accessing The project and file accessing functions are as follows. •...

  • Page 127: New

    MENUS 4.2.1 "New" creates a workspace/project and file newly. Selecting "New" from the file menu opens the new creation dialog asking the operator whether to create a workspace/ project or text file (Figure 4.2-1 ).  New Creation Dialog Figure 4.2-1 New Creation Dialog F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.
  • Page 128 MENUS  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) F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.
  • Page 129 MENUS  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 a existing workspace, see Section "2.4 Storing of Project".

  • Page 130: Open

    MENUS 4.2.2 Open "Open" opens existing files. Selecting "Open" from the file menu opens the open dialog asking the file you want to open (Figure 4.2-4 ).  Open Dialog Selecting [Open] from the file menu opens the open dialog. The following items can be selected for "File type".
  • Page 131 MENUS  Opening the Load Module File • When the workspace file is not opened. The confirmation dialog asking you to confirm whether to create a new project or open an existing workspace or project is displayed. Figure 4.2-5 Message Dialog [Yes]: Creates a new project.
  • Page 132 MENUS Figure 4.2-7 Dialog to Open File (Monitor Debugger) Figure 4.2-8 Dialog to Open File (Simulator Debugger) [Only debug information]: Loads debug information only. [Delete all flash, and load high-speed]: Reduces the time to load the target file. However, all the flash memory area must be cleared before loading.
  • Page 133 MENUS debugger. [Auto mapping]: Automatically configures memory map. This function is available only in the simulator debugger. Note: If [Auto Mapping] is not specified, configure memory map before opening the load module.  Opening the Binary File Figure 4.2-9 Dialog to Open File (Binary File) [Start address]: Specify the address to start reading binary data.
  • Page 134 MENUS  Opening the Batch File Figure 4.2-10 Dialog to Open File (Batch File) [Iconic]: Starts batch processing in icon mode. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 135: Close

    MENUS 4.2.3 Close "Close" closes open files and windows.  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 for asking the operator whether to save the file opens. - [Yes] button...Saves the file using the existing file name.

  • Page 136: Open Workspace

    MENUS 4.2.4 Open Workspace "Open Workspace" opens the existing workspace file.  Opening the Existing Workspace File The file dialog for selecting the file you want to open opens. • When the existing workspace file has been already opened and SOFTUNE Workbench is in the debug session. The dialog for asking the operator whether to terminate debugging opens.

  • Page 137: Close Workspace

    MENUS 4.2.5 Close Workspace "Close Workspace" closes the currently open workspace file.  When the Currently Open Workspace File is not Edited at All When the workspace file is closed, the dialog for asking the operator whether to save the current workspace information opens.

  • Page 138: Save

    MENUS 4.2.6 Save "Save" saves the currently open file using the existing file name.  Save Dialog The save dialog is used to save the file using the existing file name. The text file, workspace file, binary file, alias file, setup file, or coverage file can be selected from this dialog as the type of file.

  • Page 139: Save As

    MENUS 4.2.7 Save As "Save As" stores the previously saved file under a new file name.  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, setup file, or coverage file can be selected as the type of file.
  • Page 140 MENUS  Saving the Binary File Specify a save start address in [Start Address]. When the binary file has been already loaded, the start address at that time is set. Specify a save end address in [End Address]. When the binary file has been already loaded, the end address at that time is set.

  • Page 141: Save All

    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 opened in the edit window. Data in the workspace, project file and output window is not saved.

  • Page 142: Print

    MENUS 4.2.9 Print "Print" prints file data.  Data to be Printed [Print] prints data in the file currently opened in the edit window; it cannot print other window (file) data. Print output window data in any of the following two procedures: •...

  • Page 143: Recent Text File/Recent Workspace File

    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. ...

  • Page 144: Exit

    MENUS 4.2.11 Exit "Exit" terminates SOFTUNE Workbench.  When a File is being Edited The dialog for asking the operator whether to save the file being edited opens. [Yes] button ... Saves the file being edited and terminates SOFTUNE Workbench. [No] button ...

  • Page 145: Edit Menu

    MENUS Edit Menu The edit menu provides such functions as file editing, find string, and error jump.  File Editing Function The file editing function includes the following: • Undo • Redo • Cut • Copy • Paste • Delete •...

  • Page 146: Undo, Redo

    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.  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 addition or deletion of characters and lines.

  • Page 147: Cut, Copy, Paste, Delete

    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.
  • Page 148 MENUS  Delete "DELETE" deletes the character string selected from 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 Copy Paste Delete...

  • Page 149: All Select

    MENUS 4.3.3 All Select "All Select" selects all the character strings displayed in a window.  Target This function operates only in the edit and output windows. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 150: Find/Replace

    MENUS 4.3.4 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.  Target "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.
  • Page 151 MENUS Figure 4.3-2 Replace Dialog Table 4.3-2 List of Conditions and Explanation for Character String Search Condition Explanation 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.

  • Page 152: Find In Files

    MENUS 4.3.5 Find in Files This section explains how to search the specified file for the specified character string.  Find in Files SOFTUNE Workbench searches the specified file for the specified character string and displays the search result in the output window.

  • Page 153: Jump

    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. ...

  • Page 154: Bookmark

    MENUS 4.3.7 Bookmark Bookmark is a function to specify the specified location in window and enable to jump to the specified location by using menu or key operation.  Bookmark Function 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.

  • Page 155: Bookmark-Source Window

    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] - [Bookmark] - [Bookmark], dialog as shown in Figure 4.2-12 will be opened. This dialog is to indicate the list of bookmark set in source window.
  • Page 156 MENUS Please refer to [Note] for allocatable symbol.  [Add] button Set a bookmark to a location specified by [Bookmark position]  [Delete] button Delete selected bookmark from a list.  [All delete] button Delete all bookmarks from a bookmark list. ...
  • Page 157 MENUS  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] ...

  • Page 158: Bookmark-Memory Window

    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.
  • Page 159 MENUS  [Change] button Display [Add a bookmark] dialog and change the setup of selected bookmark in a bookmark list.  [Delete] button Delete a bookmark selected from the list of a bookmark.  [All Delete] button Delete all bookmarks from the list of a bookmark. ...
  • Page 160 MENUS 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.

  • Page 161: Bookmark-Edit Window

    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 Figure 4.3-8 will be opened. This dialog is to display the list of bookmark that is set to an edit window.
  • Page 162 MENUS  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.

  • Page 163: Previous Error, Next Error, Top Of Error, Bottom Of Error

    MENUS 4.3.8 Previous Error, Next Error, Top of Error, Bottom of Error "Previous error", " Next error", "Top of Error" and "Bottom of Error" moves the cursor in the edit window to the source line where a make, build, compilation, or assembler error occurred.

  • Page 164: Property

    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 •...

  • Page 165: Property-Project Window

    MENUS 4.3.9.1 Property-Project Window This section explains the property in the Project Window.  Property: General Figure 4.3-9 Property-Project Window (General 1) • File name The full-path to the selected file is displayed. • Directory The directory of the selected file is displayed. If editing is enabled, the file to be referred can be changed. If given in a relative path, the directory is described in a relative path in the project file.
  • Page 166 MENUS Figure 4.3-10 Property-Project Window (General 2) • 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) •...
  • Page 167 MENUS  Property: Conditions Figure 4.3-12 Property-Project Window (Dependence) • Tool Displays the language tool to be executed. • File Displays a dependency file list. Selecting a file name from the list displays the update date and time of the file. •...
  • Page 168 MENUS • File The file used in creating a target file is displayed in order. • Modified Displays the date and time of the last file update.  Property: Output Figure 4.3-14 Property-Project Window (Output) • Output name Main file name of all files outputted by the language tool of the selected file is displayed. •...

  • Page 169: Property-Edit Window

    MENUS 4.3.9.2 Property-Edit Window This section explains the property in the Edit window.  Property: General Figure 4.3-15 Property-Edit Window (General) • File name The full-path to the selected file is displayed. • Size Displays the file size. • Modified Displays the date and time of the last file update.

  • Page 170: Property-Source Window

    MENUS 4.3.9.3 Property-Source Window This section explains the property in the Source window.  Property: General Figure 4.3-16 Property-Source Window (General) • File name The full-path to the selected file is displayed. • Directory Displays the directory in which the source file exists. When changed, the directory is searched and the found source file is redisplayed.

  • Page 171: Property-Symbol Window

    MENUS 4.3.9.4 Property-Symbol Window This section explains the property in the Symbol window.  Property: General Figure 4.3-17 Property-Symbol Window (General) • Symbol name The name of the selected symbol is displayed. • Scope The scope position of the selected symbol is displayed. •...

  • Page 172: Property-Local Window

    MENUS 4.3.9.5 Property-Local Window This section explains the property in the Local window.  Property: General Figure 4.3-18 Property-Local Window (General) • 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.

  • Page 173: Property-Watch Window

    MENUS 4.3.9.6 Property-Watch Window This section explains the property in the Watch window.  Property: General Figure 4.3-19 Property-Watch Window (General) • 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.

  • Page 174: View Menu

    MENUS View Menu The View Menu displays each window. It also sets the tool bar and status bar to view or non-view.  Window View/Non-view The View Menu can set the following windows to view or non-view. • Project Window •...
  • Page 175 MENUS  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 enables to switch edit, source, memory or watch windows easily. • Tab F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 176: Project/Output

    MENUS 4.4.1 Project/Output "Project" switches the Project Window to view or non-view or vice versa. "Output" switches the Output Window to view or non-view or vice versa.  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 non-view, the project is not closed.

  • Page 177: Symbol

    MENUS 4.4.2 Symbol "Symbol" views the Symbol Window.  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 has been already opened activates the Window.

  • Page 178: Assembly

    MENUS 4.4.3 Assembly "Assembly" displays the Disassemble Window.  Assembly When the Assembly window is opened, the assembly is displayed, starting at the specified address. Line assembly from the short-cut menu is also possible. This function (command) can be used only when SOFTUNE Workbench is in the debug session. •...
  • Page 179 MENUS  Inline Assemble Selecting [Inline Assemble] from the short-cut menu opens the Inline assemble dialog shown in Figure 4.4-2 . Figure 4.4-2 Inline Assemble Dialog Writing a mnemonic in the [Mnemonic] edit box and clicking the [Update] button assembles and sets the mnemonic, starting from the start address.

  • Page 180: Register

    MENUS 4.4.4 Register "Register" displays the Register Window.  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 [Register] when the Register Window has been already opened activates the Window.
  • Page 181 MENUS  Selected register name change 1. Click the right button of the mouse in the Register Window to display the short-cut menu, then select [Edit]. The register edit dialog shown in Figure 4.4-3 opens. 2. Select a register name. 3.

  • Page 182: Memory

    MENUS 4.4.5 Memory "Memory" displays the Memory Window.  Displaying Memory Data When the Memory Window is opened, memory data dump is displayed, starting from the specified address. Memory data can be also modified using the short-cut menu. This function (command) can be used only when SOFTUNE Workbench is in the debug session. •...
  • Page 183 MENUS  Add Bookmark Please click on the right button of the mouse on memory window to display short-cut 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) Figure 4.4-6 Add Bookmark Dialog (Symbol) ...
  • Page 184 MENUS  Area 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  Start address Specify the start address of bookmark. ...
  • Page 185 MENUS • 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. For example, when 4 is specified as the skip data count, addresses are skipped for each 4 bytes like address 4 and address 8 and the search range is searched.
  • Page 186 MENUS • Fill Data Specifies filling data to fill specified memory area. Several filling data can be specified, delimited by a comma (,).  Copy Figure 4.4-9 Memory Operation Dialog (Copy) 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.
  • Page 187 MENUS  Copy to emulation memory (MB2141) Figure 4.4-10 Memory Operation Dialog (Copy to Emulation Memory) To copy data from user memory to emulation memory, open the [Copy to Emulation Memory] tag, then set the transfer start address and transfer end address. •...
  • Page 188 MENUS • Start Address Specify the address at which collation is to be started. Collating user memory with emulation memory is started at this address. • End Address Specify the end address of the collation source area. Collating user memory with emulation memory is continued to this address.
  • Page 189 MENUS Figure 4.4-13 Memory Edit Dialog  Setup To set the display format of the Memory Window, click the right button of the mouse in the Memory Window, then select [Setup] from the menu. The setup dialog shown in Figure 4.4-14 opens. •...

  • Page 190: Local

    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 the displayed variables can be canceled.

  • Page 191: Watch

    MENUS 4.4.7 Watch "Watch" displays the Watch Window.  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.
  • Page 192 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 short-cut menu is displayed. 2. Select [Edit] from the short-cut menu. The variable edit dialog shown in Figure 4.4-17 opens.
  • Page 193 MENUS  Start element number Specifies start element number displayed at array expansion.  End element number Specifies end element number displayed at array expansion. Only specified range is displayed at array expansion. At default, all elements are displayed. In the watch window, the setting value is restored when reactivating the debugger. Note: The value of one-dimensional array registered as the watch variable is only restored.

  • Page 194: Trace

    MENUS 4.4.8 Trace This section explains the trace function.  Trace Functions 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.
  • Page 195 MENUS  Searching for Trace Data The trace buffer can be searched for trace data. To search for trace data, select [Find] in the shortcut menu of the Trace Window. Figure 4.4-19 Trace Search Dialog • Search address Specifies the start address of the range to be searched. •...
  • Page 196 MENUS Note: 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 and Address Mask Search address Address mask Actual address to be found H'FFFF H'F0CA H'F0CA...
  • Page 197 MENUS  Saving Trace Data Trace data displayed in the Trace Window can be saved. Select [Save file] in the short-cut menu of the Trace Window. If a file name that already exists is specified, another dialog is displayed to confirm that the data will be saved over that file.
  • Page 198 MENUS Figure 4.4-23 Append Confirmation Dialog • If [Yes] is selected: The trace data is appended. • If [No] is selected: The trace data is overwritten. • If [Cancel] is selected: Saving of the trace data is cancelled.  Other Trace Functions The contents on the next page and onwards explain the methods of setting the trace function for each debugger.

  • Page 199: Trace (Simulator Debugger)

    MENUS 4.4.8.1 Trace (Simulator Debugger) This section explains the trace functions of the simulator debugger.  Trace Functions For the simulator debugger, the following trace functions can be used. • Trace mode - Controlling the trace status - Buffer-full break For details of each item, see "2.1.10 To Refer to a Program Execution History, Use [TRACE]"...

  • Page 200: Trace (Emulator Debugger [Mb2141])

    MENUS 4.4.8.2 Trace (Emulator Debugger [MB2141]) This section explains the trace functions of the emulator debugger (MB2141).  Trace Functions For the emulator debugger (MB2141), the following trace functions can be used. • Trace mode Controlling the trace status Buffer-full break For details of each item, see "2.2.7 To Refer to a Program Execution History, Use [TRACE]"...

  • Page 201: Command

    MENUS 4.4.9 Command "Command" displays the Command Window.  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".

  • Page 202: Tool Bar, Status Bar, Tab

    MENUS 4.4.10 Tool Bar, Status Bar, Tab The functions of tool bar, status bar, and tab can be configured.  Tool Bar Any of the following tool button sets displayed in the tool bar can be selected: • Common bar •...

  • Page 203: Object

    MENUS 4.4.11 Object "Object" displays the Object Window.  Object Window The Object Window displays the detailed object information used by REALOS. This window can be also used to issue system calls. To display detailed object information, select an ID, then select [Property] from the short-cut menu. ...
  • Page 204 MENUS TTW_SEM wai_sem wait state TTW_FLG wai_flg wait state TTW_MBX rcv_msg wait state TTW_MPL get_blk wait state • Wakeup Count Wakeup request count • Timeout Control Data Timeout management data • Stack Pointer Stack pointer • Stack Area Stack area ...
  • Page 205 MENUS  Detailed Display of Event Flag Figure 4.4-28 Detailed Event Flag Display Dialog • ID Event flag ID number • Address Address of event flag control block • Flag value Current event flag pattern • Flag address Address of current event flag table •...
  • Page 206 MENUS • Address Address of mailbox control block • Message State Message address • Waiting Task ID number of task in queue Waiting Task or Message State is displayed according to the wait factor.  Detailed Display of Cyclic Handler Figure 4.4-30 Detailed Cyclic Handler Display Dialog •...
  • Page 207 MENUS  Detailed Display of Ready Queue Figure 4.4-31 Detailed Ready Queue Display Dialog • Priority Priority • Address Address of ready queue header table • Queueing task ID number of queued task  Detailed Display of Timer Queue Figure 4.4-32 Detailed Timer Queue Display Dialog •...

  • Page 208: Coverage

    MENUS 4.4.12 Coverage "Coverage" displays the Coverage Window.  Coverage Window The window displaying the coverage measurement result is opened for setting the coverage and displaying the total coverage rate. This window can be used only for the emulator debugger (MB2141). ...
  • Page 209 MENUS  Coverage Rate Select [Total Coverage] from the short-cut menu of the Coverage Window. The total coverage rate and the coverage rate for each address range are displayed. Figure 4.4-34 Coverage Rate Dialog F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 210: Performance

    MENUS 4.4.13 Performance This section explains the performance function.  Performance Functions This function is used to measure the time duration and cycle count required to execute a program for a specified section. The measurement data is displayed in the Performance Window. This function can be used only in the emulator debugger (MB2141).
  • Page 211 MENUS [Example] When the display type is "measurement count" count  Performance Buffer Performance measurement data is buffered to a special buffer for performance purposes. Since the performance buffer has limited capacity, it eventually becomes full as the debugging proceeds. If the performance buffer obtains performance data that exceeds its buffer size or maximum measurement count, data is overwritten starting from the oldest data.

  • Page 212: Performance (Emulator Debugger [Mb2141])

    MENUS 4.4.13.1 Performance (Emulator debugger [MB2141]) This section explains the performance functions of the emulator debugger (MB2141).  Performance Functions of Emulator Debugger (MB2141) When the event mode of the emulator debugger (MB2141) is set to performance mode, the following performance functions can be used.
  • Page 213 MENUS • Display mode [Automatic/Manual] When [Manual] is selected, set [Lower Value] and [Interval]. • Lower value Specify display start time for detailed measurement result display. • Interval Specify display interval time for detailed measurement result display. • Unit The measurement unit is setting value [1μs/100ms] in [Timer minimum measuring unit] of [Emulation] tab of Debug Environment Setup Dialog.

  • Page 214: Fonts

    MENUS 4.4.14 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 set to the defaults. During debugging, the fonts for debug-related windows (such as Source window) can be changed.
  • Page 215 MENUS Figure 4.4-37 Set Font Dialog Figure 4.4-38 Set Font Dialog F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 216: Ram Monitoring

    MENUS 4.4.15 RAM Monitoring This section explains settings for RAM monitoring functions.  RAM Monitoring Functions The function of monitoring the content of the specified area during program execution while stopping CPU temporally is called RAM monitoring. For details, see the following sections in the "SOFTUNE Workbench User's Manual". MB2146-09B: "2.3.6 RAM Monitoring"...
  • Page 217 MENUS Figure 4.4-39 RAM Monitoring Setup Dialog • Address list: Displays a list of the specified monitoring addresses. The maximum number of addresses to be set is as follows. MB2146-09B:32 MB2146-07:16 The RAM monitoring window displays monitoring addresses in the order in which they are arranged in this list.

  • Page 218: Project

    MENUS Project "Project" sets project-related items and executes make/build.  Project-related Item Setup • Active Project • Add Project • Add Member • Setup Workspace • Setup Project • Setting Customize Build • Project Dependencies • Configuration • Include Dependencies ...

  • Page 219: Active Project

    MENUS 4.5.1 Active Project The active project is replaced.  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 checkmark is placed at the left side of the active project name in the menu. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 220: Add Project

    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.

  • Page 221: Add Project-Create

    MENUS 4.5.2.1 Add Project-Create A new project is created and stored in workspace.  Add Project-Create Figure 4.5-1 Create Project Dialog • Project Type Select the project type. For details about the project type, see Section "2.4 Storing of Project". •...
  • Page 222 MENUS • Project Name Specifies the project name. • Target File name Specifies the target file name. • 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.

  • Page 223: Add Project-Existing Project

    MENUS 4.5.2.2 Add Project-Existing Project An existing project is stored in workspace.  Add Project-Existing Project Figure 4.5-2 Add Project Dialog • 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.

  • Page 224: Add Member

    MENUS 4.5.3 Add Member "Add Member" adds a file to the project.  Add Member There are the following 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. The file dialog box for file selection is displayed.

  • Page 225: Add Member-File

    MENUS 4.5.3.1 Add Member-File A file is specified and stored in the project.  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 •...

  • Page 226: Add Member-Directory

    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 • Directory Specifies the directory having the file to be stored. • Sub-directory also targeted When a checkmark is placed, the files in the sub-directory in the specified directory are stored.

  • Page 227: Setup Workspace

    MENUS 4.5.4 Setup Workspace The basic setting regarding workspace is performed.  Setup Workspace Figure 4.5-5 Setup Workspace Dialog • Debug when workspace is open Specifies the debug action just after the workspace opens. • Save debug setup file (debug environment) when debug ends Specifies whether to save setup information upon completion of debug session.

  • Page 228: Setup Project

    MENUS 4.5.5 Setup Project Setting regarding the project is performed.  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.
  • Page 229 MENUS  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.
  • Page 230 MENUS  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. •...

  • Page 231: General

    MENUS 4.5.5.1 General This section explains the items that can generally be set in the [Setup Project] dialog.  Setting of General 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] [Output Directory] Even though any category is selected, all the C compiler option currently being set is displayed at the bottom of the dialog.
  • Page 232 MENUS • Project Type Set the type of project file selected in the tree view (absolute (ABS)/relative (REL)/library (LIB)). If the REALOS (ABS) type is selected, the project type cannot be changed. This item can be set when the project file is selected singly. The project type cannot be set for each configuration.

  • Page 233: Mcu

    MENUS 4.5.5.2 This section explains the items that can be set MCU 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] [Set CPU information] [MCU Change]...
  • Page 234 MENUS • MCU Change Open MCU Change dialog.  Setting of CPU Information  Setup CPU information - IRQ and ICR Figure 4.5-10 CPU Information Setup Dialog (IPQ and ICR) • Relationship between Vector and ICR The correspondence between external interrupts (Vector) and the interrupt control register (ICR) varies with the target MCU.
  • Page 235 MENUS  Setup CPU Information - Internal RAM Area Figure 4.5-12 CPU Information Setup Dialog (Internal RAM Area) • Start Address Sets start address of internal RAM area. • End Address Sets end address of internal RAM area.  Setup CPU Information - Standby Control Register Figure 4.5-13 CPU Information Setup Dialog (Standby Control Resister) •...
  • Page 236 MENUS  Setting of MCU Change Dialog 1. Click [MCU change] button. The MCU change dialog shown in Figure 4.5-10 opens. 2. From [Current file], choose the CPU information file 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].

  • Page 237: Setting C Compiler Options

    MENUS 4.5.5.3 Setting C Compiler Options This section explains how to set C compiler options.  Setting C Compiler Options 1. Click the [C Compiler] tab from the project setup dialog. 2. Select category. [General], [Define Macro], [Include Path], [Optimize] or [Language specifications] can be selected as category. Even though any category is selected, all the C compiler option currently being set is displayed at the bottom of the dialog.
  • Page 238 MENUS • Outputs start message (-V). • Outputs debug information (-g). • Outputs warning message (or warning level) (-w). • Outputs stack usage 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].
  • Page 239 MENUS 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"...
  • Page 240 MENUS 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].
  • Page 241 MENUS  Setting [Optimize] Options Figure 4.5-18 Optimize Option Setup Dialog The following options can be set from the optimize option setup dialog. Select the optimize option to set from the drop- down list. • General-purpose optimization level. (-O) (None/Level1-4/speed priority/size priority) F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.
  • Page 242 MENUS  Setting of Options Included in [Detail Definition] in [Optimization] Figure 4.5-19 Optimize Details Setup Dialog The following options can be specified: • Loop unrolling (-K UNROLL) • In-line expansion of standard library functions, or replacement to equivalent function (-K LIB) •...
  • Page 243 MENUS  Canceling In-line Expansion of Specified Functions 1. Select the [Optimization] category. The Set Optimization dialog (See Figure 4.5-19 ) opened. 2. Sets [General-purpose Optimization Level] to any values other than 0 and click [Detail optimize] button. 3. Select the function name to be deleted from [List of function]. 4.
  • Page 244 MENUS • Treat most significant bit of char type as sign bit (-K SCHAR). • In-line of ITRON system call development (-K REALOS). • If int type specified in bit field, treat most significant bit as sign bit (-K SBIT). •...

  • Page 245: Setting Assembler Options

    MENUS 4.5.5.4 Setting Assembler Options This section explains how to set assembler options.  Setting Assembler Options 1. Click the [Assembler] tab from the project setup dialog. 2. 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.
  • Page 246 MENUS The following options can be set from the general option setup dialog. • 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 startup options from command lines.
  • Page 247 MENUS 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.  Resetting a Macro Name 1. Select the [Define Macro] category. The macro name setup dialog shown in Figure 4.5-22 opens.
  • Page 248 MENUS 1. Select the [Include Path] category. The include path setup dialog shown in Figure 4.5-23 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].
  • Page 249 MENUS  Setting List Output Figure 4.5-24 List Output Setup Dialog 1. Select the [Output List] category. The list output setup dialog shown in Figure 4.5-24 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 to be set.
  • Page 250 MENUS  [Target Depend] Options Figure 4.5-25 Target Dependency Setup Dialog The following options can be specified: • Outputs accumulator protection code (-sa) F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 251: Setting Linker Options

    MENUS 4.5.5.5 Setting Linker Options This section explains how to set linker options.  Setting Linker Options 1. Click the [Linker] tab from the project setup dialog. 2. Select category. [General], [Allocation/Link], [Define Symbol], [List Output], [Absolute Assemble List], [Control Library], or [Register Bank] can be selected as category.
  • Page 252 MENUS The following options can be set from the general option setup dialog. • Outputs start message (-V) • Outputs debug information (-g) • Control of Default Option File (-Xdof) • Entry Point (-e) • Warning Level (-w)(Level 0 to 2) •...
  • Page 253 MENUS 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 shown in Figure 4.5-27 opens. 2. Specify a [Symbol Name]. 3.
  • Page 254 MENUS 1. Select the [Output List] category. The list output setup dialog shown in Figure 4.5-28 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 to be set from the list output setup dialog.
  • Page 255 MENUS  Setting Absolute Format Assemble List Options Figure 4.5-29 Absolute Format Assemble List Setup Dialog 1. Select the [Absolute Assemble List] category. The absolute format assemble list setup dialog shown in Figure 4.5-29 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 to be set from the absolute format assemble list setup dialog.
  • Page 256 MENUS  Setting of Options for Library Control Figure 4.5-30 Library Control Setup Dialog  Setting When the Default Library is not Used 1. Select the [Control Library] category. The library control setup dialog shown in Figure 4.5-30 opens. 2. Set a check mark to the left of [Don't retrieve the default library]. ...
  • Page 257 MENUS  Setting a Library Retrieval Path 1. Select the [Control Library] category. The library control setup dialog shown in Figure 4.5-30 opens. 2. Set [Search Path]. Clicking the [Browse] button to the right of the input file enables path reference. 3.
  • Page 258 MENUS  Setting Register Bank Figure 4.5-31 Resister Bank Setup Dialog 1. Select the [Register Bank] category. The register bank setting dialog is displayed (Figure 4.5-31 ). 2. Set the check mark for the register bank list to be used. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 259: Section Disposition/Connection Specifying

    MENUS 4.5.5.6 Section Disposition/Connection Specifying This section explains how to set the section allocation/link option (linker option).  Section Disposition/Connection Specifying 1. Click the [Linker] tab from the project setup dialog. 2. Select the [Disposition/Connection] category. The disposition/connection setup dialog shown in Figure 4.5-32 opens. 3.
  • Page 260 MENUS Figure 4.5-32 Disposition/Connection Setup Dialog F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...
  • Page 261 MENUS Figure 4.5-33 Setup Section Dialog  When a Section is Allocated to the Specified ROM/RAM Area 1. Define the ROM/RAM area. See Defining the ROM/RAM area. 2. Select the ROM/RAM area you want to set from [ROM/RAM Area List]. 3.
  • Page 262 MENUS  When a Section is Allocated to the Specified Starting Address 1. Click the [Set Section...] button. The section setup dialog shown in Figure 4.5-33 opens. 2. Select [Specify in Address] from the drop-down list for [ROM/RAM Area Name]. 3.
  • Page 263 MENUS  Notes in Addressing 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 List] are as follows: sec1=H'1000 sec2 sec3=H'F000...
  • Page 264 MENUS 5. Click the [OK] button. The specified ROM/RAM area is registered in [ROM/RAM Area List]. In Auto Disposition (Mode 2), 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. ...

  • Page 265: Setting Librarian Options

    MENUS 4.5.5.7 Setting Librarian Options This section explains how to set librarian options.  Setting Librarian Options 1. Click [Librarian] tab from the project setup dialog. 2. Select category. [General] or [Output List] can be selected as category. Specified options can be checked using [Option] at the bottom of the dialog. ...
  • Page 266 MENUS  Setting the Output-listing Figure 4.5-36 Librarian Option Setup Dialog (Output List) 1. Select any of the following output types: - Outputs section name and size for module - Outputs external define symbol for module - Outputs external browse symbol for module - Outputs all external define symbol and unsolved external define symbol 2.

  • Page 267: Setting Converter Options

    MENUS 4.5.5.8 Setting Converter Options This section explains how to set converter options.  Setting Converter Options 1. Click the [Converter] tab from the project setup dialog. 2. To start the load module converter marks the [Start load module converter] checkbox. 3.
  • Page 268 MENUS - 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.
  • Page 269 MENUS Figure 4.5-37 Converter Option Setup Dialog F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 270: Setting Debug Options

    MENUS 4.5.5.9 Setting Debug Options This section explains how to set debug options.  Setting Debug Options 1. Click the [Debug] tab from the project setup dialog. The debug option setup dialog shown in Figure 4.5-38 opens. 2. Select category. [General] or [Setup] can be selected as category.
  • Page 271 MENUS  Setting Options in [Setup] 1. Click the [Debug] tab from the project setup dialog. 2. Select [Setup] category. 3. Set [Setup Name]. Set a 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.4 Setup Wizard". Clicking the [Browse] button reads information from the set file for setup.
  • Page 272 MENUS  Changing Debugger Setup 1. Click [Debug] tab from the project setup dialog. 2. Select [Setup] category. 3. Select the setup name to be changed from [Setup Name List]. 4. Click the [Change] button. Setup Wizard is started. See Section "4.7.2.4 Setup Wizard". ...

  • Page 273: Setting Customize Build

    MENUS 4.5.6 Setting Customize Build This section explains how to start a different tool before or after executing the language tool during Make or Build.  Customize Build Function 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.
  • Page 274 MENUS  Tool Button List Delete Down  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. • Default When the Customize Build is set when 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.
  • Page 275 MENUS  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.  Title Input the tool name; duplicated tool names do not cause a problem. ...
  • Page 276 MENUS 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 Description Usable in Manager" in SOFTUNE Workbench User's Manual.

  • Page 277: Project Dependencies

    MENUS 4.5.7 Project Dependencies A subproject is defined in the project.  Project Dependencies Figure 4.5-42 Dependency of Project Dialog • 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 selected project can depend in "Project name"...

  • Page 278: Project Configuration

    MENUS 4.5.8 Project Configuration The project configuration is set.  Project Configuration There are the following 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.

  • Page 279: Project Configuration-Add And Delete

    MENUS 4.5.8.1 Project Configuration-Add and Delete The project configuration is set (Add and Delete).  Project Configuration-Add and Delete Figure 4.5-43 Add and Delete Project Configuration Dialog • Project and Configuration All projects in workspace and their configurations are displayed. •...
  • Page 280 MENUS Figure 4.5-44 Add Project Configuration Dialog • Project name The name of the project to which the configuration is added is displayed. • Configuration name Set the name of the project configuration to be added. • A copy of setting Select the configuration to which settings are copied.

  • Page 281: Project Configuration-Configuration At Build

    MENUS 4.5.8.2 Project Configuration-Configuration at Build The configuration as a subproject is made or built is set.  Project Configuration-Configuration at Build Figure 4.5-45 Set Configuration When Building Dialog • Project Select the parent project of a subproject. • Configuration Select the configuration of the parent project selected in "Project".

  • Page 282: Include Dependencies

    MENUS 4.5.9 Include Dependencies "Include Dependencies" updates include file dependency.  Include Dependencies This command (function) checks all the source files in the project file and registers all the include files being used by the source files in the project. The registered include files are displayed in the [Dependencies] category field of the SRC tab of project Window.

  • Page 283: Compile, Make, Build, And Stop

    MENUS 4.5.10 Compile, Make, Build, and Stop This section explains the functions of Compile, Make, Build, and Stop.  Compile 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.

  • Page 284: Debug

    MENUS Debug "Debug" starts and terminates debugging and controls the debugger when SOFTUNE Workbench is in the debug session.  Debug Start and Termination • Loading Target File • Start Debug/End Debug  Debugger Control When SOFTUNE Workbench is in the Debug Session •...

  • Page 285: Run

    MENUS 4.6.1 This section explains the debugger program execution function.  Run "Run" provides the following five functions: • Go When [Go] is clicked, the debugger continuously executes the program from the current program counter position. When a breakpoint is reached or when [Abort] is selected from the [Debug] menu, the debugger stops program execution. •...

  • Page 286: Abort

    MENUS 4.6.2 Abort This section explains the debugger program execution stop function.  Abort [Abort] is used to forcibly interrupt the program being executed by the debugger. When the program stops, the program counter moves to the next instruction address of the last executed instruction. Source line display and disassemble display are also updated according to the program counter value set when the program stopped.

  • Page 287: Reset Mcu

    MENUS 4.6.3 Reset MCU This section explains the MCU reset function of the debugger.  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 clear other registers to 0.

  • Page 288: Breakpoint

    MENUS 4.6.4 Breakpoint This section explains a breakpoint.  What is a Breakpoint? When the program counter passes an address or the program accesses data at an address, the position where program execution by the debugger is to be stopped is called a breakpoint. ...
  • Page 289 MENUS  Break Dialog Select [Debug] - [Breakpoints] menu to display the break dialog. The following dialog is displayed in the simulator debugger. Figure 4.6-1 Break Dialog (Simulator Debugger) • Specifying a breakpoint Enter conditions such as a break address, and click the [Set] button. The specified content is reflected in the break list. If an existing address in the break list is specified, it is overwritten.
  • Page 290 MENUS Figure 4.6-2 Details Dialog (Simulator Debugger) • Checking the currently specified breakpoint conditions If a breakpoint to be checked is selected in the list, the current setting is reflected in the dialog. When break conditions are specified in the detail setup dialog, click the [Extend] button while the target breakpoint is selected in the list. This displays the dialog that has the specified conditions reflected.

  • Page 291: Code Break (Simulator/Monitor Debugger)

    MENUS 4.6.4.1 Code Break (Simulator/Monitor Debugger) This section explains a code break in the simulator debugger and monitor debugger.  What is a Code Break? The code break is a break function that stops a program when the program counter passes (executes) through the specified address.
  • Page 292 MENUS This item is not available in the monitor debugger.  Details dialog Click the [Extend] button in the code break dialog to display the details dialog. This dialog is available only in the simulator debugger. Figure 4.6-4 Code Break Details Dialog •...

  • Page 293: Data Break (Simulator Debugger)

    MENUS 4.6.4.2 Data Break (Simulator Debugger) This section explains a data break in the simulator debugger.  What is a Data Break? The data break is a break function that stops a program when accessing data at the specified address. ...
  • Page 294 MENUS • Attribute The attribute at the time of data access is specified.  Details dialog Click the [Extend] button in the data break dialog to display the details dialog. Figure 4.6-6 Data Break Details Dialog • Control [No break / Break] Specify whether to retry or stop execution after command processing when a breakpoint is hit.

  • Page 295: Code Break-Hardware (Emulator Debugger)

    MENUS 4.6.4.3 Code Break-Hardware (Emulator debugger) This section explains a hardware break of code breaks in the emulator debugger.  What is a Hardware Break? The hardware break is a break function that uses hardware to monitor whether the program counter passes through the specified address, and stops the program.
  • Page 296 MENUS  How to Set  Setup dialog Figure 4.6-7 Code Break (Hardware) Setup Dialog • Break address Specify the address to locate a breakpoint at. • Type (Software or Hardware) Select the type of a breakpoint. This function is available only in the emulator debugger (MB2146-08/MB2146-07). •...

  • Page 297: Code Break-Software (Emulator Debugger)

    MENUS 4.6.4.4 Code Break-Software (Emulator debugger) This section explains a software break of code breaks in the emulator debugger.  What is a Software Break? The software break is a break function that uses software to monitor whether the program counter passes through the specified address, and stops the program.
  • Page 298 MENUS • Break address Specify the address to locate a breakpoint at. • Type [Software / Hardware] Select the type of a breakpoint. • Remain Displays the remaining count that is available for the breakpoint type being selected. Note: When the debugger is terminated with an error while setting a code break (software break), the contents of the flash memory may not be normal.

  • Page 299: Data Break (Emulator Debugger)

    MENUS 4.6.4.5 Data Break (Emulator Debugger) This section explains a data break in the emulator debugger.  What is a Data Break? The data break is a break function that stops a program when accessing data at the specified address. ...
  • Page 300 MENUS • Attribute (Read or Write) The attribute at the time of data access is specified.  Details dialog Click the [Extend] button of the data break dialog. The details dialog will be displayed. Effective only in the case of the emulator debugger (MB2146-09). Figure 4.6-10 Data Break Details Dialog •...

  • Page 301: Sequence Break (Emulator Debugger)

    MENUS 4.6.4.6 Sequence Break (Emulator Debugger) This section explains a sequence break in the emulator debugger.  What is a Sequence Break? The sequence break is a break function that stops a program when the two specified addresses are hit in sequence. ...
  • Page 302 MENUS • Break list Displays a list of the currently specified sequence breakpoints. Status: Displays the status (enable or disable) of the specified event. Address: Displays the specified address. Level: Displays the sequence (LEVEL1 or LEVEL2) of the addresses to be monitored. Symbol: Displays a symbol assigned to the target address.

  • Page 303: Event

    MENUS 4.6.5 Event This section explains how to set SOFTUNE Workbench events.  Use Conditions This function can be used in the following environment. Emulator debugger MB2141  Setting Events Events can be set from the event dialog shown in Figure 4.6-12 . [event mode: Normal] Figure 4.6-12 Event Dialog (Event) F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.
  • Page 304 MENUS • Event Number Specifies an event number (1 to 8). • 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. •...

  • Page 305: Sequence

    MENUS 4.6.6 Sequence "Sequence" displays the Sequence Window.  Dialog Display Select [Debug]-[Sequence] menu to open the dialog that displays the sequence setting state. A sequence, latch, and delay count can be set from this window. This function can be used in the emulator debugger (MB2141). ...
  • Page 306 MENUS • Delay Count Set the delay count. • End delay count Select "Break" or "Not Break".  Setting Latch Select [Setup Latch] from the short-cut menu of the Sequence Window. Figure 4.6-15 Latch Setup Dialog • Latch No Select a latch number. (1-2) •...

  • Page 307: Stack

    MENUS 4.6.7 Stack This section explains a SOFTUNE Workbench call stack.  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 calls further another. The call stack retains the relationship among function calls.

  • Page 308: Time Measurement

    MENUS 4.6.8 Time Measurement This section explains SOFTUNE Workbench time measurement.  Time Measurement Selecting the menus [Debug]-[Time measurement] displays the Time Measurement Dialog. The value in the parentheses indicates a difference range. Figure 4.6-18 Time Measurement Dialog • From Initialize Indicates the total execution time since the [Clear] button was clicked.
  • Page 309 MENUS  Difference in Measurement Results Clicking the [Comment] button in the Time Measurement Dialog displays the Comment Dialog. The Comment Dialog describes the difference in measurement results, which is displayed in the Time Measurement Dialog. This function is enabled only in the emulator debugger (MB2146-09). For details on the difference, refer to Section "2.3.7 Measuring the Number of Execution Cycles"...

  • Page 310: Call

    MENUS 4.6.9 Call This section explains the SOFTUNE Workbench function call function.  Function Call Function 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-20 Function Call Dialog When the function call dialog shown in Figure 4.6-20 opens, specify the function you want to call with a correct argument.
  • Page 311 MENUS  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.

  • Page 312: 4.6.10 Clear Call

    MENUS 4.6.10 Clear Call This section explains the SOFTUNE Workbench call clear function.  Clear Call "Clear Call" is used to restore the original state without executing the function call to the end while the function called by the function call is executing. This function is used after program execution has been stopped by "Breakpoints...", etc. When "Clear Call"...

  • Page 313: Vector

    MENUS 4.6.11 Vector This section explains how to display and modify SOFTUNE Workbench vectors.  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 program counter as the address of the interrupt processing routine.
  • Page 314 MENUS Figure 4.6-23 Edit Vector Dialog  Jump Display the source of the stored program at the address set in the vector table in the following 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).

  • Page 315: Load Target File

    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.

  • Page 316: Start Debug/End Debug

    MENUS 4.6.13 Start Debug/End Debug This section explains how to start and end debug session.  Start Debug Sets SOFTUNE Workbench to debug session. Select [Debug]-[Start Debug] menu. Thereafter, the debugger related commands are enabled. When SOFTUNE Workbench enters the debug session, at first load the target file. For loading target files, see "4.6.12 Load Target File".

  • Page 317: Setup

    MENUS Setup "Setup" sets SOFTUNE Workbench execution environment, debugger mode environment, and other tools.  Setting the SOFTUNE Workbench Execution Environment • Development  Setting the Debugger Mode Environment • Debug Environment • Memory Map... • Flash memory control  Setting Other Tools •...

  • Page 318: Development

    MENUS 4.7.1 Development "Development..." sets SOFTUNE Workbench operation and the environment variables required by language tools (e.g., compiler).  Environment Variable Figure 4.7-1 shows the environment variable setup dialog. The environment variables listed in Table 4.7-1 are set in this section.
  • Page 319 MENUS Figure 4.7-1 Development Environment Setup (Environment Variable) Dialog 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].
  • Page 320 MENUS  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. •...
  • Page 321 MENUS Figure 4.7-3 Display Color of Messages Dialog • Close the edit window when debugging By checking this item on a box, edit window, which opens as debugger is started, will be closed. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 322: Debug Environment

    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: • I/O Port • Interrupt •...

  • Page 323: I/O Port

    MENUS 4.7.2.1 I/O Port This section explains the I/O port setup procedure.  Setting an Input Port Figure 4.7-4 Input Port Setup Dialog • Port Address Specifies a port address. • Mask Data Specifies address mask. Only the addresses whose bits are 1 are to be compared. •...
  • Page 324 MENUS • Input Port List Displays the currently specified ports. • 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 opens. Specifying [ASCII] as [Data Type] in input port setting enables ASCII input. Specifying [Binary] as [Data Type] enables binary input.
  • Page 325 MENUS  Setting an Output Port Figure 4.7-6 Output Port Setup Dialog • 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 output type. When Binary is selected, specify its size. (Byte/Word/Long) •...
  • Page 326 MENUS Figure 4.7-7 Output Terminal Window (Binary)  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. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 327: Interrupt

    MENUS 4.7.2.2 Interrupt This section explains the interrupt setup procedure.  Setting an Interrupt 1. When the interrupt setup dialog shown in Figure 4.7-8 opens, set an [Interrupt number]. 2. Select an [Request timing]. [One Time] or [Interval] can be selected. 3.

  • Page 328: Debug Environment

    MENUS 4.7.2.3 Debug Environment This section explains how to set the debug environment.  Setting Debug Environment The Debug Environment Setup Dialog is used to make various settings related to the debugger. The content displayed in the dialog varies depending on the state of the debugger/target, as shown in the table below. ""...
  • Page 329 MENUS  Setting Items in Each Tab  [Execution] tab Figure 4.7-9 Debug Environment Setup Dialog [Execution] Tab The items that can be set in relation to execution are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-3 Setting items in the [Execute] tab Debugger Emulator...
  • Page 330 MENUS  [Step execution] tab Figure 4.7-10 Debug Environment Setup Dialog [Step execution] Tab The items that can be set in relation to step execution are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-4 Setting Items in [Step execution] Tab Debugger Emulator...
  • Page 331 MENUS  [Watch] tab Figure 4.7-11 Debug Environment Setup Dialog [Watch] Tab The items that can be set in relation to the watch are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-5 Setting items in the [Watch] tab Debugger Emulator...
  • Page 332 MENUS • Data size [Byte/Word/Long/Single/Double] Sets the display size in the assembler mode. • Memory buffering [Enable/Disable] Sets how to read the memory of variables such as array and structure. - Enable : Reads the memory of the entire variables together. They are accessed by size of the top variable. - Disable : Reads the memory by element and by member.
  • Page 333 MENUS The items that can be set in relation to the radix are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-6 Setting Items in [Radix] Tab Debugger Emulator Simulator...
  • Page 334 MENUS The items that can be set in relation to monitoring are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-7 Setting Items in [Monitoring] Tab Debugger Emulator Simulator...
  • Page 335 MENUS  [Directory] tab Figure 4.7-14 Debug Environment Setup Dialog [Directory] Tab The items that can be set in relation to directories are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-8 Setting items in the [Directory] Tab Debugger Emulator...
  • Page 336 MENUS • Directory Displays the currently set directory. To delete it, click the [Delete] button after selecting the directory.  [Tab] tab Figure 4.7-15 Debug Environment Setup Dialog [Tab] Tab The items that can be set in relation to tabs are as shown in the table below. ""...
  • Page 337 MENUS  [Error output] tab Figure 4.7-16 Debug Environment Setup Dialog [Error output] Tab The items that can be set in relation to error output are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-10 Setting Items in [Error output] Tab Debugger Emulator...
  • Page 338 MENUS • In batch operation [Dialog/Output window] Specifies an error output type at batch operation. "Output window" is the command window. • Error output level [All/Only error/Last occurred error] Sets the output type when several errors occur. If [All] is selected, a warning message is also displayed. ...
  • Page 339 MENUS Figure 4.7-18 Debug Environment Setup Dialog [Load] Tab (Monitor Debugger) The items that can be set in relation to load are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-11 Setting Items in [Load] Tab Debugger Emulator...
  • Page 340 MENUS • Only debug information This specifies whether or not to load only the debug information or not. 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. •...
  • Page 341 MENUS The items that can be set in relation to emulation are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-12 Setting Items in [Emulation] Tab Debugger Emulator Simulator...
  • Page 342 MENUS  [Response speed] Tab Figure 4.7-20 Debug Environment Setup Dialog [Response speed] Tab The items that can be set in relation to the response speed are as shown in the table below. "" indicates items that can be set, while "" indicates items that cannot be set. Table 4.7-13 Setting Items in [Response speed] Tab Debugger Emulator...
  • Page 343 MENUS Note: • If [During Debugging, response speed optimization] is enabled, the clock of the CPU, the CPU bus and the peripheral is automatically changed unintentionally when a user program break occurs. If there is a possibility that the clock change may cause any malfunction, disable [During Debugging, response speed optimization].
  • Page 344 MENUS • Event mode [Single trace/Multi trace/Performance] - Single trace Uses events for the single-trace function. - Multi trace Uses events for the multi-trace function. - Performance Uses events for performance measurement.  [Chip] tab Figure 4.7-22 Debug Environment Setup Dialog [Chip] Tab The items that can be set in relation to the chip are as shown in the table below.
  • Page 345 MENUS • Watchdog [Enable/Disable] - Enable Enables the watchdog timer. - Disable Disables the watchdog timer.  [Parallel port] tab Figure 4.7-23 Debug Environment Setup Dialog [Parallel port] Tab The items that can be set in relation to the parallel port are as shown in the table below. ""...
  • Page 346 MENUS • Port name [NONE/LPT1/LPT2] Specifies whether or not to connect to the parallel port. When connecting to it, select a parallel port name. • Status [Enable/Disable] - Enable Enables the parallel port. - Disable Disables the parallel port.  [Break] tab Figure 4.7-24 Debug Environment Setup Dialog [Break] Tab The items that can be set in relation to breaks are as shown in the table below.
  • Page 347 MENUS • Default break point [Software/Hardware] - Software Specifies the software break as the default setting for when a breakpoint has been set on the source window. - Hardware Specifies the hardware break as the default setting for when a breakpoint has been set on the source window. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 348: Setup Wizard

    MENUS 4.7.2.4 Setup Wizard This section explains how to operate the debugger's Setup Wizard.  What is Setup Wizard? Setup Wizard is used to make initial settings for the debugger. The settings are saved to a setup file; therefore, this data entry process can be omitted from the next time. It is also recommended to create multiple setup files according to the debugger type, as the creation of multiple files is allowed.
  • Page 349 MENUS  Setup Wizard Operation Procedure First, select [Debug Type]. Figure 4.7-26 Setup Wizard (Debug Type) The succeeding setup varies depending on the debugger type. To redo the setup, click the [Back] button. You will return to the previous setup screen. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.
  • Page 350 MENUS  In case of the emulator debugger 1. Select an emulator (ICE) type. Figure 4.7-27 Setup Wizard (ICE Type) 2. Specify whether to automatically load the monitor program when the debugging is started if the ICE type is MB2146- Figure 4.7-28 Setup Wizard (Automatic Load) F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.
  • Page 351 MENUS 3. Select a device type ([RS], [LAN] or [USB]). If RS or LAN is selected, some additional settings are required. Figure 4.7-29 Setup Wizard (Device Type) "RS" displayed in the list for selecting device type refers to RS232C. If RS is selected, set a port name and baud rate. Figure 4.7-30 Setup Wizard (Device Type) If LAN is selected, set a host name.
  • Page 352 MENUS 4. If ICE is any of the following cases, make the settings for communications. - MB2146-09/09A/09B - MB2146-08 - MB2146-07 Set the original oscillation frequency for the following ICE. MB2146-09/09A/09B MB2146-08 MB2146-07 Set the response speed optimization during debugging for the following ICE. MB2146-09/09A/09B MB2146-07 Figure 4.7-31 Setup Wizard (Original Oscillation Frequency)
  • Page 353 MENUS 5. Specify whether to supply the power supply from BGM adaptor to the target if the ICE type is MB2146-07. Figure 4.7-32 Setup Wizard (Power Supply) Disable if the power supply is supplied from anything other than BGM adaptor to the target. For details, see "2.4.1.2 Power Supply to Target"...
  • Page 354 MENUS 6. Specify whether the flash memory synchronizes immediately after debugger is started if the ICE type is MB2146-08 or MB2146-07. Figure 4.7-33 Setup Wizard (Synchronous of Flash Memory) 7. Set a batch file, if there is any batch file to be executed immediately after the debugger is started. Figure 4.7-34 Setup Wizard (Batch File) F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.
  • Page 355 MENUS 8. Specify whether or not to automatically load the target file during debugging. Also specify the batch files before and after the load, if necessary. The batch file specified with "Specification batch file before/after load." is executed only when [Load target file] is selected from the [Debug] Menu.
  • Page 356 MENUS When [Specification] is selected, and then the [Specification...] button is clicked, the setup dialog of the session is displayed to enable you to select the session to be restored immediately after the debugger is started. Only the information about the specified session will be set in the setup file. Figure 4.7-37 Setup Session 10.Press the [Finish] button.
  • Page 357 MENUS  In case of the simulator debugger When "Simulator Debugger" is selected for "Debug Type", perform steps shown below for settings. 1. Set a batch file, if there is any batch file to be executed immediately after the debugger is started. (see "Figure 4.7-34 Setup Wizard (Batch File)") 2.
  • Page 358 MENUS 2. Select the device type (USB). (see "Figure 4.7-29 Setup Wizard (Device Type)") 3. Set the original oscillation frequency. (see "Figure 4.7-31 Setup Wizard (Original Oscillation Frequency)") 4. Set a batch file, if there is any batch file to be executed immediately after the debugger is started. (see "Figure 4.7-34 Setup Wizard (Batch File)") 5.

  • Page 359: Memory Map

    MENUS 4.7.3 Memory Map "Memory Map..." sets the debugger's memory map.  Memory Map Setup [Simulator Debugger]  Map List Figure 4.7-41 Memory Map Setup Dialog • Map list Displays the currently set map area. • Clicking the [Setup] button opens the setup dialog (Figure 4.7-41 ) corresponding to the debug session. ...
  • Page 360 MENUS • 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).  Memory Map Setup [MB2141 (Emulator)]  Map List Figure 4.7-43 Memory Map Setup Dialog •...
  • Page 361 MENUS  Map Setup Figure 4.7-44 Map Setup Dialog • 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). •...
  • Page 362 MENUS  Undefined Area [MB2141(emulator)] Figure 4.7-45 Undefined Area Setup Dialog • Undefined Area - Access Approval Permits access to the undefined area. - Access Forbidden Inhibits access to the undefined area. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 363: Flash Memory Control

    MENUS 4.7.4 Flash Memory Control The MB2146-09/MB2146-08/MB2146-07 emulator supports programming to the Flash memory.  Flash Memory Control The MB2146-09/MB2146-08/MB2146-07 emulator supports functions of programming to the Flash memory and of code breaks (software breaks). The emulator saves the contents of the Flash memory in the debugger’s buffer; and references the buffer’s contents when reading from/programming to the Flash memory.

  • Page 364: Tool

    MENUS 4.7.5 Tool "Tool..." sets the tools to be directly started by SOFTUNE Workbench.  Tools "Tool..." is not a tool that takes charge of basic SOFTUNE Workbench functions such as a 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 Workbench.
  • Page 365 MENUS  Tool Setup Procedure 1. Select [Tool...] from the [Setup] menu. The tool setup dialog shown in Figure 4.7-46 opens. 2. Specify a title that differs from the registered names. 3. 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.
  • Page 366 MENUS  Example of Tool Setup • When notepad is used Title : note pad Execute Filename : note pad.exe Option : %f Executing Directory : %x Designate Additional Option when Executing : A check mark is not set. Use Output Window : A check mark is not set.

  • Page 367: Keyboard

    MENUS 4.7.6 Keyboard "Keyboard..." enables definition of shortcut keys.  Keyboard Setup Procedure 1. Select a type. Functions are displayed in [Function List]. 2. Select the function to be set from [Function List]. The explanation of the selected function is displayed in the explanation field (lower part) of the keyboard setup dialog. When an assigned function is selected, the currently assigned keys are displayed in [Assign key].
  • Page 368 MENUS  Restoring all the Set Keys to the Initial State Click the [Reset] button. Notes: • Several keys can be assigned to one function. In this case, the assigned keys have the same function. • 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.

  • Page 369: Editor

    MENUS 4.7.7 Editor "Editor..." enables any editor to be registered and used as the standard editor.  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.
  • Page 370 MENUS  Editor Registration Procedure 1. Select [Editor...] from the [Setup] menu. The editor setup dialog shown in Figure 4.7-48 opens. 2. Set a unique title that differs from the registered names. 3. 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.
  • Page 371 MENUS  Example Example of Fujitsu Power EDITOR setup Title Power EDITOR Execution Filename c:\Powered\powered. exe. Option "%f"-g%l Executing Directory Entering the above and clicking the [Set] button register Fujitsu Power EDITOR in the editor list. After registering Fujitsu Power EDITOR, select [Power EDITOR] from [Available Editor] and click the [OK] button. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 372: Error

    MENUS 4.7.8 Error "Error..." registers error message patterns of various tools to enable error jump.  Error Jump Setup Procedure 1. Select [Error...] from the [Setup] menu. The error jump setup dialog shown in Figure 4.7-49 opens. 2. Enter a syntax. For details on syntaxes, refer to Section "1.7 Error Jump Function"...
  • Page 373 MENUS  Syntax Modification Procedure Modify a set syntax in the following procedure: 1. Select [Error...] from the [Set] menu. The error jump setup dialog shown in Figure 4.7-49 opens. 2. Select the syntax to modified from the syntax list. The syntax and comment are displayed in the associated fields.

  • Page 374: Tool Startup

    MENUS 4.7.9 Tool Startup This section explains how to start a registered external tool.  Tool Startup The tools set by Section "4.7.5 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 shown in Figure 4.7-50 before the tool is started.

  • Page 375: Window

    MENUS Window "Window" controls window display.  Control Related to Window Display • Cascade • Vertical • Horizon • Split • Arrange Icons • Refresh • Refresh All Windows • Close All Windows  Window Name Display Up to 9 currently open window names are displayed, including icon windows. If ten windows or more are opened, the tenth and subsequent windows are displayed in [Other Windows].

  • Page 376: Cascade, Vertical, Horizon

    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 open subwindows in cascade.  Vertical "Vertical" arranges currently open subwindows vertically and fully displays them in the main window. ...

  • Page 377: Split

    MENUS 4.8.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 •...

  • Page 378: Arrange Icons

    MENUS 4.8.3 Arrange Icons "Arrange icons" arranges the locations of the minimized window icons.  Arrange Icons "Arrange icons" arranges 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 F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 379: Refresh

    MENUS 4.8.4 Refresh This command updates information on an active window.  Refresh Information on the current active window is updated. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 380: Refresh All Windows

    MENUS 4.8.5 Refresh All Windows This command updates information on all the open windows.  Refresh all Windows Information on all the open windows except the SRC tab of project and Output windows is updated. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 381: Close All Windows

    MENUS 4.8.6 Close All Windows "Close all windows" closes all open windows.  Close all Windows "Close all windows" closes all currently open windows other than the Project and Output Windows. If the file edit window being edited has not saved yet, the dialog asking you whether to save the window opens. The file opened by the external editor cannot be closed by this function.

  • Page 382: Help

    MENUS Help "Help" displays online help.  Online Help • Help Topics • Support Information  Version Information • Version Information F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 383: Help Topics

    MENUS 4.9.1 Help Topics "Help Topics" retrieves help items according to keywords.  Contents "Contents" hierarchically displays online help contents. It is used to search the contents for the item to be searched.  Keyword SOFTUNE Workbench searches the help file for the directly specified item. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 384: Support Information

    MENUS 4.9.2 Support Information "Support Information" opens the attached support information file in the Edit Window.  Support Information Support information provides the information not written in the attached manual. Please read through support information once before using SOFTUNE Workbench. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 385: Version Information

    MENUS 4.9.3 Version Information SOFTUNE version information is displayed.  Version Display at Non-debug Session Open the dialog to display the SOFTUNE Workbench logo mark and its version number.  Version Display at Debug Session Open the dialog to display the SOFTUNE Workbench logo mark, its version number, and details of the currently selected debugger.
  • Page 386 MENUS Add in DLLs ------------------------------------------------------- SiCmn Product name: SOFTUNE Workbench File Path: SiC896.dll path Version: SiC896.dll version - - - - - - - - - - - - - - - - - - - - - - - - - - - - SiiEd File Path: SiiEd3.ocx path...
  • Page 387 MENUS Version: SiOsM896.dll version ------------------------------------------------------- MC-8L/8FX Family Debugger DLL Product name: SOFTUNE Workbench File Path: SiD896.dll path Version: SiD896.dll version - - - - - - - - - - - - - - - - - - - - - - - - - - - - Debugger type: Current debugger type MCU type:...
  • Page 388 MENUS  File output Details displayed on the version information dialog are saved to a file. The default file name is "SOFTUNE_SYS.txt". Reference: Please be sure to provide us with information in this section when contacting us about SOFTUNE Workbench. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 389: Chapter 5 Add-In Module

    CHAPTER 5 Add-in Module This chapter explains SOFTUNE Workbench Add-in module. 5.1 Customize Bar F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 390: Customize Bar

    Add-in Module 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.4 Warning and Error Messages 5.1.5 Note F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 391: What Is Customize Bar

    Add-in Module 5.1.1 What is Customize Bar? This section describes the customize bar and how to install it.  What is Customize Bar? The customize bar registers batch file, Workbench menus and external tools used while running the Debugger in a tool bar. This function enables you to call them up easily by clicking one of the buttons.
  • Page 392 Add-in Module Figure 5.1-2 Dialog Displayed When Installing When the customize bar is installed, the "Customize Bar" 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. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 393: Customize Bar Menu

    Add-in Module 5.1.2 Customize Bar Menu This section describes the customize bar menu.  Customize Bar Menu There are two submenus in the [Customize Bar]. Setting: Registers batch files and Workbench menus in the customize bar. This menu is enabled when opening a workspace. View: Switches to view/hide the tool bar for the customize bar.

  • Page 394: Registering In The Customize Bar

    Add-in Module 5.1.3 Registering in the Customize Bar This section describes registering in the customize bar.  Registering in Customize Bar You can registers "batch files", "Workbench menus" and "external tools" 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 Sections "5.1.3.1 Registering Batch File", "5.1.3.2 Registering Workbench Menu"...
  • Page 395 Add-in Module  Items in Dialog • 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. •...
  • Page 396 Add-in Module Figure 5.1-5 Dialog for Open File Figure 5.1-6 Parameter Setting Dialog Figure 5.1-7 Menu List Dialog F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...
  • Page 397 Add-in Module Figure 5.1-8 Select Tool Dialog Figure 5.1-9 Setup Tool Dialog F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 398: Registering Batch File

    Add-in Module 5.1.3.1 Registering Batch File This section describes registering a batch file in the customize bar.  How to Register Batch File 1. Display dialog Select [View] - [Customize Bar] - [Setting] to display the "Customize Bar Setting" dialog (Figure 5.1-10 ). 2.
  • Page 399 Add-in Module Figure 5.1-10 Setting Dialog-Batch File F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 400: Registering Workbench Menu

    Add-in Module 5.1.3.2 Registering Workbench Menu This section describes how to register the Workbench menu in the customize bar.  How to Register Workbench Menu 1. Display the dialog Select [View] - [Customize Bar] - [Setting] to display the "Customize Bar Setting" dialog (Figure 5.1-11 ). 2.
  • Page 401 Add-in Module Figure 5.1-11 Setting Dialog-Menu F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 402: Registering External Tool

    Add-in Module 5.1.3.3 Registering External Tool This section describes how to register the external tool in the customize bar.  How to Register External Tool 1. Display the dialog Select [View] - [Customize Bar] - [Setting] to display the "Customize Bar Setting" dialog (Figure 5.1-12 ). 2.
  • Page 403 Add-in Module Figure 5.1-12 Setting Dialog-External Tool F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 404: Warning And Error Messages

    Add-in Module 5.1.4 Warning and Error Messages This section describes the warning and error messages displayed when using the customize bar.  Warning Message 1. The following warning message (Figure 5.1-13 ) 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.
  • Page 405 Add-in Module 3. The following error message (Figure 5.1-16 ) is displayed when you click "Add" without entering a tool name in the "Entry", when registering the External tools in the customize bar (See Section "5.1.3.3 Registering External Tool".) Figure 5.1-16 Error Message 3 F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 406: Note

    Add-in Module 5.1.5 Note This section describes the precautions for using the customize bar.  Note 1. The customize bar cannot be used when the Workspace is not opening. When opening the Workspace, the previous settings are restored and the customize bar buttons are enabled. 2.

  • Page 407: Appendix

    APPENDIX The Appendixes describes the register name, downloading monitor program, setting LAN interface, setting USB interface, creating ROM on monitor debugger target, external I/F for simulator. APPENDIX A List of Register Names APPENDIX B Downloading Monitor Program APPENDIX C Setting LAN Interface APPENDIX D Setting USB Interface APPENDIX E Installing Monitor Debugger APPENDIX F External I/F for Simulator...

  • Page 408: Appendix A List Of Register Names

    APPENDIX APPENDIX A List of Register Names This appendix explains register names.  Registers The registers that can be manipulated in SOFTUNE Workbench vary depending on the MCU used. The list of such registers is shown below. Some registers cannot be manipulated depending on the model. For details, see the "Hardware Manual".

  • Page 409: Appendix B Downloading Monitor Program

    APPENDIX 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".  When the Emulator is the MB2141 Series The Downloading Monitor Program procedure is described below: 1.

  • Page 410: Appendix C Setting Lan Interface

    APPENDIX APPENDIX C Setting LAN Interface To enable LAN communication, the LAN interface must be set at the PC and emulator sides. Consult the LAN administrator when setting the IP address and a port address, etc.  Setting LAN Interface at PC Side 1.

  • Page 411: Appendix D Setting Usb Interface

    APPENDIX APPENDIX D Setting USB Interface Communication via USB requires installation of the USB driver in the personal computer.  Installation of USB Driver The emulator described below connects to the PC through USB. - MB2146-09/09A/09B - MB2146-08 - MB2146-07 To install the USB driver, proceed as follows: 1.

  • Page 412: Appendix E Installing Monitor Debugger

    APPENDIX APPENDIX E Installing Monitor Debugger This appendix describes the requirements for using Monitor Debugger.  Introduction Monitor Debugger allows you to debug your application program on an intended mass-produced microcontroller with built-in flash memory using a monitor program in combination with the application program. To use Monitor Debugger, add the monitor program main routine (FGM.rel) to the application program to create your target system.
  • Page 413 APPENDIX Figure E-2 Sample Circuit for Adapter Connection Circuit Connector manufactured by YAMAICHI ELECTRONICS Connector manufactured by YAMAICHI ELECTRONICS User system FAP-10-08#4-0BS FAP-10-08#4-0BS MB95F128MB Index mark P10/UI0 Connector Connector Microcontroller Microcontroller P11/UO0 P12/UCK0 RSTX Unconnected UCK0 Unconnected "H" when flash (This can be (This can be unconnected.)
  • Page 414 APPENDIX  The following resources must be able to be allocated for the monitor program: Table E-2 Resources for Monitor Program Resource name Condition Remarks CPU core MC-8FX About 1.5 Kbytes Location addresses fixed (Note) • 0xFA00 - 0xFFBF (*1) *1: Monitor code, etc.
  • Page 415 APPENDIX Figure E-3 Outlined Resources for Use by Monitor Program RAM in detail MC-8FX Flash memory in detail 0x0080 UART/SIO,I/O User application area User application area Wild register Monitor stack Monitor program (4 byte) CALLV#0 vector (17 byte used) 0x0473 Monitor work area IRQ4 vector...
  • Page 416 APPENDIX  Additional files Table E-4 Monitor Program Files to be Added File name Description Remarks FGM.rel Monitor program main routine Source Files fgm_cfg.asm Monitor operation definitions Source Files fgm.h Header file for including the monitor program Dependencies fgm_cfg.h Monitor operation setting header Dependencies must be modified.
  • Page 417 APPENDIX  Changes to the application program Table E-5 Changes to the Application Program Remarks Change Description (Function name) Reset vector Change this to the monitor program start address. FGM_INIT( ) Stack area Add 4 bytes to the monitor program area. Watchdog timer start Replace this with the monitor program API.
  • Page 418 APPENDIX Figure E-6 Coding Example in fgm_cfg.h ;========================================================================== ; F2MC-8FX Family Monitor Debugger configuration file, ; Copyright (c) 2009-2014 Spansion ;========================================================================== /* Start address */ .IMPORT __start #define USER_STARTADR __start .....(1) /* Stack top */ .IMPORT STACK_TOP #define USER_STACKTOP STACK_TOP .....(2) /* Auto-boot address */ .IMPORT _AutoBootCheck #define USER_ABOOTADR...
  • Page 419 APPENDIX  USER_ABOOTADR Specify the address of the auto-boot checker. The auto-boot checker is described in " Creating an Auto-boot Checker". If you specify a symbol, correct the argument of the IMPORT instruction at the same time. Note that setting this address to 0x0000 or 0xFFFF makes the auto-boot checker invalid. Figure E-6 (3) is an example in which the auto-boot checker is a C language function of "AutoBootCheck()".
  • Page 420 APPENDIX  Modifying the Application Program Modify the application program to include the monitor program. The table below lists the items to be modified. Table E-7 Items to Be Changed in the Application Program Item Description Remarks Change to reset vector Change this to the monitor program start address.
  • Page 421 APPENDIX  Stack area Add 4 bytes as the area for the monitor program. In the stack pointer register, set the bottom address of the stack area obtained with 4 bytes added. Use the same value to define "USER_STACKTOP" in "fgm_cfg.h". Figure E-9 Coding Example in the Assembler ;----------------------------------------------------------- ;...
  • Page 422 APPENDIX Table E-9 Sample Use of API FGM_WDTON ( ) Monitor program API FGM_WDTON #define SETVAL 0x45 C language FGM_WDTON(SETVAL); #define SETVAL 0x45 mov a,#SETVAL Assembler pushw a call _FGM_WDTON popw a Figure E-10 Coding Example in C #include "fgm.h" (omission) /* IO_WDTC.byte = 0x45;...
  • Page 423 APPENDIX Figure E-12 Coding Example in C /* L07 = 0, L06 = 1, L05 = 2,*/ /* IO_ILR1.byte = 0x1B; */ /* L04 = 3 */ IO_ILR1.byte = 0x18; /* L04 = 0 */ Figure E-13 Coding Example in the Assembler /* L07 = 0, L06 = 1, L05 = 2,*/ /* mov _IO_ILR1,#0x1B ;...
  • Page 424 APPENDIX  Creating an Auto-boot Checker The auto-boot checker is required for the application system to work with the monitor program included after debugging. Table E-10 Auto-boot Checker auto-boot checker (USER_ABOOTADR) Processing Checks whether the application can get started automatically. Argument void : None int : Enable/disable automatic start.
  • Page 425 APPENDIX Figure E-17 Setting Example in fgm_cfg.h /* Auto-boot address */ .IMPORT _AutoBootCheck #define USER_ABOOTADR _AutoBootCheck The above example is coded to check the status of I/O port P13 and causes an auto-boot when the port is High or waits for connection from the debugger if not.
  • Page 426 APPENDIX * : On the MB95F128MB, I/O port P13 must be set along with the MOD pin to program flash memory on the board. (It does not have to be set for object loading from the debugger.)  Programming into the Target Monitor Debugger cannot be connected to the microcontroller containing no monitor program.
  • Page 427 APPENDIX  Provided Sample Programs The following files are provided as the monitor program and sample application program. Table E-12 List of Provided Sample Programs Monitor program File name Description Folder name fgm_cfg.asm Monitor operation definitions 16bit_PPG\ FGM.rel Monitor program main routine 16bit_PPG\ fgm.h Header file for including the...
  • Page 428 APPENDIX  Prohibitions and Restrictions This section summarizes the items to follow and note on debugging with the monitor program included.  Prohibitions [Prohibited] Do not manipulate any resource being used by Monitor Debugger. Monitor Debugger may behave unpredictably if you manipulate RAM or a UART/SIO register being used by Monitor Debugger.
  • Page 429 APPENDIX  Restrictions: [Restricted] The initial value of the SP register is changed. Originally, the SP register is initialized to 0x0000 immediately after a reset. Since the monitor program uses the stack area, however, the application program is started with the register containing a value other than 0x0000.
  • Page 430 APPENDIX [Restricted] Code breaks are invalid during step-in execution. When Monitor Debugger steps in for each machine instruction, it uses a wild register temporarily. In that period, no code break can be set, leaving code breakpoints invalid. Be careful in particular if a breakpoint has been set within an interrupt routine with the "interrupt mask"...
  • Page 431 APPENDIX [Restricted] Consider the electrical characteristics observed immediately after the power is turned on. Immediately after the power is turned on, the I/O ports may be unstable in status. For referencing an I/O port by the auto-boot checker, design it in due consideration of its electrical characteristics. ...

  • Page 432: Appendix F External I/F For Simulator

    APPENDIX APPENDIX F External I/F for Simulator Simulator debugger for F MC-8L/8FX supports the external I/F to create peripheral simulation modules.  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.
  • Page 433 APPENDIX There are the following functions for operating the ISS from the microcontroller resource simulator: • Reads/writes data from/to memory • Reads/writes data from/to registers • Sets interrupt sources • Requests abort of instruction execution  Simulator External I/F Specification [Function List] ISS ->...

  • Page 434: Ssdi_Entry (Start)

    APPENDIX SSDI_Entry (Start) [Format] int SSDI_Entry (int id, HINSTANCE hInstance) [Argument] // 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.

  • Page 435: Ssdi_Init (Initialize)

    APPENDIX 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. [Explanation] A call is made when the debugger is started. Perform necessary initialization. [Remarks] Now an external I/F module can be called. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 436: Ssdi_Ready (Ready)

    APPENDIX SSDI_Ready (Ready) [Format] int SSDI_Ready (void) [Argument] None [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. [Remarks] It is called after having done batch file execution and an automatic load in debugger start. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc.

  • Page 437: Ssdi_End (End)

    APPENDIX 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] F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 438: Ssdi_Reset_Event (Post Reset)

    APPENDIX 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. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 439: Ssdi_Read_Event (Post Read)

    APPENDIX SSDI_Read_Event (Post Read) [Format] int SSDI_Read_Event (READ_EVENT *info) [Argument] typedef struct { unsigned long addr; // Access address size; // Access size (1:Byte / 2:Word / 4:LONG) unsigned long total_cycle; // Total cycle count unsigned long inst_cycle; // Count of cycles from beginning of instruction unsigned long *data;...

  • Page 440: Ssdi_Write_Event (Post Write)

    APPENDIX SSDI_Write_Event (Post Write) [Format] int SSDI_Write_Event (WRITE_EVENT *info) [Argument] typedef struct { unsigned long addr; // Access address 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;...

  • Page 441: Ssdi_Execute_Event (Post Execute Instruction)

    APPENDIX SSDI_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.

  • Page 442: Ssdi_Interrupt_Event (Post Interrupt)

    APPENDIX SSDI_Interrupt_Event (Post Interrupt) [Format] void SSDI_Interrupt_Event (INTERRUPT_EVENT *info) [Argument] typedef struct { 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;...

  • Page 443: Ssdi_Timer_Event (Post Timer)

    APPENDIX F.10 SSDI_Timer_Event (Post Timer) [Format] void SSDI_Timer_Event (TIMER_EVENT *info) [Argument] typedef struct { unsigned long total_cycle; // Total cycle count unsigned long inst_cycle; // Differential cycle count from previous event time_id; // Set timer ID unsigned long *cycle; // Count of cycles delayed } TIMER_EVENT;...

  • Page 444: Ssdi_Read_Memory (Read From Memory)

    APPENDIX F.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 size; // Access size (1:Byte / 2:Word / 4:LONG) length; // Read data count void *data;...

  • Page 445: Ssdi_Write_Memory (Write To Memory)

    APPENDIX F.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 size; // Access size (1:Byte / 2:Word / 4:LONG) length; // Write data count void *data;...

  • Page 446: Ssdi_Read_Register (Read From Register)

    APPENDIX F.13 SSDI_Read_Register (Read from Register) [Format] int SSDI_Read_Register (int reg_no, unsigned long *data) [Argument] reg_no; // Register number unsigned long *data; // Data storage area [Return value] Normal end Error [Explanation] Reads data from registers [Remarks] The register number is defined in the include file (SSDI_REGISTER.H). "SSDI_REGISTER.H"...

  • Page 447: Ssdi_Write_Register (Write To Register)

    APPENDIX F.14 SSDI_Write_Register (Write to Register) [Format] int SSDI_Write_Register (int reg_no, unsigned long data) [Argument] reg_no; // Register number unsigned long data; // Data storage area [Return value] Normal end Error [Explanation] Writes data to registers [Remarks] The register number is defined in the include file (SSDI_REGISTER.H). "SSDI_REGISTER.H"...

  • Page 448: Ssdi_Set_Interrupt (Set Interrupt Source)

    APPENDIX F.15 SSDI_Set_Interrupt (Set Interrupt Source) [Format] int SSDI_Set_Interrupt (int int_no, int sw) [Argument] int_no; // Interrupt number // Interrupt state (=0:OFF / =1:ON) [Return value] Normal end 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.

  • Page 449: Ssdi_Set_Timer (Set Timer)

    APPENDIX F.16 SSDI_Set_Timer (Set Timer) [Format] int SSDI_Set_Timer (int no, unsigned long cycle, int sw, int id) [Argument] // Timer setting number unsigned long cycle; // Cycle count // Condition (0: Repeat/1: Only once) // Always set 0 [Return value] Timer setting numbers (0 to 31) = -1 Error...

  • Page 450: Ssdi_Request_Abort (Request Abort)

    APPENDIX F.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.

  • Page 451: Ssdi_Set_Area (Set Area)

    APPENDIX F.18 SSDI_Set_Area (Set Area) [Format] int SSDI_Set_Area (int no, unsigned long start, unsigned long size, int attribute, int id) [Argument] // Area setting number unsigned long start; // Starting address of area unsigned long size; // Area size unsigned long attribute;...

  • Page 452: Ssdi_Clear_Cycle (Clear Cycle Count)

    APPENDIX F.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] F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 453: Ssdi_Execute_Mcu (Execute Target Program)

    APPENDIX F.20 SSDI_Execute_MCU (Execute Target Program) [Format] void SSDI_Execute_MCU (void) [Argument] None [Return value] None [Explanation] Starts execution of program for ISS. When execution of program starts it already, it is ignored. [Remarks] F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 454: Ssdi_Getcurrentexecuteaddr (Get The Address In Execution)

    APPENDIX F.21 SSDI_GetCurrentExecuteAddr (Get the Address in Execution) [Format] unsigned long SSDI_GetCurrentExecuteAddr (void) [Argument] None [Return value] The address of currently executed instruction [Explanation] Get the address of the instruction currently in execution. [Remarks] F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 455: Appendix G Major Changes

    APPENDIX APPENDIX G Major Changes Page Section Change Results Revision 7.0 Company name and layout design change Revision 8.0 4.7.2.3 Debug Environment Changed the description of [During Debugging, response  [Response speed] Tab speed optimization] function. F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...
  • Page 456 APPENDIX F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 457: Index

    INDEX Assemble Inline Assemble ..........179 Abort Assemble List Abort...............286 Setting Absolute Format Assemble List ABS Tab Options ..........255 ABS Tab............65 Assembler Options ABS Tab Bitmap Image List........66 Setting Assembler Options ........ 245 Absolute Format Assembly Setting Absolute Format Assemble List Assembly ............
  • Page 458 INDEX Window......157, 159, 162 Color Selection Move the Caret to the Next Bookmark....156 Customization Procedure (Display Color Selection) ....... 78 Move the Caret to the Next Bookmark in the Current Window......157, 159, 162 Command Move the Caret to the Previous Bookmark ..156 Command............
  • Page 459 INDEX (Display Color Selection) .......78 Version Display at Debug Session ..... 385 Customization Procedure When SOFTUNE Workbench is in the Debug Session..........144 (Display Function Selection)....77 Customization Procedure (Font Selection) ....78 Window Display (Debug Session)...... 174 Customization Procedure Debugger (Initialization of Keyword) .....79 Changing Debugger Setup.........
  • Page 460 INDEX Document Files Simulator External I/F Specification....433 Creating Source File and Document Files,Etc..129 External Tool Download How to Register External Tool ......402 Download Flash Memory ........363 Drag & Drop Drag & Drop between Windows ......46 fgm_cfg.h Changing Monitor Operation Settings (fgm_cfg.h).........
  • Page 461 INDEX Customization Procedure (Keyword Addition) ..78 Keyword ............383 Icons Arrange Icons...........378 Identifier Identifier............16 LAN Interface Setting LAN Interface at Emulator Side....410 Include Dependencies Setting LAN Interface at PC Side....... 410 Include Dependencies ........282 Language Specifications Include File Setting of Options Included in [Language Short-Cut Menus (Click the Right Button of the Mouse Specifications] ........
  • Page 462 INDEX Short-Cut Menus (Click the Right Button of the Mouse Memory on a Load Module Name) .......66 Changing Memory Data........182 Displaying Memory Data ........182 Load Module File Memory Edit............ 188 Opening the Load Module File......131 Searching Memory Data ........184 Loading Setting of Memory Area........
  • Page 463 INDEX on Library File, Object File and Relative Format File) ..........62 Paste Object Window Paste ............... 147 Object Window ........112, 203 Performance Object/State Copying Performance Data ....... 210 Object/State Display .........112 Performance Function Setting Dialog ....212 Online Help Specifying Performance Display......212 Online Help .............382 Performance Functions Open Dialog...
  • Page 464 INDEX Project-related Item Setup .........218 Outside Specified ROM/RAM Area Registering the Created File in the Project.....31 Range..........264 Saving the Project File ........139 When a Section is Allocated to the Specified ROM/ Setting Active Project .........30 RAM Area.......... 261 Setting Active Project Configuration ....33 Ready Queue Setup Project............228 Detailed Display of Ready Queue ......
  • Page 465 INDEX Save As ............139 Setup Project Select the [Project]-[Setup Project] Menu ..... 35 Save Dialog Save Dialog .............138 Setup Wizard Setup Wizard ............. 41 Search Procedure Setup Wizard Operation Procedure ....349 Search Procedure..........152 Short-Cut Menu Searching Short-Cut Menu ......70, 74, 83, 87, 90, Searching Memory Data........184 92, 96, 97, 100, 102, 113, 115, 117, 118 Section...
  • Page 466 INDEX Migrating SOFTUNE Workbench to Debug Symbol Window Session ..........40 Symbol Window ..........87 Setting SOFTUNE Workbench Operating Syntax Conditions ..........14 Syntax Deletion Procedure ........ 372 Setting the SOFTUNE Workbench Execution Syntax Modification Procedure......373 Environment ........317 System Configuration SOFTUNE Workbench Configuration ....13 System Configuration for Using Monitor Starting SOFTUNE Workbench ......26 Debugger..........
  • Page 467 INDEX Tool Deletion Procedure........365 Outside Specified ROM/RAM Area Tool Setup Procedure........365 Range..........264 Tool Startup .............374 Warning Message..........404 Tools ...............364 Watch Window Tool Bar Watch Window .......... 99, 191 Tool Bar ............202 Window Name Tool Bar/Status Bar ..........174 Window Name Display........375 Tool Button List Windows Tool Button List ..........274...
  • Page 468 INDEX F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A...

  • Page 469: Revision History

    MC-8L/8FX Family SOFTUNE™ Workbench Operation Manual Document Number: 002-04536 Origin of Revision ECN# Issue Date Description of Change Change Migrated to Cypress and assigned document number 002-04536. 07/10/2015 MITK No change to document contents or format. 5764760 06/06/2017 RYOK Updated to Cypress logo.

This manual is also suitable for:

F2mc-8fx series

Table of Contents