ASCII Monitor

VT 100 Setting: Reversed EF4, baud rate 300, 1800, 2000 or 2400.

ROM Filename: ascii.monitor.bin.

Note: Memory (M) command does NOT work, the bug might be in the 1802 code or in the Emma 02 emulator.

Bit-set

Format: B PD

This command will set one bit of a specific output port., P gives the output port number and D the bit number. E.g. B 30 will set bit 0 of output port 3 to 1. The same command will reset the same bit to 0.

Copy

Format: C start end destination

This command will copy the indicated block of memory (start to end) to the destination location. The monitor will check if enough RAM is available and if not give an error message. Overlap in the source and destination is handled by the monitor.

Dump

Format: D start end or D start end N

N is optional or can be '8' or 'A', When no value is given the indicated memory block will be shown in UT4 format. '8' will give a shortened UT4 format with 8 bytes per line. 'A' will show only ASCII characters.

Find

Format: F start end hex-string or F start end "ascii-string"

This command will search for the hex-string in the indicated memory block. The hex string can be one or more bytes, bytes that do not matter can be indicated with a '/'. E.g. F 4000 8000 C03B// will search for all long branches to 3Bxx in memory location hex 4000 to hex 8000.

8 locations will be shown after which the monitor will wait for a comma, ESC will return to the monitor any other key will continue the search.

ASCII search can be done in the same way by putting the string between double quotes. E.g. F 4000 8000 "EMU".

Jump

Format: J address or J

This command will jump into a program with R3 = PC, R2 = RX and IE = 0. If no address is given a jump to address 0 will be done.

Program

Format: P address or P

This command will start a program with the same conditions as after a reset or run, R0 = PC and RX and IE = 1. If no address is given address 0 will be used.

Memory

Format: M address or M

Note: this command does NOT work, the bug might be in the 1802 code or in the Emma 02 emulator.

After this command is given memory can be changed at the given address or when omitted at address 0. The current value is shown by the monitor which can be changed by typing a different byte after which the address will be incremented. A space will just move to the next address without making any change. Backspace or DEL will go back one address.

Register

Format: R N

This command will print register values at entry in the monitor and/or at a breakpoint.

Test

Format: T start end

This command will test RAM between indicated start and end.

Write

Format: W start end hex-string or W start end "ascii-string"

This command will write the hex-string or ascii-string to the memory between start and end.

Save

Format: S start end "name"

This command will save the memory block between start and end to tape including the indicated name.

Verify

Format: V "name"

This command will verify the recording on tape compared to what is in memory. The recording has to be recorded with the indicated name. If a different name is found it will be printed on the screen including start and end addresses, at this time the command can be stoped by ESC and continued by a 'CR'.

Load

Format: L "name"

This command will load the recording on tape compared to memory. The recording has to be recorded with the indicated name.