Hello world tutorial

Setting up a minimalist development environment

• Download the latest MAME emulator binaries from [this pages]. Extract the zip contents to a folder such as "C:/mame/".
• You will need the NeoGeo MVS BIOS files to run NeoGeo roms. Find it with google and make sure you have the 000-lo.lo (64KiB), sfix.sfix (128KiB), sm1.sm1 (128KiB), sp-s2.sp1 (128KiB) and sfix.sfix (128KiB) files in the "c:/mame/roms/neogeo/" folder.

• Download a Super Sidekicks romset (ssideki.zip), extract it to "c:/mame/roms/ssideki/".

• You will need a batch file to start MAME with the right parameters. Start a new text file and add these contents:

mame ssideki -debug -nofilter -video d3d -waitvsync -window
pause

Run this batch file, MAME should open with its debugger enabled. Don't be scared, just press F5 to see if Super Sidekicks runs fine. If the romset is bad, the missing and/or invalid files will be shown in the DOS prompt (bad checksum, missing files...). When everything works, close the debugger and the emulation window.

• Download [the macro assembler AS (ASW)] and this zip file. There is no installation required, just extract those files to a folder like "C:/neogeo/asw/".

• For the purpose of this tutorial, notepad can be used as a source editor. Make a folder for this project such as "c:/neogeo/helloworld/".

• You will need to add a batch file in this folder to run ASW to assemble your source file. Make a new text file with the following contents:

@echo off
c:\neogeo\asw\asw main -L -quiet
c:\neogeo\asw\p2bin main -r $000000-$01FFFF
d:\neogeo\asw\flip main.bin 052-p1.bin
d:\neogeo\asw\pad 052-p1.bin 524288 255
copy 052-p1.bin c:\mame\roms\ssideki\052-p1.bin

ASW assembles your code, p2bin makes the P ROM with the right size (128KiB), flip.exe inverts bytes by pairs (byteswapping) because P ROMs have to be that way, pad.exe fills up the P ROM with $FF bytes up to 512KiB and it's then copied in place of the original Super Sidekicks rom.

Be aware that only the P ROM is replaced, all graphics, musics and sounds are still the Super Sidekicks ones.

Now that you have everything to assemble and run the ROM, you can start coding.

The code

TODO