https://github.com/wtetzner/waterbear

Assembler/Disassembler for the Dreamcast VMU
https://github.com/wtetzner/waterbear

asm assembler assembly cargo disassembler disassembly dreamcast dreamcast-vmu embedded game-dev game-development homebrew rust vmu waterbear

Last synced: 2 months ago
JSON representation

Assembler/Disassembler for the Dreamcast VMU

• Host: GitHub
• URL: https://github.com/wtetzner/waterbear
• Owner: wtetzner
• License: apache-2.0
• Created: 2018-07-20T15:51:31.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-06-14T22:16:31.000Z (7 months ago)
• Last Synced: 2024-08-02T14:05:09.252Z (5 months ago)
• Topics: asm, assembler, assembly, cargo, disassembler, disassembly, dreamcast, dreamcast-vmu, embedded, game-dev, game-development, homebrew, rust, vmu, waterbear
• Language: Rust
• Homepage:
• Size: 632 KB
• Stars: 53
• Watchers: 4
• Forks: 4
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-dreamcast - Waterbear - Cross-platform assembler and disassembler for the VMU by [Wtetzner](https://github.com/wtetzner) (VMU)

README

        
[![Build Status](https://travis-ci.org/wtetzner/waterbear.png?branch=master)](https://travis-ci.org/wtetzner/waterbear)

[![Donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/wtetzner/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](https://wtetzner.github.io/waterbear/).

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  --output 

    

    FLAGS:

        -h, --help       Prints help information

        -V, --version    Prints version information

    

    OPTIONS:

        -o, --output     Output file

    

    ARGS:

            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](http://www.elysianshadows.com/) | [ElysianVMU](http://evmu.elysianshadows.com/) - VMU Emulator                 |

| [Kresna Susila](http://slum.online/dreamcast/) | VMU assembly programmer/[game developer](http://slum.online/dreamcast/nvmu/) |

| [Marcus Comstedt](http://mc.pp.se/dc/)         | Author of the [aslc86k assembler](http://mc.pp.se/dc/sw.html), [softvms emulator](http://mc.pp.se/dc/sw.html), [hardware documentation](http://mc.pp.se/dc/vms/), and [tetris](http://mc.pp.se/dc/files/tetris.s) VMU game |

| John Maushammer                                | Author of the [lcdis](http://mc.pp.se/dc/sw.html) disassembler               |

Copyright © 2015-2023 Walter Tetzner