diff --git a/Doc/RomWBW Applications.pdf b/Doc/RomWBW Applications.pdf index 1d2632cb..643d88f8 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 be15b018..98d213d3 100644 Binary files a/Doc/RomWBW Disk Catalog.pdf and b/Doc/RomWBW Disk Catalog.pdf differ diff --git a/Doc/RomWBW Hardware.pdf b/Doc/RomWBW Hardware.pdf index 3a192a64..4612f174 100644 Binary files a/Doc/RomWBW Hardware.pdf and b/Doc/RomWBW Hardware.pdf differ diff --git a/Doc/RomWBW Introduction.pdf b/Doc/RomWBW Introduction.pdf index 4a3ee5e4..7ed24efe 100644 Binary files a/Doc/RomWBW Introduction.pdf and b/Doc/RomWBW Introduction.pdf differ diff --git a/Doc/RomWBW System Guide.pdf b/Doc/RomWBW System Guide.pdf index 7e7b7697..6a87e34e 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 19a8f214..ccd598ee 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 5610cbe4..6af5b4b3 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -1,7 +1,7 @@ --- author: Wayne Warthen () colorlinks: true -date: 23 Jan 2025 +date: 24 Jan 2025 fontsize: 12pt geometry: - top=1.5in @@ -24,7 +24,7 @@ title: RomWBW ReadMe **RomWBW ReadMe** \ Version 3.5 \ Wayne Warthen ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \ -23 Jan 2025 +24 Jan 2025 # Overview @@ -57,6 +57,7 @@ General features include: - Video drivers including TMS9918, SY6545, MOS8563, HD6445 - Keyboard (PS/2) drivers via VT8242 or PPI interfaces - Real time clock drivers including DS1302, BQ4845 +- Support for CP/NET networking using Wiznet, MT011 or Serial - OSes: CP/M 2.2, ZSDOS, CP/M 3, NZ-COM, ZPM3, QPM, p-System, and FreeRTOS - Built-in VT-100 terminal emulation support diff --git a/ReadMe.txt b/ReadMe.txt index c725c80b..2ae467ab 100644 --- a/ReadMe.txt +++ b/ReadMe.txt @@ -1,11 +1,10 @@ RomWBW ReadMe Wayne Warthen (wwarthen@gmail.com) -23 Jan 2025 +24 Jan 2025 -OVERVIEW - +Overview RomWBW software provides a complete, commercial quality implementation of CP/M (and workalike) operating systems and applications for modern @@ -32,6 +31,7 @@ General features include: - Video drivers including TMS9918, SY6545, MOS8563, HD6445 - Keyboard (PS/2) drivers via VT8242 or PPI interfaces - Real time clock drivers including DS1302, BQ4845 +- Support for CP/NET networking using Wiznet, MT011 or Serial - OSes: CP/M 2.2, ZSDOS, CP/M 3, NZ-COM, ZPM3, QPM, p-System, and FreeRTOS - Built-in VT-100 terminal emulation support @@ -79,10 +79,7 @@ The FAT filesystem may be coresident on the same disk media as RomWBW slices or on stand-alone media. This makes exchanging files with modern OSes such as Windows, MacOS, and Linux very easy. - - -ACQUIRING ROMWBW - +Acquiring RomWBW The RomWBW Repository (https://github.com/wwarthen/RomWBW) on GitHub is the official distribution location for all project source and @@ -100,10 +97,7 @@ disk images. All source code and distributions are maintained on GitHub. Code contributions are very welcome. - - -INSTALLATION & OPERATION - +Installation & Operation In general, installation of RomWBW on your platform is very simple. You just need to program your ROM with the correct ROM image from the RomWBW @@ -115,7 +109,6 @@ Complete instructions for installation and operation of RomWBW are found in the RomWBW User Guide. It is also a good idea to review the Release Notes for helpful release-specific information. - Documentation Documentation for RomWBW includes: @@ -127,9 +120,7 @@ Documentation for RomWBW includes: - RomWBW Disk Catalog - RomWBW Hardware - -ACKNOWLEDGMENTS - +Acknowledgments I want to acknowledge that a great deal of the code and inspiration for RomWBW has been provided by or derived from the work of others in the @@ -242,10 +233,7 @@ let me know if I missed you! Contributions of all kinds to RomWBW are very welcome. - - -LICENSING - +Licensing RomWBW is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free @@ -287,10 +275,7 @@ control system to ensure their contributions are clearly documented. All contributions to RomWBW are subject to this license. - - -GETTING ASSISTANCE - +Getting Assistance The best way to get assistance with RomWBW or any aspect of the RetroBrew Computers projects is via one of the community forums: diff --git a/Source/Doc/Catalog.md b/Source/Doc/Catalog.md index 0ab60438..f655598c 100644 --- a/Source/Doc/Catalog.md +++ b/Source/Doc/Catalog.md @@ -671,6 +671,8 @@ The following are found in | CPN3MT.LBR | CP/NET 3 | CP/M 3 | RCBus w/ MT011 | | CPN12DUO.LBR | CP/NET 1.2 | CP/M 2.2 | Duodyne w/ Disk I/O | | CPN3DUO.LBR | CP/NET 3 | CP/M 3 | Duodyne w/ Disk I/O | +| CPN12SER.LBR | CP/NET 1.2 | CP/M 2.2 | RomWBW Serial Port | +| CPN3SER.LBR | CP/NET 3 | CP/M 3 | RomWBW Serial Port | ## General Purpose Applications diff --git a/Source/Doc/Introduction.md b/Source/Doc/Introduction.md index 39d06f2f..b21a01f9 100644 --- a/Source/Doc/Introduction.md +++ b/Source/Doc/Introduction.md @@ -25,31 +25,6 @@ $doc_hardware$ . `\clearpage`{=latex} -## Conventions Used - -#### Size Suffixes - -Within the documentation 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 the documentation 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). - # Description ## Primary Features @@ -69,6 +44,7 @@ Supported hardware features of RomWBW include: * Video drivers including TMS9918, SY6545, MOS8563, HD6445 * Keyboard (PS/2) drivers via VT8242 or PPI interfaces * Real time clock drivers including DS1302, BQ4845 +* Support for CP/NET networking using Wiznet, MT011 or Serial * Built-in VT-100 terminal emulation support A dynamic disk drive letter assignment mechanism allows mapping @@ -77,7 +53,7 @@ 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, +OSes and allows up to 2GB of adressable storage on a single device, with up to 128MB accessible at any one time. ## Included Software @@ -89,15 +65,15 @@ slices, each with a full operating system implementation. If you use this disk image, you can easily pick whichever operating system you want to boot without changing media. -Some of the included software +Some of the included software: * Operating Systems (CP/M 2.2, ZSDOS, NZ-COM, CP/M 3, ZPM3, Z3PLUS, QPM ) -* Additional operating systems, p-System, FreeRTOS, and FUZIX. +* Support for other operating systems, p-System, FreeRTOS, and FUZIX. * Programming Tools (Z80ASM, Turbo Pascal, Forth, Cowgol) -* C Compilers including Aztec, and HI-TECK +* C Compiler's including Aztec-C, and HI-TECH C * Microsoft Basic Compiler, and Microsoft Fortran * Some games such as Colossal Cave, Zork, etc -* Wordstar +* Wordstar Word processing software Some of the provided software can be launched directly from the ROM firmware itself: diff --git a/Source/Doc/ReadMe.md b/Source/Doc/ReadMe.md index 3687b5f8..d5e0bb09 100644 --- a/Source/Doc/ReadMe.md +++ b/Source/Doc/ReadMe.md @@ -31,6 +31,7 @@ General features include: * Video drivers including TMS9918, SY6545, MOS8563, HD6445 * Keyboard (PS/2) drivers via VT8242 or PPI interfaces * Real time clock drivers including DS1302, BQ4845 +* Support for CP/NET networking using Wiznet, MT011 or Serial * OSes: CP/M 2.2, ZSDOS, CP/M 3, NZ-COM, ZPM3, QPM, p-System, and FreeRTOS * Built-in VT-100 terminal emulation support diff --git a/Source/Doc/UserGuide.md b/Source/Doc/UserGuide.md index 1fbb4f37..7616dba9 100644 --- a/Source/Doc/UserGuide.md +++ b/Source/Doc/UserGuide.md @@ -13,6 +13,31 @@ 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. +#### Conventions Used + +##### Size Suffixes + +Within the documentation 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 the documentation 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). + # Getting Started ## Installation