diff --git a/Doc/RomWBW Applications.pdf b/Doc/RomWBW Applications.pdf index 63dc9ce4..cef5b316 100644 Binary files a/Doc/RomWBW Applications.pdf and b/Doc/RomWBW Applications.pdf differ diff --git a/Doc/RomWBW Disk Catalog.pdf b/Doc/RomWBW Disk Catalog.pdf index e27a0345..316f02f0 100644 Binary files a/Doc/RomWBW Disk Catalog.pdf and b/Doc/RomWBW Disk Catalog.pdf differ diff --git a/Doc/RomWBW Errata.pdf b/Doc/RomWBW Errata.pdf index 2cb9070e..f189aa1f 100644 Binary files a/Doc/RomWBW Errata.pdf and b/Doc/RomWBW Errata.pdf differ diff --git a/Doc/RomWBW System Guide.pdf b/Doc/RomWBW System Guide.pdf index 9f0c2b6e..eb0909ed 100644 Binary files a/Doc/RomWBW System Guide.pdf and b/Doc/RomWBW System Guide.pdf differ diff --git a/Doc/RomWBW User Guide.pdf b/Doc/RomWBW User Guide.pdf index e498a456..9404b1a9 100644 Binary files a/Doc/RomWBW User Guide.pdf and b/Doc/RomWBW User Guide.pdf differ diff --git a/ReadMe.md b/ReadMe.md index bb27aadf..3be45541 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -3,7 +3,7 @@ **RomWBW ReadMe** \ Version 3.5 \ Wayne Warthen ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \ -26 Sep 2024 +27 Sep 2024 # Overview diff --git a/ReadMe.txt b/ReadMe.txt index d85a7916..aeac66fc 100644 --- a/ReadMe.txt +++ b/ReadMe.txt @@ -1,6 +1,6 @@ RomWBW ReadMe Wayne Warthen (wwarthen@gmail.com) -26 Sep 2024 +27 Sep 2024 diff --git a/Source/Apps/copysl/copysl.com b/Source/Apps/copysl/copysl.com index ce1519b1..269abbbb 100644 Binary files a/Source/Apps/copysl/copysl.com and b/Source/Apps/copysl/copysl.com differ diff --git a/Source/Apps/copysl/copysl.doc b/Source/Apps/copysl/copysl.doc index c2f7e9c4..57fc09ac 100644 --- a/Source/Apps/copysl/copysl.doc +++ b/Source/Apps/copysl/copysl.doc @@ -1,5 +1,5 @@ ========================================================================== - CopySlice Utility v0.1 for RomWbW computers + CopySlice Utility v0.2 for RomWbW computers written by Mark Pruden (Sept 2024) ========================================================================== @@ -15,6 +15,9 @@ Background This tool is only supported by RomWBW HBIOS, it uses HDIOS for all its disk IO. UNA UBIOS is not supported by this tool. +This tool is running on CP/M 2.2 or 3.0 and has access to full 64kb of +RAM, with a minimum of 48kb TPA + This tool only works with hard disk devices, other media types like floppy, are not supported at this time. This tool works across different hard disk device types, even of different physical type @@ -22,9 +25,9 @@ hard disk device types, even of different physical type Both hd1k and hd512 are fully supported, however copying from one layout type to the other is not supported. -During operation data is copied in a single read/write pass, noting data -is not verified by a re-read. If there is a write error, it will be reported, -and operation will stop. +During operation data is copied in a single read/write pass, data is not +verified by default. If there is a write error, it will be reported, and +operation will stop. General Usage ------------- @@ -39,41 +42,57 @@ E.g. COPYSL 3.3=2.10 /U -Means copy from slice 10 on disk 2, onto disk 3 slice 3. Tis is in unattended -mode, so you will not be asked to confirm the copy operation. +Means copy from slice 10 on disk 2, onto disk 3 slice 3. This is in +unattended mode, so you will not be asked to confirm the copy operation. Options ------- -U - Unattended. Will complete copy without confirmation from the user F - Full disk copy. Copies the complete disk slice, all sectors. +U - Unattended. Will complete copy without confirmation from the user. +V - Verify. Does an additional read and verify after write. Description ----------- When run COPYSL will perform command line argument validation and display -an error if they are illegal. Also any disk IO errors will cause COPYSL to exit. +an error if they are illegal. Also any disk IO errors will cause COPYSL +to exit. + +When specifying slice number(s) a check is made that the slice number is +valid, i.e. not too large that it would extend past the end of the +partition (hd1k), or the end of the media (hd512). For hd512 a check is +also performed to ensure that the slice would not extend into the first +defined partition. -When specifying slice number(s) a check is made that the slice number is valid, -i.e. not too large that it would extend past the end of the partition (hd1k), -or the end of the media (hd512). For hd512 a check is also performed to -ensure that the slice would not extend into the first defined partition. +The copy operation will be faster if the source disk has been formatted +with the CP/M file system, since during copy the CP/M directory is scanned, +and unused blocks are not copied. -The copy operation will be faster if the source disk has been formatted with -the CP/M file system, since during copy the CP/M directory is scanned, and -unused blocks are not copied. +If a filesystem is not found, (or the /F option is chosen) all data is +copied. -If a filesystem is not found, (or the /F option is chosen) all data is copied. +Verification (if option chosen) will do an aditional read (after write) +and compare the data read matches what was written. This compare is only +on every 32'nd byte. This is done for efficiency. During copy dots "." will be displayed to indicate progress of the copy. -Each "." represents 16 kBytes of data copied. Each line of "." 's is 1 mBytes. +Each "." represents 16 kBytes of data. Each line of "." 's is 1 mBytes. Testing ------- -This tool has been tested on both SD and CF media types and with hd1k and hd512 -formatted media +This tool has been writen and tested on a SC126 computer. Testing been on both +SD and CF media types, and with both hd1k and hd512 formats + +History +------- +* v 0.1 Initial Release +* v 0.2 Added the /v command option to read and verify after write Future ------ -* support a verify option to read/verify data just written +* support ability to read and write from image files stored in CP/M filesystem +* maybe the verify options could allow more complete verification. + This would be at the cost of performance +* ability to abort once the copy has started - \ No newline at end of file + \ No newline at end of file diff --git a/Source/Doc/Applications.md b/Source/Doc/Applications.md index a87b02b0..74645de9 100644 --- a/Source/Doc/Applications.md +++ b/Source/Doc/Applications.md @@ -1220,6 +1220,9 @@ from one disk slice to another slice This tool is only supported by RomWBW HBIOS, it uses HDIOS for all its disk IO. UNA UBIOS is not supported by this tool. +This tool is running on CP/M 2.2 or 3.0 and has access to full 64kb of +RAM, with a minimum of 48kb TPA + This tool only works with hard disk devices, other media types like floppy, are not supported at this time. This tool works across different hard disk device types, even of different physical type @@ -1227,9 +1230,9 @@ hard disk device types, even of different physical type Both hd1k and hd512 are fully supported, however copying from one layout type to the other is not supported. -During operation data is copied in a single read/write pass, noting data -is not verified by a re-read. If there is a write error, it will be reported, -and operation will stop. +During operation data is copied in a single read/write pass, data is not +verified by default. If there is a write error, it will be reported, and +operation will stop. #### Syntax @@ -1249,27 +1252,35 @@ mode, so you will not be asked to confirm the copy operation. #### Options +F - Full disk copy. Copies the complete disk slice, all sectors. \ U - Unattended. Will complete copy without confirmation from the user. \ -F - Full disk copy. Copies the complete disk slice, all sectors. +V - Verify. Does an additional read and verify after write. #### Usage When run COPYSL will perform command line argument validation and display -an error if they are illegal. Also any disk IO errors will cause COPYSL to exit. +an error if they are illegal. Also any disk IO errors will cause COPYSL +to exit. + +When specifying slice number(s) a check is made that the slice number is +valid, i.e. not too large that it would extend past the end of the +partition (hd1k), or the end of the media (hd512). For hd512 a check is +also performed to ensure that the slice would not extend into the first +defined partition. -When specifying slice number(s) a check is made that the slice number is valid, -i.e. not too large that it would extend past the end of the partition (hd1k), -or the end of the media (hd512). For hd512 a check is also performed to -ensure that the slice would not extend into the first defined partition. +The copy operation will be faster if the source disk has been formatted +with the CP/M file system, since during copy the CP/M directory is scanned, +and unused blocks are not copied. -The copy operation will be faster if the source disk has been formatted with -the CP/M file system, since during copy the CP/M directory is scanned, and -unused blocks are not copied. +If a filesystem is not found, (or the /F option is chosen) all data is +copied. -If a filesystem is not found, (or the /F option is chosen) all data is copied. +Verification (if option chosen) will do an aditional read (after write) +and compare the data read matches what was written. This compare is only +on every 32'nd byte. This is done for efficiency. During copy dots "." will be displayed to indicate progress of the copy. -Each "." represents 16 kBytes of data copied. Each line of "." 's is 1 MBytes. +Each "." represents 16 kBytes of data. Each line of "." 's is 1 mBytes. #### Notes @@ -1281,7 +1292,7 @@ hd1k) because the slices are incompatible. #### Etymology -The `COPYSL` application waw custom written for RomWBW and contributed +The `COPYSL` application was custom written for RomWBW and contributed by Mark Pruden. `\clearpage`{=latex} diff --git a/Source/HBIOS/cfg_GMZ180.asm b/Source/HBIOS/cfg_GMZ180.asm index a3e7fcdc..8539cbe8 100644 --- a/Source/HBIOS/cfg_GMZ180.asm +++ b/Source/HBIOS/cfg_GMZ180.asm @@ -116,7 +116,7 @@ LEDPORT .SET $0E ; STATUS LED PORT ADDRESS LEDDISKIO .SET TRUE ; ENABLES DISK I/O ACTIVITY ON STATUS LED ; DSKYENABLE .SET TRUE ; ENABLES DSKY FUNCTIONALITY -DSKYDSKACT .SET FALSE ; ENABLES DISK ACTIVITY ON DSKY DISPLAY +DSKYDSKACT .SET TRUE ; ENABLES DISK ACTIVITY ON DSKY DISPLAY ICMENABLE .SET FALSE ; ENABLES ORIGINAL DSKY ICM DRIVER (7218) ICMPPIBASE .SET $60 ; BASE I/O ADDRESS OF ICM PPI PKDENABLE .SET FALSE ; ENABLES DSKY NG PKD DRIVER (8259)