Dustlayer

Retro means old but cool.

I grew up with the Commodore C64 but was never able to master the machine. I was young, I wanted to play the latest games and let other people do the pioneer work on exploring this incredible hardware. Today I have better skills to catch up on what it takes to code the C64. I will share what I learn along the way. Enjoy the trip to the past!

Episode 3-8: If the SID doesn't fit, use a bigger Hammer

Synopsis: Sometimes you want to use a SID file which is set up for a special memory address which is not aligned with you own memory strategy. I introduce a great tool to fix this.

Download via dust: $ dust tutorials (select 'spritro')
Github Repository: Spritro Source Code on Github


The nature of playing back a SID file

A SID file is more than just some music data. A SID comes with everything you need to play back the music too. So there is Replay Routine, the actual Music Information and some SID header. No matter which Replay Routine is used, whether it be custom or something standardized due some popular Music Editor the procedure to play a SID file is always the same after loaded into memory:

  1. Initialize the Playback routine once by jumping to the SIDs init address
  2. Trigger the Play Routine Address with every screen refresh

When there are subtunes you also may want to actually select beforehand which tune to play back. The common convention is to set the X-Register to the desired subtune number before initializing the SID.

It also turned out to be pretty standard to store the SID file starting at memory location $1000 and program the replay routines accordingly. The main reason is that $1000 - $1fff are overshadowed with the Character Generator ROM so this place is not really usable to the VIC-II which can not access for example graphics you store in the RAM under ROM in that area. It is important to understand that the SID actually defines itself where it wants to be located. If you put a SID file that is intended to be put at $1000 into a different memory location it just might now work anymore. 

There are SIDs which require other locations than $1000 though and when you want to use those in your "standard" intro you may run into problems. The good news is that this can usually be very easily fixed with a tool released in 2013 actually - SidReloc.  SidReloc is actually installed when you use DUST. If you use your own environment you have to download the SidReloc source code and compile it yourself.

Let's look for a SID tune which is not using the standard location to demonstrate SidReloc magic.

Selecting a guinea pig

Screen Shot 2013-05-10 at 3.20.57 PM.png

Empty (512 Bytes) by 4-Mat is a brillant SID - short yet powerful. I can listen to it like forever. It also sets a good mood for the Spritro. To find out it's init and play address on Mac we can open it in SidPlay and check the Info Window. Let's look at the original SID file!

Load Address is $0801 which is actually the start of BASIC in the C64 memory, than Init Address is $09ed and last but not least, the Play Routine resides at $0804.

This does not go along well with our requirements to have it start somewhere at $1000.

Let's open the terminal and run SidReloc against that SID file. By default it will try to relocate the SID to $1000 but you can also specify any other location as long as it is the beginning of a page in memory. For clarification, a page is an expression for 256 Bytes of Memory. The Commodore C64 therefor has 256 Pages as 256 Bytes times 256 equals 65536 Bytes. Even easier is to remember that the ZeroPage ranges from $0000 to $00FF, Page 1 from $0100 to $01FF and so forth. Since we want to use the area starting at address $1000, we don't need to specify anything but for the sake of completeness I put down the full command in the terminal screenshot below: 

sidreloc --page 10 empty_512.bytes.sid empty_1000.sid

Screen Shot 2013-05-10 at 3.18.36 PM.png

Looks good so far! SidReloc analyzed the SID and created a new output file empty_1000.sid.  Let's load that new file in Sidplay and check again the Info Window.  

Screen Shot 2013-05-10 at 3.19.20 PM.png

Et Voila - the SID file has been relocated!

The Load Address is not exactly at $1000 since it must consider the relative Load, Init and Play Address of the original file but it's good enough to utilize the otherwise useless area around our desired memory location.

We finally load the SID file in config_resources.asm and setup the two symbols init_sid and play_sid in in config_symbols.asm so we don't have to remember the addresses.  In our Interrupt Setup routine in main.asm we initialize the SID with jsr init_sid and from there we just call jsr play_sid within our custom interrupt 50 times a second. Everything works just fine! 

SidReloc is a really a nice little utility. 

-act