Fujitsu Biscuit Joiner CM71 00329 7E User Manual

FUJITSU SEMICONDUCTOR

CONTROLLER MANUAL

CM71-00329-7E

FR FAMILY

SOFTUNE WORKBENCH

USER’S MANUAL

for V6

FR FAMILY

S^OFTUNEWORKBENCH

USER’S MANUAL

for V6

FUJITSU SEMICONDUCTOR LIMITED

Preface

■ What is the SOFTUNE Workbench?

SOFTUNE Workbench is support software for developing programs for the FR 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 the functions of SOFTUNE Workbench. This manual is intended for engineers

developing various types of products using SOFTUNE Workbench. Be sure to read this manual

completely.

■ Trademarks

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

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

owners.

■ Organization of Manual

This manual consists of two chapters.

CHAPTER1 Basic Functions

This chapter describes the basic functions on the SOFTUNE Workbench.

CHAPTER2 Dependence Functions

This chapter describes the functions dependent on each Debugger.

•

The contents of this document are subject to change without notice.

Customers are advised to consult with 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

SEMICONDUCTOR 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 SEMICONDUCTOR 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

SEMICONDUCTOR or any third party or does FUJITSU SEMICONDUCTOR warrant non-infringement of any third-party's

intellectual property right or other right by using such information. FUJITSU SEMICONDUCTOR 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 SEMICONDUCTOR 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.

•

Exportation/release of any products described in this document may require necessary procedures in accordance with the

regulations of the Foreign Exchange and Foreign Trade Control Law of Japan and/or US export control laws.

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

CONTENTS

CHAPTER1

Basic Functions .......................................................................................... 1

Workspace Management Function ..................................................................................................... 2

Project Management Function ............................................................................................................ 3

Project Dependence ........................................................................................................................... 5

Make/Build Function ........................................................................................................................... 6

Customize Build Function .............................................................................................................. 7

Include Dependencies Analysis Function ........................................................................................... 9

Functions of Setting Tool Options ..................................................................................................... 10

Error Jump Function ......................................................................................................................... 11

Editor Functions ................................................................................................................................ 13

Storing External Editors .................................................................................................................... 15

1.10 Storing External Tools ...................................................................................................................... 17

1.11 Macro Descriptions Usable in Manager ............................................................................................ 18

1.12 Setting Operating Environment ......................................................................................................... 22

1.13 Debugger Types ............................................................................................................................... 23

1.14 Memory Operation Functions ........................................................................................................... 24

1.15 Register Operations .......................................................................................................................... 25

1.16 Line Assembly and Disassembly ...................................................................................................... 26

1.17 Symbolic Debugging ......................................................................................................................... 27

1.17.1 Referring to Local Symbols ......................................................................................................... 29

1.17.2 Referring to C/C++ Variables ...................................................................................................... 30

CHAPTER2

Dependence Functions ............................................................................ 33

2.1

2.1.1

Simulator Debugger .......................................................................................................................... 34

Instruction Simulation .................................................................................................................. 36

Memory Simulation ...................................................................................................................... 37

I/O Port Simulation ...................................................................................................................... 38

Interrupt Simulation ..................................................................................................................... 39

Reset Simulation ......................................................................................................................... 40

Low Power Consumption Mode Simulation ................................................................................. 41

STUB Function ............................................................................................................................ 42

Break ........................................................................................................................................... 43

2.1.8.1 Code Break ............................................................................................................................... 44

2.1.8.2 Data Break ................................................................................................................................ 45

2.1.8.3 Trace Buffer-full Break .............................................................................................................. 46

2.1.8.4 Guarded Access Break ............................................................................................................. 47

2.1.8.5 Forced Break ............................................................................................................................ 48

2.1.9

Measuring Execution Cycle Count .............................................................................................. 49

2.1.10 Trace ........................................................................................................................................... 50

2.1.10.1 Trace Sampling ........................................................................................................................ 51

2.1.10.2 Setting Trace ............................................................................................................................ 52

2.1.10.3 Displaying Trace Data .............................................................................................................. 53

2.1.10.4 Display Format of Trace Data ................................................................................................... 54

iii

2.1.10.5 Searching Trace Data ............................................................................................................... 55

2.1.10.6 Saving Trace Data .................................................................................................................... 56

2.1.10.7 Clearing Trace Data ................................................................................................................. 57

2.1.11 Measuring Coverage ................................................................................................................... 58

2.1.11.1 Coverage Measurement Procedures ........................................................................................ 59

2.1.12 Checking Debugger Status .......................................................................................................... 62

2.2

2.2.1

Emulator Debugger (MB2197) .......................................................................................................... 65

Setting Operating Environment ................................................................................................... 66

2.2.1.1 MCU Operation Mode ............................................................................................................... 67

2.2.1.2 DRAM Refresh Control ............................................................................................................. 68

2.2.1.3 Cache Flush Control ................................................................................................................. 69

2.2.1.4 Operating Frequency ................................................................................................................ 70

2.2.2

2.2.3

2.2.4

Notes on Executing Program ....................................................................................................... 71

Commands Available during Execution of User Program ........................................................... 72

Break ........................................................................................................................................... 73

2.2.4.1 Code Break ............................................................................................................................... 74

2.2.4.2 Code Event Break .................................................................................................................... 76

2.2.4.3 Data Event Break ..................................................................................................................... 77

2.2.4.4 Trace Buffer-full Break .............................................................................................................. 78

2.2.4.5 Alignment Error Break .............................................................................................................. 79

2.2.4.6 External Trigger Break .............................................................................................................. 80

2.2.4.7 Forced Break ............................................................................................................................ 81

2.2.5

2.2.6

Measuring Execution Cycle Count .............................................................................................. 82

Trace ........................................................................................................................................... 83

2.2.6.1 Trace Data ................................................................................................................................ 84

2.2.6.2 Trace Sampling ........................................................................................................................ 85

2.2.6.3 Setting Trace ............................................................................................................................ 86

2.2.6.4 Displaying Trace Data .............................................................................................................. 87

2.2.6.5 Display Format of Trace Data ................................................................................................... 88

2.2.6.6 Searching Trace Data ............................................................................................................... 89

2.2.6.7 Saving Trace Data .................................................................................................................... 90

2.2.6.8 Clearing Trace Data ................................................................................................................. 91

2.2.6.9 Notes on Use of Tracing Function ............................................................................................ 92

Inaccessible Area ........................................................................................................................ 94

Checking Debugger Status .......................................................................................................... 95

Emulator Debugger (MB2198) .......................................................................................................... 98

Setting Operating Environment ................................................................................................. 100

2.3.1.1 Monitoring Program Automatic Loading ................................................................................. 101

2.3.1.2 MCU Operation Mode ............................................................................................................. 102

2.3.1.3 Cache Flush Control ............................................................................................................... 103

2.3.1.4 Operating Frequency .............................................................................................................. 104

2.3.1.5 External Memory Emulation ................................................................................................... 105

2.3.1.6 Debug mode ........................................................................................................................... 106

2.3.2

2.3.3

2.3.4

Notes on Executing Program ..................................................................................................... 107

Commands Available during Execution of User Program ......................................................... 108

Break ......................................................................................................................................... 110

2.3.4.1 Code Break ............................................................................................................................. 111

2.3.4.2 Data Break .............................................................................................................................. 113

2.3.4.3 Code Event Break .................................................................................................................. 114

2.3.4.4 Data Event Break ................................................................................................................... 116

2.3.4.5 Trace Buffer-full Break ............................................................................................................ 118

2.3.4.6 Alignment Error Break ............................................................................................................ 119

2.3.4.7 External Trigger Break ............................................................................................................ 120

2.3.4.8 Forced Break .......................................................................................................................... 121

2.3.4.9 Data Watch Break .................................................................................................................. 122

2.3.5

2.3.6

2.3.7

Control by Sequencer ................................................................................................................ 124

Measuring Execution Cycle Count ............................................................................................ 127

Trace ......................................................................................................................................... 128

2.3.7.1 Display Format of Trace Data ................................................................................................. 132

2.3.7.2 Saving Trace Data .................................................................................................................. 133

2.3.7.3 Notes on Use of Tracing Function .......................................................................................... 134

2.3.8

Measuring Performance ............................................................................................................ 136

2.3.8.1 Performance Measurement Procedures ................................................................................. 137

2.3.8.2 Displaying Performance Measurement Data .......................................................................... 139

2.3.9

Real-time Monitoring ................................................................................................................. 140

2.3.10 Power-on Debugging ................................................................................................................. 141

2.3.11 Inaccessible Area ...................................................................................................................... 142

2.3.12 RAM Checker ............................................................................................................................ 143

2.3.13 Checking Debugger Status ........................................................................................................ 147

2.4

2.4.1

Emulator Debugger (MB2100-01) ................................................................................................... 150

Starting debugging .................................................................................................................... 151

2.4.1.1 Power-on Reset ...................................................................................................................... 152

2.4.1.2 Operating Environments of the Target ................................................................................... 153

2.4.1.3 Security ................................................................................................................................... 155

2.4.2

2.4.3

Ending debugging ...................................................................................................................... 156

Efficiently Executing Debugging ................................................................................................ 157

2.4.3.1 Increasing Communication Speed during Debugging ............................................................ 158

2.4.3.2 Switching Debug Function ...................................................................................................... 159

2.4.4

Executing Program .................................................................................................................... 160

2.4.4.1 Setting/Release of Debug Functions ...................................................................................... 161

2.4.4.2 Monitoring ............................................................................................................................... 163

2.4.4.3 Power-on Debug ..................................................................................................................... 164

2.4.5

2.4.6

To Access the Flash Memory .................................................................................................... 166

To Interrupt the Program Execution [Break] .............................................................................. 170

2.4.6.1 Code Break (Hardware) .......................................................................................................... 171

2.4.6.2 Code Break (Software) ........................................................................................................... 173

2.4.6.3 Data Break .............................................................................................................................. 175

2.4.6.4 Trace Trigger Break ................................................................................................................ 176

2.4.6.5 Forced Break .......................................................................................................................... 177

2.4.6.6 Data Watch Break .................................................................................................................. 178

2.4.6.7 Sequencer .............................................................................................................................. 180

2.4.6.8 Guarded Access Break ........................................................................................................... 182

2.4.7

Measuring the Program Execution Time ................................................................................... 183

2.4.7.1 Measuring the Program Execution Cycle Count ..................................................................... 184

2.4.7.2 Measuring Event-to-Event Execution Cycle Count [Performance Measurement] .................. 186

2.4.8

Viewing Program Execution History [Trace] .............................................................................. 189

2.4.8.1 Displaying Trace Data ............................................................................................................ 191

2.4.8.2 Saving Trace Data .................................................................................................................. 198

2.4.8.3 Searching for Trace Data ....................................................................................................... 199

2.4.8.4 Obtaining Only Trace Data with Specified Attributes .............................................................. 200

2.4.8.5 Ending Trace Acquisition in Specified Conditions .................................................................. 201

2.4.9

Disabling Memory Access to Specified Area ............................................................................. 202

2.4.10 Displaying Messages Output from the User Program on Debugger ......................................... 203

2.4.11 Checking Debugger Status ........................................................................................................ 205

2.5

Monitor Debugger ........................................................................................................................... 208

Resources Used by Monitor Program ....................................................................................... 209

Break ......................................................................................................................................... 210

2.5.1

2.5.2

2.5.2.1 Software Break ....................................................................................................................... 211

2.5.2.2 Forced Break .......................................................................................................................... 212

2.5.3

2.5.4

Measuring Execution Time ........................................................................................................ 213

Inaccessible Area ...................................................................................................................... 214

INDEX................................................................................................................................... 215

CHAPTER1

Basic Functions

This chapter describes the basic functions on the

SOFTUNE Workbench.

1.1 Workspace Management Function

1.2 Project Management Function

1.3 Project Dependence

1.4 Make/Build Function

1.5 Include Dependencies Analysis Function

1.6 Functions of Setting Tool Options

1.7 Error Jump Function

1.8 Editor Functions

1.9 Storing External Editors

1.10 Storing External Tools

1.11 Macro Descriptions Usable in Manager

1.12 Setting Operating Environment

1.13 Debugger Types

1.14 Memory Operation Functions

1.15 Register Operations

1.16 Line Assembly and Disassembly

1.17 Symbolic Debugging