J1 CPU emulator
J1 CPU emulator written in Rust.
Ported from j1 written in go.
requires rustup
build and install
$ cargo install --path .
executables
Help with executable arguments
| Name | Description |
|---|---|
| j1 | j1 emulator |
| j1_dump | dump j1 cpu memory in assembly or instruction AST format |
| j1_example_compile_and_dump | example of programmatically using j1 |
test
$ cargo test
document
$ cargo doc
# open j1-cpu/target/doc/j1/index.html with browser
# open j1-cpu/target/doc/j1/index.html with browser
run j1 eforth repl
# option -r or --repl
$ j1 --repl
$ j1 --repl
run j1 eforth repl with a script
# from j1-cpu directory
$ j1 --repl --script resources/simple.fth
$ j1 --repl --script resources/simple.fth
j1 options
# help -h or --help
# Note: results saved to-log.txt if not running repl
$ j1 -h
j1 1.0
Roy Crippen
J1 cpu emulator
USAGE:
j1 [FLAGS] [OPTIONS]
FLAGS:
-h, --help Prints help information
-r, --repl Run the J1 forth repl
-V, --version Prints version information
OPTIONS:
-b, --bin <bin_file> Binary J1 forth imamge to load
-s, --script <script_file> Forth script file to load and execute
# Note: results saved to
$ j1 -h
j1 1.0
Roy Crippen
J1 cpu emulator
USAGE:
j1 [FLAGS] [OPTIONS]
FLAGS:
-h, --help Prints help information
-r, --repl Run the J1 forth repl
-V, --version Prints version information
OPTIONS:
-b, --bin <bin_file> Binary J1 forth imamge to load
-s, --script <script_file> Forth script file to load and execute
todo
| Task | Done |
|---|---|
| stack | |
| instructions | |
| cpu | |
| dump memory to asm and ast | |
| j1 emulator | |
| arguments for j1 executable | |
| j1 gRPC service | |
| add verbosity levels |