More HBIOS Cleaning, FLASH & FAT App Updates

- Additional HBIOS reorganization - no functional changes (in theory)
- Upgrade to v1.3.8 of FLASH4 from Will Sowerbutts
- Upgrade to FAT v1.1 based on input from Peter (@z80micro-mc)

Co-Authored-By: Will Sowerbutts <will@sowerbutts.com>

Source/Apps/FAT/ReadMe.md

@@ -1,7 +1,7 @@
 # RomWBW HBIOS CP/M FAT Utility ("FAT.COM")
 
 Author: Wayne Warthen \
-Updated: 6-Jan-2024
+Updated: 6-May-2024
 
 This application allows copying files between CP/M filesystems and FAT 
 filesystems (DOS, Windows, Mac, Linux, etc.).  The application runs on 
@@ -72,6 +72,38 @@ creation.
  - Wildcard matching in FAT filesystems is a bit unusual as
    implemented by FatFs.  See FatFs documentation.
 
+ - The `FAT FORMAT` command will not perform a physical format on
+   floppy disks.  You must use FDU to do this prior to using
+   `FAT FORMAT`.
+
+ - Formatting (`FAT FORMAT`) of floppies does not work well.  The    
+   underlying FatFs library uses some non-standard fields.  The 
+   resulting floppy may or may not be useable on other systems.  It is 
+   best to format a FAT floppy on a Windows or DOS system.  You should 
+   have no problems copying files to/from such a floppy using `FAT`.
+
+### Known Issues
+
+ - CP/M (and workalike) OSes have significant restrictions on filename
+   characters.  The FAT application will block any attempt to create a
+   file on the CP/M filesystem containing any of these prohibited
+   characters:
+
+|         `< > . , ; : ? * [ ] |/ \`
+
+   The operation will be aborted with "`Error: Invalid Path Name`" if such
+   a filename character is encountered.
+
+   Since MS-DOS does allow some of these characters, you can have
+   issues when copying files from MS-DOS to CP/M if the MS-DOS filenames
+   use these characters.  Unfortunately, FAT is not yet smart enough to
+   substitute illegal characters with legal ones.  So, you will need to
+   clean the filenames before trying to copy them to CP/M.
+
+ - The FAT application does try to detect the scenario where you are
+   copying a file to itself.  However, this detection is not perfect and
+   can corrupt a file if it occurs.  Be careful to avoid this.
+
 ### License:
 
   GNU GPLv3 (see file LICENSE.txt)
@@ -123,3 +155,4 @@ creation.
 | 12-Oct-2023 | v0.9.9  | (beta) handle updated HBIOS Disk Device call                |
 | 6-Jan-2024  | v1.0.0  | updated to latest FsFat (v0.15)                             |
 |             |         | updated to latest SDCC (v4.3)                               |
+| 6-May-2024  | v1.1.0  | improve floppy format boot record                           |

Source/HBIOS/asci.asm

@@ -618,7 +618,7 @@ ASCI_DETECT:
 ; Z180 DIVISOR IS ALWAYS A FACTOR OF 160
 ;
 ; CNTLB=	XXPXDSSS
-; FAILSAVE = 	00100000
+; FAILSAFE = 	00100000
 ;
 ; PS (PRESCALE): 0=/10, 1=/30
 ; DR (DIVIDE RATIO): 0=/16, 1=/64

Source/HBIOS/std.asm

@@ -24,10 +24,8 @@
 ; 20. MON	Jacques Pelletier's Monsputer
 ; 21. STDZ180	Genesis Z180 System
 ; 22. NABU	NABU w/ Les Bird's RomWBW Option Board
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;
-; INCLUDE VERSION
+; INCLUDE BUILD VERSION
 ;
 #INCLUDE "../ver.inc"			; ADD BIOSVER
 ;
@@ -1009,17 +1007,6 @@ INT_SIO1	.EQU	14	; ZILOG SIO 1, CHANNEL A & B
 
   #IF (PLATFORM == PLT_MBC)
 ;
-; MBC IM2 PINHEADER INTERRUPTS
-;
-;INT_IM2PH0	.EQU	0
-;INT_IM2PH1	.EQU	1
-;INT_IM2PH2	.EQU	2
-;INT_IM2PH3	.EQU	3
-;INT_IM2PH4	.EQU	4
-;INT_IM2PH5	.EQU	5
-;INT_IM2PH6	.EQU	6
-;INT_IM2PH7	.EQU	7
-;
 ; MBC Z80 INTERRUPTS
 ;
 ;INT_CTC0A	.EQU	0	; ZILOG CTC 0, CHANNEL A
@@ -1044,17 +1031,6 @@ INT_CTC0D	.EQU	15	; ZILOG CTC 0, CHANNEL D
   #ENDIF
 
   #IF (PLATFORM == PLT_DUO)
-
-; DUO IM2 PINHEADER INTERRUPTS
-
-;INT_IM2PH0	.EQU	0
-;INT_IM2PH1	.EQU	1
-;INT_IM2PH2	.EQU	2
-;INT_IM2PH3	.EQU	3
-;INT_IM2PH4	.EQU	4
-;INT_IM2PH5	.EQU	5
-;INT_IM2PH6	.EQU	6
-;INT_IM2PH7	.EQU	7
 ;
 ; DUO Z80 IM2 INTERRUPTS
 ;

Source/ver.inc

@@ -2,7 +2,7 @@
 #DEFINE	RMN	5
 #DEFINE	RUP	0
 #DEFINE	RTP	0
-#DEFINE BIOSVER	"3.5.0-dev.35"
+#DEFINE BIOSVER	"3.5.0-dev.36"
 #define rmj	RMJ
 #define rmn	RMN
 #define rup	RUP

Source/ver.lib

@@ -3,5 +3,5 @@ rmn	equ	5
 rup	equ	0
 rtp	equ	0
 biosver	macro
-	db	"3.5.0-dev.35"
+	db	"3.5.0-dev.36"
 	endm