// ____________________________ // ██▀▀█▀▀██▀▀▀▀▀▀▀█▀▀█ │ ▄▄▄ ▄ ▄▄ ▄▄ ▄▄▄▄ ▄▄ // ██ ▀ █▄ ▀██▄ ▀ ▄█ ▄▀▀ █ │ ██▄▀ ██ █ ▄ ██ ▄██ ██ ▄█▀▄ ▄█▀▄ ██ // █ █ █ ▀▀ ▄█ █ █ ▀▄█ █▄ │ ██▄▀ ▀█▄█ ██ ▀█▄ ▀▄██ ██ ▀█▄▀ ▀█▄▀ ▀█▄ // ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀────────┘ // 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 = "";