A cross-platform simulator for the GreenArrays GA144 multi-computer chip.
add README
+47
+47
README.md
+47
README.md
···
1
+
# gasim
2
+
3
+
A cross-platform simulator for the [GreenArrays,
4
+
Inc.](https://www.greenarraychips.com) [GA144 multi-computer
5
+
chip](https://www.greenarraychips.com/home/documents/index.php#GA144).
6
+
7
+
## Building
8
+
9
+
To build `gasim`, [zig 0.14.0](https://ziglang.org/download/) is required.
10
+
11
+
```bash
12
+
zig build -Doptimize=ReleaseFast
13
+
```
14
+
15
+
`gasim` executable will be available in `./zig-out/bin/gasim`.
16
+
17
+
## Usage
18
+
19
+
```bash
20
+
gasim examples/hello.blk
21
+
```
22
+
23
+
This will launch the simulator with node 708 executing instructions streamed in
24
+
from `examples/hello.blk`.
25
+
26
+
## Prior Art
27
+
28
+
* GreenArrays own SOFTSIM available in their free [arrayForth
29
+
distribution](https://www.greenarraychips.com/home/support/download-03d.php).
30
+
Works well under wine.
31
+
* [AshleyF/Color](https://github.com/AshleyF/Color) - A colorForth editor,
32
+
assembler and F18 simulator written in F#.
33
+
* [mschuldt/ga144-sim](https://github.com/mschuldt/ga144-sim) - GA144 simulator
34
+
from the [alternative toolchain](https://github.com/mschuldt/ga-tools) written
35
+
in Python.
36
+
37
+
## References
38
+
39
+
* Incredibly informative [blog
40
+
series](https://github.com/AshleyF/Color/blob/master/Docs/chuck_moores_creations.md)
41
+
by [AshleyF](https://github.com/AshleyF) that introduces the F18 architecture
42
+
and instruction set.
43
+
* GreenArrays own concise, but very informative
44
+
[documentation](https://www.greenarraychips.com/home/documents/index.php) on
45
+
the GA144 chip and F18 architecture.
46
+
* [colorForth instruction
47
+
set](https://mschuldt.github.io/www.colorforth.com/inst.htm)