A freestanding GNU Arm C/C++ and assembly SDK for the V.Tech V.Flash / V.Smile Pro. Homebrew boots through the original firmware in FlashEm and targets the ARM926EJ-S CPU and Zevio 2D/3D hardware. Evaluation targets the pinned emulator; physical hardware is currently untested.
- Graphics & Display: Double-buffered 320x240 BGR555 linear framebuffer,
5x7 printable ASCII font, software drawing primitives, Zevio 2D/3D GPU HAL,
and an upstream SDL2 port (
SDL2+ Zevio 2D renderer).- Native GPU Renderer: Double-buffered
1024x240tiled surfaces (320x240playfield at(0, 0)plus a704x240offscreen texture atlas at(320, 0)), supporting hardware clipping, quads, textured/tinted/alpha-blended sprites, textured triangles (SDL_RenderGeometry), RGB color modulation, offscreen render targets, and per-tile dirty-bitmask synchronization between the two tiled surfaces. - SDL2 Limitations: Full-texture
SDL_UpdateTexture()only (no partial rect updates orSDL_TEXTUREACCESS_STREAMINGlock/unlock), static704x240atlas without runtime compaction, and even texture widths for non-target textures.
- Native GPU Renderer: Double-buffered
- Audio & Video: Native PCM audio ring-buffer driver (
S16LE/U8), Motion JPEG (MJP) video + ADPCM/PCM playback via PicoJPEG, and a double-buffered loading screen. - Storage & Input: Sony CXD3068Q CD-ROM sector driver, read-only ISO 9660 filesystem, and UART0 controller input (D-pad, action buttons, analog stick).
- System & Diagnostics: 10 kHz Timer 0 clock, optional ARMv5 MMU identity and page/section mapping, C++ freestanding runtime support, and an ARM panic handler with undefined-instruction / SWI diagnostics.
No firmware, commercial executable, or proprietary SDK is included. Supply your own local ROM; game dumps and save cards stay in ignored local directories.
Requires CMake 3.20+, Python 3.9+, GNU Arm Embedded GCC/binutils, and Ninja or
Make. Disc images also require xorriso, genisoimage, or mkisofs; host
drawing tests require native cc (or VFLASH_HOST_CC).
cmake -S . -B build -G Ninja \
-DCMAKE_TOOLCHAIN_FILE=cmake/toolchain-vflash.cmake
cmake --build build --target all disc_image
ctest --test-dir build --output-on-failureThe default disc image is build/homebrew.cue with its companion .bin.
Additional targets, custom toolchains, and packaging commands are in the
build guide.
All example programs, demo launchers, and FlashEm instructions are available in the examples guide.
Run the host unit tests and emulator acceptance suites:
python3 -m unittest discover -s tests -v
python3 tools/emulator_smoke.py --suite suite
python3 tools/emulator_smoke.py --suite bad-apple
python3 tools/emulator_smoke.py --suite fmv
for t in atlas-frag color-mod dirty-sync lifecycle renderer sdl2 triangle-tex; do
python3 tools/gpu_smoke.py --test "$t" --mmu both
doneFor a single-disc firmware boot and scanout check:
python3 tools/emulator_smoke.py \
--emulator build/emulator/flashem --bios 'dumps/A29L160ATV@TSOP48.BIN' \
--elf build/vflash_disc_probe.elf --disc build/homebrew.cue \
--out build/video-smoke --verify-videoSee the test guide for emulator setup, direct ELF loading, and debugging options.
| Path | Purpose |
|---|---|
include/vflash/ |
Public SDK C headers (vflash/video.h, vflash/audio.h, etc.) |
include/sdl2_vflash/ |
Freestanding SDL2 configuration and V.Flash extension header |
src/gpu/ |
Software and Zevio 2D/3D GPU HAL backends |
src/graphics/ |
CPU drawing, 5x7 font, PicoJPEG, Zevio 2D renderer, SDL2 port |
src/platform/ |
Video scanout, MJP player, CD-ROM, ISO 9660 FS, audio, input, clock, MMU, loading screen |
src/runtime/ |
Bounded allocator, panic capture, and crash screen renderer |
startup/ |
ARM startup/exception assembly and linker scripts |
examples/ |
Demos, benchmarks, C++ test, SDL2 demos, and unified test suite |
cmake/ |
Cross toolchain, program targets, and disc image rules |
scripts/panic/ |
Standalone panic diagnostic build scripts |
tools/, tests/ |
Host tooling, asset staging, smoke runner, and unit tests |
docs/ |
Guides, hardware/API references, and research notes |
HACKING.md, .clang-format |
Coding style guidelines and formatting configuration |