CHAPTER 9 D EBUGGER
9.9 Command Reference
9.9.4 Data Memory Operation
dd (data memory dump)
Function
This command displays the content of the data memory in a 16 words/line hexadecimal dump format.
Format
>dd [<address1> [<address2>]]↵ (direct input mode)
<address1>: Start address to display; hexadecimal or symbol (IEEE-695 format only)
<address2>: End address to display; hexadecimal or symbol (IEEE-695 format only) Condition: 0 ≤ address1 ≤ address2 ≤ last data memory address
Display
(1) When [data] window is opened
If both <address1> and <address2> are not defined, the [Data] window is redisplayed beginning with address 0x000.
If <address1> is defined , or even <address2> is defined, the [Data] window is redisplayed in such a way that <address1> is displayed at the uppermost line.
Even when <address1> specifies somewhere in 16 addresses/line, data is displayed beginning with the top of that line. For example, even though you may have specified address 0x118 for <address1>, data is displayed beginning with address 0x110.
However, if an address near the uppermost part of data memory (e.g. maximum address is 0xfff), such as 0xff5, is specified as <address1>, the last line displayed in the window in this case is 0xff0, the specified address is not at the top of the window.
Since the [Data] window can be scrolled to show the entire data memory, defining <address2> does not have any specific effect. Only defining dress1> and both defining <address1> and <ad-dress2> has same display result.
(2) When [data] window is closed
If both <address1> and <address2> are not defined, the debugger displays data for 256 words from address 0x000 in the [Command] window.
>dd↵
"/" indicates an unused address. "!" indicates that the address contains write-only bits or read-only bits.
If only <address1> is defined, the debugger displays data for 256 words from <address1>.
If both <address1> and <address2> are defined, the debugger displays data from <address1> to
<address2>.
If a command execution is being output to a log file by the log command when you dump the data memory, 256 words of data are displayed in the [Command] window even if the [Data] window is opened and are also output to the log file.
Notes
• Both the start and end addresses specified here must be within the range of the data memory area available with each microcomputer model.
An error results if the input one is not a hexadecimal number or not a valid symbol.
Error : invalid value.
An error results if the limit is exceeded.
Error : address beyond data range.
• An error results if the start address is larger than the end address.
Error : end address < start address.
• The contents of the write-only I/O area cannot be read, but will be marked as hyphens (-).
For the contents of address of mixed read-only and write-only bits in I/O area, an exclamation mark (!) will be marked in front of the data.
The contents of the unused area will be marked as slashes (/).
GUI utility
[View | Data Dump] menu item
When this menu item is selected, the [Data] window opens or becomes active and displays the current data memory contents.
de (data memory enter)
Function
This command rewrites the contents of the data memory with the input hexadecimal data. Data can be written to continuous memory locations beginning with a specified address.
Format
(1) >de <address> <data1> [<data2> [...<data16>]]↵ (direct input mode)
(2) >de↵ (guidance mode)
Data enter address ? <address>↵ Address Original data : <data>↵
...
>
<address>: Start address from which to write data; hexadecimal or symbol (IEEE-695 format only)
<data(1–16)>: Write data; hexadecimal
Condition: 0 ≤ address ≤ last data memory address, 0 ≤ data ≤ 0xf
Examples Format (1)
>de 100 A↵ ... Rewrites data at address 0x100 with 0xa.
Format (2)
>de↵
Data enter address ? 100↵ ... Address is input.
100 0 : a↵ ... Data is input.
101 0 : ↵ ... Skipped.
102 0 : q↵ ... Command is terminated.
>
Notes
• The start address specified here must be within the range of the data memory area available with each microcomputer model.
An error results if the input one is not a hexadecimal number or a valid symbol.
Error : invalid value.
An error results if the limit is exceeded.
Error : address beyond data range.
• The contents of the read only area cannot be rewritten. A warning message will be displayed if you specify such an address.
Warning : read only address, can't write.
• In guidance mode, the contents of the write-only I/O area will be marked as hyphens (-).
For the contents of address of mixed read-only and write-only bits in I/O area, an exclamation mark (!) will be marked in front of the data.
The contents of the unused area will be marked as slashes (/). If you encounter any address marked by "/", press [Enter] key to skip that address or terminate the command.
• Data must be input using a hexadecimal number in the range of 4 bits (0 to 0xf). An error results if the limit is exceeded.
Error : data range (0 - 0xf).
• When the contents of the data memory is modified using the de command, the displayed contents of the [Data] window are updated automatically.
• In guidance mode, the following keyboard inputs have special meaning:
"q↵" … Command is terminated. (finish inputting and start execution)
"^↵" … Return to previous address.
"↵" … Input is skipped. (keep current value)
If the maximum address of data memory is reached and gets a valid input other than "^↵", the command is terminated.
GUI utility [Data] window
The [Data] window allows direct modification of data. Click the [Data] window and select the dis-played data to be modified then enter a hexadecimal number.
df (data memory fill)
Function
This command rewrites the contents of the specified data memory area with the specified data.
Format
(1) >df <address1> <address2> <data> ↵ (direct input mode)
(2) >df↵ (guidance mode)
Start address ? <address1>↵ End address ? <address2>↵ Fill data ? <data>↵
>
<address1>: Start address of specified range; hexadecimal or symbol (IEEE-695 format only)
<address2>: End address of specified range; hexadecimal or symbol (IEEE-695 format only)
<data>: Write data; hexadecimal
Condition: 0 ≤ address1 ≤ address2 ≤ last data memory address, 0 ≤ data ≤ 0xf
Examples Format (1)
>df 200 2FF 0↵ ... Fills the data memory area from address 0x200 to address 0x2ff with 0x0.
Format (2)
>df↵
Start address ? 200↵ ... Start address is input.
End address ? 2ff↵ ... End address is input.
Fill data ? 0↵ ... Data is input.
>
∗ Command execution can be canceled by entering only the [Enter] key and nothing else.
Notes
• Both the start and end addresses specified here must be within the range of the data memory area available with each microcomputer model.
An error results if the input one is not a hexadecimal number or a valid symbol.
Error : invalid value.
An error results if the limit is exceeded.
Error : address beyond data range.
• An error results if the start address is larger than the end address.
Error : end address < start address.
• Data must be input using a hexadecimal number in the range of 4 bits (0 to 0xf). An error results if the limit is exceeded.
Error : data range (0 - 0xf).
• Write operation is not performed to the read only address of the I/O area.
• When there is an unused area in the specified address range, no error occurs. The area other than the unused area will be filled with the specified data.
• When the contents of the data memory is modified using the df command, the displayed contents of the [Data] window are updated automatically.
GUI utility None
dm (data memory move)
Function
This command copies the contents of the specified data memory area to another area.
Format
(1) >dm <address1> <address2> <address3>↵ (direct input mode)
(2) >dm↵ (guidance mode)
Start address ? <address1>↵ End address ? <address2>↵ Destination address ? <address3>↵
>
<address1>: Start address of source area to be copied from; hexadecimal or symbol (IEEE-695 format only)
<address2>: End address of source area to be copied from; hexadecimal or symbol (IEEE-695 format only)
<address3>: Address of destination area to be copied to; hexadecimal or symbol (IEEE-695 format only) Condition: 0 ≤ address1 ≤ address2 ≤ last data memory address, 0 ≤ address3 ≤ last data memory address
Examples Format (1)
>dm 200 2FF 280↵ ... Copies data within the range from address 0x200 to address 0x2ff to the area from address 0x280.
Format (2)
>dm↵
Start address ? 200↵ ... Source area start address is input.
End address ? 2ff↵ ... Source area end address is input.
Destination address 280↵ ... Destination area start address is input.
>
∗ Command execution can be canceled by entering only the [Enter] key and nothing else.
Notes
• All the addresses specified here must be within the range of the data memory area available with each microcomputer model.
An error results if the input one is not a hexadecimal number or a valid symbol.
Error : invalid value.
An error results if the limit is exceeded.
Error : address beyond data range.
• Write operation is not performed to the read-only address of the I/O area.
• Data in the write-only area cannot be read. If the source area contains write-only address, 0 is written to the corresponding destination. If the destination area contains read-only address, the data of that address can not be rewritten. If the source and destination areas contain I/O address of mixed read-only bits and write-read-only bits, either read or write operation can be executed for the corresponding bits.
• An error results if there is an unused area in the specified source or destination area, and no copy operation will be done.
Error : no mapping area.
• When the contents of the data memory is modified using the dm command, the displayed contents of the [Data] window are updated automatically.
GUI utility None