Main page

Demo

.ssp [10] .sbp [10] .start [20] mov r6, 0 mov r7, 1 push r6 push r7 jmp @fib_loop fib_loop: pop r0 mov r5, 0 pop r7 pop r6 add r5, r7 add r5, r6 mov r6, r7 mov r7, r5 push r6 push r7 jo @finish int 5 jmp @fib_loop finish: hlt

Run

Quickstart

git clone https://github.com/BlueGummi/belle && cd belle

Cargo, RustC, GCC, and Makefile compatibility must be present on the system if these programs are to be installed.

Every executable in this repository can have the --help flag passed to display helpful information.

./build.sh -w && ./install.sh -c # This installs the binaries to ~/.local/bin on Unix OS's

Or, for Windows

.\build.ps1 -w && .\install.ps1 -c # This installs the binaries to ~/.local/bin on Windows

The binaries can be run by calling basm, belle, or bdump.

ISA (Instruction set) - docs/isa

Assembler - docs/basm.md

Emulator - docs/belle.md

Disassembler - docs/bdump.md

Utilities - docs/btils.md

BELLE and the BELLE utilities in action:

Naming

BELLE is the emulator, whilst BELLE-ISA/ISABELLE is the instruction set.

Statuses:

Inspiration

The Little Computer 3 - Inspired some of the design aspects of the BELLE-ISA and BELLE, particularly word-addressed memory and the 16-bit nature of the machine (it’s why “BELLE” has two L’s - it’s to honor the LC3)

Intel x86 assembly - Inspired the syntax for the assembly.