Introduction to arrayForth™
This section is intended to acquaint you with colorForth and to give you enough information to install and operate colorForth. It then goes on to explain the use of the arrayForth tools that are provided to facilitate the writing and testing of software for GreenArrays chips. The following outline serves as a table of contents for the documentation.
Getting Started
Information useful to someone who is considering use of colorForth for the first time, or on a new platform; or who needs to check for recent changes.
Using colorForth
Basics
In order to do anything at all, you will need to know how to communicate with the system and how to run programs:
arrayForth Self Test
Once you have familiarized yourself with the human interface and the Interpreter, and before you begin learning to use the Editor and other capabilities, we recommend that you perform a simple self test procedure to verify that the system worked as you received it. Take the following steps after executing the program and getting the colorForth logo:
- Type
softsim
- You will see the instruction level simulator display, with small characters, lots of numbers, and a control panel hinting area.
- Press the button hinted as "g", which is under your left middle finger when your hand is in home position.
- Observe that the simulator is now running. What you see going on will depend on which chip is supported by the system you are running, but the simulation should be going on with a self replicating code module making its way through the chip.
The above serves as our equivalent to the classical "hello world" but as a way to inspire more confidence we chose to do something a bit more demanding... and relevant.
Now, let's learn what's needed so that you can see your code running in softsim or real chips!
Working with Source
If you will be creating or modifing code for the F18 or the PC, or interpretive scripts for utilities, you will need to learn how to edit colorForth source code and to manage collections of source code on mass storage.
Running the F18 Utilities
This section explains the operation of softsim and the interactive development environment for the F18 computers in the GreenArray Chips. Actual programming of the F18 and PC in colorForth is described later.
- softsim is an instruction level simulator for GreenArrays chips, using code you compile for ROM and/or RAM, and with provision for adding testbeds to simulate I/O.extend softsim to allow you to define and simulate external peripherals to interact with using I/O pins.
- Interactive Development Environment (IDE) for running and debugging code using real live chips.
- Support for multichip environments
Programming the F18
This section is a tutorial for those wishing to write code for our chips.
- Disk space assignment
- Style
- Instruction Set
- Code Library
- Information on Specific Chips
- GA32(31) 1.0 Shuttle Run 3-5/09
- Data Sheet
- Chip Poster
- Hardware Specifics
- ROM code
- Usage Rules
- GA4 1.1 Shuttle Run 5-7/09
- Data Sheet
- Chip Poster
- Hardware Specifics
- ROM code
- Usage Rules
- GA144 1.0 Shuttle Run 8-10/09
- Data Sheet
- Chip Poster
- Hardware Specifics
- ROM code
- Usage Rules
- GA4 1.2 Shuttle Run 8-10/09
- Data Sheet
- Chip Poster
- Hardware Specifics
- ROM code
- Usage Rules
Programming the PC
This section focuses on PC programming solely to support the GreenArrays chips, rather than general purpose colorForth programming for the PC.
Useful Reference Documents
Sometimes it helps to have a "cheat sheet" handy; many of us, for example, keep chip posters taped to the wall where we work. The following colorForth cheat sheets, referenced in the above material, are collected here so you can find them easily: