https://github.com/jjyr/jonesforth_riscv

Jonesforth RISC-V port.
https://github.com/jjyr/jonesforth_riscv

forth jonesforth riscv

Last synced: 2 months ago
JSON representation

Jonesforth RISC-V port.

• Host: GitHub
• URL: https://github.com/jjyr/jonesforth_riscv
• Owner: jjyr
• Created: 2020-10-04T14:41:26.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-12-30T17:26:35.000Z (about 4 years ago)
• Last Synced: 2024-08-05T17:24:33.705Z (5 months ago)
• Topics: forth, jonesforth, riscv
• Language: Assembly
• Homepage:
• Size: 448 KB
• Stars: 55
• Watchers: 7
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-hacking-lists - jjyr/jonesforth_riscv - Jonesforth RISC-V port. (Assembly)

README

        
# Jonesforth RISC-V

RISC-V 64 implementation of Jones forth.

The code is based on Richard WM Jones's excellent literate x86 assembly

implementation of Forth, more on which here:

http://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/

The x86 version source code is copied from a mirror repo: https://github.com/nornagon/jonesforth

The RISC-V version is rewritten by [JJy](https://justjjy.com), mostly modification is in the `jonesforth.S` file.

> The RISC-V version jonesforth is using RV64 instructions, so the WORD size and alignment is 8 bytes.

## Run

Run Qemu VM:

1. Start qemu RISC-V VM: `make qemu` - will outputs lots out logs, wait until complete the boot.

2. Push files to qemu VM: `make push-remote` - the files are under `/jonesforth`.

3. Connect to RISC-V VM: `make ssh`.

> The docker image is very large, you can build it locally if you can't download it from server https://github.com/jjyr/docker-riscv-qemu-fedora

Compile & Run:

1. Compile `make`.

2. Start REPL: `make run`.

3. Run all tests: `make test`

> We haven't passed all tests yet: [issue #1](https://github.com/jjyr/jonesforth_riscv/issues/1)

## RISC-V references

* [RISCV Specification](https://riscv.org/technical/specifications/)

* [RISC-V Assembly Programmer's Manual](https://github.com/riscv/riscv-asm-manual/blob/master/riscv-asm.md)