Skip to content
Assembler/Disassembler for the Dreamcast VMU
Rust
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
src
waterbear-instruction-derive
.gitignore
.travis.yml
Cargo.lock
Cargo.toml
LICENSE
README.md
build.rs

README.md

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.2.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-2019 Walter Tetzner

You can’t perform that action at this time.