40 lines
1.1 KiB
Markdown
40 lines
1.1 KiB
Markdown
# MSXBUILD
|
|
|
|
Utils to use openMSX in build pipelines.
|
|
|
|
You can use these scripts as-is. But as always, feel free to extend it
|
|
for your specific needs or contribute a fix or feature.
|
|
|
|
## Makefile features
|
|
|
|
* SDCC msx build steps
|
|
* Headless openMSX buildpipe on max speed.
|
|
* openMSX safe exit failure guards.
|
|
* Automatic disk image import + export per build step.
|
|
* wgets resources from msxhub
|
|
|
|
## TCL Scripts
|
|
|
|
Tcl scripts for safe openMSX integrations as reliable build step
|
|
in compiling/packing/testing msx software natively.
|
|
But managed from external build tool like make or scripts.
|
|
This means that great care is given to make sure that openMSX
|
|
exits correctly.
|
|
|
|
The use this, pass the one or more scripts on the command line and
|
|
set the optional environment variables when executing openMSX:
|
|
|
|
FAIL_AFTER_BOOT=30 \
|
|
FAIL_AFTER_PATH=bin/myapp \
|
|
BOOT_HDD_PATH=bin/myapp/disk \
|
|
BOOT_HDD_IMAGE=bin/myapp/disk.img \
|
|
JOYPORTA=mouse \
|
|
openmsx \
|
|
-script <path-to>/boot_env.tcl \
|
|
-script <path-to>/boot_hdd.tcl \
|
|
-script <path-to>/fail_after.tcl \
|
|
-machine ...
|
|
|
|
Check the scripts source code for more (technical) details.
|
|
|