MirrorRepos/RomWBW
1
0
Fork 1
mirror of https://github.com/wwarthen/RomWBW.git synced 2026-02-06 14:11:48 -06:00
Code Issues Projects Releases Wiki Activity

MSX Combo Disk follow-up

Browse Source
This commit is contained in:
H.J.Berends
2026-01-10 13:29:01 +01:00
parent 998babfdfb
commit 91bf21e3eb
5 changed files with 86 additions and 94 deletions
Download Patch File Download Diff File Expand all files Collapse all files

152
Source/Images/d_msx/ReadMe.txt
View File

@@ -1,76 +1,76 @@
===== MSX System Disk for RomWBW =====
This disk is one of several ready-to-run disks provided with RomWBW.
It contains software to launch the MSX system or a MSX (game) ROM.
The source code is maintained in following repository:
https://github.com/b3rendsh/msxbase
== Requirements ==
HBDOS can be used on a Z80 or Z180 RomWBW computer with at least 192KB RAM and
support for a system timer. MSX BASIC and the MSX ROM loader require a TMS9918A
compatible video card, system timer and 128KB RAM.
hbmsx.com requires a keyboard and VDP that is compliant with the MSX standard.
rcmsx.com uses the console keyboard and text output is displayed on both the
console and video card.
msxrom.com uses the console keyboard and requires a MSX compliant VDP and PSG.
To use HBDOS the first FAT partition on the first large storage media must
contain the MSX command interpreter i.e. the COMMAND.COM file.
Different hardware and software configurations can be supported by using
alternative build options, see source repository.
== Usage ==
Start hbmsx.com or rcmsx.com to load the MSX system HBDOS / Disk BASIC.
Start msxrom.com to load a MSX (game) ROM image e.g. "msxrom arkanoid.rom".
== HBDOS ==
HBDOS is compatible with all functions of MSX-DOS 1 and includes enhancements
to support large disks with standard FAT12 or FAT16 partitions.
It is a CP/M 2.2 work-alike DOS that uses the FAT filesystem. Many text
applications that work on MSX-DOS 1 or CP/M 2.2 will run without modification.
Direct disk access, FAT32, i/o byte, user areas and subdirectories are not
supported.
At the DOS command prompt enter "basic" to start MSX BASIC.
== BASIC ==
All functions of MSX BASIC are available, if HBDOS is loaded then the Disk
BASIC extension is also available.
Use the IPL command to return to RomWBW i.e. do a cold reboot.
In Disk BASIC use "call system" to return to the DOS command prompt.
== ROM CART ==
The MSX ROM loader supports MSX ROM cartridge images of maximum 32KB.
Not all MSX ROM games will work and some games may require an additional ROM
patch or additional hardware. When a MSX ROM is running you can reboot RomWBW
by pressing the CTRL+STOP key (default mapped to CTRL+V).
== Console ==
The RomWBW (VT100) console can be used for keyboard input and screen output,
with some limitations:
Cursor and function keys may not work, use control key combinations or a MSX
compatible keyboard.
To paste text into BASIC set the terminal send character delay to at least 40ms.
The MSX BIOS uses VT52 escape sequences, on a VT100 console sometimes an extra
character is displayed.
The MSX 1 BIOS text mode is set to 40 columns.
-- HJB 01/06/2026
===== MSX System Disk for RomWBW =====
This disk is one of several ready-to-run disks provided with RomWBW.
It contains software to launch the MSX system or a MSX (game) ROM.
The source code is maintained in following repository:
https://github.com/b3rendsh/msxbase
== Requirements ==
HBDOS can be used on a Z80 or Z180 RomWBW computer with at least 192KB RAM and
support for a system timer. MSX BASIC and the MSX ROM loader require a TMS9918A
compatible video card, system timer and 128KB RAM.
hbmsx.com requires a keyboard and VDP that is compliant with the MSX standard.
rcmsx.com uses the console keyboard and text output is displayed on both the
console and video card.
msxrom.com uses the console keyboard and requires a MSX compliant VDP and PSG.
To use HBDOS the first FAT partition on the first large storage media must
contain the MSX command interpreter i.e. the COMMAND.COM file.
Different hardware and software configurations can be supported by using
alternative build options, see source repository.
== Usage ==
Start hbmsx.com or rcmsx.com to load the MSX system HBDOS / Disk BASIC.
Start msxrom.com to load a MSX (game) ROM image e.g. "msxrom arkanoid.rom".
== HBDOS ==
HBDOS is compatible with all functions of MSX-DOS 1 and includes enhancements
to support large disks with standard FAT12 or FAT16 partitions.
It is a CP/M 2.2 work-alike DOS that uses the FAT filesystem. Many text
applications that work on MSX-DOS 1 or CP/M 2.2 will run without modification.
Direct disk access, FAT32, i/o byte, user areas and subdirectories are not
supported.
At the DOS command prompt enter "basic" to start MSX BASIC.
== BASIC ==
All functions of MSX BASIC are available, if HBDOS is loaded then the Disk
BASIC extension is also available.
Use the IPL command to return to RomWBW i.e. do a cold reboot.
In Disk BASIC use "call system" to return to the DOS command prompt.
== ROM CART ==
The MSX ROM loader supports MSX ROM cartridge images of maximum 32KB.
Not all MSX ROM games will work and some games may require an additional ROM
patch or additional hardware. When a MSX ROM is running you can reboot RomWBW
by pressing the CTRL+STOP key (default mapped to CTRL+V).
== Console ==
The RomWBW (VT100) console can be used for keyboard input and screen output,
with some limitations:
Cursor and function keys may not work, use control key combinations or a MSX
compatible keyboard.
To paste text into BASIC set the terminal send character delay to at least 40ms.
The MSX BIOS uses VT52 escape sequences, on a VT100 console sometimes an extra
character is displayed.
The MSX 1 BIOS text mode is set to 40 columns.
-- HJB 01/06/2026

8
Source/MSX/BuildMsxDsk.ps1
View File

@@ -41,10 +41,10 @@ Expand-Archive -Force -Path msximg.zip
# Populate FAT system partition
&"mtools" -c copy -i msximg\msx_sys.dsk -omv d_fat\*.* ::
&"mtools" -c copy -i msximg\msx_sys.dsk -omv ..\..\Binary\MSX_std.rom ::MSX-STD.ROM
&"mtools" -c copy -i msximg\msx_sys.dsk -omv ..\..\Binary\msx-ldr.com ::MSX-LDR.COM
&"mtools" -c copy -i msximg\msx_sys.dsk -omv ..\..\Binary\Apps\reboot.com ::REBOOT.COM
&"mtools" -c mcopy -i msximg\msx_sys.dsk -omv d_fat\*.* ::
&"mtools" -c mcopy -i msximg\msx_sys.dsk -omv ..\..\Binary\MSX_std.rom ::MSX-STD.ROM
&"mtools" -c mcopy -i msximg\msx_sys.dsk -omv ..\..\Binary\msx-ldr.com ::MSX-LDR.COM
&"mtools" -c mcopy -i msximg\msx_sys.dsk -omv ..\..\Binary\Apps\reboot.com ::REBOOT.COM
$FileList = "msximg\msx_mbr.dat +" + $FileList + "+ msximg\msx_sys.dsk + msximg\msx_data.dsk"

12
Source/MSX/ReadMe.md
View File

@@ -19,12 +19,8 @@ image.
Usage
-----
1. Copy the Source folder into the RomWBW folder.
2. Download mtools for Windows: https://github.com/YawHuei/mtools_win32
3. Copy the mtools executables into the (new) RomWBW\Tools\mtools folder
4. Run the RomWBW build script for your platform e.g. "build msx std"
or "build rcz80 std"
5. In the Source\MSX folder run "BuildMsxDsk.cmd"
First run the RomWBW build script for your platform e.g. "build msx std"
or "build rcz80 std" then in the Source\MSX folder run "BuildMsxDsk.cmd"
If the scripts run successfully the Binary\msx_combo.dsk file is created.
@@ -46,7 +42,3 @@ RomWBW this will be the A-drive.
The FAT16 data partition is a formatted empty partition.
If the MSX system is started from RomWBW this will be the B-drive.
Note
----
This is a work in progress and subject to change without notice.

8
Source/MSX/d_fat/README.TXT
View File

@@ -1,5 +1,5 @@
===== FAT Disk for RomWBW =====
FAT / MSX system files
===== FAT Disk for RomWBW =====
FAT / MSX system files
-- HJB 12/06/2025