Difference between revisions of "AppSignature"

From MSX Game Library

(Code name)
Line 31: Line 31:
 
! Code !! Rel !! Creator's name
 
! Code !! Rel !! Creator's name
 
|-
 
|-
| <tt>0x00XX</tt> ||  || ''Reserved''
+
| <tt>0x00??</tt> ||  || ''Reserved''
 
|-
 
|-
 
| <tt>"AB"</tt> || ✔️ || Konami (''Boxing'' and ''Football'')
 
| <tt>"AB"</tt> || ✔️ || Konami (''Boxing'' and ''Football'')
Line 57: Line 57:
 
| <tt>"XX"</tt> ||  || ''Reserved''
 
| <tt>"XX"</tt> ||  || ''Reserved''
 
|-
 
|-
| <tt>0xFFXX</tt> ||  || ''Reserved''
+
| <tt>0xFF??</tt> ||  || ''Reserved''
 
|}
 
|}
 
Come on [https://discord.gg/pMeadGfv8E Discord] to reserve your own name.
 
Come on [https://discord.gg/pMeadGfv8E Discord] to reserve your own name.
  
 
Code names are only definitively assigned when an application is published with this code.
 
Code names are only definitively assigned when an application is published with this code.

Revision as of 01:13, 17 January 2023

This Build tool option allow to add an application signature to binary data (right after the header). The signature format is inspired by the meta-data that Konami used to identify its cartridges and add cross-game options.

:: Add application signature to binary data (true or false)
AppSignature = true;

:: Application company
AppCompany = "GL";

:: Application ID (0~65535)
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.

You can also add extra data using AppExtra option. WIP

Code name

Some creator's code are already reserved:

Code Rel Creator's name
0x00?? Reserved
"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
"RC" Reserved
"TL" Tele-Line
"YZ" ✔️ Konami (Game Master 2)
"WD" Wim Dewijngaert
"XX" Reserved
0xFF?? Reserved

Come on Discord to reserve your own name.

Code names are only definitively assigned when an application is published with this code.