Difference between revisions of "Target"

From MSX Game Library

(Mapped ROM program)
(Mapped ROM program)
Line 3: Line 3:
 
== Plain ROM program ==
 
== Plain ROM program ==
 
== Mapped ROM program ==
 
== Mapped ROM program ==
You can create program using one of the supported ROM mappers:
+
You can create program using one of this supported ROM mappers:
* '''ASCII-8''': 8KB chunks for a total to 64KB to 2MB,
+
* '''ASCII-8''': 8KB segments for a total to 64KB to 2MB,
* '''ASCII-16''': 16KB chunks for a total to 64KB to 4MB,  
+
* '''ASCII-16''': 16KB segments for a total to 64KB to 4MB,  
* '''KONAMI''': 8KB chunks for a total to 64KB to 2MB,  
+
* '''Konami''': 8KB segments for a total to 64KB to 2MB,  
* '''KONAMI-SCC''': 8KB chunks for a total to 64KB to 2MB.
+
* '''Konami SCC''': 8KB segments for a total to 64KB to 2MB.
  
In your <tt>build.bat</tt>, chose as target on of the following type: <tt>ROM_ASCII8</tt>, <tt>ROM_ASCII16</tt>, <tt>ROM_KONAMI</tt>, <tt>ROM_KONAMI_SCC</tt>.
+
In your <tt>build.bat</tt>, chose as <tt>target</tt> on of the following type: <tt>ROM_ASCII8</tt>, <tt>ROM_ASCII16</tt>, <tt>ROM_KONAMI</tt>, <tt>ROM_KONAMI_SCC</tt>.
 +
You can specify the ROM size (in KB) in the <tt>ROMSize</tt> variable. Default value is 128 (KB).
 +
Any multiple value of the mapper's segments size is valid, but I recommend using powers of 2 values (64, 128, 256, etc.) to help emulators to autodetect the right mapper.
 +
 
 +
Some Build Tool configuration examples:
 +
 
 +
REM -- 128KB ASCII-8 mapped-ROM
 +
target=ROM_ASCII8
 +
 +
REM -- 4MB ASCII-16 mapped-ROM
 +
target=ROM_ASCII16
 +
ROMSize=4096
 +
 +
REM -- 512KB Konami SCC mapped-ROM
 +
target=ROM_KONAMI_SCC
 +
ROMSize=512

Revision as of 13:26, 4 March 2022

Basic program

MSX-DOS program

Plain ROM program

Mapped ROM program

You can create program using one of this supported ROM mappers:

  • ASCII-8: 8KB segments for a total to 64KB to 2MB,
  • ASCII-16: 16KB segments for a total to 64KB to 4MB,
  • Konami: 8KB segments for a total to 64KB to 2MB,
  • Konami SCC: 8KB segments for a total to 64KB to 2MB.

In your build.bat, chose as target on of the following type: ROM_ASCII8, ROM_ASCII16, ROM_KONAMI, ROM_KONAMI_SCC. You can specify the ROM size (in KB) in the ROMSize variable. Default value is 128 (KB). Any multiple value of the mapper's segments size is valid, but I recommend using powers of 2 values (64, 128, 256, etc.) to help emulators to autodetect the right mapper.

Some Build Tool configuration examples:

REM -- 128KB ASCII-8 mapped-ROM
target=ROM_ASCII8

REM -- 4MB ASCII-16 mapped-ROM
target=ROM_ASCII16
ROMSize=4096

REM -- 512KB Konami SCC mapped-ROM
target=ROM_KONAMI_SCC
ROMSize=512