Sprinter-SDCC/release_docs/en/examples.md

Programs and examples

The SDK release includes its regression programs in tests/: hello, cat, gfx_demo, bgitest and others. They exercise compiler, libc, graphics and Sprinter runtime behavior. Build them with make; make floppy packs them into a local build/media/toolkit-tests.img.

Larger demonstrations (balls, mdview, mdview2, rpgwalk, scroll, space) are published in the separate Examples project. Clone it separately and point it at this installed SDK:

export SPRINTER_ROOT=/path/to/sprinter-c
cd /path/to/Examples
pyenv exec python -m pip install -r requirements.txt
make

For your own program, use the SDK's app.mk:

SPRINTER_ROOT ?= /path/to/sprinter-c
EXAMPLE := my_app
include $(SPRINTER_ROOT)/app.mk

make floppy creates an image under the application's build/media/. For an emulator launch, set MAME_HOME to a prepared MAME runtime with sprinter or mame.arm, roms/ and IMG/; MAME_BIN, MAME_ROMPATH, MAME_DSS_IMAGE, MAME_SYSTEM_HDD_IMAGE and MAME_BIOS can override each part.