VMU development

Overview

Developing standalone games for the VMU is both a challenging and rewarding development feat. On one hand, it's not the easiest embedded device or to target, given that it doesn't have a C compiler and has its own set of hardware eccentricities. On the other hand, the device features a rich instruction set, 3 different clock sources, a FAT filesystem, and many different peripherals which can be leveraged by a developer, making it something of a Sega Saturn of little 8-bit gaming devices.

While there is an active and ongoing effort within the scene to lower the barrier of entry into VMU development and to get more high-quality tutorials and materials out there for newbies, this page will hopefully serve as an entry point based on what is currently available.

Hardware

A high-level overview of the VMU's hardware and peripherals can be found here. A good initial look at application-development for the device can be found at Marcus Comstedt's VMU Programming Site. A combination of this site and the official File:VMU.pdf VMU Development Manual is typically what is referenced while programming for the VMU.

Programming

Since there is no C compiler for the VMU's 8-bit Sanyo CPU, development is traditionally done in Sanyo LC86k assembly language; however, it is now possible to write C code indirectly targeting the device via emulation of the ARM Cortex A23 CPU.

LC86k Assembly Code

The Waterbear assembler/disassembler is the favored tool for creating VMU binaries, as it is cross-platform, supports all undocumented opcodes and SFRs, and is still under active development. You can find it here.

C Code

Thanks to the uM23 emulator, it is now possible to indirectly write C code for the VMU. The code is cross-compiled for the ARM Cortex A23 target, and the resulting binary image is then loaded onto the VMU as a "DATA" file. The uM23 emulator, which must be loaded onto the device as the main "GAME" file, will then allow you to select an ARM binary image to run from its menu. More information can be found here.

Testing

Emulators

The favored emulator for VMU development and testing is the ElysianVMU emulator, as it is cross-platform, is ranked top for features and accuracy, and is still actively developed. The emulator also has an explicit goal of offering a debugging environment to facilitate development. Much of the debugger is still under active development; however, just features like the RAM and flash memory explorer widgets can be of great use during development. More information can be found here.

Physical Device

Before publishing or distributing your game, it is highly recommended that you still test on physical hardware. There are various ways through which one can get a GAME file onto the actual device depending on your Dreamcast's configuration and peripherals.

• DreamShell
• VMU Tool
• Web Browser

References

Here are some reference resources to get started

• Marcus Comstedt's VMU Programming Site
• link Dmitry.gr VMU hacking
• Slum Online development
• ElysianVMU - Emulator, File Manager, Debugger
• Waterbear - VMU Assembler, Disassembler, VMS tools
• VMU documentation in PDF: File:VMU.pdf

This page is a stub page. It needs to be expanded with more detail. If you know more information about this topic, please sign up and contribute to dreamcast.wiki!