Difference between revisions of "AppSignature"

From MSX Game Library

(Code name)
Line 15: Line 15:
  
 
If 2-character string is recommended for creator code and integer for application number, in fact, both of those parameters can be any of:
 
If 2-character string is recommended for creator code and integer for application number, in fact, both of those parameters can be any of:
* 2-character string (<tt>"MX"</tt> for example),
+
* 2-character string (<tt>"MX"</tt>, <tt>"a7"</tt> for example),
 
* 16-bits decimal unsigned number (<tt>1234</tt> for example),
 
* 16-bits decimal unsigned number (<tt>1234</tt> for example),
 
* 16-bits hexadecimal number starting with <tt>0x</tt> (<tt>0x0750</tt> for example).
 
* 16-bits hexadecimal number starting with <tt>0x</tt> (<tt>0x0750</tt> for example).

Revision as of 09:01, 23 October 2022

This Build tool option allow to add an application signature to binary data (right after the header).

:: Add application signature to binary data (0=false, 1=true)
set AppSignature=1

:: Application company
set AppCompany="GL"

:: Application ID (0~65535)
set AppID=0

Application's signature is 4 bytes long and composed of:

  • 2 bytes for the creator/group/company code name (a 2-character string),
  • 2 bytes for the application number (any value between 0 and 65535).

If 2-character string is recommended for creator code and integer for application number, in fact, both of those parameters can be any of:

  • 2-character string ("MX", "a7" for example),
  • 16-bits decimal unsigned number (1234 for example),
  • 16-bits hexadecimal number starting with 0x (0x0750 for example).

Application signature is put just after the binary header:

  • At ROM start address +0010h,
  • At Basic binary start address +0007h.

Code name

Some creator's code are already reserved:

Code Rel Creator's name
"AB" ✔️ Konami (Boxing and Football)
"CD" ✔️ Konami (many games)
"EF" ✔️ Konami (Pennant Race and Knightmare 3)
"JP" Johan de Punder
"GH" Reserved
"GL" ✔️ MSXgl (samples)
"PP" Pixel Phenix
"TL" Tele-Line
"YZ" ✔️ Konami (Game Master 2)
"XX" Reserved

Come on Discord to reserve your own name.