Fujitsu CM71-00329-7E

CHAPTER1 Basic Functions

■Line Number Information

Line number information is set with the line number information table in SOFTUNE Workbench when a

debug information file is loaded. Once registered, such information can be used at anytime thereafter.

Line number is defined as follows:

[Source File Name] $Line Number

Contents

Main Page Page Page Preface ii Copyright 2002-2011 FUJITSU SEMICONDUCTOR LIMITED All rights reserved. CONTENTS Page Page Page CHAPTER1 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 Setting Options 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 Page 1.9 Storing External Editors Precautions Setting Options Example of Optional Settings 1.10 Storing External Tools This section describes the SOFTUNE Workbench function to set an external tool. External Tools Setting Options 1.11 Macro Descriptions Usable in Manager Macro List Page Page Examples of Macro Expansion 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 C/C++ Variables Notes on C/C++ Symbols Page Page 2.1 Simulator Debugger This section describes the functions of the simulator debugger. Simulator Debugger Operating Conditions Simulation Range Page 2.1.2 Memory Simulation This section describes the memory simulation executed. Memory Simulation Simulation Memory Space Memory Area Access Attributes 2.1.3 I/O Port Simulation This section describes I/O port simulation executed. I/O Port Simulation (Input Port) I/O Port Simulation (Output Port) 2.1.4 Interrupt Simulation This section describes interrupt simulation executed. Interrupt Simulation 2.1.5 Reset Simulation 2.1.6 Low Power Consumption Mode Simulation 2.1.7 STUB Function Program execution 2.1.8 Break 2.1.8.1 Code Break This function causes a break by monitoring a specified address by software. Code Break How to set 2.1.8.2 Data Break How to set 2.1.8.3 Trace Buffer-full Break 2.1.8.4 Guarded Access Break 2.1.8.5 Forced Break 2.1.9 Measuring Execution Cycle Count This function measures the program execution cycle count and step count. The measuring item 2.1.10 Trace 2.1.10.1 Trace Sampling 2.1.10.2 Setting Trace Page 2.1.10.4 Display Format of Trace Data Page Page Page 2.1.11 Measuring Coverage 2.1.11.1 Coverage Measurement Procedures 60 - Displaying coverage rate of load module (Specify /MODULE for the command qualifier) - Details (Specify /DETAIL for command qualifier.) - Summary (Specify /GENERAL for command qualifier.) 61 - Displays per source line (Specify /SOURCE for the command qualifier) - Displays per machine instruction (Specify /INSTRUCTION for the command qualifier) 2.1.12 Checking Debugger Status This section explains how to check information about the simulator debugger. Page Page 2.2 Emulator Debugger (MB2197) 2.2.1 Setting Operating Environment 2.2.1.1 MCU Operation Mode 2.2.1.2 DRAM Refresh Control This section explains DRAM refresh setup. DRAM Refresh Control 2.2.1.3 Cache Flush Control 2.2.1.4 Operating Frequency 2.2.2 Notes on Executing Program 2.2.3 Commands Available during Execution of User Program This section explains the commands available during the execution of a user program. 2.2.4 Break 2.2.4.1 Code Break Code Break How to set Page 2.2.4.2 Code Event Break How to set 2.2.4.3 Data Event Break How to set 2.2.4.4 Trace Buffer-full Break 2.2.4.5 Alignment Error Break 2.2.4.6 External Trigger Break 2.2.4.7 Forced Break 2.2.5 Measuring Execution Cycle Count This function measures the program execution cycle count. The measuring item error 2.2.6 Trace 2.2.6.1 Trace Data Data sampled and recorded by tracing is called trace data. Trace Data 2.2.6.2 Trace Sampling 2.2.6.3 Setting Trace 2.2.6.4 Displaying Trace Data Page Page Page Page 2.2.6.9 Notes on Use of Tracing Function Page 2.2.7 Inaccessible Area This section explains inaccessible area. Inaccessible area Access to memory area including inaccessible area 2.2.8 Checking Debugger Status This section explains how to check information about the emulator debugger (MB2197). Page Page 2.3 Emulator Debugger (MB2198) Debug Functions with FR80S Page 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 Cache Flush Control 2.3.1.4 Operating Frequency 2.3.1.5 External Memory Emulation 2.3.1.6 Debug mode 2.3.2 Notes on Executing Program 2.3.3 Commands Available during Execution of User Program This section explains the commands available during the execution of a user program. Page 2.3.4 Break 2.3.4.1 Code Break Code Break How to set Page 2.3.4.2 Data Break How to set 2.3.4.3 Code Event Break How to set Page 2.3.4.4 Data Event Break How to set Page 2.3.4.5 Trace Buffer-full Break 2.3.4.6 Alignment Error Break 2.3.4.7 External Trigger Break 2.3.4.8 Forced Break 2.3.4.9 Data Watch Break Setting Number Page 2.3.5 Control by Sequencer Setting Sequencer Level 3 Level 2 Level 1 Page 2.3.6 Measuring Execution Cycle Count This function measures the program execution time. Error 2.3.7 Trace Frame Number Trace Filter Setting Trace Trigger Page 2.3.7.1 Display Format of Trace Data Page 2.3.7.3 Notes on Use of Tracing Function Page 2.3.8 Measuring Performance 2.3.8.1 Performance Measurement Procedures Page 139 2.3.8.2 Displaying Performance Measurement Data To display the time measured, specify the starting event number or the ending event number. 2.3.9 Real-time Monitoring 2.3.10 Power-on Debugging This section explains power-on debugging. Power-on debugging 2.3.11 Inaccessible Area This section explains inaccessible area by the emulator debugger for the MB2198. Inaccessible area Access to memory area including inaccessible area 2.3.12 RAM Checker This section describes the function of the RAM Checker. Overview RAM Checker window Operation requirements Specification list Using the RAM Checker Memory access during logging Log file RAM Checker Viewer 2.3.13 Checking Debugger Status This section explains how to check information about the emulator debugger (MB2198). Page Page 2.4 Emulator Debugger (MB2100-01) 2.4.1 Starting debugging This section describes the method of starting debugging. Starting Debugging Verification Items When Starting Debugging 2.4.1.1 Power-on Reset This section describes how to issue the power-on reset. Issuing the Power-on Reset 2.4.1.2 Operating Environments of the Target Page 2.4.1.3 Security 2.4.2 Ending debugging This section describes the method of ending debugging. Ending debugging When the debugger has aborted 2.4.3 Efficiently Executing Debugging 2.4.3.1 Increasing Communication Speed during Debugging 2.4.3.2 Switching Debug Function 2.4.4 Executing Program This section describes the method of executing a user program. Executing a program Control during program execution 2.4.4.1 Setting/Release of Debug Functions The debug function is set or can be released while executing the user program. Page 2.4.4.2 Monitoring This section describes the monitoring function. Monitoring How to use 2.4.4.3 Power-on Debug This section describes power-on debug function. Power-o n Debug How to use Page 2.4.5 To Access the Flash Memory This section describes the access method to the flash memory. Access to Flash Memory What is flash memory synchronization? Methods of flash memory synchronization Page Page Page 2.4.6 To Interrupt the Program Execution [Break] 2.4.6.1 Code Break (Hardware) Page 2.4.6.2 Code Break (Software) Operation Requirements Page 2.4.6.3 Data Break 2.4.6.4 Trace Trigger Break 2.4.6.5 Forced Break This function forcibly suspends program execution. When a User Program does not Stop 2.4.6.6 Data Watch Break Page 2.4.6.7 Sequencer Operation of Sequencer Specifications of Sequencer Setting 2.4.6.8 Guarded Access Break 2.4.7 Measuring the Program Execution Time This section explains the function to measure the program execution time. Measured Items Measurement unit 2.4.7.1 Measuring the Program Execution Cycle Count Setting Measurement Unit Error Information 2.4.7.2 Measuring Event-to-Event Execution Cycle Count [Performance Measurement] Measurement Items 1 2 Measuring Procedure Ending the Measurement Remeasuring 2.4.8 Viewing Program Execution History [Trace] This section describes the trace function. What is Trace Trace Functions Acquiring Trace Data Trace Buffer Page 2.4.8.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.4.8.1.1 Trace Data Display Examples (RAW Data) Page Page 2.4.8.1.2 Trace Data Display Example (Instruction) This section describes trace data that is displayed in the instruction mode. Instruction Display 2.4.8.1.3 Trace Data Display Example (Source) 2.4.8.2 Saving Trace Data This section explains how to save trace data. Saving Trace Data 2.4.8.3 Searching for Trace Data This section explains how to search for trace data. Searching for Trace Data 2.4.8.4 Obtaining Only Trace Data with Specified Attributes This section explains the trace filter. Trace Filter 2.4.8.5 Ending Trace Acquisition in Specified Conditions This section explains the trace trigger. Trace Trigger 2.4.9 Disabling Memory Access to Specified Area This section explains the access-prohibited area. Access-prohibited Area 2.4.10 Displaying Messages Output from the User Program on Debugger This section explains semihosting features. What is Semihosting Feature What is Terminal Window Using Semihosting Feature 2.4.11 Checking Debugger Status This section explains how to check information. Page Page Page 2.5.1 Resources Used by Monitor Program 2.5.2 Break 2.5.2.1 Software Break How to set 2.5.2.2 Forced Break 2.5.3 Measuring Execution Time This function measures the execution time of a program. Measurement Item 2.5.4 Inaccessible Area This section explains inaccessible area by the monitor debugger. Inaccessible area Access to memory area including inaccessible area Page Index