1 User Manual Getting Started
David Banks edited this page 2016-07-13 16:45:57 +01:00

The only client side software that's needed is a simple terminal emulator, connected to the serial port at 57,600 baud.

On Linux, I use gtkterm:

gtkterm -p /dev/ttyUSB0 -s 57600

After powering up the target system, you should see:

ICE-T65 In-Circuit Emulator version 0.72
Compiled at 13:40:03 on Nov 15 2015
8 watches/breakpoints implemented
Tracing every 1 instructions while single stepping
CPU free running...

The emulator has two modes:

  • running mode, where it is executing target processor instructions
  • command mode, where it is the target processor is stopped, and the emulator is waiting for command input

The emulator powers up in the running mode, and the target system should run normally.

To change to command mode, just hit return, and you should see the command prompt:

Interrupted
09.678286: FE87 : LDA B000    
>>

The first field (09.678286) is the number of cycles of processor execution (in million cycles). If the target clock speed were 1MHz (which it is the Acorn Atom, this is also the number of seconds).

The second field (FE87) is the address of the current instruction.

The third field (LDA B000) is a disassembly of the current instruction.

At this point, you can list all the command available using the help (h) command.

>> help
ICE-T65 In-Circuit Emulator version 0.72
Compiled at 13:40:03 on Nov 15 2015
8 watches/breakpoints implemented
Commands:
    help
    continue
    regs
    dis
    fill
    crc
    mem
    rdm
    wrm
    test
    reset
    step
    trace
    blist
    breakx
    watchx
    breakrm
    watchrm
    breakwm
    watchwm
    clear
    trigger
>> 

Command can be abbreviated to their first few characters.

Each of the commands is described in the command reference section below.

To see the current value of the target processor registers, use the regs (r) command:

>> r
6502 Registers:
  A=01 X=00 Y=09 SP=00F4 PC=FE87
  Status: -V-B----

To single step a few instruction, use the step (s) command:

s 3
Stepping 3 instructions
13.840846: FE8A : AND #F0     
13.840848: FE8C : STA B000    
13.840852: FE8F : PLA         
>> 

To change back to running mode, use the continue (c) command.

>> c  
CPU free running...