Difference between revisions of "Target"

From MSX Game Library

(Mapped ROM program)
Line 15: Line 15:
 
Some Build Tool configuration examples:
 
Some Build Tool configuration examples:
  
REM -- 128KB ASCII-8 mapped-ROM
+
  REM -- 128KB ASCII-8 mapped-ROM
target=ROM_ASCII8
+
  target=ROM_ASCII8
 
   
 
   
REM -- 4MB ASCII-16 mapped-ROM
+
  REM -- 4MB ASCII-16 mapped-ROM
target=ROM_ASCII16
+
  target=ROM_ASCII16
ROMSize=4096
+
  ROMSize=4096
 
   
 
   
REM -- 512KB Konami SCC mapped-ROM
+
  REM -- 512KB Konami SCC mapped-ROM
target=ROM_KONAMI_SCC
+
  target=ROM_KONAMI_SCC
ROMSize=512
+
  ROMSize=512
  
 
See <tt>s_vgm</tt> sample for a concrete use case.
 
See <tt>s_vgm</tt> sample for a concrete use case.

Revision as of 13:27, 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

See s_vgm sample for a concrete use case.