This document contains information about user identification of C64 players. It's used for player name and song length recognition. The data that are already defined were taken from C64 program 'Advanced Music Searcher AMS 5.0', (c) MMS/Taboo

(converted from version 5.0.415) plus our own update made by Ray and PG of Unreal. The player identification file is in the main Pulse directory and its name is 'c64plrs.inf'.

Music is searched from $0300 to $ff00 per $100 bytes.
For example the actual search address is $1200
ID=$0001:$4c if the value at addy $1201 (actual+ID offset) is $4c...
ID=$0003:$56 ...and the value at $1203 is $56, the player was identified.
The same principle is used for Messages etc...
Both Order and Sector positions can be 'byte offsets' - values are converted to lines (every change -> one line increase)
Note: some players have these values in zero page or tape buffer etc...
So, if the player address in memory is not important, use:
#$.... (e.g..#$0334) - the '#' marks a fixed address (not relative like without it). This is valid only for Sector and Order position and ALL values must be fixed (It means, if one of them is relative, the rest of them must be relative too)

How to find the needed values?

At first - you should be a real C64 fan if you want to add some C64 players identification to the Pulse, because it's not easy (at least you should know something about C64 machine code (some opcodes)). There are two ways, how to find the needed value, while first of them presumpts, that you own a C64, load the needed music and search in a monitor. The second way is to open the Pulse Component setup, open the 'AudioMate music engine' folder, go to 'Players' -> 'SID6581 player' preferences and open the 'Memory window' bookmark. This is a simple C64 monitor which displays the C64 memory contents.
Set the refresh rate to 'Fast' or 'Raster'. Most of the C64 tunes start at address $1000 (and it's the default memory position in the Memory window), but some don't, so you have to search a bit in this case. You should search for some text message which is usually placed near the start of the player routine. The routine itself often starts with JMP instruction ($4C), followed by two bytes (Lo and Hi byte of the jump address). Usually there is a sequence of two or more JMP instructions at the start, so it looks like this:

$4C $2A $12 $4C $78 $11 $4C $72 $14

(It would be JMP $122A, JMP $1178 and JMP $1472 in assembler)

The first byte after the instruction (the lower byte of the jump address) can be used for a player identification, because it differs in 99% cases from any other player and it doesn't change if the player is placed on any other memory location.

Let's presumpt that the load address of the song is $1000. Then we can set the ID:

ID=$0001:$2A
ID=$0004:$78
ID=$0007:$72

This will cause the Pulse to recognize the player (if it finds the appropriate bytes at $1001, $1004 and $1007).

Of course you should know the name of the player, otherwise name it as 'Unknown ##' (the ## is a number, because there are already many of the unknown players in the C64plrs.inf file).

Now you should start searching for the order and sector positions in the player. The order position is the byte that usually increases from time to time (e.g. 1x each 5 seconds). The 3 order positions are often one by one. The sector positions should be also the increasing values, but they increase much faster (many times per second) and they count from zero each time the order value increases. Well, this is not much easy, but if you understand the system, you should be able to find it easily.