diff --git a/Doc/RomWBW Applications.pdf b/Doc/RomWBW Applications.pdf index 921b0ad5..0f5ba26d 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 a344f3b9..6122a45b 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 af896eaa..b7d47dd0 100644 Binary files a/Doc/RomWBW Errata.pdf and b/Doc/RomWBW Errata.pdf differ diff --git a/Doc/RomWBW ROM Applications.pdf b/Doc/RomWBW ROM Applications.pdf index 1ea4364e..7e4af1a9 100644 Binary files a/Doc/RomWBW ROM Applications.pdf and b/Doc/RomWBW ROM Applications.pdf differ diff --git a/Doc/RomWBW System Guide.pdf b/Doc/RomWBW System Guide.pdf index 77d98374..af36d720 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 e9a69b50..b672b863 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 83d241c6..eb769b2f 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -3,7 +3,7 @@ **RomWBW ReadMe** \ Version 3.4 \ Wayne Warthen ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \ -29 Nov 2023 +30 Nov 2023 # Overview @@ -14,15 +14,24 @@ platforms are supported including those produced by these developer communities: - [RetroBrew Computers](https://www.retrobrewcomputers.org) -- [RC2014](https://rc2014.co.uk), + () +- [RC2014](https://rc2014.co.uk) (), [RC2014-Z80](https://groups.google.com/g/rc2014-z80) -- [retro-comp](https://groups.google.com/forum/#!forum/retro-comp) + () +- [Retro Computing](https://groups.google.com/g/retro-comp) + () - [Small Computer Central](https://smallcomputercentral.com/) + () + +A complete list of the currently supported platforms is found in the +\[Installation\] section. General features include: +- Z80 Family CPUs including Z80, Z180, and Z280 - Banked memory services for several banking designs -- Disk drivers for RAM, ROM, Floppy, IDE, CF, and SD +- Disk drivers for RAM, ROM, Floppy, IDE ATA/ATAPI, CF, SD, USB, Zip, + Iomega - Serial drivers including UART (16550-like), ASCI, ACIA, SIO - Video drivers including TMS9918, SY6545, MOS8563, HD6445 - Keyboard (PS/2) drivers via VT8242 or PPI interfaces @@ -42,11 +51,11 @@ ROM firmware itself: A dynamic disk drive letter assignment mechanism allows mapping operating system drive letters to any available disk media. -Additionally, mass storage devices (IDE Disk, CF Card, SD Card) support -the use of multiple slices (up to 256 per device). Each slice contains a -complete CP/M filesystem and can be mapped independently to any drive -letter. This overcomes the inherent size limitations in legacy OSes and -allows up to 2GB of accessible storage on a single device. +Additionally, mass storage devices (IDE Disk, CF Card, SD Card, etc.) +support the use of multiple slices (up to 256 per device). Each slice +contains a complete CP/M filesystem and can be mapped independently to +any drive letter. This overcomes the inherent size limitations in legacy +OSes and allows up to 2GB of accessible storage on a single device. The pre-built ROM firmware images are generally suitable for most users. However, it is also very easy to modify and build custom ROM images that @@ -66,7 +75,7 @@ changing media. By design, RomWBW isolates all of the hardware specific functions in the ROM chip itself. The ROM provides a hardware abstraction layer such that all of the operating systems and applications on a disk will run on any -RomWBW-based system. To put it simply, you can take a disk (or CF/SD +RomWBW-based system. To put it simply, you can take a disk (or CF/SD/USB Card) and move it between systems transparently. A tool is provided that allows you to access a FAT-12/16/32 filesystem. @@ -76,18 +85,19 @@ OSes such as Windows, MacOS, and Linux very easy. # Acquiring RomWBW -The [RomWBW Repository](https://github.com/wwarthen/RomWBW) on GitHub is -the official distribution location for all project source and -documentation. The fully-built distribution releases are available on -the [RomWBW Releases Page](https://github.com/wwarthen/RomWBW/releases) -of the repository. On this page, you will normally see a Development -Snapshot as well as recent stable releases. Unless you have a specific -reason, I suggest you stick to the most recent stable release. Expand -the “Assets” drop-down for the release you want to download, then select -the asset named RomWBW-vX.X.X-Package.zip. The Package asset includes -all pre-built ROM and Disk images as well as full source code. The other -assets contain only source code and do not have the pre-built ROM or -disk images. +The [RomWBW Repository](https://github.com/wwarthen/RomWBW) +() on GitHub is the official +distribution location for all project source and documentation. The +fully-built distribution releases are available on the [RomWBW Releases +Page](https://github.com/wwarthen/RomWBW/releases) +() of the repository. On +this page, you will normally see a Development Snapshot as well as +recent stable releases. Unless you have a specific reason, I suggest you +stick to the most recent stable release. Expand the “Assets” drop-down +for the release you want to download, then select the asset named +RomWBW-vX.X.X-Package.zip. The Package asset includes all pre-built ROM +and Disk images as well as full source code. The other assets contain +only source code and do not have the pre-built ROM or disk images. All source code and distributions are maintained on GitHub. Code contributions are very welcome. diff --git a/ReadMe.txt b/ReadMe.txt index 91858946..5903cb98 100644 --- a/ReadMe.txt +++ b/ReadMe.txt @@ -1,6 +1,6 @@ RomWBW ReadMe Wayne Warthen (wwarthen@gmail.com) -29 Nov 2023 +30 Nov 2023 @@ -13,15 +13,21 @@ Z80/180/280 retro-computing hardware systems. A wide variety of platforms are supported including those produced by these developer communities: -- RetroBrew Computers -- RC2014, RC2014-Z80 -- retro-comp -- Small Computer Central +- RetroBrew Computers (https://www.retrobrewcomputers.org) +- RC2014 (https://rc2014.co.uk), + RC2014-Z80 (https://groups.google.com/g/rc2014-z80) +- Retro Computing (https://groups.google.com/g/retro-comp) +- Small Computer Central (https://smallcomputercentral.com/) + +A complete list of the currently supported platforms is found in the +[Installation] section. General features include: +- Z80 Family CPUs including Z80, Z180, and Z280 - Banked memory services for several banking designs -- Disk drivers for RAM, ROM, Floppy, IDE, CF, and SD +- Disk drivers for RAM, ROM, Floppy, IDE ATA/ATAPI, CF, SD, USB, Zip, + Iomega - Serial drivers including UART (16550-like), ASCI, ACIA, SIO - Video drivers including TMS9918, SY6545, MOS8563, HD6445 - Keyboard (PS/2) drivers via VT8242 or PPI interfaces @@ -41,11 +47,11 @@ ROM firmware itself: A dynamic disk drive letter assignment mechanism allows mapping operating system drive letters to any available disk media. -Additionally, mass storage devices (IDE Disk, CF Card, SD Card) support -the use of multiple slices (up to 256 per device). Each slice contains a -complete CP/M filesystem and can be mapped independently to any drive -letter. This overcomes the inherent size limitations in legacy OSes and -allows up to 2GB of accessible storage on a single device. +Additionally, mass storage devices (IDE Disk, CF Card, SD Card, etc.) +support the use of multiple slices (up to 256 per device). Each slice +contains a complete CP/M filesystem and can be mapped independently to +any drive letter. This overcomes the inherent size limitations in legacy +OSes and allows up to 2GB of accessible storage on a single device. The pre-built ROM firmware images are generally suitable for most users. However, it is also very easy to modify and build custom ROM images that @@ -65,7 +71,7 @@ changing media. By design, RomWBW isolates all of the hardware specific functions in the ROM chip itself. The ROM provides a hardware abstraction layer such that all of the operating systems and applications on a disk will run on any -RomWBW-based system. To put it simply, you can take a disk (or CF/SD +RomWBW-based system. To put it simply, you can take a disk (or CF/SD/USB Card) and move it between systems transparently. A tool is provided that allows you to access a FAT-12/16/32 filesystem. @@ -78,16 +84,18 @@ OSes such as Windows, MacOS, and Linux very easy. ACQUIRING ROMWBW -The RomWBW Repository on GitHub is the official distribution location -for all project source and documentation. The fully-built distribution -releases are available on the RomWBW Releases Page of the repository. On -this page, you will normally see a Development Snapshot as well as -recent stable releases. Unless you have a specific reason, I suggest you -stick to the most recent stable release. Expand the “Assets” drop-down -for the release you want to download, then select the asset named -RomWBW-vX.X.X-Package.zip. The Package asset includes all pre-built ROM -and Disk images as well as full source code. The other assets contain -only source code and do not have the pre-built ROM or disk images. +The RomWBW Repository (https://github.com/wwarthen/RomWBW) on GitHub is +the official distribution location for all project source and +documentation. The fully-built distribution releases are available on +the RomWBW Releases Page (https://github.com/wwarthen/RomWBW/releases) +of the repository. On this page, you will normally see a Development +Snapshot as well as recent stable releases. Unless you have a specific +reason, I suggest you stick to the most recent stable release. Expand +the “Assets” drop-down for the release you want to download, then select +the asset named RomWBW-vX.X.X-Package.zip. The Package asset includes +all pre-built ROM and Disk images as well as full source code. The other +assets contain only source code and do not have the pre-built ROM or +disk images. All source code and distributions are maintained on GitHub. Code contributions are very welcome. diff --git a/Source/Doc/Book.h b/Source/Doc/Book.h index 6c7d3b93..f1bfb4ed 100644 --- a/Source/Doc/Book.h +++ b/Source/Doc/Book.h @@ -30,7 +30,9 @@ header-includes: {\scshape \bfseries \fontsize{48pt}{56pt} \selectfont $doc_product$ \par} {\bfseries \fontsize{32pt}{36pt} \selectfont $doc_title$ \par} \vspace{24pt} - {\huge $doc_ver$ \\ $doc_date$ \par} + {\huge $doc_ver$ \par} + \vspace{12pt} + {\large Updated $doc_date$ \par} \vspace{24pt} {\large \itshape $doc_orgname$ \\ \href{http://$doc_orgurl$}{$doc_orgurl$} \par} \vspace{12pt} diff --git a/Source/Doc/ReadMe.md b/Source/Doc/ReadMe.md index 656fceaf..93aba3a8 100644 --- a/Source/Doc/ReadMe.md +++ b/Source/Doc/ReadMe.md @@ -10,14 +10,23 @@ A wide variety of platforms are supported including those produced by these developer communities: * [RetroBrew Computers](https://www.retrobrewcomputers.org) -* [RC2014](https://rc2014.co.uk), [RC2014-Z80](https://groups.google.com/g/rc2014-z80) -* [retro-comp](https://groups.google.com/forum/#!forum/retro-comp) + () +* [RC2014](https://rc2014.co.uk) (), \ + [RC2014-Z80](https://groups.google.com/g/rc2014-z80) + () +* [Retro Computing](https://groups.google.com/g/retro-comp) + () * [Small Computer Central](https://smallcomputercentral.com/) + () + +A complete list of the currently supported platforms is found in the +[Installation] section. General features include: +* Z80 Family CPUs including Z80, Z180, and Z280 * Banked memory services for several banking designs -* Disk drivers for RAM, ROM, Floppy, IDE, CF, and SD +* Disk drivers for RAM, ROM, Floppy, IDE ATA/ATAPI, CF, SD, USB, Zip, Iomega * Serial drivers including UART (16550-like), ASCI, ACIA, SIO * Video drivers including TMS9918, SY6545, MOS8563, HD6445 * Keyboard (PS/2) drivers via VT8242 or PPI interfaces @@ -34,12 +43,12 @@ ROM firmware itself: * ROM BASIC (Nascom BASIC and Tasty BASIC) * ROM Forth -A dynamic disk drive letter assignment mechanism allows mapping -operating system drive letters to any available disk media. -Additionally, mass storage devices (IDE Disk, CF Card, SD Card) support -the use of multiple slices (up to 256 per device). Each slice contains -a complete CP/M filesystem and can be mapped independently to any -drive letter. This overcomes the inherent size limitations in legacy +A dynamic disk drive letter assignment mechanism allows mapping +operating system drive letters to any available disk media. +Additionally, mass storage devices (IDE Disk, CF Card, SD Card, etc.) +support the use of multiple slices (up to 256 per device). Each slice +contains a complete CP/M filesystem and can be mapped independently to +any drive letter. This overcomes the inherent size limitations in legacy OSes and allows up to 2GB of accessible storage on a single device. The pre-built ROM firmware images are generally suitable for most @@ -61,7 +70,7 @@ By design, RomWBW isolates all of the hardware specific functions in the ROM chip itself. The ROM provides a hardware abstraction layer such that all of the operating systems and applications on a disk will run on any RomWBW-based system. To put it simply, you can take -a disk (or CF/SD Card) and move it between systems transparently. +a disk (or CF/SD/USB Card) and move it between systems transparently. A tool is provided that allows you to access a FAT-12/16/32 filesystem. The FAT filesystem may be coresident on the same disk media as RomWBW @@ -70,18 +79,19 @@ OSes such as Windows, MacOS, and Linux very easy. # Acquiring RomWBW -The [RomWBW Repository](https://github.com/wwarthen/RomWBW) on GitHub is -the official distribution location for all project source and -documentation. The fully-built distribution releases are available on -the [RomWBW Releases Page](https://github.com/wwarthen/RomWBW/releases) -of the repository. On this page, you will normally see a Development -Snapshot as well as recent stable releases. Unless you have a specific -reason, I suggest you stick to the most recent stable release. Expand -the "Assets" drop-down for the release you want to download, then select -the asset named RomWBW-vX.X.X-Package.zip. The Package asset includes -all pre-built ROM and Disk images as well as full source code. The other -assets contain only source code and do not have the pre-built ROM or -disk images. +The [RomWBW Repository](https://github.com/wwarthen/RomWBW) +() on GitHub is the official +distribution location for all project source and documentation. The +fully-built distribution releases are available on the +[RomWBW Releases Page](https://github.com/wwarthen/RomWBW/releases) +() of the repository. On +this page, you will normally see a Development Snapshot as well as +recent stable releases. Unless you have a specific reason, I suggest you + stick to the most recent stable release. Expand the "Assets" drop-down +for the release you want to download, then select the asset named +RomWBW-vX.X.X-Package.zip. The Package asset includes all pre-built ROM +and Disk images as well as full source code. The other assets contain +only source code and do not have the pre-built ROM or disk images. All source code and distributions are maintained on GitHub. Code contributions are very welcome. diff --git a/Source/Doc/UserGuide.md b/Source/Doc/UserGuide.md index a3b6d493..7a8b0948 100644 --- a/Source/Doc/UserGuide.md +++ b/Source/Doc/UserGuide.md @@ -43,6 +43,33 @@ find this document far too basic. Others will find it lacking in many areas. I am doing my best and encourage you to provide constructive feedback. +`\clearpage`{=latex} + +#### Conventions + +##### Size Suffixes + +Within this document and in RomWBW in general, the use of size +suffixes KB, MB, GB, and TB refer to the binary variant as shown +below. The modern suffixes (KiB, MiB, etc.) are not used here because +they were not prevalent during the time that the RomWBW OSes were +used. This keeps all of RomWBW and associated applications consistent. + +| Suffix | Value | Meaning | +|------------|-----------|----------------------------------------| +| KB | 1024 | 1,024 bytes | +| MB | 1024^2^ | 1,048,576 bytes | +| GB | 1024^3^ | 1,073,741,824 bytes | +| TB | 1024^4^ | 1,099,511,627,776 bytes | + +##### Links and URLs + +Many of the references in this document to Internet addresses (URLs) +do not provide the address in the text. However, these links are +embedded and "clickable" within the documents. Your PDF viewer should +highlight these links in some manner (typically an alternate color +or an underline). + # Overview RomWBW software provides a complete, commercial quality @@ -52,9 +79,14 @@ A wide variety of platforms are supported including those produced by these developer communities: * [RetroBrew Computers](https://www.retrobrewcomputers.org) -* [RC2014](https://rc2014.co.uk), [RC2014-Z80](https://groups.google.com/g/rc2014-z80) -* [retro-comp](https://groups.google.com/forum/#!forum/retro-comp) + () +* [RC2014](https://rc2014.co.uk) (), \ + [RC2014-Z80](https://groups.google.com/g/rc2014-z80) + () +* [Retro Computing](https://groups.google.com/g/retro-comp) + () * [Small Computer Central](https://smallcomputercentral.com/) + () A complete list of the currently supported platforms is found in the [Installation] section. @@ -118,18 +150,19 @@ OSes such as Windows, MacOS, and Linux very easy. ## Acquiring RomWBW -The [RomWBW Repository](https://github.com/wwarthen/RomWBW) on GitHub is -the official distribution location for all project source and -documentation. The fully-built distribution releases are available on -the [RomWBW Releases Page](https://github.com/wwarthen/RomWBW/releases) -of the repository. On this page, you will normally see a Development -Snapshot as well as recent stable releases. Unless you have a specific -reason, I suggest you stick to the most recent stable release. Expand -the "Assets" drop-down for the release you want to download, then select -the asset named RomWBW-vX.X.X-Package.zip. The Package asset includes -all pre-built ROM and Disk images as well as full source code. The other -assets contain only source code and do not have the pre-built ROM or -disk images. +The [RomWBW Repository](https://github.com/wwarthen/RomWBW) +() on GitHub is the official +distribution location for all project source and documentation. The +fully-built distribution releases are available on the +[RomWBW Releases Page](https://github.com/wwarthen/RomWBW/releases) +() of the repository. On +this page, you will normally see a Development Snapshot as well as +recent stable releases. Unless you have a specific reason, I suggest you + stick to the most recent stable release. Expand the "Assets" drop-down +for the release you want to download, then select the asset named +RomWBW-vX.X.X-Package.zip. The Package asset includes all pre-built ROM +and Disk images as well as full source code. The other assets contain +only source code and do not have the pre-built ROM or disk images. All source code and distributions are maintained on GitHub. Code contributions are very welcome. @@ -277,7 +310,8 @@ your hardware provider's documentation for details. A null-modem connection may be required. Set the baud rate as indicated in the table above. Set the line characteristics to 8 data bits, 1 stop bit, no parity, and no flow control. If possible, select ANSI or VT-100 terminal -emulation. +emulation. Hardware flow control is not required for terminal +operation, but may be necessary for [Serial Port Transfers]. RomWBW will automatically attempt to detect and support typical add-on components for each of the systems supported. More information on the @@ -798,7 +832,8 @@ Sound 0 SND0: AY-3-8910 3+1 CHANNELS The 'R' command within the Boot Loader performs a software reset of the system. The system will perform a startup just like powering -up or pressing the hardware reset button. +up or pressing the hardware reset button (although the hardware is +not physically reset). There is generally no need to do this, but it can be convenient when you want to see the boot messages again or ensure your system is in @@ -3434,11 +3469,11 @@ users. All required build tools (compilers, assemblers, etc.) are included in the distribution, so it is not necessary to setup a build environment on your computer. -RomWBW can be built on modern Windows, Linux, or MacOS computers. The -process for building a custom ROM is documented in the ReadMe.txt file -in the Source directory of the distribution. Any modern version of -Windows, MacOS, or Linux released in the last 10 years should be able -to run the build process. +RomWBW can be built on modern Windows, Linux, or MacOS computers. The +process for building a custom ROM is documented in the ReadMe.txt file +in the Source directory of the distribution. Any modern version of +Windows (32-bit or 64-bit), MacOS, or Linux released in the last 10 +years should be able to run the build process. For those who are interested in more than basic system customization, note that all source code is provided (including the operating diff --git a/Source/ver.inc b/Source/ver.inc index cf066c01..21d16377 100644 --- a/Source/ver.inc +++ b/Source/ver.inc @@ -2,7 +2,7 @@ #DEFINE RMN 4 #DEFINE RUP 0 #DEFINE RTP 0 -#DEFINE BIOSVER "3.4.0-dev.26" +#DEFINE BIOSVER "3.4.0-dev.27" #define rmj RMJ #define rmn RMN #define rup RUP diff --git a/Source/ver.lib b/Source/ver.lib index fadf6dde..f0aa5afd 100644 --- a/Source/ver.lib +++ b/Source/ver.lib @@ -3,5 +3,5 @@ rmn equ 4 rup equ 0 rtp equ 0 biosver macro - db "3.4.0-dev.26" + db "3.4.0-dev.27" endm