SOFTUNE WORKBENCH is support software for developing programs for the FR-V, FR, F2MC-16, and
2
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.
■ Purpose of this manual and target readers
This manual explains how to operate the SOFTUNE Workbench and design the product.
This manual is intended for engineers designing several kinds of products using SOFTUNE Workbench.
■ Trademarks
SOFTUNE is a trademark of FUJITSU LIMIITED.
FR-V is a product of FUJITSU LIMIITED.
FR is the abbreviation of FUJITSU RISC Controller and a product of FUJITSU LIMIITED.
2
F
MC is the abbreviation of FUJITSU Flexible Microcontroller and a trademark of FUJITSU LIMIITED.
Microsoft and Windows are registered trademarks in the United States and other countries of United States
Microsoft Corporation.
■ Organization of Manual
This manual consists of four chapters.
Chapter 1 Outline of SOFTUNE WORKBENCH
This chapter gives an outline of SOFTUNE WORKBENCH.
Chapter 2 Operation
This chapter describes the basic operation method and development procedure of SOFTUNE
WORKBENCH.
Chapter 3 Windows
This chapter explains SOFTUNE WORKBENCH windows in detail.
Chapter 4 Menus
This chapter explains in detail the SOFTUNE WORKBENCH menu configuration and the dialog boxes
to be started from each menu.
Appendix
The Appendixes describes the register name, downloading monitor program, setting LAN interface,
setting USB interface, creating ROM on monitor debugger target, building REAROS debugger target,
building REAROS debug modules into program, display on ICE.
i
• The contents of this document are subject to change without notice.
Customers are advised to consult with FUJITSU sales representatives before ordering.
• The information, such as descriptions of function and application circuit examples, in this document are presented solely for
the purpose of reference to show examples of operations and uses of Fujitsu semiconductor device; Fujitsu does not warrant
proper operation of the device with respect to use based on such information. When you develop equipment incorporating
the device based on such information, you must assume any responsibility arising out of such use of the information. Fujitsu
assumes no liability for any damages whatsoever arising out of the use of the information.
• Any information in this document, including descriptions of function and schematic diagrams, shall not be construed as
license of the use or exercise of any intellectual property right, such as patent right or copyright, or any other right of Fujitsu
or any third party or does Fujitsu warrant non-infringement of any third-party' s intellectual property right or other right by
using such information. Fujitsu assumes no liability for any infringement of the intellectual property rights or other rights of
third parties which would result from the use of information contained herein.
• The products described in this document are designed, developed and manufactured as contemplated for general use,
including without limitation, ordinary industrial use, general office use, personal use, and household use, but are not
designed, developed and manufactured as contemplated (1) for use accompanying fatal risks or dangers that, unless
extremely high safety is secured, could have a serious effect to the public, and could lead directly to death, personal injury,
severe physical damage or other loss (i.e., nuclear reaction control in nuclear facility, aircraft flight control, air traffic
control, mass transport control, medical life support system, missile launch control in weapon system), or (2) for use
requiring extremely high reliability (i.e., submersible repeater and artificial satellite).
Please note that Fujitsu will not be liable against you and/or any third party for any claims or damages arising in connection
with above-mentioned uses of the products.
• Any semiconductor devices have an inherent chance of failure. You must protect against injury, damage or loss from such
failures by incorporating safety design measures into your facility and equipment such as redundancy, fire protection, and
prevention of over-current levels and other abnormal operating conditions.
• If any products described in this document represent goods or technologies subject to certain restrictions on export under the
Foreign Exchange and Foreign Trade Law of Japan, the prior authorization by Japanese government will be required for
export of those products from Japan.
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.
■ Product name abbreviation
In this manual, product names are abbreviated as follows:
Microsoft Windows 95 operating system is abbreviated Windows 95.
Microsoft Windows 98 operating system is abbreviated Windows 98.
Microsoft Windows NT Server network operating system Version 4.0 and Microsoft Windows NT
Workstation operating system Version 4.0 are abbreviated Windows NT.
iii
iv v
CONTENTS
CHAPTER 1OUTLINE OF SOFTUNE WORKBENCH ..................................................... 1
3.2Tool Bar ............................................................................................................................................ 39
3.3Status Bar ......................................................................................................................................... 41
4.2File Menu .......................................................................................................................................... 97
4.2.7Save As ..................................................................................................................................... 107
4.2.8Save All ..................................................................................................................................... 109
4.3Edit Menu ........................................................................................................................................ 113
4.4View Menu ...................................................................................................................................... 133
APPENDIX A List of Register Names ......................................................................................................... 304
APPENDIX B Downloading Monitor Program ............................................................................................ 305
APPENDIX C Setting LAN Interface ........................................................................................................... 306
APPENDIX D Setting USB Interface .......................................................................................................... 308
viii
CHAPTER 1
OUTLINE OF SOFTUNE
WORKBENCH
SOFUTUNE 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 tool, etc.
Debuggers are a simulator debugger, emulator
debugger, etc.
1.1 Outline
1.2 What is SOFTUNE WORKBENCH?
1.3 Procedure for Developing Programs with SOFTUNE WORKBENCH
1
CHAPTER 1 OUTLINE OF SOFTUNE WORKBENCH
1.1Outline
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. An option setting dialog box for
each tool opens, thereby enabling the easy use of the tools.
■ Debuggers
SOFTUNE WORKBENCH has integrated the simulator debugger, emulator debugger into one. The
optimum debugger can be selected and used as required.
■ Others
Installing an REALOS configurator (option) enables cooperative operation without complicated setting.
2
CHAPTER 1 OUTLINE OF SOFTUNE WORKBENCH
1.2What 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
As shown in Figure 1.2-1 SOFTUNE WORKBENCH consists of three parts: body, debugger, and
manager.
The debugger part contains the simulator debugger, emulator debugger. These debuggers can be switched
and used as required.
The manager part enables users to code and make programs without full knowledge of language tool (e.g.,
C compiler and assembler) start and option specification.
The configurator is not built into SOFTUNE WORKBENCH because it is an option. Installing this option,
however, enables cooperative operation on SOFTUNE WORKBENCH.
SOFTUNE WORKBENCH manages all processing from programming to debugging in units of projects.
Projects contain all program files, options of tools (e.g., C compiler), and debugger environment setup, etc.
3
CHAPTER 1 OUTLINE OF SOFTUNE WORKBENCH
1.3Procedure 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.Designing a project
3.Creating a program source and executing make/build
4.Executing debugging
■ Setting SOFTUNE WORKBENCH operating conditions
When developing a program with SOFTUNE WORKBENCH, first open the development environment
setup dialog box from the [Setup] - [Development] Menu and set environment variables and projects. For
details about how to set environment variables and projects, see Section 4.7.1 Development.
The environment variables set from this dialog box are referenced by language tools such as the C
compiler.
■ Designing a project
Set information for the program to be developed in a project.
When developing a new project, open the new creation dialog box from the [File] - [New] Menu and select
[Workspace/Project File] from the dialog box. The new project creation dialog box opens.
When the project has already existed, the existing project file can be opened from the [File] - [Open
Workspace] Menu. When using the SOFTUNE V01 or V02 project file, see Section 2.13 Reading
SOFTUNE Project Files of Old Versions.
■ Creating a program source and executing make/build
Open the new creation dialog box from the [File] - [New] Menu and select [Text File]. When the editor is
started, write the source program and save it to the file with the [File] - [Save As] Menu.
When a necessary source file is created, register it in the project with the [Project] - [Add Member] Menu.
When registering the source file in the project is completed, execute "make" with the [Project] - [Make]
Menu or execute "build" with the [Project] - [Build] Menu.
If a syntax error occurs during compilation or assembling, double-click the error display location in the
Output Window with the left button of the mouse. The program jumps to the line where the error occurred.
Correct the source file, and then reexecute the [Project] - [Make] Menu.
■ Executing debugging
When a load module file is created, debugging can be executed.
4
CHAPTER 2
OPERATION
This chapter explains the basic operation of SOFTUNE
WORKBENCH for each of the following items:
2.1 Parameters to be Entered from Dialog Boxes
2.2 Starting and Terminating SOFTUNE WORKBENCH
2.3 Creating Workspace
2.4 Storing Project
2.5 Creating and Registering Source File in Project
2.6 Definition of Subproject
2.7 Creation of Project Configuration
2.8 Setting Tools
2.9 Setting Linker Options
2.10 Make/Build
2.11 Debugging
2.12 Executing Debugging Only
2.13 Reading SOFTUNE Project Files of Old Versions
2.14 Moving Project File
5
CHAPTER 2 OPERATION
2.1Parameters to be Entered from Dialog Boxes
When key entry is requested from a dialog box, 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. Some points (e.g, line number and register specification) are
extended. Operations involving floating-point numbers and character strings are not supported. The
overflows that occur during the operation are ignored. Zero division results in an error.
■ Address formula
An address formula is an extension of the data formula; it represents a memory location. Like the data
formula, the address formula consists of a term and an operator. The terms and operators usable in address
formulas are the same as those in data formulas
■ Identifier
Alphabetic characters, numbers, and "_" can be used as identifiers. Each identifier must begin with a
character other than numbers. Uppercase characters are distinguished from lowercase characters or vice
versa.
■ File name specification
File name specification complies with Windows rules.
6
CHAPTER 2 OPERATION
2.1.1Data 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 base number of the
numerical value. If no specifier is specified, the base number specified by the default is used. The default
base numbers are determined for each of the locations from which values must be entered. For details, see
each dialog box.
The numerical value representation range is from 0 to H'FFFFFFFF.
However, this range is further restricted, depending on the values to be entered.
The minus values are represented such as -D'1.
(Example)
Binary constantB'1010
Octal constantQ'1267
Decimal constantD'1800
Hexadecimal constantH'12AF or 0x12AF
Note:
No blank is allowed between a specifier and a numerical value.
■ Floating-point number
The following two floating-point numbers are supported.
- Single-precision floating-point number (S)....float
- Double-precision floating-point number (D)....double, long double
The internal format and size comply with the floating-point type handled by the C compiler.
"d" specifies an unsigned decimal number.
Nearest value rounding applies to input values. If the represented value is not a normalized number, a
warning message is displayed and the following value is input:
- When an underflow occurs .... The values that can be represented as unnormalized numbers are changed
- When an overflow occurs .... Values are changed to infinity.
[F'][ ]{.d|d[.[d]]}[{S|D}[[+| -]d]]
to unnormalized numbers. The values less than unnormalized numbers are
changed to ± 0.
7
CHAPTER 2 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.
8
CHAPTER 2 OPERATION
2.1.2Data 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. The accessory information generated by the
assembler is label information. Each symbol consists of a module name, a function name, and a symbol
name. Specify these names as follows:
[[module-name][\function-name]\] symbol-name
When the source program is written in the assembly language, module-name is the name written in the
operand of the [PROGRAM] statement. When it is written in the C language, module-name is the name of
the source file to be compiled. Function-name is a function name written in the C language; it is valid only
when the source program is written in the C language.
To distinguish a global symbol from others, write it as \symbol-name.
Table 2.1-1 shows symbol description.
No Japanese character strings can not be used for symbols.
Table 2.1-1 Symbol Cannot Description
Symbol Local symbol in function → static symbol in module → global symbol
\Symbol Local symbol in the specified function in the current module
\function\symbolStatic symbol in the specified module or global symbol defined in the
Module\symbolLocal symbol in the specified function in the specified module
Module\function\symbolSymbol in class (Valid for static)
■ 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.
Description Contents
Global symbol
specified module
Symbol in class function
[source file-name]$line-number
When referencing an address with a line number, prefix $ to the line number. A line number can be
specified only in a decimal number. Specify the line number in the following format. If the extension of the
9
CHAPTER 2 OPERATION
source file name is .c, line number specification can be omitted. If the source file name is not alphanumeric
characters, enclose the line number in double quotes.
■ Character constant
A character constant is the character value enclosed in a single quote; it cannot include a single quote and \.
Instead of these characters (single quote and back slash), escape characters can be used as character
constants. Characters that can constitute character strings can be used as escape characters.
10
CHAPTER 2 OPERATION
2.1.3Data 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 %.
Usable register names differ for each MCU; see Appendix A Register Names.
11
CHAPTER 2 OPERATION
2.1.4Operators 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
Minus sign
Address
Logical NOT
Bit NOT
Memory indirect reference
Size (byte)
Type cast
Multiplication
Division
Remainder
Addition
Subtraction
Left shift
Right shift
Less than
Less than or equal to
Greater than
Greater than or equal to
Linear expression
Binary operator
Binary operator
Binary operator (Relational operator)
12
7 ==
!=
8 & Bit AND Binary operator
9 ^ Bit EOR
10 | Bit OR
11 && Logical AND
12 || Logical OR
Equal to
Not equal to
Remarks:
CHAPTER 2 OPERATION
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.
13
CHAPTER 2 OPERATION
2.1.5Address 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)
offset:Value relative to addressing (starting address)
■ Bit addressing
The notation below is used to represent a bit address. Symbols for bit address attributes can be also used.
Bit addressing is valid when /BIT is specified in the command qualifier.
bit-offset: ....Value used to specify a bit position
When addressing is omitted, address 0 is assumed.
[addressing] : bit-offset
14
CHAPTER 2 OPERATION
2.1.6File Name Specification
File name specification complies with Windows for host environment.
When drive-name is omitted, the current drive is selected.
15
CHAPTER 2 OPERATION
2.2Starting and Terminating SOFTUNE WORKBENCH
This section explains how to start and terminate SOFTUNE WORKBENCH.
■ Starting and terminating SOFTUNE WORKBENCH
With SOFTUNE V3, to start SOFTUNE WORKBENCH, double-click the [F2MC-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
box 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. To take over the information, click the [Yes] button. Not to
take over it, click the [No] button.
■ Terminating SOFTUNE WORKBENCH
To terminate SOFTUNE WORKBENCH, select [Exit] from the [File] Menu or click the x button above
and on the right of the window.
SOFTUNE WORKBENCH cannot be terminated when compile/assemble, make, build, or tool is being
executed. Be sure to terminate SOFTUNE WORKBENCH after compile/assemble, make, build, or tool has
been terminated or suspended.
16
CHAPTER 2 OPERATION
2.3Creating Workspace
Workspace is necessary to store projects in SOFTUNE WORKBENCH to register project,
follow the steps below.
■ Creation 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.
- Creating workspace in opening project
When [File]-[Open Workspace] is selected to open a project, workspace to store the project is also
created.
In this case, the name and position of workspace are the same as those of the project.
If any workspace file already exists, however, it is opened instead of the project file.
- Creating blank workspace
Blank space that has no project is created. Projects must be stored separately.
In this case, projects can be stored different in name and position from workspace.
■ Creating Workspace in Creating New Project
1. Select [File]-[New].
When the [New] dialog is opened, select "Workspace/Project File" in [Type of File] and click the [OK]
button.
2. Select the [Project] tab.
When the [New] dialog is opened, select the [Project] tab.
3. Select [Create New Workspace].
Click the [Create New Workspace] check button to create workspace. Create workspace in the same
way that a new project is created.
■ Creating Workspace in Opening Project
1. Select [File]-[Open Workspace].
2. Select "Project File" in [Type of File].
When the [Open Workspace] dialog is opened, select "Project File" in [Type of File].
3. Select the project file to be opened.
Select the project file to be opened.
4. Click the [Open] button.
■ 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.
17
CHAPTER 2 OPERATION
3. Select the type of workspace.
Select [Blank Workspace] as the type of workspace.
4. Enter the workspace name.
Enter the workspace name. This name is used as a workspace file name. At default it is also used as a
workspace directory (the workspace directory can be changed).
5. Click the [OK] button.
18
Loading...
+ 292 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.