| lib | ||
| test | ||
| .gitignore | ||
| .project | ||
| Makefile | ||
| Makelocal.mk.tpl | ||
| README.md | ||
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.
Features
- SDCC msx build steps.
- Allows headless openMSX buildpipe.
- openMSX safe exit failure guards.
- Automatic disk image import + export per build step.
- Downloads and caches resources from msxhub.com
Dependencies
- make
- openmsx
- sdcc
- hex2bin
- wget
- unix2dos
Usage
Include the lib/make/msxbuild.mk file from your Makefile.
And override the required paths;
- PATH_SDCC ?= /usr/bin
- PATH_HEX2BIN ?= /usr/bin
- PATH_UNIX2DOS ?= /usr/bin
- PATH_OPENMSX ?= /opt/openMSX/bin/
- PATH_MSXBUILD ?= /opt/msxbuild
Then build result based compile rules see an example in; test/ahello/0module.mk
Functions
Current set is WIP.
- mb_compile_asm
- mb_link_asm_lib
- mb_link_asm
- mb_link_asm_0000 = call mb_link_asm,$(1),$(2),0x0000
- mb_link_asm_0100
- mb_link_asm_1000
- mb_link_asm_4000
- mb_link_asm_8000
- mb_link_asm_C000
- mb_link_asm_dos = alias for mb_link_asm_0100
- mb_hex2com
- mb_hex2dat
- mb_openmsx_dos2
- mb_openmsx_macro80
- mb_msxhub_file
- mb_msxhub_get_dos2
- mb_msxhub_get_macro80
- mb_assert_file_equals = note: text file only
- mb_autoexec_append_cmd
- mb_autoexec_append_echo
- mb_autoexec_append_rem
- mb_autoexec_append_gui_mode
- mb_autoexec_append_stop_fail
- mb_autoexec_append_exit
- mb_autoexec_write_default
- mb_autoexec_open_gui
- mb_autoexec_open_gui_cmd
- mb_autoexec_cmd
- mb_autoexec_cmd_test
- mb_clean
- mb_mkdir
- mb_delete
- mb_copy
- mb_create_dist
Errata
- Doesn't work on windows
- Missing dos1 support
- Missing c support