CHAPTER 8 D EBUGGER
8.9 Command Reference
8.9.3 Program Memory Operation
a / as (assemble mnemonic)
Function
This command assembles the input mnemonic and rewrites the corresponding code to the program memory at the specified address.
Format
(1) >a <address> <mnemonic>[<file name>]↵ (direct input mode)
(2) >a [<address>]↵ (guidance mode)
Start address ? : <address>↵ ... Displayed only when <address> is omitted.
Address Original code Original mnemonic : <mnemonic>↵
...
>
<address>: Start address from which to write code; hexadecimal or symbol (IEEE-695 format only)
<mnemonic>: Input mnemonic; valid mnemonic of E0C63000 (expression and symbols are supported)
<file name>: File in which the symbol used in the operand was defined.
Condition: 0 ≤ address ≤ last program memory address
Examples Format (1)
>a 200 "ld %a,f"↵ ... Assembles "LD %A,0xF" and rewrites the code at address 0x200.
Format (2)
>a↵
Start address ? 200↵ ... Address is input.
0200 1ff6 ld %a,%f : add %a,%b↵ ... Mnemonic is input.
Source file name (enter to ignore) ?↵ ... Ignored ∗
0201 1fff *nop : ^↵ ... Returned to previous address.
0200 1972 add %a,%b : ↵ ... Input is skipped.
0201 1fff *nop : q↵ ... Command is terminated.
>
∗Source file name should be entered when a symbol/label is used as the operand. Specify the source file name in which the symbol was defined.
0200 1972 add %a,%b : jr LOOP↵ ... Symbol is used.
Source file name (enter to ignore) ? main.s↵ ... Source file name is input.
Notes
• The a and as commands have the same function.
• The start address you specified must be within the range of the program 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 (no such symbol / symbol type error) An error results if the limit is exceeded.
Error : Address out of range, use 0-0xXXXX • An error results if the input mnemonic is invalid for E0C63000.
Error : illegal mnemonic
• 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 program memory is reached and gets a valid input other than "^↵", the command is terminated.
• When the contents of the program memory are modified using the a (as) command, the unassemble contents of the [Source] window are updated immediately.
• Although the contents of the unassemble display are modified by rewriting code, those of source display remain unchanged.
GUI utility None
pe (program memory enter)
Function
This command rewrites the contents of the specified address in the program memory with the input hexadecimal code.
Format
(1) >pe <address> <code1> [<code2> [...<code8>]]↵ (direct input mode)
(2) >pe [<address>]↵ (guidance mode)
Program enter address ? <address>↵ ... Displayed only when <address> is omitted.
Address Original code : <code>↵
...
>
<address>: Start address from which to write code; hexadecimal or symbol (IEEE-695 format only)
<code(1–8)>: Write code; hexadecimal (valid operation code of E0C63000) Condition: 0 ≤ address ≤ last program memory address, 0 ≤ input code ≤ 0x1fff
Examples Format (1)
>pe 200 1972↵ ... Rewrites the code at address 0x200 with 0x1972 (add %a, %b).
Format (2)
>pe↵
Program enter address ? 200↵ ... Address is input.
0200 1fff : 1972↵ ... Code is input.
0201 1fff : ↵ ... Address 0x201 is skipped.
0202 1fff : q↵ ... Command is terminated.
>
Notes
• The start address you specified must be within the range of the program memory area available with each microcomputer model.
An error results if the input one is not hexadecimal number or not a valid symbol.
Error : invalid value (no such symbol / symbol type error) An error results if the limit is exceeded.
Error : Address out of range, use 0-0xXXXX
• Code must be input using a hexadecimal number in the range of 13 bits (0 to 0x1fff).
An error results if the input one is not a hexadecimal number.
Error : invalid value
An error results if the input code exceeds the limit or it is invalidated in the .PAR file.
Error : illegal code
• 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 program memory is reached and gets a valid input other than "^↵", the command is terminated.
• When the contents of the program memory are modified using the pe command, the unassemble contents of the [Source] window are updated immediately.
• Although the contents of the unassemble display are modified by rewriting code, those of source display remain unchanged.
GUI utility None
pf (program memory fill)
Function
This command rewrites the contents of the specified program memory area with the specified code.
Format
(1) >pf <address1> <address2> <code>↵ (direct input mode)
(2) >pf↵ (guidance mode)
Start address ? <address1>↵ End address ? <address2>↵ Fill code ? <code>↵
>
<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)
<code>: Write code; hexadecimal (valid operation code of E0C63000)
Condition: 0 ≤ address1 ≤ address2 ≤ last program memory address, 0 ≤ code ≤ 0x1fff
Examples Format (1)
>pf 200 20f 1ffe↵ ... Fills the area from address 0x200 to address 0x20f with 0x1ffe (nop).
Format (2)
>pf↵
Start address ? 200↵ ... Start address is input.
End address ? 20f↵ ... End address is input.
Fill code ? 1fff↵ ... Code is input.
>
∗ Command execution can be canceled by entering only the [Enter] key and nothing else.
Notes
• The addresses specified here must be within the range of the program 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 (no such symbol / symbol type error) An error results if the limit is exceeded.
Error : Address out of range, use 0-0xXXXX • An error results if the start address is larger than the end address.
Error : end address < start address
• When the contents of the program memory is modified using the pf command, the contents of the [Source] window are updated automatically.
• Although the contents of the unassemble display are modified by rewriting code, those of source display remain unchanged.
GUI utility None
pm (program memory move)
Function
This command copies the content of a specified program memory area to another area.
Format
(1) >pm <address1> <address2> <address3>↵ (direct input mode)
(2) >pm↵ (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 program memory address
0 ≤ address3 ≤ last program memory address
Examples Format (1)
>pm 200 2ff 280↵ ... Copies the codes within the range from address 0x200 to address 0x2ff to the area from address 0x280.
Format (2)
>pm↵
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
• The addresses you specified must be within the range of the program 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 (no such symbol / symbol type error) An error results if the limit is exceeded.
Error : Address out of range, use 0-0xXXXX • An error results if the start address is larger than the end address.
Error : end address < start address
• When the contents of the program memory is modified using the pm command, the contents of the [Source] window are updated automatically.
• Although the contents of the unassemble display are modified by rewriting code, those of source display remain unchanged.
GUI utility None