CamelForth

This is an implementation of Camel Forth, ported to the RCA 1802 8-bit processor by Harold Rabbie. The data sheet describing the instruction set of this processor is available at http://www.intersil.com/data/fn/fn1441.pdf



Files included in this archive

RCA 1802 Assembler source code files:

camel18.asm FORTH primitives and inner interpreter
camel18d.asm CPU and Model Dependencies
camel18h.asm High level words

1802sim.c C source code for an 1802 CPU simulator (for Cygwin or Linux)
makefile makefile for Cygwin
Readme.txt The file you're reading now


Building the CamelForth system

This requires the Pseudo-SAM 1802 cross assembler for MS-DOS (ps18a12.zip), available in the Development Tools section of the Downloads area.



Typing "make" in Cygwin cross-assembles the RCA1802 source code and generates two files:

CF1802.OBJ Intel hex object code
CF1802.LST Assembly listing

Simulating Forth on the RCA 1802

"make" also builds the RCA 1802 instruction-level simulator, which allows a Linux or Cygwin host PC to simulate object code running on RCA 1802 hardware.

The simulator emulates Forth EMIT and ACCEPT using standard output and standard input.

"make run" runs the simulation of the CamelForth system

The Forth word TRACE controls simulator tracing at run-time:
1 TRACE turns on Forth-level tracing
2 TRACE turns on Instruction-level tracing
0 TRACE turns off all tracing