Build Tool

From MSX Game Library

Revision as of 13:57, 9 March 2022 by Aoineko (talk | contribs) (Target)


Options

Path

  • ProjDir: Project source directory
  • OutDir: Output directory for intermediate files
  • LibDir: Engine source directory
  • ToolsDir: Path to utilities used during build process

Tools

  • :

Project

  • ProjName: Project name (will be use for output filename)
  • ProjModules: Project modules to build (use ProjName if not defined)
  • LibModules: List of library modules to build
  • AddSources: Additional sources (can be C or sdasz80 assembler)

Target

  • Machine: MSX version. Can be:
    • 1: MSX 1
    • 2: MSX 2
    • 2P: MSX 2+
    • TR: MSX TurboR
    • 12: MSX 1/2 (working on MSX1 but allow to use MSX2 feature)
  • Target: Target format. See complete list.
    • BIN: .bin BASIC binary program (8000h~)
    • ROM_8K: .rom 8KB ROM in page 1 (4000h ~ 5FFFh)
    • ROM_8K_P2: .rom 8KB ROM in page 2 (8000h ~ 9FFFh)
    • ROM_16K: .rom 16KB ROM in page 1 (4000h ~ 7FFFh)
    • ROM_16K_P2: .rom 16KB ROM in page 2 (8000h ~ BFFFh)
    • ROM_32K: .rom 32KB ROM in page 1-2 (4000h ~ BFFFh)
    • ROM_48K: .rom 48KB ROM in page 0-2 (0000h ~ BFFFh). Pages 1-2 visible at start
    • ROM_48K_ISR: .rom 48KB ROM in page 0-2 (0000h ~ BFFFh). Pages 0-2 visible at start
    • ROM_64K: .rom 64KB ROM in page 0-3 (0000h ~ FFFFh). Pages 1-2 visible at start
    • ROM_64K_ISR: .rom 64KB ROM in page 0-3 (0000h ~ FFFFh). Pages 0-2 visible at start
    • ROM_ASCII8: .rom 128KB ROM using ASCII-8 mapper
    • ROM_ASCII16: .rom 128KB ROM using ASCII-16 mapper
    • ROM_KONAMI: .rom 128KB ROM using Konami mapper (8KB segments)
    • ROM_KONAMI_SCC: .rom 128KB ROM using Konami SCC mapper (8KB segments)
    • DOS1: .com MSX-DOS 1 program (0100h~) No direct acces to Main-ROM
    • DOS2: .com MSX-DOS 2 program (0100h~) No direct acces to Main-ROM
    • DOS2_ARG: .com [WIP] MSX-DOS 2 program (using command line arguments ; 0100h~) No direct acces to Main-ROM.
  • ROMSize: ROM mapper size (from 64 to 4096). Must be a multiple of 8 or 16 depending on the mapper type
  • ForceRamAddr: Overwrite RAM starting address (C000h if not defined)