Create a mapped ROM - Revision history

Aoineko: /* NEO mapper */

2026-01-05T18:21:07Z

‎NEO mapper

2025-03-07T21:29:41Z

‎Symbols

2025-01-23T14:53:41Z

‎NEO mapper

2025-01-04T23:41:03Z

‎Principles

2025-01-04T23:38:41Z

‎Yamanooto & ASCII16-X

2025-01-04T23:36:52Z

‎NEO mapper

2025-01-04T23:30:52Z

‎Raw binary data

2024-12-18T17:53:24Z

‎Raw binary data

2024-12-16T16:57:06Z

‎Example

2024-12-16T11:59:33Z

‎Banked call

@@ Line 177: / Line 177: @@
 === NEO mapper ===
-[[NEO mapper]] works on the same principle as the old mappers, but has more bank switching registers (covering page 0) and registers are 16-bit instead of 8-bit.
+[[NEO mapper]] works on the same principle as the legacy mappers, but has more bank switching registers (covering page 0) and registers are 16-bit instead of 8-bit.
 When your <tt>main()</tt> function start, the mapped-ROM cartridge slot is selected in pages #0, #1 and #2 of the memory space.

@@ Line 86: / Line 86: @@
 // Segment #5 (bank #3)
-u8 MyData[] = { 1, 2, 3, 4, 5, 6, 7, 8 };
+const u8 MyData[] = { 1, 2, 3, 4, 5, 6, 7, 8 };
 </syntaxhighlight>
@@ Line 93: / Line 93: @@
 // Main program
-extern u8 MyData[]; // Tell the compiler this data exists somewhere else.
+extern const u8 MyData[]; // Tell the compiler this data exists somewhere else.
 SET_BANK_SEGMENT(3, 5); // Switch segment visible through bank #3.

@@ Line 184: / Line 184: @@
 <img style="width:400px; margin:0.5em;" src="https://raw.githubusercontent.com/aoineko-fr/MSXgl/main/engine/doc/mapper_neo16.png" />
-NEO-8:
+Segment #4 of the NEO-8 and segment #2 of the NEO-16 have a special use: they are designed to be selected in bank #0, and the Build tool will automatically add an interrupt handling code (ISR) to them. This segment can be used to store code or data, but note that it will be accumulated from address 0x0100 (after the ISR).
 * Bank #0 (0000h-1FFFh): Segment #4 (contain the ISR)
 * Bank #1 (2000h-3FFFh): Segment #5
 * Bank #2 (4000h-5FFFh): Segment #0 (contain the ROM header)
@@ Line 192: / Line 196: @@
 * Bank #5 (A000h-BFFFh): Segment #3
-For 16 KB mappers:
+NEO-16
-* Bank #0 (0000h-3FFFh): Segment #2 (contain the ISR)
+* Bank #0 (0000h-3FFFh): Segment #2 (contain the ISR + user code/data after 0x0100)
 * Bank #1 (4000h-7FFFh): Segment #0 (contain the ROM header)
 * Bank #2 (8000h-BFFFh): Segment #1
+See the [[NEO mapper|NEO mapper specifications]] for more details about the mapper.
 === Yamanooto & ASCII16-X ===

@@ Line 27: / Line 27: @@
 The supported mappers are:
-{| class="wikitable"
+{{:Target/Mappers}}
 More details on the different mappers:

@@ Line 211: / Line 211: @@
 === Yamanooto & ASCII16-X ===
-Yamanooto and ASCII16-X are mapper that works like legacy mappers but allows more the 256 segments so they overcome their maximal size.
+Yamanooto and ASCII16-X are mappers that works like legacy mappers but allows more the 256 segments so they overcome their maximal size.
 Yamanoto:

← Older revision		Revision as of 23:36, 4 January 2025
Line 209:		Line 209:

	See the [[NEO mapper\|NEO mapper specifications]] for more details.		See the [[NEO mapper\|NEO mapper specifications]] for more details.
		+
		+	=== Yamanooto & ASCII16-X ===
		+	Yamanooto and ASCII16-X are mapper that works like legacy mappers but allows more the 256 segments so they overcome their maximal size.
		+
		+	Yamanoto:
		+	* Banks: 4 banks of 8 KB (visible on memory pages 1 and 2)
		+	* Size: up to 8 MB
		+	* Support: Yamanooto and openMSX
		+
		+	ASCII16-X:
		+	* Banks: 2 banks of 16 KB (visible on memory pages 1 and 2)
		+	* Size: up to 64 MB
		+	* Support: Incomming hardware and openMSX (8 MB)

	== Advice ==		== Advice ==

@@ Line 149: / Line 149: @@
 //-- List of raw data files to be added to final binary (array). Each entry must be in the following format: { offset:0x0000, file:"myfile.bin" }
 RawFiles = [
-     { segment: 2, file:"content/music1.vgm"},
+     { segment: 2, file: "content/music1.vgm"},
-     { segment: 3, file:"content/music2.vgm" },
+     { segment: 3, file: "content/music2.vgm" },
-     { offset: 0x18000, file:"content/image.bin" },
+     { offset: 0x18000, file: "content/image.bin" },
-     { page: 4, file:"content/video.bin" }
+     { page: 4, file: "content/video.bin" }
 ];
 </syntaxhighlight>

@@ Line 160: / Line 160: @@
 * <tt>segment</tt>: segment number for mapped ROMs (Build tool use mapper's bank size to determine the final position).
 * <tt>page</tt>: page number (16 KB) for mapped or plain ROM.
 The sample <tt>s_vgm</tt> showcase the use this option.

@@ Line 77: / Line 77: @@
 In the Build Tool:
-* <tt>s_mapper.c</tt> will be compile as a 32 KB plain ROM (which represents the first 4 segments).
+* <tt>s_mapper.c</tt> will be compile as a 32 KB plain ROM (which represents the first 4 segments: #0 to #3).
-* Then, the Build Tool will search for source files for segment #5 to #15 starting with <tt>s_mapper_</tt>. 3 files extensions are supported: <tt>.c</tt>, <tt>.asm</tt> and <tt>.s</tt>.
+* Then, the Build Tool will search for source files for segment #4 to #15 starting with <tt>s_mapper_</tt>. 3 files extensions are supported: <tt>.c</tt>, <tt>.asm</tt> and <tt>.s</tt>.
 ** <tt>s_mapper_s4_b2.c</tt> will be find, compile to be visible in bank 2 (from 0x8000) and added to link list.
 ** <tt>s_mapper_s5_b3.asm</tt> will be find, compile to be visible in bank 3 (from 0xA000) and added to link list. Assembler segment source file must include the <tt>.area</tt> directive with the segment name <tt>_SEG{num}</tt> (<tt>_SEG5</tt> here).

@@ Line 133: / Line 133: @@
 u8 BankedFunc() __banked; // Prototype to tell the compiler this function exists somewhere else.
-BankedFunc(); // automatic switch to segment #7 then restore previous segment
+void main()
 </syntaxhighlight>