Skip to content

wtetzner/waterbear

Repository files navigation

Build Status Donate

waterbear

Waterbear is an assembler for the Dreamcast VMU. It can be used either as a library or as a command-line program.

Documentation

The documentation for waterbear can be viewed here.

Usage

To assemble a file, use the waterbear assemble command:

waterbear assemble example.s -o example.vms

For help, run waterbear help:

% waterbear help
waterbear 0.18.0
Assembler for the Dreamcast VMU

USAGE:
    waterbear [SUBCOMMAND]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

SUBCOMMANDS:
    assemble       Assembler for the Dreamcast VMU
    disassemble    Disassembler for the Dreamcast VMU
    help           Prints this message or the help of the given subcommand(s)

The help command can be used on subcommands as well:

% waterbear help assemble
waterbear.exe-assemble
Assembler for the Dreamcast VMU

USAGE:
    waterbear.exe assemble <INPUT> --output <OUTPUT>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -o, --output <OUTPUT>    Output file

ARGS:
    <INPUT>    Sets the input file to assemble

Building

Make sure you have Rust/Cargo installed: https://rustup.rs/

Ensure you have the latest version of Rust:

$ rustup update stable

Build using Cargo:

$ cargo build --release

Credits

These are people who have either directly or indirectly helped with the development of waterbear.

Name Contribution
Falco Girgis ElysianVMU - VMU Emulator
Kresna Susila VMU assembly programmer/game developer
Marcus Comstedt Author of the aslc86k assembler, softvms emulator, hardware documentation, and tetris VMU game
John Maushammer Author of the lcdis disassembler

Copyright © 2015-2023 Walter Tetzner