A very, very, very simple WLA-DX template for an SMS game

Features

• Basic Makefile to build the project
• A simple, unpaged memory map setup, via include file
• Some basic defines
• Example RAMSECTIONs for system variables, pause support and user variables
• Example main program structure which waits for a frame interrupt and loops
• SMS TMR header generation

WLA-DX features non demonstrated

• Too numerous to mention!

Prerequisites

Using toolchain-sms Docker image (recommended)

See here for instructions on pulling and using the image.

Note: this Docker image has currently only been tested under MacOS, although it would be expected to work under Linux also.

or

Installing dependencies manually

• WLA-DX
• GNU Make

Build instructions

1. Download and install prerequisites
2. Run make or make build to build a .sms file into the build folder
3. Read the docs at https://wla-dx.readthedocs.io/en/latest/index.html
4. Have fun

Cleaning

Run make clean to clean the build

Example program

The example.s file is a working program which flashes the background color at a rate of 60Hz (50Hz on a PAL system)

Run it by either copying the source code into main.s, or changing the ENTRYPOINT in the makefile to be example and rebuilding.