Merge pull request #651 from b3rendsh/master

MSX Combo Disk follow-up

Source/Images/d_msx/ReadMe.txt

@@ -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

Source/MSX/BuildMsxDsk.ps1

@@ -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"
 

Source/MSX/ReadMe.md

@@ -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.

Source/MSX/d_fat/README.TXT

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