Miscellaneous

- Add minimal Fuzix instructions to User Guide
- Enable CTC auto-detect by default for RCBus.  It causes no problems to auto-detect it and it will stop a CTC from generating unexpected interrupts after a soft restart.
- Upgrade `SUPERSUB` to v1.3 (previously v1.1)

ReadMe.md

@@ -3,7 +3,7 @@
 **RomWBW ReadMe** \
 Version 3.4 \
 Wayne Warthen  ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \
-08 Oct 2023
+09 Oct 2023
 
 # Overview
 

ReadMe.txt

@@ -1,6 +1,6 @@
 RomWBW ReadMe
 Wayne Warthen (wwarthen@gmail.com)
-08 Oct 2023
+09 Oct 2023
 
 
 

Source/Doc/UserGuide.md

@@ -2363,6 +2363,53 @@ You can also contact Phillip for detailed information on the Z180
 implementation of FreeRTOS for RomWBW.
 [feilipu](https://github.com/feilipu)
 
+## Fuzix
+
+Fuzix is a Unix-ish operating system for small systems.  It is the work 
+of Alan Cox and is hosted on GitHub at
+<https://github.com/EtchedPixels/FUZIX>. Fuzix itself is a stand-alone 
+operating system, but it frequently utilizes RomWBW to boot and launch 
+on RomWBW-supported platforms.
+
+For those Fuzix platforms that leverage RomWBW for startup, you will
+program your ROM with the normal RomWBW ROM -- there
+is no Fuzix-specific ROM.  A Fuzix disk image for your system is then
+written to your disk media.  After booting your system via the normal
+RomWBW ROM, you start Fuzix simply by choosing the disk device
+containing the Fuzix image at the RomWBW Loader prompt.
+
+To create a Fuzix disk image:
+
+* Locate and download the Fuzix disk image for your system from
+  <https://www.fuzix.org/>.
+
+* Remove the 1KB header from the image file.  The Fuzix disk images
+  are built to run under an emulator that requires a 1KB prefix.  You
+  must remove this prefix before writing the image to your physical
+  disk media.  Unix dd is the easiest way to do this:
+  
+  `dd bs=1024 skip=1 if=sc126-0.3.ide of=sc126-0.3.trimmed`
+
+* Write the trimmed image to your disk media.  This can also be
+  done with dd or with Win32DiskImager under Windows.
+
+To boot into Fuzix:
+
+* Power-up or reset your system.  RomWBW should load normally
+  and bring you to the RomWBW Boot Loader prompt.
+
+* Change your baud rate to 38,400.  This can be done from the
+  RomWBW Boot Loader prompt with the following command:
+
+  `I 0 38400`
+
+  You will also need to change your terminal baud rate at this time.
+
+* At the `bootdev:` prompt, enter `hda1`.  Fuzix should load and
+  you will be prompted for a date/time.
+
+* At the `login:` prompt, enter `root`.  No password is required.
+
 # Custom Applications
 
 The operation of the RomWBW hosted operating systems is enhanced through

Source/HBIOS/Bank Layout.txt

@@ -27,7 +27,18 @@ Bank ID		Module		Start	Size
 0x04 - N	ROM Disk Data
 
 
-RAM Bank Layout
+Typical ROM Bank Layout
+
+Bank ID         Usage
+-------         ------
+0x00            Boot Bank (HBIOS image)
+0x01		ROM Loader, Monitor, ROM OSes
+0x02		ROM Applications
+0x03		Reserved
+0x04-0x0F	ROM Disk Banks
+
+
+Typical RAM Bank Layout
 
 Bank ID         Usage
 -------         ------
@@ -39,7 +50,7 @@ Bank ID         Usage
 0x8F            Common
 
 
-ROMless Bank Layout
+Typical ROMless Bank Layout
 
 Bank ID         Usage
 -------         ------

Source/HBIOS/cfg_rcz80.asm

@@ -46,7 +46,7 @@ RTCIO		.EQU	$C0		; RTC LATCH REGISTER ADR
 KIOENABLE	.EQU	FALSE		; ENABLE ZILOG KIO SUPPORT
 KIOBASE		.EQU	$80		; KIO BASE I/O ADDRESS
 ;
-CTCENABLE	.EQU	FALSE		; ENABLE ZILOG CTC SUPPORT
+CTCENABLE	.EQU	TRUE		; ENABLE ZILOG CTC SUPPORT
 CTCDEBUG	.EQU	FALSE		; ENABLE CTC DRIVER DEBUG OUTPUT
 CTCBASE		.EQU	$88		; CTC BASE I/O ADDRESS
 CTCTIMER	.EQU	FALSE		; ENABLE CTC PERIODIC TIMER

Source/HBIOS/ctc.asm

@@ -25,7 +25,7 @@ CTC_TIM256CFG	.EQU	%00110111	; CTC TIMER/256 MODE CONFIG
 ; DETERMINE WHICH CHANNEL CAUSED AN INTERRUPT.
 ;==================================================================================================
 ;
-#IF (INTMODE != 2)
+#IF (CTCTIMER & (INTMODE != 2))
 	.ECHO	"*** WARNING: CTC TIMER DISABLED -- INTMODE 2 REQUIRED!!!\n"
 #ENDIF
 ;

Source/HBIOS/std.asm

@@ -640,27 +640,26 @@ RAMD_BNKS	.EQU	(BID_RAMDN - BID_RAMD0 + 1)
 ;
 #ENDIF
 ;
-#IF TRUE
-	.ECHO "BID_BUF: " \ .ECHO BID_BUF \ .ECHO "\n"
-	.ECHO "BID_AUX: " \ .ECHO BID_AUX \ .ECHO "\n"
-	.ECHO "BID_BIOS: " \ .ECHO BID_BIOS \ .ECHO "\n"
-	.ECHO "BID_USR: " \ .ECHO BID_USR \ .ECHO "\n"
-	.ECHO "BID_COM: " \ .ECHO BID_COM \ .ECHO "\n"
-
+#IF FALSE
+	.ECHO "--- RAM/ROM CAPACITY ---\n"
+	.ECHO "BID_ROM0: " \ .ECHO BID_ROM0 \ .ECHO "\n"
+	.ECHO "BID_ROMN: " \ .ECHO BID_ROMN \ .ECHO "\n"
+	.ECHO "BID_RAM0: " \ .ECHO BID_RAM0 \ .ECHO "\n"
+	.ECHO "BID_RAMN: " \ .ECHO BID_RAMN \ .ECHO "\n"
+	.ECHO "--- BANK LAYOUT ---\n"
 	.ECHO "BID_BOOT: " \ .ECHO BID_BOOT \ .ECHO "\n"
 	.ECHO "BID_IMG0: " \ .ECHO BID_IMG0 \ .ECHO "\n"
 	.ECHO "BID_IMG1: " \ .ECHO BID_IMG1 \ .ECHO "\n"
 	.ECHO "BID_IMG2: " \ .ECHO BID_IMG2 \ .ECHO "\n"
-
 	.ECHO "BID_ROMD0: " \ .ECHO BID_ROMD0 \ .ECHO "\n"
 	.ECHO "BID_ROMDN: " \ .ECHO BID_ROMDN \ .ECHO "\n"
+	.ECHO "BID_BIOS: " \ .ECHO BID_BIOS \ .ECHO "\n"
 	.ECHO "BID_RAMD0: " \ .ECHO BID_RAMD0 \ .ECHO "\n"
 	.ECHO "BID_RAMDN: " \ .ECHO BID_RAMDN \ .ECHO "\n"
-
-	.ECHO "BID_ROM0: " \ .ECHO BID_ROM0 \ .ECHO "\n"
-	.ECHO "BID_ROMN: " \ .ECHO BID_ROMN \ .ECHO "\n"
-	.ECHO "BID_RAM0: " \ .ECHO BID_RAM0 \ .ECHO "\n"
-	.ECHO "BID_RAMN: " \ .ECHO BID_RAMN \ .ECHO "\n"
+	.ECHO "BID_BUF: " \ .ECHO BID_BUF \ .ECHO "\n"
+	.ECHO "BID_AUX: " \ .ECHO BID_AUX \ .ECHO "\n"
+	.ECHO "BID_USR: " \ .ECHO BID_USR \ .ECHO "\n"
+	.ECHO "BID_COM: " \ .ECHO BID_COM \ .ECHO "\n"
 #ENDIF
 ;
 ; MEMORY LAYOUT

Source/Images/Common/All/SUPERSUB.DOC

@@ -1,4 +1,4 @@
-			SUPERSUB DOCUMENTATION	(revised 09/13/81)
+			SUPERSUB DOCUMENTATION	(revised 09/25/84)
 			----------------------
 
 						09/05/81
@@ -11,6 +11,17 @@ are familiar with that utility and its use.
 
 			------------------
 
+Version 1.3 update:
+
+George Cary has added MP/M capability to version 1.2 of SuperSUB. In
+version 1.3 I fixed a problem that caused SuperSUB to bomb when the
+.SUB file did not end in a 1AH (which is an ascii end-of-file
+character). It was depending on the 1AH to end the file, and ignoring
+the physical end-of-file. Physical end-of-file will now terminate
+properly.			- Jeffrey J. Nonken
+
+			------------------
+
 Version 1.1 update:
 
 Control-character translation has been added.  This facility works
@@ -138,4 +149,4 @@ NOTES
 5) Interactive mode may be aborted by typing control-C as the first
    character of a line.  Also, all normal CP/M editing characters are
    available.
-
+