Difference between revisions of "Target"

From MSX Game Library

(Mapped ROM program)
Line 16: Line 16:
  
 
   REM -- 128KB ASCII-8 mapped-ROM
 
   REM -- 128KB ASCII-8 mapped-ROM
   target=ROM_ASCII8
+
   set target=ROM_ASCII8
 
   
 
   
 
   REM -- 4MB ASCII-16 mapped-ROM
 
   REM -- 4MB ASCII-16 mapped-ROM
   target=ROM_ASCII16
+
   set target=ROM_ASCII16
   ROMSize=4096
+
   set ROMSize=4096
 
   
 
   
 
   REM -- 512KB Konami SCC mapped-ROM
 
   REM -- 512KB Konami SCC mapped-ROM
   target=ROM_KONAMI_SCC
+
   set target=ROM_KONAMI_SCC
   ROMSize=512
+
   set 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:28, 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
  set target=ROM_ASCII8

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

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

See s_vgm sample for a concrete use case.