COMMAND REFERENCE MANUAL

Transcription

1 FUJITSU SEMICONDUCTOR CONTROLLER MANUAL CM E F 2 MC TM -16 FAMILY SOFTUNE TM WORKBENCH COMMAND REFERENCE MANUAL

2

3 F 2 MC TM -16 FAMILY SOFTUNE TM WORKBENCH COMMAND REFERENCE MANUAL FUJITSU LIMITED

4

5 PREFACE What is the Softune Workbench? Softune Workbench is support software for developing programs for the FR-V, FR, F 2 MC-16, and F 2 MC- 8L 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 Trademarks This manual explains the command and embedded variable/function of the SOFTUNE Workbench in the reference format. This manual is intended for engineers developing various types of products using SOFTUNE Workbench. Be sure to read this manual completely. SOFTUNE is a trademark of FUJITSU LIMITED. FR is the abbreviation of FUJITSU RISC Controller and a product of FUJITSU LIMITED. F 2 MC is the abbreviation of Fujitsu Flexible Microcontroller and a registered trademark of FUJITSU LIMITED. Windows is registered trademarks of Microsoft Corporation in the U.S. and other countries. Organization of Manual This manual consists of 14 chapters and an appendix. Chapter 1 Environment Setup Commands This chapter describes the Environment Setup Commands. Chapter 2 Program Execution Commands This chapter describes the Program Execution Commands. Chapter 3 Break/Event Control Commands This chapter describes the Break/Event Control Commands. Chapter 4 Program Execution Analysis Commands This chapter describes the Program Execution Analysis Commands. Chapter 5 Memory/Register Operation Commands This chapter describes the Memory/Register Operation Commands. Chapter 6 Line Assemble and Disassemble Commands This chapter describes the Line Assemble and Disassemble Commands. Chapter 7 Load and Save Commands This chapter describes the Load and Save Commands. Chapter 8 Source File/Symbol Commands This chapter describes the Source File/Symbol Commands. Chapter 9 Command Procedure Commands This chapter describes the Command Procedure Commands. i

6 Chapter 10 Replacement Commands This chapter describes the Replacement Commands. Chapter 11 Utility Commands This chapter describes the Utility Commands. Chapter 12 Task Debug Commands This chapter describes the Task Debug Commands. Chapter 13 Control Commands This chapter describes the Control Commands. Chapter 14 Built-in Variables and Functions This chapter describes the Built-in Variables and Functions. APPENDIX These appendixes describe the Manager-Related Messages, Error Message for Debuggers, and Execution Suspension Message List. The contents of this document are subject to change without notice. Customers are advised to consult with FUJITSU sales representatives before ordering. The information, such as descriptions of function and application circuit examples, in this document are presented solely for the purpose of reference to show examples of operations and uses of Fujitsu semiconductor device; Fujitsu does not warrant proper operation of the device with respect to use based on such information. When you develop equipment incorporating the device based on such information, you must assume any responsibility arising out of such use of the information. Fujitsu assumes no liability for any damages whatsoever arising out of the use of the information. Any information in this document, including descriptions of function and schematic diagrams, shall not be construed as license of the use or exercise of any intellectual property right, such as patent right or copyright, or any other right of Fujitsu or any third party or does Fujitsu warrant non-infringement of any third-party s intellectual property right or other right by using such information. Fujitsu assumes no liability for any infringement of the intellectual property rights or other rights of third parties which would result from the use of information contained herein. The products described in this document are designed, developed and manufactured as contemplated for general use, including without limitation, ordinary industrial use, general office use, personal use, and household use, but are not designed, developed and manufactured as contemplated (1) for use accompanying fatal risks or dangers that, unless extremely high safety is secured, could have a serious effect to the public, and could lead directly to death, personal injury, severe physical damage or other loss (i.e., nuclear reaction control in nuclear facility, aircraft flight control, air traffic control, mass transport control, medical life support system, missile launch control in weapon system), or (2) for use requiring extremely high reliability (i.e., submersible repeater and artificial satellite). Please note that Fujitsu will not be liable against you and/or any third party for any claims or damages arising in connection with above-mentioned uses of the products. Any display has an inherent chance of failure. You must protect against injury, damage or loss from such failures by incorporating safety design measures into your facility and equipment such as redundancy, fire protection, and prevention of over-current levels and other abnormal operating conditions. If any products described in this document represent goods or technologies subject to certain restrictions on export under the Foreign Exchange and Foreign Trade Law of Japan, the prior authorization by Japanese government will be required for export of those products from Japan. Copyright 2004 FUJITSU LIMITED All rights reserved ii

7 READING THIS MANUAL Page Layout Each section of this manual is summarized immediately below the title. You can obtain a rough overview of this product by reading through these summaries. Also, higher level section headings are given in lower sections so that you can know to which section the text you are currently reading belongs. Command Reference Notation Format The command reference notation format is given below. Command name (debuggers) "Format" "Description" "Example" Command name: Name of command to be explained Debuggers Usable commands depend on the debugger type. Which debugger can use the command and which debugger cannot use it are described. : Can use command : Can use command except when instruction being executed : Cannot use command : There is no debugger. Format The format, parameters, and command qualifiers of the command are explained. Enter the command in this format. Description The command function is explained. Example Command coding example. This example may differ slightly from the actual coding iii

8 iv

9 CONTENTS CHAPTER 1 Environment Setup Commands INITIALIZE EXIT RESET SET RUNMODE SHOW RUNMODE SET MODE SHOW MODE SET DEBUG SHOW DEBUG SET TIMERSCALE SHOW TIMERSCALE SET RADIX SHOW RADIX SET SOURCE SHOW SOURCE SHOW SYSTEM SET MAP (type 1) SET MAP (type 2) SHOW MAP CANCEL MAP ENABLE VERIFYMODE DISABLE VERIFYMODE SHOW VERIFYMODE SET INPORT SHOW INPORT CANCEL INPORT SET OUTPORT SHOW OUTPORT CANCEL OUTPORT SET INTERRUPT SHOW INTERRUPT CANCEL INTERRUPT SET VECTOR SHOW VECTOR ENABLE WATCHDOG DISABLE WATCHDOG SHOW WATCHDOG SET WATCH CANCEL WATCH CHAPTER 2 Program Execution Commands GO v

10 2.2 SET GO SHOW GO STEP SET STEP SHOW STEP CALL CLEAR CALL SHOW STATUS CHAPTER 3 Break/Event Control Command SET BREAK (type 1) SET BREAK (type 2) SHOW BREAK CANCEL BREAK ENABLE BREAK DISABLE BREAK SET DATABREAK (type 1) SET DATABREAK (type 2) SHOW DATABREAK CANCEL DATABREAK ENABLE DATABREAK DISABLE DATABREAK SET XBREAK SHOW XBREAK CANCEL XBREAK SET SBREAK SHOW SBREAK CANCEL SBREAK SET EVENT (type 1) SET EVENT (type 2) SHOW EVENT CANCEL EVENT ENABLE EVENT DISABLE EVENT SET SEQUENCE (type 1) SET SEQUENCE (type 2) SHOW SEQUENCE (type 1) SHOW SEQUENCE (type 2) CANCEL SEQUENCE ENABLE SEQUENCE DISABLE SEQUENCE SET DELAY SHOW DELAY SET TRIGGER SHOW TRIGGER CHAPTER 4 Program Execution Analysis Commands vi

11 4.1 SET MULTITRACE SHOW MULTITRACE CLEAR MULTITRACE ENABLE MULTITRACE DISABLE MULTITRACE SEARCH MULTITRACE SET PERFORMANCE SHOW PERFORMANCE CLEAR PERFORMANCE SET COVERAGE SHOW COVERAGE CANCEL COVERAGE CLEAR COVERAGE ENABLE COVERAGE DISABLE COVERAGE SET SAMPLING SHOW SAMPLING SHOW CALLS SHOW TIMER CLEAR TIMER SET TRACE (type 1) SET TRACE (type 2) SHOW TRACE (type 1) SHOW TRACE (type 2) CLEAR TRACE ENABLE TRACE DISABLE TRACE SEARCH TRACE SET DATATRACEAREA SHOW DATATRACEAREA CANCEL DATATRACEAREA SET TRACETRIGGER SHOW TRACETRIGGER CANCEL TRACETRIGGER SET RAMCHECK SHOW RAMCHECK CANCEL RAMCHECK ENABLE RAMCHECK DISABLE RAMCHECK CHAPTER 5 Memory/Register Operation Commands EXAMINE ENTER SET MEMORY SHOW MEMORY SEARCH MEMORY SET REGISTER vii

12 5.7 SHOW REGISTER COMPARE FILL MOVE DUMP COPY VERIFY CHAPTER 6 Line Assemble and Disassemble Commands ASSEMBLE DISASSEMBLE CHAPTER 7 Load and Save Commands LOAD SAVE CHAPTER 8 Source File/Symbol Commands LIST SET PATH SHOW PATH SHOW SCOPE UP DOWN CHAPTER 9 Command Procedure Commands BATCH QUIT CHAPTER 10 Replacement Commands SET ALIAS SHOW ALIAS CANCEL ALIAS SET VARIABLE SHOW VARIABLE CANCEL VARIABLE CHAPTER 11 Utility Commands SET LOGGING SHOW LOGGING CANCEL LOGGING ENABLE LOGGING DISABLE LOGGING PRINTF SET OUTPUT SHOW OUTPUT viii

13 CHAPTER 12 Task Debug Commands SYSTEMCALL SHOW OBJECT CHAPTER 13 Control Commands IF REPEAT WHILE BREAK CHAPTER 14 Built-in Variables and Functions %CALL %ERRNUM %ENTRY %STKTOP %RADIX %SCPADR %LOADNUM %BIT, %B, %W, %L, %S, %D %STRGET %STRSTR %STRCMP %STRLEN %STRCAT %SYMLEN %TOVAL %TOSTR %EVAL %EVENTNUM %TRIGGERNUM APPENDIX APPENDIX A Manager-Related Messages APPENDIX B Error Message for Debuggers APPENDIX C Execution Suspension Messages List ix

14 x

15 CHAPTER 1 Environment Setup Commands This chapter describes the environment setup commands. 1.1 INITIALIZE 1.2 EXIT 1.3 RESET 1.4 SET RUNMODE 1.5 SHOW RUNMODE 1.6 SET MODE 1.7 SHOW MODE 1.8 SET DEBUG 1.9 SHOW DEBUG 1.10 SET TIMERSCALE 1.11 SHOW TIMERSCALE 1.12 SET RADIX 1.13 SHOW RADIX 1.14 SET SOURCE 1.15 SHOW SOURCE 1.16 SHOW SYSTEM 1.17 SET MAP (type 1) 1.18 SET MAP (type 2) 1.19 SHOW MAP 1.20 CANCEL MAP 1.21 ENABLE VERIFYMODE 1

16 CHAPTER 1 Environment Setup Commands 1.22 DISABLE VERIFYMODE 1.23 SHOW VERIFYMODE 1.24 SET INPORT 1.25 SHOW INPORT 1.26 CANCEL INPORT 1.27 SET OUTPORT 1.28 SHOW OUTPORT 1.29 CANCEL OUTPORT 1.30 SET INTERRUPT 1.31 SHOW INTERRUPT 1.32 CANCEL INTERRUPT 1.33 SET VECTOR 1.34 SHOW VECTOR 1.35 ENABLE WATCHDOG 1.36 DISABLE WATCHDOG 1.38 SET WATCH 1.39 CANCEL WATCH 2

17 CHAPTER 1 Environment Setup Commands 1.1 INITIALIZE The INITIALIZE command initializes the debugger. INITIALIZE The INITIALIZE command initializes the debugger. This initialization nullifies all settings other than macro, alias and debug variable. >INITIALIZE 3

18 CHAPTER 1 Environment Setup Commands 1.2 EXIT The EXIT command terminates the debugger. EXIT The EXIT command terminates the debugger. >EXIT 4

19 CHAPTER 1 Environment Setup Commands 1.3 RESET The RESET command inputs the reset signal to the MCU. RESET The RESET command inputs the reset signal to the MCU. >RESET 5

20 CHAPTER 1 Environment Setup Commands 1.4 SET RUNMODE The SET RUNMODE command sets an MCU operation mode. SET RUNMODE Command qualifiers Setting operation mode /DEBUG (default at start-up) Sets operation mode to DEBUG. /NATIVE Sets operation mode to NATIVE. Setting emulator operating speed /LOW (default at start-up) Set when MCU operates at low speed. Only the MB2141 ICE can specify this command. /HIGH Set when MCU operates at high speed. The margin of the signal that the ICE hardware checks is relaxed. Only the MB2141 ICE can specify this command. The SET RUNMODE command sets an MCU operation mode. There are two operation modes: DEBUG and NATIVE, which differ from each other as follows: DEBUG mode All MCU operations can be debugged, but the running speed will decrease a little. 6

21 CHAPTER 1 Environment Setup Commands NATIVE mode Real-time running is enabled, but part of the debugging functions will be restricted. An emulator should be usually placed in the low-speed mode. The emulator should be placed in the highspeed mode when operating the F 2 MC-16H/16F at high speed, and if the emulator fails to function normally. >SET RUNMODE/TRACE 7

22 CHAPTER 1 Environment Setup Commands 1.5 SHOW RUNMODE The SHOW RUNMODE command displays the MCU operation mode set by the SET RUNMODE command. SHOW RUNMODE The SHOW RUNMODE command displays the MCU operation mode set by the SET RUNMODE command. >SHOW RUNMODE run mode: TRACE 8

23 CHAPTER 1 Environment Setup Commands 1.6 SET MODE The SET MODE command sets the event mode as follows. SET MODE Command qualifiers Set event mode. /NORMAL (default at start-up) Sets event mode to NORMAL. /MULTITRACE Sets event mode to MULTITRACE. /PERFORMANCE Sets event mode to PERFORMANCE. The SET MODE command sets the event mode: NORMAL mode The event function is used for trace control by a sequencer. Command setting related to SEQUENCE, DELAY, and TRACE is enabled. MULTITRACE mode (Only MB2141) The event function is used for multitracing. Command setting related to MULTITRACE is enabled. PERFORMANCE mode The event function is used for measuring performance. Command setting related to PERFORMANCE is enabled. The commands related to EVENT can be used in all modes, each mode has different values. If a mode is changed, the value will return to the value previously set in the mode. A mode change will also clear the single-trace, multitrace, and performance buffers. The start-up is "/NORMAL". 9

24 CHAPTER 1 Environment Setup Commands >SET MODE /MULTITRACE 10

25 CHAPTER 1 Environment Setup Commands 1.7 SHOW MODE The SHOW MODE command displays the setting state of the event mode. SHOW MODE The SHOW MODE command displays the setting state of the event mode. >SHOW MODE event mode: normal 11

26 CHAPTER 1 Environment Setup Commands 1.8 SET DEBUG The SET DEBUG command sets the debug area. SET DEBUG area-number, area-starting-bank Parameters area number Specify the number of the debug area. area starting bank (default: hexadecimal number) Specify the starting bank of the debug area. Command qualifiers [MB2141] Code area /CODE (default when omitted) Sets breakpoint area by debug area. Data area /READ Sets debug area to read area. /WRITE Sets debug area to write area. Only the following patterns can be specified as command qualifiers: /CODE, /READ, /WRITE, /READ/WRITE Command qualifiers settings are information only for break-related processing and do not affect the settings of the coverage measurement area. 12

27 CHAPTER 1 Environment Setup Commands The SET DEBUG command sets the debug area. [MB2141] This setting will affect the settings of breakpoints and the coverage area. Up to 65,535 breakpoints can be set if the /CODE, /READ, and /WRITE settings of the debug area are the same as those of breakpoints. The coverage measurement range can be specified only within the area where coverage is set. The debug area is available in DEBUG1 and DEBUG2 (area number 1 and 2). An area of 512 K (8 banks) is set in the two areas. The lower 3 bits of the starting bank are ignored. Setting a debug area will clear all break and coverage information. [MB ] This setting will affect the setting of the coverage area. The coverage measurement range can be specified only within the area where coverage is set. The debug area is available in DEBUG1, 2, 3 and DEBUG4. An area of 1MB (16 banks) is set in the two areas. However, the DEBUG1 area and the DEBUG2 area are fixed to the next setup. DEBUG1:0x x0FFFFF DEBUG2:0xF xFFFFFF Setting a debug area will clear all coverage information. [MB ] This setting will affect the settings of breakpoints. Up to 65,535 breakpoints can be set. The debug area is available in DEBUG1, 2, 3 and DEBUG4. An area of 1MB (16 banks) is set in the two areas. However, the DEBUG1 area and the DEBUG2 area are fixed to the next setup. DEBUG1:0x x0FFFFF DEBUG2:0xF xFFFFFF Setting a debug area will clear all break information. >SET DEBUG /CODE 1, F8 >SET DEBUG/READ/WRITE 2, 00 13

28 CHAPTER 1 Environment Setup Commands 1.9 SHOW DEBUG The SHOW DEBUG command displays the debug area set by the SET DEBUG command. SHOW DEBUG The SHOW DEBUG command displays the debug area set by the SET DEBUG command. >SHOW DEBUG DEBUG1 /CODE F8 (F FFFFFF) DEBUG2 /READ /WRITE 00 ( FFFF) 14

29 CHAPTER 1 Environment Setup Commands 1.10 SET TIMERSCALE The SET TIMERSCALE command sets the minimum measurement unit of a timer. SET TIMERSCALE Command qualifiers Sets the minimum measurement unit of a timer. /1 us (default when omitted) Sets minimum measurement unit of timer to 1 µs. /100 ns Sets minimum measurement unit of timer to 100 ns. The SET TIMERSCALE command sets the minimum measurement unit of a timer. The unit can be set to either 1 µs or 100 ns. The start-up is 1 µs. This setting will determine the minimum measurement units of the following timers: Sequencer timer Emulation timer Performance measurement timer >SET TIMERSCALE/100ns 15

30 CHAPTER 1 Environment Setup Commands 1.11 SHOW TIMERSCALE The SHOW TIMERSCALE command displays the minimum measurement unit of a timer. SHOW TIMERSCALE The SHOW TIMERSCALE command displays the minimum measurement unit of a timer. >SHOW TIMERSCALE Timer scale: 100 ns 16

31 CHAPTER 1 Environment Setup Commands 1.12 SET RADIX The SET RADIX command sets default base number. SET RADIX Command qualifiers /BINARY Sets default base number to binary number. /OCTAL Sets default base number to octal number. /DECIMAL Sets default base number to decimal number. /HEXADECIMAL (default) Sets default base number to hexadecimal number. The SET RADIX command sets default base number. >SET RADIX/HEXADECIMAL 17

32 CHAPTER 1 Environment Setup Commands 1.13 SHOW RADIX The SHOW RADIX command displays the current base number. SHOW RADIX The SHOW RADIX command displays the current base number. >SHOW RADIX default radix: hexadecimal 18

33 CHAPTER 1 Environment Setup Commands 1.14 SET SOURCE The SET SOURCE command sets source line display mode. SET SOURCE Command qualifiers Source line display mode /DISPLAY (default at start-up) Sets mode in which source lines displayed. /NODISPLAY Sets mode in which source lines not displayed. When the disassemble list is displayed, the SET SOURCE command sets whether or not to display the added source line. When the debugger is started, the mode in which source lines are displayed is set. >SET SOURCE/DISPLAY 19

34 CHAPTER 1 Environment Setup Commands 1.15 SHOW SOURCE The SHOW SOURCE command displays the source line display mode set by the SET SOURCE command. SHOW SOURCE The SHOW SOURCE command displays the source line display mode set by the SET SOURCE command. >SHOW SOURCE source mode: display 20

35 CHAPTER 1 Environment Setup Commands 1.16 SHOW SYSTEM The SHOW SYSTEM command displays system information. SHOW SYSTEM The SHOW SYSTEM command displays system information. >SHOW SYSTEM F 2 MC-16 Family Softune Workbench V30L30 Debugger type = Debugger MCU type = MB90F394 VCpu dll name = C:\Release\Softune\BIN\wv907e2.dll Common version = V02L06 version = V02L04 MCU frequency = MHz Communication device = USB 21

36 CHAPTER 1 Environment Setup Commands 1.17 SET MAP (type 1) The SET MAP command sets a memory space area type and access attribute. SET MAP {address address-range} Parameters address (address formula) Specify the memory address where access attribute to be set. address-range (address formula) Specify the memory area where access attribute to be set Command qualifiers Specifying access attribute /READ Enables data read access. /WRITE Enables data write access. /CODE Enables code read access. If command qualifier is omitted, /READ/WRITE is set. Specifying area type /USER [MB2141] [MB ] [MB ] Sets area to user memory area. /EMULATION (default when omitted) [MB2141] [MB ] [MB ] Sets area to emulation memory area. /MIRROR [MB2141] Sets area to mirror area Copying contents of mirror area. 22

37 CHAPTER 1 Environment Setup Commands Copying contents of mirror area /COPY [MB2141] Copies contents in user memory when mirror area set. This qualifier is ignored except when /MIRROR is given. /NOCOPY (default when omitted) [MB2141] Does not copy contents in user memory when mirror area set. This qualifier is ignored except when /MIRROR is given. The SET MAP command sets a memory space area type and access attribute. (SIM) Up to 31 memory areas can be set. (Enables to specify in byte) When the load module file is loaded by the LOAD command, appropriate access attributes are automatically set according to the file information. (EML) [MB2141] User memory area (/USER) Up to 8 areas can be specified in 2 bytes. There is no restriction on the size of one area. Emulation area (/EMULATION) Up to 7 areas (including the mirror and internal ROM areas) can be specified in 2 bytes. The maximum size of one area is up to 64 Kbytes. If an area of 64 Kbytes or more is specified, two or more areas will be reserved automatically. Even if an area of less than 64 Kbytes is specified, two areas will be needed when bank boundaries are included. Mirror area (/MIRROR) Up to 5 areas including the emulation area can be specified. Attribute setting is disabled. The command qualifiers for data copy (/COPY and /NOCOPY) can be specified at one time. [MB ] User memory area (/USER) Up to 4 areas can be specified in 256 bytes. There is no restriction on the size of one area. Emulation area (/EMULATION) Up to 4 areas can be specified in 256 bytes. The maximum size of one area is up to 1M bytes [MB ] User memory area (/USER) Up to 4 areas can be specified in 256 bytes. There is no restriction on the size of one area. Emulation area (/EMULATION) Up to 4 areas can be specified in 256 bytes. The maximum size of one area is up to 256 Kbytes >SET MAP/READ/WRITE FFF 23

38 CHAPTER 1 Environment Setup Commands 1.18 SET MAP (type 2) The SET MAP command sets an undefined area access attributes. SET MAP {/GUARD /NOGUARD} Command qualifiers Setting undefined area access attributes /GUARD (default when internal ROM provided) Disables access to undefined area. Note: In the MB and MB ICE, if the user memory or the emulation memory is set on 00 bank, the guarded break does not work on 00 bank of the access to the undefined area. /NOGUARD (default when internal ROM not provided) Enables full access to undefined area. The SET MAP command sets an access attributes to undefined area. Either the command qualifier for allowing any access (/NOGUARD) or for disallowing access (/GUARD) can be specified for an undefined area. >SET MAP/GUARD 24

39 CHAPTER 1 Environment Setup Commands 1.19 SHOW MAP The SHOW MAP command displays the set memory space access attributes. SHOW MAP The SHOW MAP command displays the set memory space access attributes. >SHOW MAP address attribute type BF read write IO FF code read write internal RAM FFF read write user FFFF code read internal ROM(image) F FBFFFF code read internal ROM FD FFFFFF code read internal ROM undefined area : guard setup possibility : user = 3 emulation = 2 25

40 CHAPTER 1 Environment Setup Commands 1.20 CANCEL MAP The CANCEL MAP command assigns the undefined attribute to the specified address area. CANCEL MAP {address address-range} Parameters address (address formula) Specify the address where undefined attribute to be assigned. address-range (address formula) Specify the address range where undefined attribute to be assigned. Command qualifier /ALL Assigns undefined attribute to all set maps. The CANCEL MAP command assigns the undefined attribute to the specified address area. >CANCEL MAP/ALL 26

41 CHAPTER 1 Environment Setup Commands 1.21 ENABLE VERIFYMODE The ENABLE VERIFYMODE command enables the verify mode used when memory is written by a command. ENABLE VERIFYMODE The ENABLE VERIFYMODE command enables the verify mode used when memory is written by a command. The verify mode is enabled when the debugger is started. >ENABLE VERIFYMODE 27

42 CHAPTER 1 Environment Setup Commands 1.22 DISABLE VERIFYMODE The DISABLE VERIFYMODE command disables the verify mode used when memory is written by a command. DISABLE VERIFYMODE The DISABLE VERIFYMODE command disables the verify mode used when memory is written by a command. The verify mode is enabled when the debugger is started. >DISABLE VERIFYMODE 28

43 CHAPTER 1 Environment Setup Commands 1.23 SHOW VERIFYMODE The SHOW VERIFYMODE command displays the status of the verify mode. SHOW VERIFYMODE The SHOW VERIFYMODE command displays the status of the verify mode. (mode in which verify operation enabled or disabled is displayed when memory is written by a command) >SHOW VERIFYMODE verify mode: enable 29

44 CHAPTER 1 Environment Setup Commands 1.24 SET INPORT The SET INPORT command specifies data input for the specified port. SET INPORT port-address, bit-pattern, data-input-source [, cycle-count] Parameters port-address Specify the port address. mask-data Specify the mask data. Only 1 mask data bit can be used as port data. data-input-source Specify the data input source (file name, input terminal) when program reads data from input port or when count of program instruction execution cycles exceeds specified cycle count. Specify $TERMINAL as input terminal. $TERMINAL cannot be specified as file name. cycle-count (default: decimal number) Specify the count of program instruction execution cycles (H'1 to H'FFFFFFFF). Command qualifiers Specifying access attribute /BYTE (default when omitted) Specifies port access when specified address accessed 1 byte. /WORD Specifies port access when specified address accessed 2 bytes. /LONG Specifies port access when specified address accessed 4 bytes 30

45 CHAPTER 1 Environment Setup Commands /ASCII Uses character codes of input data as input values. When /ASCII is specified, the access size is always /BYTE. The SET INPORT command specifies data input to a port each time the program reads data from the specified port or each time the count of program instruction execution cycles exceeds the specified cycle count. When cycle-count is not specified in the parameters, data is read from the specified data input source each time the program reads data from the input port. When cycle-count is specified in the parameters, port contents are updated per fixed cycle irrespective of port access. If data-input-source is a file, data input processing returns to the beginning of the file when the last data is entered. If data-input-source is a input terminal ($TERMINAL), the dialog box for data input request is displayed when the set port is read-accessed. When this dialog box appears, enter the input data. Up to 4096 port addresses can be simulated. >SET INPORT 0, 1F, INBUF0. DAT >SHOW INPORT address bit pattern size cycle input F byte INBUF0. DAT 00004F 00000F ascii $terminal 31

46 CHAPTER 1 Environment Setup Commands 1.25 SHOW INPORT The SHOW INPORT command displays the data set by the SET INPORT command. SHOW INPORT The SHOW INPORT command displays the data set by the SET INPORT command. >SHOW INPORT address bit pattern size cycle input 0000FF 0000FF byte $terminal 00004F 00000F ascii $terminal 32

47 CHAPTER 1 Environment Setup Commands 1.26 CANCEL INPORT The CANCEL INPORT command cancels simulation of specified port address. CANCEL INPORT [port-address [,...] ] Parameter port-address Specify the port address. Command qualifier /ALL Cancels all data set by SET INPORT command. The CANCEL INPORT command cancels simulation of specified port address. >CANCEL INPORT/ALL 33

48 CHAPTER 1 Environment Setup Commands 1.27 SET OUTPORT The SET OUTPORT command specifies data output to the specified port. SET OUTPORT port-address, bit-pattern, data-output-destination Parameters port-address Specify the port address. Mask-data Specify the mask data. Only 1 mask data bit can be used as port data. data-output-destination Specify the data output destination (file name, output terminal) where data written to output port by program to be stored. Specify $TERMINAL as the output terminal. $TERMINAL cannot be specified as the file name. The same file name cannot be used. Command qualifiers Specifying access attribute /BYTE (default when omitted) Specifies port access when specified address accessed 1 byte. /WORD Specifies port access when specified address accessed 2 bytes. /LONG Specifies port access when specified address accessed 4 bytes. 34

49 CHAPTER 1 Environment Setup Commands /ASCII When data-output-destination is $TERMINAL, the debugger converts the data output to the port (regarded as ASCII codes) to characters and displays them on the screen. When data-output-destination is a file, the debugger outputs binary codes as they are. When /ASCII is specified, the access size is always /BYTE. The SET OUTPORT command specifies that data is to be stored in the specified data output destination each time the program writes data to the specified port. If the disk becomes full when data-output-destination is a file, the debugger displays the error message and does not store the subsequent data in the file. When data-output-destination is a output terminal ($TERMINAL), the debugger displays the data output to the port on the screen in hexadecimal number. However, when command qualifier /ASCII is specified, the debugger displays the output data in characters because the debugger treats the output data as character codes. Up to 4096 port addresses can be simulated. >SET OUTPORT 0, 3F, OU1. DAT >SHOW OUTPORT address bit pattern size output F byte OU1. DAT FF ascii $TERMINAL 35

50 CHAPTER 1 Environment Setup Commands 1.28 SHOW OUTPORT The SHOW OUTPORT command displays the data set by the SET OUTPORT command. SHOW OUTPORT The SHOW OUTPORT command displays the data set by the SET OUTPORT command. >SHOW OUTPORT address bit pattern size output F byte OU1. DAT FF ascii $TERMINAL 36

51 CHAPTER 1 Environment Setup Commands 1.29 CANCEL OUTPORT The CANCEL OUTPORT command cancels the simulation of the specified port address. CANCEL OUTPORT [port address [,...] ] Parameter port-address Specify the port address. Command qualifier /ALL Cancels simulation of port set by SET OUTPORT command. The CANCEL OUTPORT command cancels the simulation of the specified port address. >CANCEL OUTPORT/ALL 37

52 CHAPTER 1 Environment Setup Commands 1.30 SET INTERRUPT The SET INTERRUPT command sets interrupt-generation condition. SET INTERRUPT interrupt number, cycle count Parameters interrupt-number (default : decimal number) Specify the interrupt vector number. For usable interrupts, refer to the manual for the chip being used. cycle-count (default decimal number) Specify the count of program instruction execution cycles (H'1 to H'FFFFFFFF). Command qualifier /INTERVAL Specifies cyclic generation of interrupts. When the program is executed for the specified count of instruction execution cycles or more, the SET INTERRUPT command causes the specified interrupt and cancels the interrupt-generation condition. When /INTERVAL is specified, the specified interrupt is generated per specified count of instruction execution cycles during program execution. The interrupt-generation condition is valid until it is cancelled by the CANCEL INTERRUPT command. >SET INTERRUPT 4,

53 CHAPTER 1 Environment Setup Commands 1.31 SHOW INTERRUPT The SHOW INTERRUPT command displays the interrupt-generation condition set by the SET INTERRUPT command. SHOW INTERRUPT The SHOW INTERRUPT command displays the interrupt vector number, cycle count (decimal number), and INTERVAL set by the SET INTERRUPT command in this order. INTERVAL specifies any of the following: shot: Without INTERVAL (specifies single interrupt generation). Interval: With INTERVAL (specifies repetitive interrupt generation). >SHOW INTERRUPT no cycle kind shot interval 39

54 CHAPTER 1 Environment Setup Commands 1.32 CANCEL INTERRUPT The CANCEL INTERRUPT command cancels all the interrupt-generation conditions. CANCEL INTERRUPT [interrupt number [,...] ] Parameter interrupt-number (default : decimal number) Specify the interrupt vector number. Command qualifier /ALL Cancels all interrupt-generation conditions set by SET INTERRUPT command. The CANCEL INTERRUPT command cancels all the interrupt-generation conditions set by the SET INTERRUPT command. >CANCEL INTERRUPT/ALL 40

55 CHAPTER 1 Environment Setup Commands 1.33 SET VECTOR The SET VECTOR command sets the vector number data. SET VECTOR vector-number, address-value Parameters vector-number Specify the number of vector to be set. address-value Specify the starting address value of routine corresponding to specified vector number. The SET VECTOR command sets the address value of the vector number in the specified area. >SET VECTOR 11,FF1000 >SHOW VECTOR VectorNo. Address Symbol Factor 11 FF1000 timebase timer 41

56 CHAPTER 1 Environment Setup Commands 1.34 SHOW VECTOR The SHOW VECTOR command displays vector number data. SHOW VECTOR [vector-number-range] Parameter vector-table-range Specify the range of vector numbers to be displayed. Specify range in "[starting-number..ending-number]" format. The SHOW VECTOR command displays vector number data. If vector-number-range specifying is omitted, vector number display is started from the next vector number. >SHOW VECTOR VectorNo. address Symbol Factor 9 FF0000 start INT exception 11 FF1000 timebase timer external interrupt INT CAN #0 (receive complete) 42

57 CHAPTER 1 Environment Setup Commands 1.35 ENABLE WATCHDOG The ENABLE WATCHDOG command enables a watchdog timer. ENABLE WATCHDOG The ENABLE WATCHDOG command enables a watchdog timer. >ENABLE WATCHDOG 43

58 CHAPTER 1 Environment Setup Commands 1.36 DISABLE WATCHDOG The DISABLE WATCHDOG command disables a watchdog timer. DISABLE WATCHDOG The DISABLE WATCHDOG command disables a watchdog timer. >DISABLE WATCHDOG 44

59 CHAPTER 1 Environment Setup Commands 1.37 SHOW WATCHDOG The SHOW WATCHDOG command displays the enabled/disabled state of a watchdog timer. SHOW WATCHDOG The SHOW WATCHDOG command displays the enabled/disabled state of a watchdog timer. >SHOW WATCHDOG watchdog: enable 45

60 CHAPTER 1 Environment Setup Commands 1.38 SET WATCH The specified variable is registered to the watch window. SET WATCH Variable name [, Watch window number] Parameter Variable name The variable or the expression registered in the watch window is specified. Watch window number The number of the watch window where the variable is added is specified. Watch window 1 is specified when omitting it. Command qualifier Cardinal number /BINARY It is specified to display the variable value by the binary number. /OCTAL It is specified to display the variable value by the octal number. /DECIMAL It is specified to display the variable value by the decimal number. /HEXADECIMAL It is specified to display the variable value by the hexadecimal number. Watch mode /AUTOMATIC It interprets it in the watch mode to which the variable is set in the debugging environment. When the setting of the debugging environment is changed, the watch mode of the variable is changed. 46

61 CHAPTER 1 Environment Setup Commands /C The variable is interpreted as a C/C++ language type. /ASSEMBLER The variable is interpreted as an assembler type. Data size /BYTE It is specified to make the display at the assembler mode one byte length. /WORD It is specified to make the display at the assembler mode two byte lengths. /LONG It is specified to make the display at the assembler mode four byte lengths. /SINGLE It is specified to make the display at the assembler mode a single precision floating point number. /DOUBLE It is specified to make the display at the assembler mode a double precision floating point number. Individual monitor setting /MONITORING (Default when omitting it) The individual monitor setting of the variable is turned on. /NOMONITORING The individual monitor setting of the variable is turned off. It registers to the watch window for which the variable was specified. When the variable that has already been registered is specified, two or more same variables are registered. When the command qualifier of the cardinal number, the watch mode, and the data size is omitted, it becomes set specified in the debugging environment. Only when/assembler setting is specified, the specification of the data size is enable. When the debugger starts, information before is restored as for the setting of the watch point. First of all, please delete all the watch points with CANCEL WATCH/ALL etc., when you set the watch point with the batch file when the debugger starts. >SET WATCH strsym.a,1 >SET WATCH/HEXADECIMAL/ASSEMBLER/WORD/NOMONITORING LABEL1,1 47

62 CHAPTER 1 Environment Setup Commands 1.39 CANCEL WATCH The specified variable is deleted from the watch window. CANCEL WATCH Variable name [, Watch window number] CANCEL WATCH /ALL [Watch window number] Parameter Variable name The variable or the expression deleted from the watch window is specified. Watch window number The number of the watch window where the variable is deleted is specified. Watch window 1 is specified when omitting it. Command qualifier /ALL All the watch points are deleted from the specified window. The variable of the specified watch window is deleted. When two or more variables of this name exist, only the variable that appears first is deleted. >CANCEL WATCH flag,1 >CANCEL WATCH/ALL 2 48

63 CHAPTER 2 Program Execution Commands This chapter describes the program execution commands. 2.1 GO 2.2 SET GO 2.3 SHOW GO 2.4 STEP 2.5 SET STEP 2.6 SHOW STEP 2.7 CALL 2.8 CLEAR CALL 2.9 SHOW STATUS 49

64 CHAPTER 2 Program Execution Commands 2.1 GO The GO command executes the program from the specified starting address. GO [starting-address] [, break-address1] [, break-address2] Parameters starting-address (address formula) Specify the address at which program execution started. break-address (address formula) Specify the address at which program execution stopped. Command qualifiers Return setting /RETURN Executes program from function currently being executed to parent function return location. Only programs coded in C/C++ can use this function. The optimized program may not be stopped normally. Setting interrupt mask /MASK Masks interrupt. /NOMASK Does not mask interrupt. [MB2141/MB ] Trace control /ENABLETRACE Enables trace function at start of program execution. /DISABLETRACE Disables trace function at start of program execution. 50

65 CHAPTER 2 Program Execution Commands The GO command executes the program from the specified starting address. If starting-address specifying is omitted, the program is executed from the address indicated by the current program counter. The break address set by the GO command is automatically deleted when program execution is stopped. The command qualifiers, /ENABLETRACE and /DISABLETRACE, are specified for trace control by a sequencer. If a command qualifiers is omitted, program execution will start as set by the SET GO command. >GO power$20 Break at main$10 >GO power$20, main$5 51

66 CHAPTER 2 Program Execution Commands 2.2 SET GO The SET GO command specifies the execution conditions for the GO command as command qualifiers are omitted. SET GO Command qualifiers Setting interrupt mask /MASK Masks interrupt. /NOMASK (default at start-up) Does not mask interrupt. [MB2141/MB ] Trace control /ENABLETRACE (default at start-up) Enables trace function at start of program execution. /DISABLETRACE Disables trace function at start of program execution. The SET GO command specifies the execution conditions for the GO command as command qualifiers are omitted. >SET GO /MASK >GO 52

67 CHAPTER 2 Program Execution Commands 2.3 SHOW GO The SHOW GO command displays the current execution conditions (SET GO command settings) for the GO command. SHOW GO The SHOW GO command displays the current execution conditions (SET GO command settings) for the GO command. >SHOW GO go mode: nomask, enabletrace 53

68 CHAPTER 2 Program Execution Commands 2.4 STEP The STEP command executes the program in units of source lines or machine instructions according to the condition set by the SET STEP command. STEP [step count] Parameter step-count (default: decimal number) Specify the count of STEP command executed (H'1 to H'FFFFFFFF). If step-count specifying is omitted, the count of times is 1. Command qualifiers Specification of the STEP unit /INSTRUCTION Executes program in the unit of a machine instruction. /LINE Executes program in units of source lines. /AUTOMATIC (default at start-up) Automatically changes execution unit according to source window display mode as follows: When the source window display mode is the source line display mode, the program is executed in units of source lines (/LINE). When the source window display mode is another display mode, the program is executed in units of machine instructions (/INSTRUCTION). Specification of the STEP operation /INTO Executes program for each step in called function, subroutine, or interrupt handler. /OVER Executes function call and subroutine call instructions (i.e., CALL) and software interrupt instructions (i.e., INT) as one step. 54

69 CHAPTER 2 Program Execution Commands Function call is valid when /LINE is specified. Subroutine call instructions and software interrupt instructions are valid when /INSTRUCTION is specified. /MASK Masks interrupt. /NOMASK (default at start-up) Does not mask interrupt. Specification of STEP/OVER using the INTP instruction /INTPSKIP Executes STEP/OVER by using the INTP instruction. /NOINTPSKIP Does not execute STEP/OVER by using the INTP instruction. The STEP command executes the program in units of source lines or machine instructions according to the condition set by the SET STEP command. The condition set by the SET STEP command can be ignored by specifying a command qualifier. >STEP >STEP/INSTRUCTION 55

70 CHAPTER 2 Program Execution Commands 2.5 SET STEP The SET STEP command specifies the step execution condition when no command qualifier is specified in the STEP command. SET STEP Command qualifiers Step unit specification /INSTRUCTION Executes program in the unit of a machine instruction. /LINE Executes program in units of source lines. /AUTOMATIC (default at start-up) Automatically changes execution unit according to source window display mode as follows: When the source window display mode is the source line display mode, the program is executed in units of source lines (/LINE). When the source window display mode is another display mode, the program is executed in units of machine instructions (/INSTRUCTION). Step operation specification /INTO (default at start-up) Executes program for each step in called function, subroutine, or interrupt handler. /OVER Executes function call and subroutine call instructions (i.e., CALL) and software interrupt instructions (i.e., INT) as one step. Function call is valid when /LINE is specified. Subroutine call instructions and software interrupt instructions are valid when /INSTRUCTION is specified. 56

71 CHAPTER 2 Program Execution Commands Interrupt mask specification /MASK Masks interrupt /NOMASK (default at start-up) Does not mask interrupt. Specification of STEP/OVER using the INTP instruction. /INTPSKIP Executes STEP/OVER by using the INTP instruction. /NOINTPSKIP Does not execute STEP/OVER by using the INTP instruction. The SET STEP command specifies the step execution condition when no command qualifier is specified in the STEP command. When the Softune workbench is started, the step execution condition is AUTOMATIC, INTO. >SET STEP/INSTRUCTION 57

72 CHAPTER 2 Program Execution Commands 2.6 SHOW STEP The SHOW STEP command displays the step execution condition of the current STEP command. SHOW STEP The SHOW STEP command displays the step execution condition of the current STEP command. >SHOW STEP step mode: instruction, into 58

73 CHAPTER 2 Program Execution Commands 2.7 CALL The CALL command executes the specified function and displays a return value. (However, if the return value is of structure or union or class type, an error occurs). CALL function-name ([argument [,...] ]) Parameters function-name Specify the name of function to be called. argument Complies with C/C++ arguments. However, structures, unions and class cannot be specified as variable names. Command qualifiers /DISPLAY (Default at start-up) Sets a return value displayed. /NODISPLAY Sets a return value not displayed. The CALL command executes the specified function and displays a return value. (However, if the return value is structure, union or class type, an error occurs). The CALL command can be used only when the program coded in C/C++ is compiled with debug information. If a breakpoint is reached when a function is being executed by the CALL command, the program breaks at that position. CALL command execution is continued by subsequently restarting program execution with the GO command. To suspend CALL command execution, use the CLEAR CALL command. The CALL command cannot be nested. 59

74 CHAPTER 2 Program Execution Commands The register and flag values before the function is called are retained. These values are restored to the original values after the function has been executed. The argument of the specified function is evaluated and executed in dummy argument type. If the count of specified actual arguments is greater than that of dummy arguments, extra actual arguments are evaluated in int type. The return value is set in built-in variable %CALL. The CALL command sets a breakpoint at the address indicated by the current program counter and sets the return address at the address so that control will return to the breakpoint. The command then calls the function. For this reason, if the function executed by the CALL command accidentally passes the address indicated by the current program counter, the program will break in the middle of the function. In this case, the following message is displayed: Break at address by Invalid call termination CALL command execution is continued by restarting program execution with the GO command. >CALL debug (cmd, p) return value is H'

75 CHAPTER 2 Program Execution Commands 2.8 CLEAR CALL The CLEAR CALL command cancels the CALL command and restores the status set before the register is called. CLEAR CALL The CLEAR CALL command cancels the CALL command and restores the status set before the register is called. >CALL debug (cmd, p) Break at FF0F20 by breakpoint >CLEAR CALL 61

76 CHAPTER 2 Program Execution Commands 2.9 SHOW STATUS The SHOW STATUS command displays the MCU execution status. SHOW STATUS The SHOW STATUS command displays the MCU execution status. If the MCU breaks, the command displays the break factor of the immediately-preceding program execution. >SHOW STATUS MCU status: executing >SHOW STATUS break at 00FF00 by breakpoint 62

77 CHAPTER 3 Break/Event Control Command This chapter describes the break/event control commands. 3.1 SET BREAK (type 1) 3.2 SET BREAK (type 2) 3.3 SHOW BREAK 3.4 CANCEL BREAK 3.5 ENABLE BREAK 3.6 DISABLE BREAK 3.7 SET DATABREAK (type 1) 3.8 SET DATABREAK (type 2) 3.9 SHOW DATABREAK 3.10 CANCEL DATABREAK 3.11 ENABLE DATABREAK 3.12 DISABLE DATABREAK 3.13 SET XBREAK 3.14 SHOW XBREAK 3.15 CANCEL XBREAK 3.16 SET SBREAK 3.17 SHOW SBREAK 3.18 CANCEL SBREAK 3.19 SET EVENT (type 1) 3.20 SET EVENT (type 2) 3.21 SHOW EVENT 63

78 CHAPTER 3 Break/Event Control Command 3.22 CANCEL EVENT 3.23 ENABLE EVENT 3.24 DISABLE EVENT 3.25 SET SEQUENCE (type 1) 3.26 SET SEQUENCE (type 2) 3.27 SHOW SEQUENCE (type 1) 3.28 SHOW SEQUENCE (type 2) 3.29 CANCEL SEQUENCE 3.30 ENABLE SEQUENCE 3.31 DISABLE SEQUENCE 3.32 SET DELAY 3.33 SHOW DELAY 3.34 SET TRIGGER 3.35 SHOW TRIGGER 64