MSX Game Library - Recent changes [en]

NEO mapper/Extension2

Aoineko — Sat, 03 Oct 2026 22:18:51 GMT

‎Programmable processor and emulation

Show changes

NEO mapper

Aoineko — Sun, 27 Sep 2026 08:27:15 GMT

‎Programmable processor and emulation

NEO mapper/Extension2

Aoineko — Sat, 26 Sep 2026 20:13:07 GMT

‎Principles

NEO mapper/Extension2

Aoineko — Sat, 26 Sep 2026 19:59:55 GMT

Created page with "{{WARNING|This page is still in the proposal stage and should not yet be considered an official specification.}} Proposal for an extension to the NEO mapper format. == S..."

New page

{{WARNING|This page is still in the proposal stage and should not yet be considered an official specification.}}

Proposal for an extension to the [[NEO mapper]] format.

== Specifications ==

=== Principles ===

Any write operation to the NEO mapper with data bit 7 set to 1 and address bit 0 set to 1 is considered an access to extended features. In that case, the mapper bank register is not modified.

All other write operations should be considered normal access to the mapper's bank register.

The data contains:
* The number of an extended function in the mapper
* A bit indicating whether the function should be enabled or disabled

The address contains an 8-bit parameter to be passed to the function.
{|
|-
|
{| class="wikitable"
|+ ADDRESS
|-
! 15 || 14 || 13 || 12 || 11 || 10 || 9 || 8 || 7 || 6 || 5 || 4 || 3 || 2 || 1 || 0
|-
|style="background-color:#BBB;" colspan="2"| Page
|style="background-color:#FAA;"| 0
|style="background-color:#FAA;"| 0
|style="background-color:#FAA;"| 0
|style="background-color:#BBB;"| 0
|style="background-color:#BBB;"| 0
|style="background-color:#BBB;"| 0
|style="background-color:#AAF;" colspan="8"| Function
|}
|
{| class="wikitable"
|+ DATA
|-
! 7 || 6 || 5 || 4 || 3 || 2 || 1 || 0
|-
|style="background-color:#AAF;" colspan="8"| Parameter
|}
|}

=== Functions ===
==== 0x00: Cartridge information ====
When activated, any read access to the given bank will return the cartridge information (8 KB, mirrored on NEO-16).
{| class="wikitable"
|+ PARAMETER
|-
! 8 || 7 || 6 || 5 || 4 || 3 || 2 || 1
|-
|style="background-color:#BBB;"| 0
|style="background-color:#BBB;"| 0
|style="background-color:#BBB;"| 0
|style="background-color:#BBB;"| 0
|style="background-color:#BBB;"| 0
|style="background-color:#AAF;" colspan="5"| ROM Bank
|}

Examples:
{| class="wikitable"
|-
! Action || Pseudo-code
|-
| Activate information in bank 2 of NEO-16 || <tt>[0x7005] = 0xC0</tt>
|-
| Read information (offset +5) from bank 2 of NEO-16 || <tt>BankSize = [0x8005]</tt>
|-
| Disactivate information in bank 2 of NEO-16 || <tt>[0x7005] = 0x80</tt>
|}

==== 0x01: Cartridge configuration ====

==== 0x04: Activate SRAM/FRAM ====
When activated, any read/write access to the specified bank (defined in the parameter) is redirected to the selected segment of the SRAM/FRAM.

SRAM/FRAM is accessed through 8 KB segments (on the NEO-16, the segment is mirrored).

Up to 16 segments can be accessed, for a total capacity of 128 KB.
{| class="wikitable"
|+ PARAMETER
|-
! 8 || 7 || 6 || 5 || 4 || 3 || 2 || 1
|-
|style="background-color:#AAF;" colspan="4"| RAM Segment
|style="background-color:#BBB;"| 0
|style="background-color:#AAF;" colspan="5"| ROM Bank
|}

==== 0x05: Activate device ====
Activate or disactivate the given device.
{| class="wikitable"
|+ PARAMETER
|-
! 8 || 7 || 6 || 5 || 4 || 3 || 2 || 1
|-
|style="background-color:#BBB;"| 0
|style="background-color:#BBB;"| 0
|style="background-color:#BBB;"| 0
|style="background-color:#AAF;" colspan="5"| Device ID
|}

Devices:
* <tt>00</tt>: MSX-Music (OPLL)
* <tt>01</tt>: MSX-Audio
* <tt>02</tt>: SCC
* <tt>03</tt>: SCC+
* <tt>04</tt>: 2nd PSG (port 10h)
* <tt>05</tt>: Darky (2 x ePSG)
* <tt>06</tt>: Darky Jr. (2 x PSG)
* <tt>08</tt>: OPM (SFK-01, SFG-01 et SFG-05 ver.1)
* <tt>09</tt>: OPP (SFG-05 ver.2)
* <tt>12</tt>: OPL4
* <tt>15</tt>: SAM2695

== Appendix ==
=== Programmable processor and emulation ===
Here is a pseudo code in C to handle NEO mappers extension for programmable processor based cartridges or for emulators:

NEO-16 mapper:
<syntaxhighlight lang="c">
const uint8* romData; // ROM data
uint16 bankValue[3]; // Bank switching register value

// Extended function prototypes
typedef void (*funcEnable_t)(bool, uint8);
typedef void (*funcWrite_t)(uint16, uint8);
typedef uint8 (*funcRead_t)(uint16);
// Extended functions table
funcEnable_t funcEnableTable[32];
funcWrite_t funcWriteTable[3];
funcRead_t funcReadTable[3];

// Handle device initialization
void NEO16_Init()
{
for (uint8 i = 0; i < 3; i++)
{
bankValue[i] = 0x0000;
funcWriteTable[i] = NULL;
funcReadTable[i] = NULL;
}
for (uint8 i = 0; i < 32; i++)
funcEnableTable[i] = NULL;
}

// Handle write access
void NEO16_Write(uint16 address, uint8 value)
{
uint8 bank = ((address >> 12) & 0x03) - 1; // Get the corresponding bank number
if (bank > 2)
return; // skip

if (funcWriteTable[bank] != NULL) // Check for bank write callback
{
funcWriteTable[bank](address, value);
}
else if ((address & 0x0001) && (value & 0x80)) // Handle extended function
{
uint8 funcId = value & 0x3F; // Get function ID
if (funcEnableTable[funcId] != NULL)
funcEnableTable[funcId](value & 0x40, (address >> 1) & 0xFF); // Execute function specific code
}
else // Write to the given bank register
{
if (address & 1) // Set bank register MSB
bankValue[bank] = ((value & 0x0F) << 8) | (bankValue[bank] & 0x00FF);
else // Set bank register LSB
bankValue[bank] = (bankValue[bank] & 0xFF00) | (value);
}
}

// Handle read access
uint8 NEO16_Read(uint16 address)
{
uint8 bank = address >> 14; // Get the corresponding bank number
if (bank > 2)
return 0xFF; // skip

if (funcReadTable[bank] != NULL) // Check for bank read callback
return funcReadTable[bank](address);
else
return romData[(bankValue[bank]) << 14 + (address & 0x3FFF)];
}
</syntaxhighlight>

=== Extension example ===
Here is a pseudo code in C to handle a SRAM extension for NEO mapper:

<syntaxhighlight lang="c">
uint8 sramSeg; // Current SRAM segment [0:15]
uint8 sramBank; // Current bank where SRAM is selected (0xFF if not selected)
uint8* sramData; // SRAM data (hardware specific)

// Write to SRAM
void SRAM_Write(uint16 address, uint8 value)
{
sramData[(sramSeg * 0x2000) + (address & 0x1FFF)] = value; //
}

// Read from SRAM
uint8 SRAM_Read(uint16 address)
{
return sramData[(sramSeg * 0x2000) + (address & 0x1FFF)];
}

// Enable/disable SRAM feature
void SRAM_Enable(bool enable, uint8 param)
{
if (sramBank != 0xFF) // Disable previous SRAM registration
{
if (funcWriteTable[sramBank] == SRAM_Write)
funcWriteTable[sramBank] = NULL;
if (funcReadTable[sramBank] == SRAM_Read)
funcReadTable[sramBank] = NULL;
sramBank = 0xFF;
}

if (enable) // Enable a SRAM segment in the given bank
{
uint8 bank = param & 0x07; // Get bank number
if (bank > 2)
return; // skip (for NEO-16)

sramSeg = (param >> 4) & 0x0F; // SRAM segment number
sramBank = bank;
funcWriteTable[sramBank] = SRAM_Write; // Register SRAM callbacks
funcReadTable[sramBank] = SRAM_Read;
}
}

// Initialize SRAM feature
void SRAM_Init()
{
sramBank = 0xFF;
funcEnableTable[0x04] = SRAM_Enable; // Register to function 0x04 (SRAM/FRAM feature)
}
</syntaxhighlight>

Then, you just need to call <tt>SRAM_Init()</tt> from <tt>NEO16_Init()</tt> to register the extended feature.

AppSignature

Aoineko — Sat, 26 Sep 2026 11:38:14 GMT

‎Programming

Modules/tool/sign/Desc

Aoineko — Sat, 26 Sep 2026 11:30:40 GMT

Modules/tool/sign/Desc

Aoineko — Sat, 26 Sep 2026 11:28:46 GMT

Created page with "The {{MOD|tool/sign}} module allows to check for the presence of another application in the cartridge ports (to create Konami-style cartridge combinations)."

New page

The {{MOD|tool/sign}} module allows to check for the presence of another application in the cartridge ports (to create Konami-style cartridge combinations).

Modules/tool/sign

Aoineko — Sat, 26 Sep 2026 11:27:08 GMT

Created page with "{{MODULE |name=tool/sign |category=Tool |dependency1= |dependency2= |dependency3= |sample1= |sample2= |sample3= }}"

New page

{{MODULE
|name=tool/sign
|category=Tool
|dependency1=
|dependency2=
|dependency3=
|sample1=
|sample2=
|sample3=
}}

Modules

Aoineko — Sat, 26 Sep 2026 11:26:52 GMT

AppSignature

Aoineko — Sat, 26 Sep 2026 11:25:51 GMT

‎Programming

Projects

Aoineko — Sat, 26 Sep 2026 10:49:53 GMT

NEO mapper

Aoineko — Sat, 26 Sep 2026 08:15:34 GMT

‎Hardware

Projects

Aoineko — Thu, 24 Sep 2026 20:44:32 GMT

Free call to BIOS routine

Aoineko — Tue, 22 Sep 2026 18:35:53 GMT

Projects

Aoineko — Sat, 12 Sep 2026 20:58:27 GMT

@@ Line 186: / Line 186: @@
 | NEO-8 mapper:
 <syntaxhighlight lang="c">
-const uint8* romData; // ROM data
+extern const uint8* romData; // ROM data
 uint16 bankValue[6]; // Bank switching register value
@@ Line 219: / Line 219: @@
 | NEO-16 mapper:
 <syntaxhighlight lang="c">
-const uint8* romData; // ROM data
+extern const uint8* romData; // ROM data
 uint16 bankValue[3]; // Bank switching register value

← Older revision		Revision as of 11:38, 26 September 2026
Line 49:		Line 49:

	To handle all cases, the addresses to check are: 0x4010, 0x4018, 0x8010 and 0x8018.		To handle all cases, the addresses to check are: 0x4010, 0x4018, 0x8010 and 0x8018.
		+
		+	The MSXgl's {{MOD\|tool/sign}} module provides C functions for detecting games in other cartridge ports.

	== Creator ID ==		== Creator ID ==

← Older revision		Revision as of 11:30, 26 September 2026
Line 1:		Line 1:
−	The {{MOD\|tool/sign}} module allows to ~~check for the presence of another application in the~~ cartridge ~~ports (to create~~ Konami-style ~~cartridge combinations)~~.	+	The {{MOD\|tool/sign}} module allows to detect other games on secondary cartridge slot using [[AppSignature\|Konami-style signature]].

@@ Line 37: / Line 37: @@
 * {{MOD|tool/qrcode}} (QR Code generator)
 * {{MOD|tool/reg}} (Registers setting)
 * {{MOD|tool/sjis}} (Shift-JIS conversion)

@@ Line 46: / Line 46: @@
 Keep in mind than MSX store data as Less significant byte first (Little endian).
-<u>Note</u>: For ROM targets, if a [[ROM type signature]] is present at offset +0010h, then the application signature is placed just after (header +0x0018)
+For ROM targets, if a [[ROM type signature]] is present at offset +0010h, then the application signature is placed just after (header +0x0018).
 == Creator ID ==
@@ Line 75: / Line 77: @@
 | <tt>"FD"</tt> || ✔️ || FutureDisk
 |-
-| <tt>"FP"</tt> || ✔️ || Fausto
+| <tt>"FP"</tt> || ✔️ || Fausto Pracek
 |-
 | <tt>"JP"</tt> ||  || Johan de Punder
@@ Line 85: / Line 87: @@
 | <tt>"H_"</tt> ||  || Peruho
 |-
-| <tt>"HN"</tt> ||  || Hando
+| <tt>"HN"</tt> || ✔️ || Hando
 |-
 | <tt>"MO"</tt> || ✔️ || MO5.com
@@ Line 126: / Line 128: @@
 {| class="wikitable sortable"
-! C !! App !! Author !! Application
+! Sign !! Author !! Application
 |-
-| <tt>"B5"</tt> || <tt>"EM"</tt> || Bik5 (J. Bikker) || ''Eggy's Maze''
+| <tt>"CCTR"</tt> || Casper Croes<br/>Pixel Phenix || ''Soul Trapped''
 |-
-| <tt>"B5"</tt> || <tt>"R3"</tt> || Bik5 (J. Bikker) || ''DELTA''
+| <tt>"FDLW"</tt> || FutureDisk || ''A Lone Wolf''
 |-
-| <tt>"CC"</tt> || <tt>"PC"</tt> || Casper Croes || ''Phenix Corrupta''
+| <tt>"FPEX"</tt> || Fausto Pracek || ''Sam.Pr Explore''
 |-
-| <tt>"CC"</tt> || <tt>"TR"</tt> || Casper Croes || ''Soul Trapped''
+| <tt>"FPMW"</tt> || Fausto Pracek || ''Martian War''
 |-
-| <tt>"FD"</tt> || <tt>"LW"</tt> || FutureDisk || ''A Lone Wolf''
+| <tt>"FPSL"</tt> || Fausto Pracek || ''Soccer League''
 |-
-| <tt>"FP"</tt> || <tt>"EX"</tt> || Fausto Pracek || ''Sam.Pr Explore''
+| <tt>"FPSP"</tt> || Fausto Pracek || ''Sam.Pr''
 |-
-| <tt>"FP"</tt> || <tt>"MW"</tt> || Fausto Pracek || ''Martian War''
+| <tt>"HNMG"</tt> || Hando || ''MUGI''
 |-
-| <tt>"FP"</tt> || <tt>"SL"</tt> || Fausto Pracek || ''Soccer League''
+| <tt>"MOR5"</tt> || MO5.com || ''Room 5''
 |-
-| <tt>"FP"</tt> || <tt>"SP"</tt> || Fausto Pracek || ''Sam.Pr''
+| <tt>"NBTC"</tt> || Nicola "8bit" || ''The New Castle''
 |-
-| <tt>"NB"</tt> || <tt>"TC"</tt> || Nicola "8bit" || ''The New Castle''
+| <tt>"PPCR"</tt> || Pixel Phenix || ''Crawlers (MSXdev'23)''
 |-
-| <tt>"PP"</tt> || <tt>"CR"</tt> || Pixel Phenix || ''Crawlers (MSXdev'23)''
+| <tt>"PH",001</tt> || Pixel Phenix || ''Crawlers (cartridge)''
 |-
-| <tt>"PH"</tt> || <tt>001</tt> || Pixel Phenix || ''Crawlers (cartridge)''
+| <tt>"PH",003</tt> || Pixel Phenix || ''Peng Pong''
 |-
-| <tt>"PH"</tt> || <tt>003</tt> || Pixel Phenix || ''Peng Pong''
+| <tt>"RGAJ"</tt> || Tiago Tresoldi<br/>Freja Lindgren || ''AstroJump''
 |-
-| <tt>"RG"</tt> || <tt>"TM"</tt> || Rutagames || ''TerMSX Multi''
+| <tt>"RGTM"</tt> || Rutagames || ''TerMSX Multi''
 |-
-| <tt>"RS"</tt> || <tt>"P9"</tt> || RoboSoft || ''Planet X9''
+| <tt>"RSP9"</tt> || RoboSoft || ''Planet X9''
 |-
-| <tt>"RS"</tt> || <tt>"PE"</tt> || RoboSoft || ''Attack of the Petscii Robots''
+| <tt>"RSPE"</tt> || RoboSoft || ''Attack of the Petscii Robots''
 |-
-| <tt>"TT"</tt> || <tt>"TP"</tt> || Thomas ‘Totta’ Lundgren || ''Tetpuz''
+| <tt>"TT4P"</tt> || Antxiko || ''Tiny Tetris VS''
 |-
-| <tt>"TT"</tt> || <tt>"DL"</tt> || Thomas ‘Totta’ Lundgren || ''Doomlings''
+| <tt>"TTDL"</tt> || Thomas "Totta" Lundgren || ''Doomlings''
 |-
-| <tt>"MO"</tt> || <tt>"R5"</tt> || MO5.com || ''Room 5''
+| <tt>"TTTP"</tt> || Thomas "Totta" Lundgren || ''Tetpuz''
 |-
-| <tt>"GL"</tt> || <tt>?</tt> || MSXgl || (samples)
+| <tt>"GL",...</tt> || MSXgl || (samples)
 |-
-| <tt>"AB"</tt> || <tt>?</tt> || Konami || (''Boxing'' and ''Football'')
+| <tt>"AB",...</tt> || Konami || (''Boxing'' and ''Football'')
 |-
-| <tt>"CD"</tt> || <tt>?</tt> || Konami || (many games)
+| <tt>"CD",...</tt> || Konami || (many games)
 |-
-| <tt>"EF"</tt> || <tt>?</tt> || Konami || (''Pennant Race'' and ''Knightmare 3'')
+| <tt>"EF",...</tt> || Konami || (''Pennant Race'' and ''Knightmare 3'')
 |-
-| <tt>"YZ"</tt> || <tt>?</tt> || Konami || (''Game Master 2)''
+| <tt>"YZ",...</tt> || Konami || (''Game Master 2)''
 |}

@@ Line 7: / Line 7: @@
 === Principles ===
-Any write operation to the NEO mapper with data bit 7 set to 1 and address bit 0 set to 1 is considered an access to extended features. In that case, the mapper bank register is not modified.
+Any write operation to the NEO mapper with address bits 10-12 set to 0 is considered as access to extended features. In that case, the mapper bank register is not modified.
 All other write operations should be considered normal access to the mapper's bank register.
-The data contains:
+The address contains an 8-bit function ID.
 {|
 |-
@@ Line 28: / Line 24: @@
 |style="background-color:#FAA;"| 0
 |style="background-color:#FAA;"| 0
-|style="background-color:#BBB;"| 0
+|style="background-color:#AAF;" colspan="3"| Bank
 |style="background-color:#AAF;" colspan="8"| Function
 |}
@@ Line 42: / Line 36: @@
 |}
 |}
 === Functions ===

@@ Line 449: / Line 449: @@
 |webmsx=https://www.file-hunter.com/MSXdev/?id=delta
 |version=1.3.2
-|signature="5BR3"
+|signature="B5R3"
 |image1=https://www.msxdev.org/wp-content/uploads/2026/02/MSXdev25_DELTA_v1.0_000.jpg
 |image2=https://www.msxdev.org/wp-content/uploads/2026/02/MSXdev25_DELTA_v1.0_002.jpg

@@ Line 111: / Line 111: @@
 * '''[https://github.com/cristianoag/msx-picoverse-public PicoVerse] 2040 and 2350''': Support for NEO-8 and NEO-16 mappers up to ~15 MB.
 * '''[https://github.com/arkadiuszmakarenko/RISKYMSX RISKY MSX]''': Support for NEO-8 and NEO-16 mappers up to 256 KB.
-* '''[https://github.com/piigaa-densetu-two-dai/MSXpi MSXπ]''': Support for NEO-16 mappers up to 16 MB
+* '''[https://github.com/piigaa-densetu-two-dai/MSXpi MSXπ]''': Support for NEO-16 mappers up to 16 MB.
-* '''[https://github.com/piigaa-densetu-two-dai/MSXpi_plus_v2 MSXπ Plus (V2)]''': Support for NEO-16 mappers up to 16 MB
+* '''[https://github.com/piigaa-densetu-two-dai/MSXpi_plus_v2 MSXπ Plus (V2)]''': Support for NEO-16 mappers up to 16 MB.
 === Emulator ===

@@ Line 596: / Line 596: @@
 |image1=https://i.postimg.cc/P5P4sxTp/859c2b11-9446-4212-9435-e7ce8df679e4.png
 |image2=https://i.postimg.cc/zXD777M5/demo-city-itch.png
 }}

@@ Line 15: / Line 15: @@
 Here is a summary of all possible the combinations:
-<html><img width="900px" src="https://cdn.discordapp.com/attachments/574951023374761988/995082329997443184/unknown.png" /></html>
+{| class="wikitable"
 You can found many examples in <tt>engine\src\bios.h</tt>.

@@ Line 580: / Line 580: @@
 |image1=https://aoineko.org/msxgl/images/thumb/b/b6/Game_mugi_01.png/775px-Game_mugi_01.png
 |image2=https://aoineko.org/msxgl/images/thumb/6/60/Game_mugi_02.png/775px-Game_mugi_02.png
 }}