jurjen.ladeniusandClaude Opus 4.8
f3340e86c6
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
387 lines
16 KiB
JavaScript
387 lines
16 KiB
JavaScript
// ____________________________
|
|
// ██▀▀█▀▀██▀▀▀▀▀▀▀█▀▀█ │ ▄▄▄ ▄ ▄▄ ▄▄ ▄▄▄▄ ▄▄
|
|
// ██ ▀ █▄ ▀██▄ ▀ ▄█ ▄▀▀ █ │ ██▄▀ ██ █ ▄ ██ ▄██ ██ ▄█▀▄ ▄█▀▄ ██
|
|
// █ █ █ ▀▀ ▄█ █ █ ▀▄█ █▄ │ ██▄▀ ▀█▄█ ██ ▀█▄ ▀▄██ ██ ▀█▄▀ ▀█▄▀ ▀█▄
|
|
// ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀────────┘
|
|
// by Guillaume 'Aoineko' Blanchard under CC BY-SA license
|
|
//─────────────────────────────────────────────────────────────────────────────
|
|
|
|
//*******************************************************************************
|
|
// BUILD STEPS
|
|
//*******************************************************************************
|
|
|
|
DoClean = false; //-- Clear all intermediate files and exit (boolean)
|
|
DoCompile = true; //-- Compile all the project and engine source code (boolean). Generate all REL files
|
|
DoMake = true; //-- Link all the project and engine source code (boolean). Merge all REL into one IHX file
|
|
DoPackage = true; //-- Generate final binary file (boolean). Binarize the IHX file
|
|
DoDeploy = true; //-- Gathering of all files necessary for the program to work (boolean). Depends on the type of target
|
|
DoRun = false; //-- Start the program automatically at the end of the build (boolean)
|
|
|
|
//*****************************************************************************
|
|
// DIRECTORIES SETTINGS
|
|
//*****************************************************************************
|
|
|
|
//-- Project directory (string)
|
|
ProjDir = `${process.cwd()}/`; // This set the directory from where you executed the build script as the project directory
|
|
|
|
//-- Intermediate files directory (string)
|
|
OutDir = `${ProjDir}out/`;
|
|
|
|
//*****************************************************************************
|
|
// TOOLS SETTINGS
|
|
//*****************************************************************************
|
|
|
|
if (process.platform === "win32") { //-- Bundled SDCC toolchain (Windows only)
|
|
SDCCPath = `${ToolsDir}sdcc/`; //-- Path to SDCC tools chain (string)
|
|
Compiler = `${SDCCPath}bin/sdcc`; //-- Path to the C compile program (string)
|
|
Assembler = `${SDCCPath}bin/sdasz80`; //-- Path to the assembler program (string)
|
|
Linker = `${SDCCPath}bin/sdcc`; //-- Path to the linker program (string)
|
|
MakeLib = `${SDCCPath}bin/sdar`; //-- Path to the program to generate lib file (string)
|
|
} //-- On macOS/Linux the system SDCC is used (see setup_global.js)
|
|
Hex2Bin = `${ToolsDir}MSXtk/bin/MSXhex`; //-- Path to IHX to binary convertor (string)
|
|
MSXDOS = `${ToolsDir}build/DOS/`; //-- Path to the MSX-DOS files (string)
|
|
DskTool = `${ToolsDir}build/msxtar/msxtar`; //-- Path to the tool to generate DSK file (string)
|
|
Emulator = ""; //-- Path to the emulator to launch the project (string)
|
|
if (process.platform !== "win32") { //-- On macOS/Linux, auto-detect openMSX from PATH (e.g. 'brew install openmsx')
|
|
try { Emulator = require('child_process').execSync("command -v openmsx", { encoding: 'utf8' }).trim(); } catch (e) {}
|
|
}
|
|
// Emulator = `${ToolsDir}openMSX/openmsx`;
|
|
// Emulator = `${ToolsDir}Emulicious/Emulicious`;
|
|
// Emulator = `${ToolsDir}fMSX/fMSX`;
|
|
// Emulator = `${ToolsDir}MSXEC/MSXEC`;
|
|
// Emulator = `${ToolsDir}BlueMSX/blueMSX`;
|
|
// Emulator = `${ToolsDir}MEISEI/meisei`;
|
|
// Emulator = `${ToolsDir}RuMSX/MSX`;
|
|
|
|
//*****************************************************************************
|
|
// PROJECT SETTINGS
|
|
//*****************************************************************************
|
|
|
|
//-- Project name (string). Will be use for output filename
|
|
ProjName = "";
|
|
|
|
//-- List of project modules to build (array). If empty, ProjName will be added
|
|
ProjModules = [];
|
|
|
|
//-- Project segments base name (string). ProjName will be used if not defined
|
|
ProjSegments = "";
|
|
|
|
//-- List of library modules to build (array)
|
|
LibModules = [ "system", "bios", "vdp", "print", "input", "memory" ];
|
|
|
|
//-- Additional sources to be compiled and linked with the project (array)
|
|
AddSources = [];
|
|
|
|
//-- Additional extern library to be linked with the project (array)
|
|
AddLibs = [];
|
|
|
|
//-- Target MSX machine version (string)
|
|
// - 1 MSX1
|
|
// - 2 MSX2
|
|
// - 12 MSX1 and 2 (multi support)
|
|
// - 2K Korean MSX2 (SC9 support)
|
|
// - 2P MSX2+
|
|
// - 22P MSX2 and 2+ (multi support)
|
|
// - 122P MSX1, 2 and 2+ (multi support)
|
|
// - TR MSX turbo R
|
|
// - 0 MSX0
|
|
// - 2PP MSX2++
|
|
// - 2S MSX2#
|
|
Machine = "1";
|
|
|
|
//-- Target program format (string)
|
|
// - BIN_DISK .bin BASIC binary program (starting at 8000h) on disk
|
|
// - BIN_TAPE .bin BASIC binary program (starting at 8000h) on tape
|
|
// - BIN_USR .bin BASIC USR binary driver (starting at C000h)
|
|
// - DOS1 .com MSX-DOS 1 program (starting at 0100h)
|
|
// - DOS2 .com MSX-DOS 2 program (starting at 0100h)
|
|
// - DOS0 .com Direct program boot from disk (starting at 0100h)
|
|
// - ROM_8K .rom 8 KB ROM in page 1 (4000h ~ 5FFFh)
|
|
// - ROM_8K_P2 .rom 8 KB ROM in page 2 (8000h ~ 9FFFh)
|
|
// - ROM_16K .rom 16 KB ROM in page 1 (4000h ~ 7FFFh)
|
|
// - ROM_16K_P2 .rom 16 KB ROM in page 2 (8000h ~ BFFFh)
|
|
// - ROM_32K .rom 32 KB ROM in page 1&2 (4000h ~ BFFFh)
|
|
// - ROM_48K .rom 48 KB ROM in page 0-2 (0000h ~ BFFFh)
|
|
// - ROM_48K_ISR .rom 48 KB ROM in page 0-2 (0000h ~ BFFFh) with ISR replacement
|
|
// - ROM_64K .rom 64 KB ROM in page 0-3 (0000h ~ FFFFh)
|
|
// - ROM_64K_ISR .rom 64 KB ROM in page 0-3 (0000h ~ FFFFh) with ISR replacement
|
|
// - ROM_ASCII8 .rom ASCII-8: 8 KB segments for a total of 64 KB to 2 MB
|
|
// - ROM_ASCII16 .rom ASCII-16: 16 KB segments for a total of 64 KB to 4 MB
|
|
// - ROM_KONAMI .rom Konami MegaROM (aka Konami4): 8 KB segments for a total of 64 KB to 2 MB
|
|
// - ROM_KONAMI_SCC .rom Konami MegaROM SCC (aka Konami5): 8 KB segments for a total of 64 KB to 2 MB
|
|
// - ROM_NEO8 .rom NEO-8: 8 KB segments for a total of 1 MB to 32 MB
|
|
// - ROM_NEO16 .rom NEO-16: 16 KB segments for a total of 1 MB to 64 MB
|
|
// - ROM_YAMANOOTO .rom Yamanooto: 8 KB segments for a total up to 8 MB
|
|
// - ROM_ASCII16X .rom ASCII16-X: 16 KB segments for a total up to 64 MB
|
|
// - RAW .bin Raw binary code and data to be compiled at a given address
|
|
// - LIB .lib C library to be included in other project
|
|
Target = "ROM_32K";
|
|
|
|
//-- ROM mapper total size in KB (number). Must be a multiple of 8 or 16 depending on the mapper type (from 64 to 4096 for legacy mappers; can be up to 65536 for NEO-16 mapper)
|
|
ROMSize = 128;
|
|
|
|
//-- Check for ROM boot skipping if a given key is pressed (boolean)
|
|
ROMSkipBoot = false;
|
|
|
|
//-- The key to be check for ROM boot skipping (string). Key must be from keyboard row #7.
|
|
// - F4
|
|
// - F5
|
|
// - ESC
|
|
// - TAB
|
|
// - STOP
|
|
// - BS
|
|
// - SELECT
|
|
// - RETURN
|
|
ROMSkipBootKey = "ESC";
|
|
|
|
//-- Add code to check MSX version at program startup (boolean)
|
|
CheckVersion = false;
|
|
|
|
//-- Postpone the ROM startup to let the other ROMs initialize like Disk controller or Network cartridge (boolean)
|
|
ROMDelayBoot = false;
|
|
|
|
//-- Add a ROM signature to help flasher and emulator to detect the ROM type properly (boolean)
|
|
AddROMSignature = false;
|
|
|
|
//-- Select RAM in slot 0 and install ISR and optional code there (string). For MSX with at least 64 KB of RAM
|
|
// - RAM0_NONE Don't install RAM in page 0
|
|
// - RAM0_ISR Install only ISR
|
|
// - RAM0_SEGMENT Install ISR and segment data (for mapped-ROM)
|
|
InstallRAMISR = "RAM0_NONE";
|
|
|
|
//-- Type of custom ISR to install (string). ISR is install in RAM or ROM depending on Target and InstallRAMISR parameters
|
|
// - NONE No ISR
|
|
// - ALL Handle all interruptions
|
|
// - VBLANK V-blank handler
|
|
// - VHBLANK V-blank and h-blank handler (V9938 or V9958)
|
|
// - V9990 V-blank, h-blank and command end handler (V9990)
|
|
CustomISR = "VBLANK";
|
|
|
|
//-- Event called before BIOS is released (boolean). For target format that switch out BIOS from page 0
|
|
BIOSReleaseEvent = false;
|
|
|
|
//-- Use automatic banked call and trampoline functions (boolean). For mapped ROM
|
|
BankedCall = false;
|
|
|
|
//-- Overwrite code starting address (number). For example. 0xE000 for a driver in RAM
|
|
ForceCodeAddr = 0;
|
|
|
|
//-- Overwrite RAM starting address (number). For example. 0xE000 for 8K RAM machine
|
|
ForceRamAddr = 0;
|
|
|
|
//-- 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 = [];
|
|
|
|
//-- List of data files to copy to disk (array)
|
|
DiskFiles = [];
|
|
|
|
//-- Size of the final disk (.DSK file). Can be "360K" or "720K" (string)
|
|
DiskSize = "720K";
|
|
|
|
//-- Parse MSX-DOS command-line arguments
|
|
DOSParseArg = true;
|
|
|
|
//*******************************************************************************
|
|
// SIGNATURE SETTINGS
|
|
//*******************************************************************************
|
|
|
|
//-- Add application signature to binary data (boolean)
|
|
AppSignature = false;
|
|
|
|
//-- Application company (*). Can be 2 character string or 16-bits integer (0~65535)
|
|
AppCompany = "XX";
|
|
|
|
//-- Application ID. Can be 2 character string or 16-bits integer (0~65535)
|
|
AppID = 0;
|
|
|
|
//-- Application extra data (array). Comma-separated bytes starting with data size
|
|
AppExtra = [];
|
|
|
|
//*******************************************************************************
|
|
// MAKE SETTINGS
|
|
//*******************************************************************************
|
|
|
|
//-- Force to generate MSXgl static library even if 'msxgl.lib' already exist (boolean)
|
|
BuildLibrary = true;
|
|
|
|
//-- Prepare program for debug (boolean)
|
|
Debug = false;
|
|
|
|
//-- Move debug symbols to deployement folder (boolean)
|
|
DebugSymbols = false;
|
|
|
|
//-- Allow compiler to generate undocumented Z80 instructions (boolean)
|
|
AllowUndocumented = false;
|
|
|
|
//-- Assembler code optimizer (string)
|
|
// - None
|
|
// - Peep SDCC peep hole otpimizer
|
|
// - MDL MDL z80 otpimizer
|
|
AsmOptim = "None";
|
|
|
|
//-- Code optimization priority (string)
|
|
// - Default
|
|
// - Speed
|
|
// - Size
|
|
Optim = "Speed";
|
|
|
|
//-- Code optimization priority (string/integer)
|
|
// - Fast 2000
|
|
// - Default 3000
|
|
// - Optimized 50000
|
|
// - Ultra 200000
|
|
// - Insane 10000000
|
|
CompileComplexity = "Default";
|
|
|
|
//-- Additionnal compilation options (string)
|
|
CompileOpt = "";
|
|
|
|
//-- Skip file if compile data (REL) is newer than the source code (boolean)
|
|
CompileSkipOld = false;
|
|
|
|
//-- Additionnal link options (string)
|
|
LinkOpt = "";
|
|
|
|
//-- Automatic increment of build version in a header file (boolean)
|
|
BuildVersion = false;
|
|
|
|
//-- Package all segments into a lib file to reduce the number of files to link (boolean)
|
|
PackSegments = false;
|
|
|
|
//-- Additionnal options of Hex to Binary convertor (string)
|
|
HexBinOpt = "";
|
|
|
|
//-- Generate Clang compatible Compilation database (boolean)
|
|
GenCompileDB = false;
|
|
|
|
//-- Command lines to be executed before the build process (array)
|
|
PreBuildScripts = [];
|
|
|
|
//-- Command lines to be executed after the build process (array)
|
|
PostBuildScripts = [];
|
|
|
|
//*******************************************************************************
|
|
// LOCALISATION SETTINGS
|
|
//*******************************************************************************
|
|
|
|
//-- List files to be localized (array)
|
|
LocFiles = [];
|
|
|
|
//-- Localization output filename (string)
|
|
LocOutput = "localization.h";
|
|
|
|
//-- Localization structure name (string)
|
|
LocStruct = "g_LocData";
|
|
|
|
//-- Split localization data and definitions in different files (boolean)
|
|
LocSplitDef = false;
|
|
|
|
//*****************************************************************************
|
|
// BUILD TOOL OPTION
|
|
//*****************************************************************************
|
|
|
|
//-- Activate verbose mode and get more build information (boolean)
|
|
Verbose = false;
|
|
|
|
//-- Output build information to the standard console (boolean)
|
|
LogStdout = true;
|
|
|
|
//-- Output build information to a log file (boolean)
|
|
LogFile = false;
|
|
|
|
//-- Name of the log file (string)
|
|
LogFileName = "";
|
|
|
|
//*******************************************************************************
|
|
// ANALYZER SETINGS
|
|
//*******************************************************************************
|
|
|
|
//-- Execute MAP analyzer (boolean)
|
|
Analyzer = false;
|
|
|
|
//-- Analyzer output selection (string)
|
|
// - Console Output to termial console
|
|
// - File Output to file
|
|
// - Both Output to file and termial console (default)
|
|
AnalyzerOutput = "Both";
|
|
|
|
//-- Analyzer report elements (string)
|
|
// - [A] Report areas
|
|
// - [S] Report segments
|
|
// - [M] Report modules
|
|
// - [C] Report code symbols
|
|
// - [V] Report variable symbols
|
|
AnalyzerReport = "ASMCV";
|
|
|
|
//-- Analyzer report sorting (string)
|
|
// - None No sorting (MAP file order)
|
|
// - Alpha Alphanumeric sorting
|
|
// - Size Size sorting (default)
|
|
AnalyzerSort = "Size";
|
|
|
|
//-- Export analyzer data to CSV file (boolean)
|
|
AnalyzerCSV = false;
|
|
|
|
//-- Analyzer CSV file separator (string)
|
|
AnalyzerSeparator = ",";
|
|
|
|
//*******************************************************************************
|
|
// PACKAGE SETTINGS
|
|
//*******************************************************************************
|
|
|
|
//-- Should the build tool create a standalone package? (boolean)
|
|
Standalone = false;
|
|
|
|
//*******************************************************************************
|
|
// EMULATOR SETINGS
|
|
//*******************************************************************************
|
|
|
|
//-------------------------------------------------------------------------------
|
|
// General options
|
|
|
|
EmulMachine = true; //-- Force the MSX version of the emulated machine (boolean)
|
|
EmulMachineName = ""; //-- openMSX machine used to run disk/DOS/tape targets (string, e.g. "Philips_NMS_8250"). These can't boot on C-BIOS (it only autostarts cartridge ROMs), so they need a real MSX whose (copyrighted) system ROMs are in ~/.openMSX/share/systemroms/ or .../machines/. Cartridge ROM targets ignore this and use the version-correct C-BIOS. Empty = C-BIOS for everything.
|
|
Emul60Hz = false; //-- Force the emulated machine to be at 60 Hz (boolean)
|
|
EmulFullScreen = false; //-- Force the emulator to start in fullscreen mode (boolean)
|
|
EmulMute = false; //-- Disable emulator sound (boolean)
|
|
EmulDebug = false; //-- Start emulator debugger with program launch (boolean)
|
|
EmulTurbo = false; //-- Start emulator in turbo mode (boolean)
|
|
|
|
//-- Emulator extra parameters to be add to command-line (string). Emulator sotfware specific
|
|
EmulExtraParam = "";
|
|
|
|
//-------------------------------------------------------------------------------
|
|
// Extension options
|
|
|
|
EmulSCC = false; //-- Add SCC extension (boolean)
|
|
EmulMSXMusic = false; //-- Add MSX-Music extension (boolean)
|
|
EmulMSXAudio = false; //-- Add MSX-Audio extension (boolean)
|
|
EmulOPL4 = false; //-- Add OPL4 extension (boolean)
|
|
EmulPSG2 = false; //-- Add second PSG extension (boolean)
|
|
EmulV9990 = false; //-- Add V9990 video-chip extension (boolean)
|
|
EmulRAM = false; //-- Add mapped-RAM extension (boolean)
|
|
Emul2ndCart = ""; //-- Add additionnal cartridge in secondary slot (string)
|
|
|
|
//-------------------------------------------------------------------------------
|
|
// Input options
|
|
|
|
//-- Plug a virtual device into the joystick port A (string)
|
|
// - Joystick
|
|
// - Mouse
|
|
// - Paddle
|
|
// - JoyMega
|
|
// - NinjaTap
|
|
EmulPortA = "";
|
|
|
|
//-- Plug a virtual device into the joystick port B (string)
|
|
EmulPortB = "";
|
|
|
|
//-------------------------------------------------------------------------------
|
|
// Run device options
|
|
|
|
//-- Run device like 'RISKY MSX' or 'Easy-USB' (string)
|
|
RunDevice = "";
|
|
|
|
//-- Run device option (string)
|
|
RunDeviceOpt = "";
|