A cross-platform simulator for the GreenArrays GA144 multi-computer chip.
Update fantasy README to be more achievable
+18
-11
+18
-11
README.md
+18
-11
README.md
···
17
17
## Usage
18
18
19
19
```bash
20
-
gasim examples/hello.blk
20
+
gasim examples/hello.node
21
21
```
22
22
23
-
This will launch the simulator with node 708 executing instructions streamed in
24
-
from `examples/hello.blk`.
23
+
Currently, this just launches the simulator with node 001's RAM and ROM loaded
24
+
with the contents of the provided binary file.
25
+
26
+
The expected file format is 288 8-bit bytes, with the first 144 bytes
27
+
containing the RAM contents and the next 144 bytes containing the ROM contents.
28
+
29
+
### TODO
30
+
31
+
- [ ] I/O
32
+
- [ ] ROM implementations
25
33
26
34
## Prior Art
27
35
28
-
* GreenArrays own SOFTSIM available in their free [arrayForth
36
+
- GreenArrays own SOFTSIM available in their free [arrayForth
29
37
distribution](https://www.greenarraychips.com/home/support/download-03d.php).
30
38
Works well under wine.
31
-
* [AshleyF/Color](https://github.com/AshleyF/Color) - A colorForth editor,
39
+
- [AshleyF/Color](https://github.com/AshleyF/Color) - A colorForth editor,
32
40
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.
41
+
- [mschuldt/ga144-sim](https://github.com/mschuldt/ga144-sim) - GA144 simulator
42
+
from an [alternative toolchain](https://github.com/mschuldt/ga-tools).
36
43
37
44
## References
38
45
39
-
* Incredibly informative [blog
46
+
- Incredibly informative [blog
40
47
series](https://github.com/AshleyF/Color/blob/master/Docs/chuck_moores_creations.md)
41
48
by [AshleyF](https://github.com/AshleyF) that introduces the F18 architecture
42
49
and instruction set.
43
-
* GreenArrays own concise, but very informative
50
+
- GreenArrays own concise, but very informative
44
51
[documentation](https://www.greenarraychips.com/home/documents/index.php) on
45
52
the GA144 chip and F18 architecture.
46
-
* [colorForth instruction
53
+
- [colorForth instruction
47
54
set](https://mschuldt.github.io/www.colorforth.com/inst.htm)