Cypress F2MC-8L Series Manuel utilisateur

Doc. # 002-04536 Rev. *A

Cypress Semiconductor

198 Champion Court

San Jose, CA 95134-1709

www.cypress.com

F2MC-8L/8FX Family

SOFTUNE™ Workbench Operation Manual

F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A 2

Copyrights

and its subsidiaries, including Spansion LLC (“Cypress”). This document, including any software or firmware included or

referenced in this document (“Software”), is owned by Cypress under the intellectual property laws and treaties of the United

States and other countries worldwide. Cypress reserves all rights under such laws and treaties and does not, except as

specifically stated in this paragraph, grant any license under its patents, copyrights, trademarks, or other intellectual property

rights. If the Software is not accompanied by a license agreement and you do not otherwise have a written agreement with

Cypress governing the use of the Software, then Cypress hereby grants you a personal, non-exclusive, nontransferable

license (without the right to sublicense) (1) under its copyright rights in the Software (a) for Software provided in source code

form, to modify and reproduce the Software solely for use with Cypress hardware products, only internally within your

organization, and (b) to distribute the Software in binary code form externally to end users (either directly or indirectly

through resellers and distributors), solely for use on Cypress hardware product units, and (2) under those claims of

Cypress’s patents that are infringed by the Software (as provided by Cypress, unmodified) to make, use, distribute, and

import the Software solely for use with Cypress hardware products. Any other use, reproduction, modification, translation, or

compilation of the Software is prohibited.

TO THE EXTENT PERMITTED BY APPLICABLE LAW, CYPRESS MAKES NO WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, WITH REGARD TO THIS DOCUMENT OR ANY SOFTWARE OR ACCOMPANYING HARDWARE, INCLUDING,

BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

PURPOSE. To the extent permitted by applicable law, Cypress reserves the right to make changes to this document without

further notice. Cypress does not assume any liability arising out of the application or use of any product or circuit described

in this document. Any information provided in this document, including any sample design information or programming code,

is provided only for reference purposes. It is the responsibility of the user of this document to properly design, program, and

test the functionality and safety of any application made of this information and any resulting product. Cypress products are

not designed, intended, or authorized for use as critical components in systems designed or intended for the operation of

weapons, weapons systems, nuclear installations, life-support devices or systems, other medical devices or systems

(including resuscitation equipment and surgical implants), pollution control or hazardous substances management, or other

uses where the failure of the device or system could cause personal injury, death, or property damage (“Unintended Uses”).

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. You shall indemnify and hold Cypress harmless from and against all claims, costs, damages, and other

liabilities, including claims for personal injury or death, arising from or related to any Unintended Uses of Cypress products.

Cypress, the Cypress logo, Spansion, the Spansion logo, and combinations thereof, WICED, PSoC, CapSense, EZ-USB, F-

RAM, and Traveo are trademarks or registered trademarks of Cypress in the United States and other countries. For a more

complete list of Cypress trademarks, visit cypress.com. Other names and brands may be claimed as property of their

respective owners.

SOFTUNE is a trademark of Cypress Semiconductor Corp.

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

or other countries.

F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A 3

Preface

What is the SOFTUNE Workbench?

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

Organization of Manual

This manual consists of five chapters and appendix.

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. Debuggers are a simulator debugger, emulator debugger, and monitor debugger.

CHAPTER 2 Operation

This chapter explains the basic operation methods of SOFTUNE Workbench. It is divided into the following items.

CHAPTER 3 Windows

This chapter explains SOFTUNE Workbench windows.

CHAPTER 4 MENUS

This chapter explains the SOFTUNE Workbench menu configuration and the dialogs to be started from each menu.

CHAPTER 5 Add-in Module

This chapter explains SOFTUNE Workbench Add-in module.

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.

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

Contents

CHAPTER 1 Outline of SOFTUNE Workbench ........................................................ 11

1.1 Outline .............................................................................................................................................. 12

1.2 What is SOFTUNE Workbench? ...................................................................................................... 13

1.3 Procedure for Developing Programs with SOFTUNE Workbench ................................................... 14

CHAPTER 2 Operation .............................................................................................. 15

2.1 Parameters to be Entered from Dialog ............................................................................................. 16

2.1.1 Data and Address Formulas (Numerical Constant) .................................................................... 17

2.1.2 Data and Address Formulas (Symbols, Line Numbers, Character Constants) ........................... 19

2.1.3 Data and Address Formulas (Register Name, Flag Name) ........................................................ 21

2.1.4 Operators Usable in Data and Address Formulas ...................................................................... 22

2.1.5 Address Formula Specification ................................................................................................... 24

2.1.6 File Name Specification .............................................................................................................. 25

2.2 Starting and Terminating SOFTUNE Workbench ............................................................................ 26

2.3 Creating Workspace ......................................................................................................................... 27

2.4 Storing of Project .............................................................................................................................. 29

2.5 Creating and Registering Source File in Project .............................................................................. 31

2.6 Definition of Subproject .................................................................................................................... 32

2.7 Creation of Project Configuration ..................................................................................................... 33

2.8 Setting Tools .................................................................................................................................... 35

2.9 Setting Linker Options ...................................................................................................................... 36

2.10 Make/Build ....................................................................................................................................... 38

2.10.1 Making or Building of Project ...................................................................................................... 39

2.11 Debugging ........................................................................................................................................ 40

2.12 Executing Debugging Only ............................................................................................................... 41

2.13 Opening SOFTUNE Project Files of Old Versions ........................................................................... 43

2.14 Moving Project Files ......................................................................................................................... 45

2.15 Useful Functions .............................................................................................................................. 46

CHAPTER 3 Windows ............................................................................................... 47

3.1 Window Configuration ...................................................................................................................... 48

3.2 Tool Bar ............................................................................................................................................ 49

3.3 Status Bar ........................................................................................................................................ 52

3.4 Project Window ................................................................................................................................ 53

3.4.1 SRC Tab ..................................................................................................................................... 54

3.4.2 ABS Tab ...................................................................................................................................... 65

3.5 Output Window ................................................................................................................................. 70

F2MC-8L/8FX Family SOFTUNE Workbench Operation Manual, Doc. # 002-04536 Rev. *A 6

Contents

3.6 Edit Window (Standard Editor) ......................................................................................................... 73

3.6.1 Setting Standard Editor ............................................................................................................... 77

3.7 Source Window ................................................................................................................................ 82

3.8 Symbol Window ............................................................................................................................... 87

3.9 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 ..................................................................................................................... 97

3.13 Watch Window ................................................................................................................................. 99

3.14 Trace Window ................................................................................................................................ 102

3.15 Command Window ......................................................................................................................... 104

3.15.1 Setting Character String Replacement ...................................................................................... 107

3.15.2 Logging ..................................................................................................................................... 111

3.16 Object Window ............................................................................................................................... 112

3.17 Coverage Window .......................................................................................................................... 114

3.18 Performance Window ..................................................................................................................... 116

3.19 Sequence Window ......................................................................................................................... 118

3.20 RAM Monitoring Window ................................................................................................................ 119

CHAPTER 4 MENUS ................................................................................................ 121

4.1 Menu Configuration (Tree) ............................................................................................................. 122

4.2 File Menu ....................................................................................................................................... 126

4.2.1 New ........................................................................................................................................... 127

4.2.2 Open ......................................................................................................................................... 130

4.2.3 Close ......................................................................................................................................... 135

4.2.4 Open Workspace ...................................................................................................................... 136

4.2.5 Close Workspace ...................................................................................................................... 137

4.2.6 Save .......................................................................................................................................... 138

4.2.7 Save As ..................................................................................................................................... 139

4.2.8 Save All ..................................................................................................................................... 141

4.2.9 Print ........................................................................................................................................... 142

4.2.10 Recent Text File/Recent Workspace File .................................................................................. 143

4.2.11 Exit ............................................................................................................................................ 144

4.3 Edit Menu ....................................................................................................................................... 145

4.3.1 Undo, Redo ............................................................................................................................... 146

4.3.2 Cut, Copy, Paste, Delete ........................................................................................................... 147

4.3.3 All Select ................................................................................................................................... 149

4.3.4 Find/Replace ............................................................................................................................. 150

4.3.5 Find in Files ............................................................................................................................... 152

4.3.6 Jump ......................................................................................................................................... 153

4.3.7 Bookmark .................................................................................................................................. 154

4.3.7.1 Bookmark-Source Window ..................................................................................................... 155

4.3.7.2 Bookmark-Memory Window ................................................................................................... 158

4.3.7.3 Bookmark-Edit Window .......................................................................................................... 161

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

4.4 View Menu ..................................................................................................................................... 174

4.4.1 Project/Output ........................................................................................................................... 176

4.4.2 Symbol ...................................................................................................................................... 177

4.4.3 Assembly ................................................................................................................................... 178

4.4.4 Register ..................................................................................................................................... 180

4.4.5 Memory ..................................................................................................................................... 182

4.4.6 Local .......................................................................................................................................... 190

4.4.7 Watch ........................................................................................................................................ 191

4.4.8 Trace ......................................................................................................................................... 194

4.4.8.1 Trace (Simulator Debugger) ................................................................................................... 199

4.4.8.2 Trace (Emulator Debugger [MB2141]) ................................................................................... 200

4.4.9 Command .................................................................................................................................. 201

4.4.10 Tool Bar, Status Bar, Tab .......................................................................................................... 202

4.4.11 Object ........................................................................................................................................ 203

4.4.12 Coverage ................................................................................................................................... 208

4.4.13 Performance .............................................................................................................................. 210

4.4.13.1 Performance (Emulator debugger [MB2141]) ........................................................................ 212

4.4.14 Fonts ......................................................................................................................................... 214

4.4.15 RAM Monitoring ........................................................................................................................ 216

4.5 Project ............................................................................................................................................ 218

4.5.1 Active Project ............................................................................................................................ 219

4.5.2 Add Project ................................................................................................................................ 220

4.5.2.1 Add Project-Create ................................................................................................................ 221

4.5.2.2 Add Project-Existing Project ................................................................................................... 223

4.5.3 Add Member .............................................................................................................................. 224

4.5.3.1 Add Member-File ................................................................................................................... 225

4.5.3.2 Add Member-Directory ........................................................................................................... 226

4.5.4 Setup Workspace ...................................................................................................................... 227

4.5.5 Setup Project ............................................................................................................................. 228

4.5.5.1 General .................................................................................................................................. 231

4.5.5.2 MCU ....................................................................................................................................... 233

4.5.5.3 Setting C Compiler Options .................................................................................................... 237

4.5.5.4 Setting Assembler Options .................................................................................................... 245

4.5.5.5 Setting Linker Options ............................................................................................................ 251

4.5.5.6 Section Disposition/Connection Specifying ............................................................................ 259

4.5.5.7 Setting Librarian Options ....................................................................................................... 265

4.5.5.8 Setting Converter Options ...................................................................................................... 267

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

4.6 Debug ............................................................................................................................................. 284

4.6.1 Run ............................................................................................................................................ 285

4.6.2 Abort .......................................................................................................................................... 286

4.6.3 Reset MCU ................................................................................................................................ 287

4.6.4 Breakpoint ................................................................................................................................. 288

4.6.4.1 Code Break (Simulator/Monitor Debugger) ............................................................................ 291

4.6.4.2 Data Break (Simulator Debugger) .......................................................................................... 293

4.6.4.3 Code Break-Hardware (Emulator debugger) ......................................................................... 295

4.6.4.4 Code Break-Software (Emulator debugger) ........................................................................... 297

4.6.4.5 Data Break (Emulator Debugger) ........................................................................................... 299

4.6.4.6 Sequence Break (Emulator Debugger) .................................................................................. 301

4.6.5 Event ......................................................................................................................................... 303

4.6.6 Sequence .................................................................................................................................. 305

4.6.7 Stack ......................................................................................................................................... 307

4.6.8 Time Measurement ................................................................................................................... 308

4.6.9 Call ............................................................................................................................................ 310

4.6.10 Clear Call .................................................................................................................................. 312

4.6.11 Vector ........................................................................................................................................ 313

4.6.12 Load Target File ........................................................................................................................ 315

4.6.13 Start Debug/End Debug ............................................................................................................ 316

4.7 Setup .............................................................................................................................................. 317

4.7.1 Development ............................................................................................................................. 318

4.7.2 Debug Environment .................................................................................................................. 322

4.7.2.1 I/O Port ................................................................................................................................... 323

4.7.2.2 Interrupt .................................................................................................................................. 327

4.7.2.3 Debug Environment ............................................................................................................... 328

4.7.2.4 Setup Wizard ......................................................................................................................... 348

4.7.3 Memory Map ............................................................................................................................. 359

4.7.4 Flash Memory Control ............................................................................................................... 363

4.7.5 Tool ........................................................................................................................................... 364

4.7.6 Keyboard ................................................................................................................................... 367

4.7.7 Editor ......................................................................................................................................... 369

4.7.8 Error .......................................................................................................................................... 372

4.7.9 Tool Startup ............................................................................................................................... 374

4.8 Window .......................................................................................................................................... 375

4.8.1 Cascade, Vertical, Horizon ........................................................................................................ 376

4.8.2 Split ........................................................................................................................................... 377

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

4.9 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 .................................................................................... 389

5.1 Customize Bar ................................................................................................................................ 390

5.1.1 What is Customize Bar? ............................................................................................................ 391

5.1.2 Customize Bar Menu ................................................................................................................. 393

5.1.3 Registering in the Customize Bar .............................................................................................. 394

5.1.3.1 Registering Batch File ............................................................................................................ 398

5.1.3.2 Registering Workbench Menu ................................................................................................ 400

5.1.3.3 Registering External Tool ....................................................................................................... 402

5.1.4 Warning and Error Messages ................................................................................................... 404

5.1.5 Note ........................................................................................................................................... 406

APPENDIX ...................................................................................................................... 407

APPENDIX A List of Register Names ...................................................................................................... 408

APPENDIX B Downloading Monitor Program ......................................................................................... 409

APPENDIX C Setting LAN Interface ........................................................................................................ 410

APPENDIX D Setting USB Interface ....................................................................................................... 411

APPENDIX E Installing Monitor Debugger .............................................................................................. 412

APPENDIX F External I/F for Simulator ................................................................................................. 432

F.1 SSDI_Entry (Start) ...................................................................................................................... 434

F.2 SSDI_Init (Initialize) ..................................................................................................................... 435

F.3 SSDI_Ready (Ready) .................................................................................................................. 436

F.4 SSDI_End (End) .......................................................................................................................... 437

F.5 SSDI_Reset_Event (Post Reset) ................................................................................................ 438

F.6 SSDI_Read_Event (Post Read) .................................................................................................. 439

F.7 SSDI_Write_Event (Post Write) .................................................................................................. 440

F.8 SSDI_Execute_Event (Post Execute Instruction) ....................................................................... 441

F.9 SSDI_Interrupt_Event (Post Interrupt) ........................................................................................ 442

F.10 SSDI_Timer_Event (Post Timer) ................................................................................................. 443

F.11 SSDI_Read_Memory (Read from Memory) ................................................................................ 444

F.12 SSDI_Write_Memory (Write to Memory) ..................................................................................... 445

F.13 SSDI_Read_Register (Read from Register) ............................................................................... 446

F.14 SSDI_Write_Register (Write to Register) .................................................................................... 447

F.15 SSDI_Set_Interrupt (Set Interrupt Source) ................................................................................. 448

F.16 SSDI_Set_Timer (Set Timer) ...................................................................................................... 449

F.17 SSDI_Request_Abort (Request Abort) ....................................................................................... 450

F.18 SSDI_Set_Area (Set Area) ......................................................................................................... 451

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

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Cypress Microcontrôleur

Cypress

Cypress FM4-U120-9B560 Manuel utilisateur

Cypress

Cypress CY8CKIT-001 Manuel utilisateur

Cypress

Cypress EZ-USB FX3 CYUSB3KIT-003 Manuel utilisateur

Cypress

Cypress CapSense Plus CY3280-CPM1 Manuel utilisateur

Cypress

Cypress CY4608 Instructions d'utilisation et d'entretien

Cypress

Cypress CY3276 Manuel utilisateur

Cypress

Cypress CY4607 HX2VL Manuel utilisateur

Cypress

Cypress PSoC CY8CKIT-008 Manuel utilisateur

Cypress

Cypress PSoC CY8CPROTO-062-4343W Manuel utilisateur

Cypress

Cypress MB9BF564K Manuel utilisateur

Cypress

Cypress CY8CKIT-062-BLE Manuel utilisateur

Cypress

Cypress FR81S CY91F52 Series Mode d'emploi

Cypress

Cypress S6J3200 Series Mode d'emploi

Cypress

Cypress CY3280-BSM Manuel utilisateur

Cypress

Cypress CapSense CY8CMBR2010 Mode d’emploi

Cypress

Cypress CY3250-PLC20QFN Manuel utilisateur

Cypress

Cypress PSoC 4 Manuel utilisateur

Cypress

Cypress CY8CKIT-042-BLE-A Manuel utilisateur

Cypress

Cypress CY3668 Manuel utilisateur

Cypress

Cypress CY8CKIT-147 Manuel

Cypress

Cypress PERFORM MB96630 Series Manuel utilisateur

Cypress

Cypress CY8CKIT-030 Manuel utilisateur

Cypress

Cypress FM0+ S6E1C-Series Manuel utilisateur

Cypress

Cypress S6J3200 Series Manuel utilisateur

Manuels Microcontrôleur populaires d'autres marques

AMS

AMS AS7261 Demo Kit Manuel utilisateur

Novatek

Novatek NT6861 Manuel utilisateur

Espressif Systems

Espressif Systems ESP8266 SDK Guide de configuration

Nuvoton

Nuvoton ISD61S00 ChipCorder Mode d’emploi

STMicrolectronics

STMicrolectronics ST7 Assembler Linker Manuel utilisateur

Texas Instruments

Texas Instruments Chipcon CC2420DK Manuel utilisateur

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM Manuel utilisateur

NEC

NEC 78GK0S/K 1+ Series Instructions d'installation et d'utilisation

Mikroe

Mikroe SEMITECH N-PLC Click Instructions d'installation et d'utilisation

Intel

Intel Agilex Manuel utilisateur

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE Manuel utilisateur

Texas Instruments

Texas Instruments TMS320F2837 D Series Manuel utilisateur

CYPRES

CYPRES CY14NVSRAMKIT-001 Manuel utilisateur

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM Manuel utilisateur

Espressif Systems

Espressif Systems ESP8266EX Mode d'emploi

Abov

Abov AC33M8128L Manuel utilisateur

Laird

Laird BL654PA Manuel utilisateur

Silicon Laboratories

Silicon Laboratories C8051F800 Manuel utilisateur