Fujitsu F2 MC-16 PREFACE

i

PREFACE

■What is the SOFTUNE Workbench?

SOFTUNE Workbench is support software for developing programs for the F2MC-16 family 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 functions of SOFTUNE Workbench.

This manual is intended for engineers designing several kinds of products using SOFTUNE Workbench.

Other company names and products names are trademarks or registered trademarks of their respective

companies.

■Trademarks

REALOS, SOFTUNE are trademark of Fujitsu Semiconductor Limited, Japan.

Note: F2MC is the abbreviation of FUJITSU Flexible Microcontroller.

Microsoft, Windows and Windows Media are either registered trademarks of Microsoft Corporation in the

United States and/or other countries.

The company names and brand names herein are the trademarks or registered trademarks of their respective

owners.

■Organization of This Manual

This manual consists of the following 2 chapters.

CHAPTER 1 BASIC FUNCTIONS

This chapter describes the basic functions on the SOFTUNE Workbench.

CHAPTER 2 DEPENDENCE FUNCTIONS

This chapter describes the functions dependent on each Debugger.

Contents

Main Page Page Page PREFACE What is the SOFTUNE Workbench? Purpose of this manual and target readers Trademarks Organization of This Manual ii Copyrights 2004-2011 FUJITSU SEMICONDUCTOR LIMITED All rights reserved. Page Page CONTENTS Page Page Page Page Page CHAPTER 1 BASIC FUNCTIONS This chapter describes the basic functions on the SOFTUNE Workbench. 1.1 Workspace Management Function 1.2 Project Management Function Project Format Project Configuration Active Project Configuration 1.3 Project Dependence 1.4 Make/Build Function This section explains the make/build function of SOFTUNE Workbench. Make Function Build Function 1.4.1 Customize Build Function Macro List Page 1.5 Include Dependencies Analysis Function 1.6 Functions of Setting Tool Options 1.7 Error Jump Function This section describes the error jump function in SOFTUNE Workbench. Error Jump Function Syntax Page 1.8 Editor Functions 1.9 Storing External Editors This section describes the function to set an external editor to SOFTUNE Workbench. External Editor Precautions Example of Optional Settings 1.10 Storing External Tools This section describes the function to set an external tool to SOFTUNE Workbench. External Tools 1.11 Macro Descriptions Usable in Manager Macro List Page Examples of Macro Expansion Page 1.12 Setting Operating Environment 1.13 Debugger Types 1.14 Memory Operation Functions This section describes the memory operation functions. Functions for Memory Operations 1.15 Register Operations 1.16 Line Assembly and Disassembly 1.17 Symbolic Debugging Page 1.17.1 Referring to Local Symbols This section describes referring to local symbols and Scope. Scope Moving Scope Specifying Symbol and Search Procedure 1.17.2 Referring to Variable of C Language Notes on C Language Symbols Page 2.1 Simulator Debugger Operating Condition of High-speed Simulator Debugger Simulation Range 2.1.1 Setting Operating Environment 2.1.1.1 Boot ROM File Automatic Execution Page 2.1.3 Memory Simulation This section describes the memory simulation executed by SOFTUNE Workbench. Memory Simulation Simulation Memory Space Memory Area Access Attributes 2.1.4 I/O Port Simulation I/O Port Simulation (Output Port) 2.1.5 Interrupt Simulation This section describes the interrupt simulation executed by SOFTUNE Workbench. Interrupt Simulation Page 2.1.7 Low-Power Consumption Mode Simulation 2.1.8 STUB Function Program execution 2.1.9 Break 2.1.9.1 Code Break Page 2.1.9.2 Data Break 2.1.9.3 Trace-Buffer-Full Break 2.1.9.4 Guarded Access Break Page 2.1.10 Measuring Execution Cycle Count This function measures the program execution cycle count. Page 2.1.11 Trace 2.1.11.1 Setting Trace 2.1.11.2 Displaying Trace Data 2.1.11.3 Searching Trace Data 2.1.11.4 Saving Trace Data 2.1.12 Measuring Coverage 2.1.12.1 Coverage Measurement Procedures 59 Details (Specify /DETAIL for command qualifier) 60 Displays per source line (specify /SOURCE for the command qualifier) Displays per machine instruction (specify /INSTRUCTION for the command qualifier) 2.1.13 Checking Debugger Information This section explains how to check information about the simulator debugger. Page 2.2 Emulator Debugger (MB2141) This section explains the functions of the emulator debuggers for the MB2141. Emulator Debugger 2.2.1 Setting Operating Environment 2.2.1.1 MCU Operation Mode MCU Operation Speed 2.2.1.2 Debug Area 2.2.1.3 Memory Area Types A unit in which memory is allocated is called an area. There are seven different area types. Page Page 2.2.1.4 Memory Mapping Page 2.2.1.5 Timer Minimum Measurement Unit 2.2.2 Notes on Commands for Executing Program Page 2.2.3 Commands Available during Execution of User Program 2.2.4 On-the-fly Memory Access Page 2.2.5 Break 2.2.5.1 Code Break Page 2.2.5.2 Data Break 2.2.5.3 Sequential Break 2.2.5.4 Guarded Access Break 2.2.5.5 Trace-Buffer-Full Break 2.2.5.6 Performance-Buffer-Full Break 2.2.5.7 Forced Break 2.2.6 Events Event Modes 90 2.2.6.1 Operation in Normal Mode Timer latch Delay counter Sequencer Single trace measurement Event-related Commands in Normal Mode 2.2.6.2 Operation in Multi Trace Mode Event-related Commands in Multi Trace Mode 94 2.2.6.3 Operation in Performance Mode Performance measurement Events Event-related Commands in Performance Mode 2.2.7 Control by Sequencer 97 2.2.7.1 Setting Sequencer Figure 2.2-6 shows the sequencer operation. Figure 2.2-6 Operation of Sequencer Page 2.2.7.2 Break by Sequencer 2.2.7.3 Trace Sampling Control by Sequencer Level 1 Level 2 Level 3 2.2.7.4 Time Measurement by Sequencer 2.2.7.5 Sample Flow of Time Measurement by Sequencer Level 1 Level 2 Level 3 00 m 00 s 000 ms 000.0 s 2.2.8 Real-time Trace 2.2.8.1 Single Trace Frame Number and Step Number in Single Trace 2.2.8.2 Setting Single Trace Page 2.2.8.3 Multi trace Multi Trace Frame Number 111 Figure 2.2-13 Frame Number in Multi Trace 2.2.8.4 Setting Multi Trace 2.2.8.5 Displaying Trace Data Storage Status 2.2.8.6 Specify Displaying Trace Data Start 2.2.8.7 Display Format of Trace Data 116 Displaying All Machine Cycles (Specify /CYCLE.) Page Page 2.2.8.8 Reading Trace Data On-the-fly Reading Trace Data On-the-fly in Single Trace Reading Trace Data On-the-fly in the Multi Trace 2.2.8.9 Saving Trace Data 2.2.9 Measuring Performance 2.2.9.1 Performance Measurement Procedures Executing Program Displaying Performance Measurement Data Clearing Performance Measurement Data 125 2.2.9.2 Display Performance Measurement Data Event number Display the measured time and measuring count by using the SHOW PERFORMANCE Displaying Measured Time To display the time measured, specify the starting event number or the ending event number. 2.2.10 Measuring Coverage Coverage Measurement Procedures Coverage Measurement Operation 2.2.10.1 Coverage Measurement Procedures 128 Displaying coverage rate of load module (specify /MODULE for the command qualifier) Details (Specify /DETAIL for command qualifier) 129 Displays per source line (specify /SOURCE for the command qualifier) Displays per machine instruction (specify /INSTRUCTION for the command qualifier) Page 2.2.11 Execution Time Measurement Setting the Minimum Measurement Unit Page 2.2.12 Sampling by External Probe Sampling by External Probe External Probe Sampling Timing Displaying and Setting External Probe Data Commands for External Probe Data 2.2.13 Checking Debugger Information This section explains how to check information about the MB2141 emulator debugger. Page 2.3 Emulator Debugger (MB2147-01) This section explains the functions of the emulator debuggers for the MB2147-01. Emulator 2.3.1 Setting Operating Environment 2.3.1.1 Monitoring Program Automatic Loading 2.3.1.2 MCU Operation Mode 2.3.1.3 Debug Area 2.3.1.4 Memory Area Types A unit in which memory is allocated is called an area. There are five different area types. Page 2.3.1.5 Memory Mapping Creating and Viewing Memory Map 2.3.1.6 Debug Function 2.3.1.7 Event Mode 2.3.2 Notes on Commands for Executing Program Page 2.3.3 Commands Available during Execution of User Program Page 2.3.4 Break 2.3.4.1 Code Break Notes on Data Break Page 2.3.4.2 Data Break 2.3.4.3 Monitoring Data Break Setting Number 2.3.4.4 Sequential Break 2.3.4.5 Guarded Access Break 2.3.4.6 Trace-Buffer-Full Break 2.3.4.7 Performance-Buffer-Full Break 2.3.4.8 External Trigger Break 2.3.4.9 Forced Break 2.3.5 Control by Sequencer Page 2.3.5.1 Setting Sequencer Setting Sequencer 2.3.6 Real-time Trace Trace Trigger Setup Setting Data Monitoring Trace Trigger Trace Control during Executing User Program 2.3.6.1 Setting Single Trace 2.3.6.2 Multi Trace Multi Trace Frame Number Trace Delay 1 2 3 4 Get four times of the hit to the trace end trigger Trace buffer = 64 blocks Multitrace end trigger Page 2.3.6.3 Setting Methods of Multi Trace Page 2.3.6.4 Displaying Trace Data Storage Status 2.3.6.5 Specify Displaying Trace Data Storage Status 2.3.6.6 Display Format of Trace Data 179 Displaying All Machine Cycles (Specify /CYCLE) Page Page 2.3.6.7 Reading Trace Data On-the-fly Reading Trace Data On-the-fly 2.3.6.8 Saving Trace Data 2.3.7 Measuring Performance 2.3.7.1 Performance Measurement Procedures Page 187 2.3.7.2 Display Performance Measurement Data Event number Display the measured time and measuring count by using the SHOW PERFORMANCE Displaying Measured Time To display the time measured, specify the starting event number or the ending event number. 2.3.8 Measuring Coverage Coverage Measurement Procedures Coverage Measurement Operation 2.3.8.1 Coverage Measurement Procedures 190 Details (Specify /DETAIL for command qualifier.) 191 Displays per source line (Specify /SOURCE for the command qualifier) Displays per machine instruction (Specify /INSTRUCTION for the command qualifier) 2.3.9 Real-time Monitoring 2.3.10 Execution Time Measurement Page 2.3.11 Power-on Debugging This section explains power-on debugging by the emulators for the MB2147-01. Power-on Debugging 2.3.12 RAM Checker This section describes the functions of the RAM Checker. Overview RAM Check Window Use Conditions Specifications List To Use the RAM Checker About Log File RAM Checker Viewer 2.3.13 Checking Debugger Information This section explains how to check information about the MB2147-01 emulator debugger. Page 2.4 Emulator Debugger (MB2147-05) This section explains the functions of the emulator debuggers for the MB2147-05. Emulator 2.4.1 Setting Operating Environment 2.4.1.1 Monitoring Program Automatic Loading 2.4.1.2 MCU Operation Mode 2.4.1.3 Debug Area 2.4.1.4 Memory Area Types A unit in which memory is allocated is called an area. There are five different area types. Page 2.4.1.5 Memory Mapping Creating and Viewing Memory Map 2.4.2 Notes on Commands for Executing Program Page 2.4.3 Commands Available during Execution of User Program 2.4.4 Break 2.4.4.1 Code Break Page 2.4.4.2 Data Break 2.4.4.3 Guarded Access Break 2.4.4.4 Trace-Buffer-Full Break 2.4.4.5 Forced Break 2.4.5 Real-time Trace Page 2.4.5.1 Setting Trace 2.4.5.2 Displaying Trace Data Storage Status 2.4.5.3 Specifying Displaying Trace Data Start 2.4.5.4 Display Format of Trace Data 227 Displaying All Machine Cycles Page Page 2.4.5.5 Reading Trace Data On-the-fly Reading Trace Data On-the-fly 2.4.5.6 Saving Trace Data 2.4.6 Measuring Execution Cycle Count This function measures the program execution cycle count. 2.5 Emulator Debugger (MB2198) This section explains the functions of the emulator debuggers for the MB2198. Emulator Debugger 2.5.1 Setting Operating Environment 2.5.1.1 Monitoring Program Automatic Loading 2.5.1.2 Boot ROM File Automatic Execution 2.5.1.3 MCU Operation Mode 2.5.1.4 Operation Frequency Control 2.5.2 Notes on Commands for Executing Program 2.5.3 Commands Available during Execution of User Program Page 2.5.4 Break 2.5.4.1 Code Break Page 2.5.4.2 Data Break 2.5.4.3 Guarded Access Break 2.5.4.4 Sequential Break Types of Sequential Break 2.5.4.5 Trace-Buffer-Full Break 2.5.4.6 Performance-Buffer-Full Break 2.5.4.7 External Trigger Break 2.5.4.8 Forced Break 2.5.5 Control by Sequencer Page 2.5.5.1 Operating of sequencer Page 2.5.6 Real-time Trace Trace Trigger Setup 2.5.6.1 Setting Trace Page 2.5.6.2 Displaying Trace Data Storage Status 2.5.6.3 Specifying Displaying Trace Data Start 262 2.5.6.4 Display Format of Trace Data Time Stamp Data Frame Number Data access Display in Instruction Execution Order (Specify /INSTRUCTION.) Page 2.5.6.5 Saving Trace Data 2.5.7 Measuring Performance 2.5.7.1 Performance Measurement Procedures 2.5.7.2 Display Performance Measurement Data 2.5.8 Execution Time Measurement Page 2.5.9 Power-On Debugging This section explains power-on debugging by the emulators for the MB2198. Power-on Debugging 2.6 Emulator Debugger (MB2100-01) 2.6.1 Starting debugging 2.6.1.1 Operating Environments of the Target Page 2.6.1.2 Security 2.6.2 Ending debugging When the debugger has aborted 2.6.3 Efficiently Executing Debugging 2.6.3.1 Increasing Communication Speed during Debugging 2.6.3.2 Switching Debug Function Switching methods 2.6.4 Executing Program 2.6.4.1 Setting/Release of Debug Functions The debug function can be set or released while executing the user program. Page 2.6.4.2 Monitoring This section describes the monitoring function in the MB2100-01 emulator debugger. Monitoring How to use 2.6.4.3 Power-on Debug This section describes power-on debug function in the MB2100-01 emulator debugger. Power-o n Debug How to use Page 2.6.4.4 Notes on Commands for Executing Program Page 2.6.5 To Access the Flash Memory What is flash memory synchronization? Methods of flash memory synchronization Page Page Page 2.6.6 To Interrupt the Program Execution [Break] 2.6.6.1 Code Break (Hardware) Special Operation when breakpoint is set Page 2.6.6.2 Code Break (Software) Operation Requirements 2.6.6.3 Data Break 2.6.6.4 Forced Break This function forcibly suspends program execution. How to Generate When a User Program does not Stop 2.6.6.5 Data Watch Break Page 2.6.6.6 Sequencer Operation of Sequencer Specifications of Sequencer Page 2.6.7 Measuring the Program Execution Cycle Count This section explains the function of measuring the number of program execution cycles. Error Information Page 2.6.8 Measuring Event-to-Event Execution Cycle Count [Performance Measurement] Remeasuring 1 2 Page 2.6.8.1 Measuring Performance Ending the Measurement 2.6.9 Viewing Program Execution History [Trace] Page 2.6.9.1 Displaying Trace Data This section explains how to display trace data. Display Formats of Trace Data Trace Data Display Position How to Display Trace Data Page 2.6.9.2 Trace Data Display Examples (RAW Data) This section describes trace data that is displayed in the RAW data mode. RAW Data Display Special frame Frame Number Indicates instruction executed. 2.6.9.3 Trace Data Display Example (Instruction) This section describes trace data that is displayed in the instruction mode. Instruction Display Frame Number Display that supplements 2.6.9.4 Trace Data Display Example (Source) This section describes trace data that is displayed in the source line mode. Source Display 2.6.9.5 Saving Trace Data 2.6.9.6 Searching for Trace Data This section explains how to search for trace data. Searching for Trace Data 2.6.10 How to Display the Output Message from User Program to the Debugger What is Terminal Window Using Method of Semihosting Feature 2.6.11 Checking Debugger Information This section explains how to check information about the MB2100-01 emulator debugger. Page Page 2.7.1 Resources Used by Monitor Program 2.7.2 Break 2.7.2.1 Software Break Page Page Page Index