https://github.com/axvonx/belle
BELLE (Big Endian, Low Level Emulator) The monorepo for a custom 16 bit RISC architecture.
https://github.com/axvonx/belle
16-bit big-endian cpu-emulator emulator risc rust
Last synced: 7 days ago
JSON representation
BELLE (Big Endian, Low Level Emulator) The monorepo for a custom 16 bit RISC architecture.
- Host: GitHub
- URL: https://github.com/axvonx/belle
- Owner: axvonx
- License: bsd-3-clause
- Created: 2024-11-28T21:45:04.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2026-04-19T02:05:15.000Z (about 2 months ago)
- Last Synced: 2026-04-19T04:05:37.466Z (about 2 months ago)
- Topics: 16-bit, big-endian, cpu-emulator, emulator, risc, rust
- Language: Rust
- Homepage: http://belle-cpu.xyz/
- Size: 5.26 MB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# belle - The complete program utility set for the Big Endian, Low Level Emulator
[](https://github.com/BlueGummi/belle/actions/workflows/ci.yml)
[](https://github.com/BlueGummi/belle/actions/workflows/publish.yml)
All documentation is available on [the website for this project](https://bluegummi.github.io/belle)
## A [PDF](https://github.com/BlueGummi/belle/blob/master/BELLE-ISA_Manual_v3.pdf) is also available
> Note: The PDF may be somewhat technical
## Quickstart
On **x86 Linux** systems, run
```bash
curl -s https://raw.githubusercontent.com/BlueGummi/belle/refs/heads/master/examples/binstall.sh | bash
```
On **macOS and other Unix systems**, run
```bash
git clone https://github.com/BlueGummi/belle --depth=1 && cd belle && ./build.sh -w && ./install.sh -c
```
AUR Installation - Binary
```bash
yay -S belle-cpu
```
And on Windows, run
```pwsh
irm ('https://raw.githubusercontent.com/BlueGummi/belle/refs/heads/master/examples/binstall.ps1') | iex
```
The binaries can be run by calling `basm`, `belle`, or `bdump`.
### NEW: Friendly compile-time errors in the assembler!
## [Further documentation](https://bluegummi.github.io/belle)
### BELLE and the BELLE utilities in action:
[](https://asciinema.org/a/699396)
## Naming
**BELLE** is the *emulator*, whilst **BELLE-ISA/ISABELLE** is the *instruction set*.
### Roadmap
Ordered from easy to complex
- [x] Implement error line printing for codegen errors on the assembler
- [x] Make colored disassembling consistent
- [x] Implement address printing for the disassembler
- [x] Implement hex printing for the disassembler
- [ ] Finish tutorials
- [x] Implement objdump-like jump visualization
- [ ] Forth-like language + compiler