diff --git a/Doc/RomWBW Applications.pdf b/Doc/RomWBW Applications.pdf index 5efc2ac0..8c528f10 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 cda64d08..18bd7579 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 c00a909e..35102af8 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 261c5c63..d60d1133 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 26c80411..a8d5d443 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 21a14490..a79d889e 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 4d08a225..a92bc038 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -7,7 +7,7 @@ **RomWBW Introduction** \ Version 3.5 \ Wayne Warthen ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \ -22 Feb 2025 +24 Mar 2025 # Overview diff --git a/ReadMe.txt b/ReadMe.txt index 79ae2ac7..827e906f 100644 --- a/ReadMe.txt +++ b/ReadMe.txt @@ -1,6 +1,6 @@ RomWBW Introduction Wayne Warthen (wwarthen@gmail.com) -22 Feb 2025 +24 Mar 2025 @@ -17,11 +17,11 @@ Z80/180/280 retro-computing hardware systems. 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 Computing (https://groups.google.com/g/retro-comp) -- Small Computer Central (https://smallcomputercentral.com/) +- 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 RomWBW Hardware . @@ -41,16 +41,16 @@ Card) and move it between systems transparently. Supported hardware features of RomWBW include: -- Z80 Family CPUs including Z80, Z180, and Z280 -- Banked memory services for several banking designs -- 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 -- Real time clock drivers including DS1302, BQ4845 -- Support for CP/NET networking using Wiznet, MT011 or Serial -- Built-in VT-100 terminal emulation support +- Z80 Family CPUs including Z80, Z180, and Z280 +- Banked memory services for several banking designs +- 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 +- 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 operating system drive letters to any available disk media. @@ -73,22 +73,22 @@ changing media. Some of the included software: -- Operating Systems (CP/M 2.2, ZSDOS, NZ-COM, CP/M 3, ZPM3, Z3PLUS, - QPM ) -- Support for other operating systems, p-System, FreeRTOS, and FUZIX. -- Programming Tools (Z80ASM, Turbo Pascal, Forth, Cowgol) -- 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 Word processing software +- Operating Systems (CP/M 2.2, ZSDOS, NZ-COM, CP/M 3, ZPM3, Z3PLUS, QPM + ) +- Support for other operating systems, p-System, FreeRTOS, and FUZIX. +- Programming Tools (Z80ASM, Turbo Pascal, Forth, Cowgol) +- 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 Word processing software Some of the provided software can be launched directly from the ROM firmware itself: -- System Monitor -- Operating Systems (CP/M 2.2, ZSDOS) -- ROM BASIC (Nascom BASIC and Tasty BASIC) -- ROM Forth +- System Monitor +- Operating Systems (CP/M 2.2, ZSDOS) +- ROM BASIC (Nascom BASIC and Tasty BASIC) +- ROM Forth 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 @@ -174,25 +174,24 @@ Documentation There are several documents that form the core of the RomWBW documentation: -- RomWBW User Guide is the main user guide for RomWBW, it covers the - major topics of how to install, manage and use RomWBW, and includes - additional guidance to the use of some of the operating systems - supported by RomWBW +- RomWBW User Guide is the main user guide for RomWBW, it covers the + major topics of how to install, manage and use RomWBW, and includes + additional guidance to the use of some of the operating systems + supported by RomWBW -- RomWBW Hardware contains a description of all the hardware - platforms, and devices supported by RomWBW. +- RomWBW Hardware contains a description of all the hardware platforms, + and devices supported by RomWBW. -- RomWBW Applications is a reference for the ROM-hosted and OS-hosted - applications created or customized to enhance the operation of - RomWBW. +- RomWBW Applications is a reference for the ROM-hosted and OS-hosted + applications created or customized to enhance the operation of RomWBW. -- RomWBW Disk Catalog is a reference for the contents of the disk - images provided with RomWBW, with a description of many of the files - on each image +- RomWBW Disk Catalog is a reference for the contents of the disk images + provided with RomWBW, with a description of many of the files on each + image -- RomWBW System Guide discusses much of the internal design and - construction of RomWBW. It includes a reference for the RomWBW HBIOS - API functions. +- RomWBW System Guide discusses much of the internal design and + construction of RomWBW. It includes a reference for the RomWBW HBIOS + API functions. Each of the operating systems and ROM applications included with RomWBW are sophisticated tools in their own right. It is not reasonable to @@ -217,9 +216,9 @@ 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: -- RetroBrew Computers Forum -- RC2014 Google Group -- retro-comp Google Group +- RetroBrew Computers Forum +- RC2014 Google Group +- retro-comp Google Group Submission of issues and bugs are welcome at the RomWBW GitHub Repository. @@ -244,110 +243,108 @@ RetroBrew Computers Community. I sincerely appreciate all of their contributions. The list below is probably missing many names – please let me know if I missed you! -- Andrew Lynch started it all when he created the N8VEM Z80 SBC which - became the first platform RomWBW supported. Some of his original - code can still be found in RomWBW. +- Andrew Lynch started it all when he created the N8VEM Z80 SBC which + became the first platform RomWBW supported. Some of his original code + can still be found in RomWBW. -- Dan Werner wrote much of the code from which RomWBW was originally - derived and he has always been a great source of knowledge and - advice. +- Dan Werner wrote much of the code from which RomWBW was originally + derived and he has always been a great source of knowledge and advice. -- Douglas Goodall contributed code, time, testing, and advice in “the - early days”. He created an entire suite of application programs to - enhance the use of RomWBW. Unfortunately, they have become unusable - due to internal changes within RomWBW. As of RomWBW 2.6, these - applications are no longer provided. +- Douglas Goodall contributed code, time, testing, and advice in “the + early days”. He created an entire suite of application programs to + enhance the use of RomWBW. Unfortunately, they have become unusable + due to internal changes within RomWBW. As of RomWBW 2.6, these + applications are no longer provided. -- Sergey Kiselev created several hardware platforms for RomWBW - including the very popular Zeta. +- Sergey Kiselev created several hardware platforms for RomWBW including + the very popular Zeta. -- David Giles created support for the Z180 CSIO which is now included - SD Card driver. +- David Giles created support for the Z180 CSIO which is now included SD + Card driver. -- Phil Summers contributed the Forth and BASIC adaptations in ROM, the - AY-3-8910 sound driver, DMA support, and a long list of general code - and documentation enhancements. +- Phil Summers contributed the Forth and BASIC adaptations in ROM, the + AY-3-8910 sound driver, DMA support, and a long list of general code + and documentation enhancements. -- Ed Brindley contributed some of the code that supports the RCBus - platform. +- Ed Brindley contributed some of the code that supports the RCBus + platform. -- Spencer Owen created the RC2014 series of hobbyist kit computers - which has exponentially increased RomWBW usage. Some of his kits - include RomWBW. +- Spencer Owen created the RC2014 series of hobbyist kit computers which + has exponentially increased RomWBW usage. Some of his kits include + RomWBW. -- Stephen Cousins has likewise created a series of hobbyist kit - computers at Small Computer Central and is distributing RomWBW with - many of them. +- Stephen Cousins has likewise created a series of hobbyist kit + computers at Small Computer Central and is distributing RomWBW with + many of them. -- Alan Cox has contributed some driver code and has provided a great - deal of advice. +- Alan Cox has contributed some driver code and has provided a great + deal of advice. -- The CP/NET client files were developed by Douglas Miller. +- The CP/NET client files were developed by Douglas Miller. -- Phillip Stevens contributed support for FreeRTOS. +- Phillip Stevens contributed support for FreeRTOS. -- Curt Mayer contributed the original Linux / MacOS build process. +- Curt Mayer contributed the original Linux / MacOS build process. -- UNA BIOS and FDISK80 are the products of John Coffman. +- UNA BIOS and FDISK80 are the products of John Coffman. -- FLASH4 is a product of Will Sowerbutts. +- FLASH4 is a product of Will Sowerbutts. -- CLRDIR is a product of Max Scane. +- CLRDIR is a product of Max Scane. -- Tasty Basic is a product of Dimitri Theulings. +- Tasty Basic is a product of Dimitri Theulings. -- Dean Netherton contributed eZ80 CPU support, the sound driver - interface, and the SN76489 sound driver. +- Dean Netherton contributed eZ80 CPU support, the sound driver + interface, and the SN76489 sound driver. -- The RomWBW Disk Catalog document was produced by Mykl Orders. +- The RomWBW Disk Catalog document was produced by Mykl Orders. -- Rob Prouse has created many of the supplemental disk images - including Aztec C, HiTech C, SLR Z80ASM, Turbo Pascal, Microsoft - BASIC Compiler, Microsoft Fortran Compiler, and a Games compendium. +- Rob Prouse has created many of the supplemental disk images including + Aztec C, HiTech C, SLR Z80ASM, Turbo Pascal, Microsoft BASIC Compiler, + Microsoft Fortran Compiler, and a Games compendium. -- Martin R has provided substantial help reviewing and improving the - User Guide and Applications documents. +- Martin R has provided substantial help reviewing and improving the + User Guide and Applications documents. -- Mark Pruden has made a wide variety of contributions including: +- Mark Pruden has made a wide variety of contributions including: - - significant content in the Disk Catalog and User Guide - - creation of the Introduction and Hardware documents - - Z3PLUS operating system disk image - - COPYSL utility - - a feature for RomWBW configuration by NVRAM - - the /B bulk mode of disk assignment to the ASSIGN utility + - significant content in the Disk Catalog and User Guide + - creation of the Introduction and Hardware documents + - Z3PLUS operating system disk image + - COPYSL utility + - a feature for RomWBW configuration by NVRAM + - the /B bulk mode of disk assignment to the ASSIGN utility -- Jacques Pelletier has contributed the DS1501 RTC driver code. +- Jacques Pelletier has contributed the DS1501 RTC driver code. -- Jose Collado has contributed enhancements to the TMS driver - including compatibility with standard TMS register configuration. +- Jose Collado has contributed enhancements to the TMS driver including + compatibility with standard TMS register configuration. -- Kevin Boone has contributed a generic HBIOS date/time utility - (WDATE). +- Kevin Boone has contributed a generic HBIOS date/time utility (WDATE). -- Matt Carroll has contributed a fix to XM.COM that corrects the port - specification when doing a send. +- Matt Carroll has contributed a fix to XM.COM that corrects the port + specification when doing a send. -- Dean Jenkins enhanced the build process to accommodate the Raspberry - Pi 4. +- Dean Jenkins enhanced the build process to accommodate the Raspberry + Pi 4. -- Tom Plano has contributed a new utility (HTALK) to allow talking - directly to HBIOS COM ports. +- Tom Plano has contributed a new utility (HTALK) to allow talking + directly to HBIOS COM ports. -- Lars Nelson has contributed several generic utilities such as a - universal (OS agnostic) UNARC application. +- Lars Nelson has contributed several generic utilities such as a + universal (OS agnostic) UNARC application. -- Dylan Hall added support for specifying a secondary console. +- Dylan Hall added support for specifying a secondary console. -- Bill Shen has contributed boot loaders for several of his systems. +- Bill Shen has contributed boot loaders for several of his systems. -- Laszlo Szolnoki has contributed an EF9345 video display controller - driver. +- Laszlo Szolnoki has contributed an EF9345 video display controller + driver. -- Ladislau Szilagyi has contributed an enhanced version of CP/M Cowgol - that leverages RomWBW memory banking. +- Ladislau Szilagyi has contributed an enhanced version of CP/M Cowgol + that leverages RomWBW memory banking. -- Les Bird has contributed support for the NABU w/ Option Board +- Les Bird has contributed support for the NABU w/ Option Board Related Projects diff --git a/Source/Doc/SystemGuide.md b/Source/Doc/SystemGuide.md index 633f29bf..5a64fbf1 100644 --- a/Source/Doc/SystemGuide.md +++ b/Source/Doc/SystemGuide.md @@ -466,7 +466,7 @@ between system images on the fly. During the RomWBW build process, one of the output files produced is an actual CP/M application (an executable .COM program file). Like the normal .ROM files, this file is placed in the Binary directory with the -same names as the ROM file, but with the file extension of .ROM. Once +same name as the ROM file, but with the file extension of .ROM. Once you have a running CP/M (or compatible) system, you can upload/copy this application file to the filesystem. By executing this file, you will initiate an Application Boot using the system image contained in the