Merge pull request #449 from kiwisincebirth/map/z3plus
Z3PLUS Distro - Initial Addition of the Z3PLUS Distro
This commit is contained in:
Wayne Warthen
GitHub
@@ -30,10 +30,13 @@ The original DRI CP/M 3.0 Operating System Documentation Set. This
|
||||
should be considered the primary reference for CP/M 3 system operation.
|
||||
|
||||
|
||||
NZCOM User's Manual ("NZCOM Users Manual.pdf")
|
||||
----------------------------------------------
|
||||
NZCOM, Z3PLUS, and replace ZCPR3.3 Documentation
|
||||
------------------------------------------------
|
||||
|
||||
NZCOM operating system operation manual.
|
||||
NZCOM operating system operation manual. ("NZCOM Users Manual.pdf")
|
||||
Z3PLUS operating system operation manual. ("Z3PLUS Users Manual.pdf")
|
||||
Z-System User Guide ("Z-System User Guide.pdf")
|
||||
ZCPR3.3 Users Guide ("ZCPR3.3 Users Guide.pdf")
|
||||
|
||||
|
||||
QP/M 2.7 Installation Guide and Supplements ("qpm27.pdf")
|
||||
|
||||
BIN
Doc/CPM/Z-System Users Guide.pdf
Normal file
BIN
Doc/CPM/Z-System Users Guide.pdf
Normal file
Binary file not shown.
6773
Doc/CPM/Z3PLUS Users Manual.pdf
Normal file
6773
Doc/CPM/Z3PLUS Users Manual.pdf
Normal file
File diff suppressed because it is too large
Load Diff
BIN
Doc/CPM/ZCPR3.3 User Guide.pdf
Normal file
BIN
Doc/CPM/ZCPR3.3 User Guide.pdf
Normal file
Binary file not shown.
Binary file not shown.
Binary file not shown.
586
ReadMe.md
586
ReadMe.md
@@ -1,293 +1,293 @@
|
||||
|
||||
|
||||
**RomWBW ReadMe** \
|
||||
Version 3.5 \
|
||||
Wayne Warthen ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \
|
||||
23 Oct 2024
|
||||
|
||||
# Overview
|
||||
|
||||
RomWBW software provides a complete, commercial quality implementation
|
||||
of CP/M (and workalike) operating systems and applications for modern
|
||||
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)
|
||||
(<https://www.retrobrewcomputers.org>)
|
||||
- [RC2014](https://rc2014.co.uk) (<https://rc2014.co.uk>),
|
||||
[RC2014-Z80](https://groups.google.com/g/rc2014-z80)
|
||||
(<https://groups.google.com/g/rc2014-z80>)
|
||||
- [Retro Computing](https://groups.google.com/g/retro-comp)
|
||||
(<https://groups.google.com/g/retro-comp>)
|
||||
- [Small Computer Central](https://smallcomputercentral.com/)
|
||||
(<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 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
|
||||
- OSes: CP/M 2.2, ZSDOS, CP/M 3, NZ-COM, ZPM3, QPM, p-System, and
|
||||
FreeRTOS
|
||||
- Built-in VT-100 terminal emulation support
|
||||
|
||||
RomWBW is distributed as both source code and pre-built ROM and disk
|
||||
images. 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
|
||||
|
||||
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 users.
|
||||
However, it is also very easy to modify and build custom ROM images that
|
||||
fully tailor the firmware to your specific preferences. All tools
|
||||
required to build custom ROM firmware under Windows are included – no
|
||||
need to install assemblers, etc. The firmware can also be built using
|
||||
Linux or MacOS after confirming a few standard tools have been
|
||||
installed.
|
||||
|
||||
Multiple disk images are provided in the distribution. Most disk images
|
||||
contain a complete, bootable, ready-to-run implementation of a specific
|
||||
operating system. A “combo” disk image contains multiple 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.
|
||||
|
||||
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/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
|
||||
slices or on stand-alone media. This makes exchanging files with modern
|
||||
OSes such as Windows, MacOS, and Linux very easy.
|
||||
|
||||
# Acquiring RomWBW
|
||||
|
||||
The [RomWBW Repository](https://github.com/wwarthen/RomWBW)
|
||||
(<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)
|
||||
(<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.
|
||||
|
||||
# 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
|
||||
distribution. Subsequently, you can write disk images on your disk
|
||||
drives (IDE disk, CF Card, SD Card, etc.) which then provides even more
|
||||
functionality.
|
||||
|
||||
Complete instructions for installation and operation of RomWBW are found
|
||||
in the [RomWBW User
|
||||
Guide](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20User%20Guide.pdf).
|
||||
|
||||
## Documentation
|
||||
|
||||
Documentation for RomWBW includes:
|
||||
|
||||
- [RomWBW User
|
||||
Guide](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20User%20Guide.pdf)
|
||||
- [RomWBW System
|
||||
Guide](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20System%20Guide.pdf)
|
||||
- [RomWBW
|
||||
Applications](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20Applications.pdf)
|
||||
- [RomWBW
|
||||
Errata](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20Errata.pdf)
|
||||
|
||||
# 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
|
||||
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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Phillip Stevens contributed support for FreeRTOS.
|
||||
|
||||
- Curt Mayer contributed the original Linux / MacOS build process.
|
||||
|
||||
- UNA BIOS and FDISK80 are the products of John Coffman.
|
||||
|
||||
- FLASH4 is a product of Will Sowerbutts.
|
||||
|
||||
- CLRDIR is a product of Max Scane.
|
||||
|
||||
- Tasty Basic is a product of Dimitri Theulings.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Mark Pruden has also contributed a great deal of content to the Disk
|
||||
Catalog, User Guide as well as the COPYSL utility.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Lars Nelson has contributed several generic utilities such as a
|
||||
universal (OS agnostic) UNARC application.
|
||||
|
||||
- Dylan Hall added support for specifying a secondary console.
|
||||
|
||||
- Bill Shen has contributed boot loaders for several of his systems.
|
||||
|
||||
- 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.
|
||||
|
||||
- Les Bird has contributed support for the NABU w/ Option Board
|
||||
|
||||
Contributions of all kinds to RomWBW are very welcome.
|
||||
|
||||
# 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
|
||||
Software Foundation, either version 3 of the License, or (at your
|
||||
option) any later version.
|
||||
|
||||
RomWBW is distributed in the hope that it will be useful, but WITHOUT
|
||||
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
||||
more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License along
|
||||
with RomWBW. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
Portions of RomWBW were created by, contributed by, or derived from the
|
||||
work of others. It is believed that these works are being used in
|
||||
accordance with the intentions and/or licensing of their creators.
|
||||
|
||||
If anyone feels their work is being used outside of its intended
|
||||
licensing, please notify:
|
||||
|
||||
> Wayne Warthen
|
||||
> <wwarthen@gmail.com>
|
||||
|
||||
RomWBW is an aggregate work. It is composed of many individual,
|
||||
standalone programs that are distributed as a whole to function as a
|
||||
cohesive system. Each program may have its own licensing which may be
|
||||
different from other programs within the aggregate.
|
||||
|
||||
In some cases, a single program (e.g., CP/M Operating System) is
|
||||
composed of multiple components with different licenses. It is believed
|
||||
that in all such cases the licenses are compatible with GPL version 3.
|
||||
|
||||
RomWBW encourages code contributions from others. Contributors may
|
||||
assert their own copyright in their contributions by annotating the
|
||||
contributed source code appropriately. Contributors are further
|
||||
encouraged to submit their contributions via the RomWBW source code
|
||||
control system to ensure their contributions are clearly documented.
|
||||
|
||||
All contributions to RomWBW are subject to this license.
|
||||
|
||||
# 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](https://www.retrobrewcomputers.org/forum/)
|
||||
- [RC2014 Google
|
||||
Group](https://groups.google.com/forum/#!forum/rc2014-z80)
|
||||
- [retro-comp Google
|
||||
Group](https://groups.google.com/forum/#!forum/retro-comp)
|
||||
|
||||
Submission of issues and bugs are welcome at the [RomWBW GitHub
|
||||
Repository](https://github.com/wwarthen/RomWBW).
|
||||
|
||||
Also feel free to email Wayne Warthen at <wwarthen@gmail.com>.
|
||||
|
||||
|
||||
**RomWBW ReadMe** \
|
||||
Version 3.5 \
|
||||
Wayne Warthen ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \
|
||||
25 Oct 2024
|
||||
|
||||
# Overview
|
||||
|
||||
RomWBW software provides a complete, commercial quality implementation
|
||||
of CP/M (and workalike) operating systems and applications for modern
|
||||
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)
|
||||
(<https://www.retrobrewcomputers.org>)
|
||||
- [RC2014](https://rc2014.co.uk) (<https://rc2014.co.uk>),
|
||||
[RC2014-Z80](https://groups.google.com/g/rc2014-z80)
|
||||
(<https://groups.google.com/g/rc2014-z80>)
|
||||
- [Retro Computing](https://groups.google.com/g/retro-comp)
|
||||
(<https://groups.google.com/g/retro-comp>)
|
||||
- [Small Computer Central](https://smallcomputercentral.com/)
|
||||
(<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 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
|
||||
- OSes: CP/M 2.2, ZSDOS, CP/M 3, NZ-COM, ZPM3, QPM, p-System, and
|
||||
FreeRTOS
|
||||
- Built-in VT-100 terminal emulation support
|
||||
|
||||
RomWBW is distributed as both source code and pre-built ROM and disk
|
||||
images. 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
|
||||
|
||||
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 users.
|
||||
However, it is also very easy to modify and build custom ROM images that
|
||||
fully tailor the firmware to your specific preferences. All tools
|
||||
required to build custom ROM firmware under Windows are included – no
|
||||
need to install assemblers, etc. The firmware can also be built using
|
||||
Linux or MacOS after confirming a few standard tools have been
|
||||
installed.
|
||||
|
||||
Multiple disk images are provided in the distribution. Most disk images
|
||||
contain a complete, bootable, ready-to-run implementation of a specific
|
||||
operating system. A “combo” disk image contains multiple 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.
|
||||
|
||||
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/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
|
||||
slices or on stand-alone media. This makes exchanging files with modern
|
||||
OSes such as Windows, MacOS, and Linux very easy.
|
||||
|
||||
# Acquiring RomWBW
|
||||
|
||||
The [RomWBW Repository](https://github.com/wwarthen/RomWBW)
|
||||
(<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)
|
||||
(<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.
|
||||
|
||||
# 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
|
||||
distribution. Subsequently, you can write disk images on your disk
|
||||
drives (IDE disk, CF Card, SD Card, etc.) which then provides even more
|
||||
functionality.
|
||||
|
||||
Complete instructions for installation and operation of RomWBW are found
|
||||
in the [RomWBW User
|
||||
Guide](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20User%20Guide.pdf).
|
||||
|
||||
## Documentation
|
||||
|
||||
Documentation for RomWBW includes:
|
||||
|
||||
- [RomWBW User
|
||||
Guide](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20User%20Guide.pdf)
|
||||
- [RomWBW System
|
||||
Guide](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20System%20Guide.pdf)
|
||||
- [RomWBW
|
||||
Applications](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20Applications.pdf)
|
||||
- [RomWBW
|
||||
Errata](https://github.com/wwarthen/RomWBW/raw/master/Doc/RomWBW%20Errata.pdf)
|
||||
|
||||
# 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
|
||||
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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Phillip Stevens contributed support for FreeRTOS.
|
||||
|
||||
- Curt Mayer contributed the original Linux / MacOS build process.
|
||||
|
||||
- UNA BIOS and FDISK80 are the products of John Coffman.
|
||||
|
||||
- FLASH4 is a product of Will Sowerbutts.
|
||||
|
||||
- CLRDIR is a product of Max Scane.
|
||||
|
||||
- Tasty Basic is a product of Dimitri Theulings.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Mark Pruden has also contributed a great deal of content to the Disk
|
||||
Catalog, User Guide as well as the COPYSL utility.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Lars Nelson has contributed several generic utilities such as a
|
||||
universal (OS agnostic) UNARC application.
|
||||
|
||||
- Dylan Hall added support for specifying a secondary console.
|
||||
|
||||
- Bill Shen has contributed boot loaders for several of his systems.
|
||||
|
||||
- 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.
|
||||
|
||||
- Les Bird has contributed support for the NABU w/ Option Board
|
||||
|
||||
Contributions of all kinds to RomWBW are very welcome.
|
||||
|
||||
# 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
|
||||
Software Foundation, either version 3 of the License, or (at your
|
||||
option) any later version.
|
||||
|
||||
RomWBW is distributed in the hope that it will be useful, but WITHOUT
|
||||
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
||||
more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License along
|
||||
with RomWBW. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
Portions of RomWBW were created by, contributed by, or derived from the
|
||||
work of others. It is believed that these works are being used in
|
||||
accordance with the intentions and/or licensing of their creators.
|
||||
|
||||
If anyone feels their work is being used outside of its intended
|
||||
licensing, please notify:
|
||||
|
||||
> Wayne Warthen
|
||||
> <wwarthen@gmail.com>
|
||||
|
||||
RomWBW is an aggregate work. It is composed of many individual,
|
||||
standalone programs that are distributed as a whole to function as a
|
||||
cohesive system. Each program may have its own licensing which may be
|
||||
different from other programs within the aggregate.
|
||||
|
||||
In some cases, a single program (e.g., CP/M Operating System) is
|
||||
composed of multiple components with different licenses. It is believed
|
||||
that in all such cases the licenses are compatible with GPL version 3.
|
||||
|
||||
RomWBW encourages code contributions from others. Contributors may
|
||||
assert their own copyright in their contributions by annotating the
|
||||
contributed source code appropriately. Contributors are further
|
||||
encouraged to submit their contributions via the RomWBW source code
|
||||
control system to ensure their contributions are clearly documented.
|
||||
|
||||
All contributions to RomWBW are subject to this license.
|
||||
|
||||
# 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](https://www.retrobrewcomputers.org/forum/)
|
||||
- [RC2014 Google
|
||||
Group](https://groups.google.com/forum/#!forum/rc2014-z80)
|
||||
- [retro-comp Google
|
||||
Group](https://groups.google.com/forum/#!forum/retro-comp)
|
||||
|
||||
Submission of issues and bugs are welcome at the [RomWBW GitHub
|
||||
Repository](https://github.com/wwarthen/RomWBW).
|
||||
|
||||
Also feel free to email Wayne Warthen at <wwarthen@gmail.com>.
|
||||
|
||||
598
ReadMe.txt
598
ReadMe.txt
@@ -1,299 +1,299 @@
|
||||
RomWBW ReadMe
|
||||
Wayne Warthen (wwarthen@gmail.com)
|
||||
23 Oct 2024
|
||||
|
||||
|
||||
|
||||
OVERVIEW
|
||||
|
||||
|
||||
RomWBW software provides a complete, commercial quality implementation
|
||||
of CP/M (and workalike) operating systems and applications for modern
|
||||
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/)
|
||||
|
||||
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 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
|
||||
- OSes: CP/M 2.2, ZSDOS, CP/M 3, NZ-COM, ZPM3, QPM, p-System, and
|
||||
FreeRTOS
|
||||
- Built-in VT-100 terminal emulation support
|
||||
|
||||
RomWBW is distributed as both source code and pre-built ROM and disk
|
||||
images. 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
|
||||
|
||||
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 users.
|
||||
However, it is also very easy to modify and build custom ROM images that
|
||||
fully tailor the firmware to your specific preferences. All tools
|
||||
required to build custom ROM firmware under Windows are included – no
|
||||
need to install assemblers, etc. The firmware can also be built using
|
||||
Linux or MacOS after confirming a few standard tools have been
|
||||
installed.
|
||||
|
||||
Multiple disk images are provided in the distribution. Most disk images
|
||||
contain a complete, bootable, ready-to-run implementation of a specific
|
||||
operating system. A “combo” disk image contains multiple 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.
|
||||
|
||||
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/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
|
||||
slices or on stand-alone media. This makes exchanging files with modern
|
||||
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.
|
||||
|
||||
All source code and distributions are maintained on GitHub. Code
|
||||
contributions are very welcome.
|
||||
|
||||
|
||||
|
||||
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
|
||||
distribution. Subsequently, you can write disk images on your disk
|
||||
drives (IDE disk, CF Card, SD Card, etc.) which then provides even more
|
||||
functionality.
|
||||
|
||||
Complete instructions for installation and operation of RomWBW are found
|
||||
in the RomWBW User Guide.
|
||||
|
||||
|
||||
Documentation
|
||||
|
||||
Documentation for RomWBW includes:
|
||||
|
||||
- RomWBW User Guide
|
||||
- RomWBW System Guide
|
||||
- RomWBW Applications
|
||||
- RomWBW Errata
|
||||
|
||||
|
||||
|
||||
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
|
||||
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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Phillip Stevens contributed support for FreeRTOS.
|
||||
|
||||
- Curt Mayer contributed the original Linux / MacOS build process.
|
||||
|
||||
- UNA BIOS and FDISK80 are the products of John Coffman.
|
||||
|
||||
- FLASH4 is a product of Will Sowerbutts.
|
||||
|
||||
- CLRDIR is a product of Max Scane.
|
||||
|
||||
- Tasty Basic is a product of Dimitri Theulings.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Mark Pruden has also contributed a great deal of content to the Disk
|
||||
Catalog, User Guide as well as the COPYSL utility.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Lars Nelson has contributed several generic utilities such as a
|
||||
universal (OS agnostic) UNARC application.
|
||||
|
||||
- Dylan Hall added support for specifying a secondary console.
|
||||
|
||||
- Bill Shen has contributed boot loaders for several of his systems.
|
||||
|
||||
- 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.
|
||||
|
||||
- Les Bird has contributed support for the NABU w/ Option Board
|
||||
|
||||
Contributions of all kinds to RomWBW are very welcome.
|
||||
|
||||
|
||||
|
||||
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
|
||||
Software Foundation, either version 3 of the License, or (at your
|
||||
option) any later version.
|
||||
|
||||
RomWBW is distributed in the hope that it will be useful, but WITHOUT
|
||||
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
||||
more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License along
|
||||
with RomWBW. If not, see https://www.gnu.org/licenses/.
|
||||
|
||||
Portions of RomWBW were created by, contributed by, or derived from the
|
||||
work of others. It is believed that these works are being used in
|
||||
accordance with the intentions and/or licensing of their creators.
|
||||
|
||||
If anyone feels their work is being used outside of its intended
|
||||
licensing, please notify:
|
||||
|
||||
Wayne Warthen
|
||||
wwarthen@gmail.com
|
||||
|
||||
RomWBW is an aggregate work. It is composed of many individual,
|
||||
standalone programs that are distributed as a whole to function as a
|
||||
cohesive system. Each program may have its own licensing which may be
|
||||
different from other programs within the aggregate.
|
||||
|
||||
In some cases, a single program (e.g., CP/M Operating System) is
|
||||
composed of multiple components with different licenses. It is believed
|
||||
that in all such cases the licenses are compatible with GPL version 3.
|
||||
|
||||
RomWBW encourages code contributions from others. Contributors may
|
||||
assert their own copyright in their contributions by annotating the
|
||||
contributed source code appropriately. Contributors are further
|
||||
encouraged to submit their contributions via the RomWBW source code
|
||||
control system to ensure their contributions are clearly documented.
|
||||
|
||||
All contributions to RomWBW are subject to this license.
|
||||
|
||||
|
||||
|
||||
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
|
||||
|
||||
Submission of issues and bugs are welcome at the RomWBW GitHub
|
||||
Repository.
|
||||
|
||||
Also feel free to email Wayne Warthen at wwarthen@gmail.com.
|
||||
RomWBW ReadMe
|
||||
Wayne Warthen (wwarthen@gmail.com)
|
||||
25 Oct 2024
|
||||
|
||||
|
||||
|
||||
OVERVIEW
|
||||
|
||||
|
||||
RomWBW software provides a complete, commercial quality implementation
|
||||
of CP/M (and workalike) operating systems and applications for modern
|
||||
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/)
|
||||
|
||||
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 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
|
||||
- OSes: CP/M 2.2, ZSDOS, CP/M 3, NZ-COM, ZPM3, QPM, p-System, and
|
||||
FreeRTOS
|
||||
- Built-in VT-100 terminal emulation support
|
||||
|
||||
RomWBW is distributed as both source code and pre-built ROM and disk
|
||||
images. 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
|
||||
|
||||
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 users.
|
||||
However, it is also very easy to modify and build custom ROM images that
|
||||
fully tailor the firmware to your specific preferences. All tools
|
||||
required to build custom ROM firmware under Windows are included – no
|
||||
need to install assemblers, etc. The firmware can also be built using
|
||||
Linux or MacOS after confirming a few standard tools have been
|
||||
installed.
|
||||
|
||||
Multiple disk images are provided in the distribution. Most disk images
|
||||
contain a complete, bootable, ready-to-run implementation of a specific
|
||||
operating system. A “combo” disk image contains multiple 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.
|
||||
|
||||
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/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
|
||||
slices or on stand-alone media. This makes exchanging files with modern
|
||||
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.
|
||||
|
||||
All source code and distributions are maintained on GitHub. Code
|
||||
contributions are very welcome.
|
||||
|
||||
|
||||
|
||||
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
|
||||
distribution. Subsequently, you can write disk images on your disk
|
||||
drives (IDE disk, CF Card, SD Card, etc.) which then provides even more
|
||||
functionality.
|
||||
|
||||
Complete instructions for installation and operation of RomWBW are found
|
||||
in the RomWBW User Guide.
|
||||
|
||||
|
||||
Documentation
|
||||
|
||||
Documentation for RomWBW includes:
|
||||
|
||||
- RomWBW User Guide
|
||||
- RomWBW System Guide
|
||||
- RomWBW Applications
|
||||
- RomWBW Errata
|
||||
|
||||
|
||||
|
||||
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
|
||||
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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Phillip Stevens contributed support for FreeRTOS.
|
||||
|
||||
- Curt Mayer contributed the original Linux / MacOS build process.
|
||||
|
||||
- UNA BIOS and FDISK80 are the products of John Coffman.
|
||||
|
||||
- FLASH4 is a product of Will Sowerbutts.
|
||||
|
||||
- CLRDIR is a product of Max Scane.
|
||||
|
||||
- Tasty Basic is a product of Dimitri Theulings.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Mark Pruden has also contributed a great deal of content to the Disk
|
||||
Catalog, User Guide as well as the COPYSL utility.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- 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.
|
||||
|
||||
- Lars Nelson has contributed several generic utilities such as a
|
||||
universal (OS agnostic) UNARC application.
|
||||
|
||||
- Dylan Hall added support for specifying a secondary console.
|
||||
|
||||
- Bill Shen has contributed boot loaders for several of his systems.
|
||||
|
||||
- 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.
|
||||
|
||||
- Les Bird has contributed support for the NABU w/ Option Board
|
||||
|
||||
Contributions of all kinds to RomWBW are very welcome.
|
||||
|
||||
|
||||
|
||||
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
|
||||
Software Foundation, either version 3 of the License, or (at your
|
||||
option) any later version.
|
||||
|
||||
RomWBW is distributed in the hope that it will be useful, but WITHOUT
|
||||
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
||||
more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License along
|
||||
with RomWBW. If not, see https://www.gnu.org/licenses/.
|
||||
|
||||
Portions of RomWBW were created by, contributed by, or derived from the
|
||||
work of others. It is believed that these works are being used in
|
||||
accordance with the intentions and/or licensing of their creators.
|
||||
|
||||
If anyone feels their work is being used outside of its intended
|
||||
licensing, please notify:
|
||||
|
||||
Wayne Warthen
|
||||
wwarthen@gmail.com
|
||||
|
||||
RomWBW is an aggregate work. It is composed of many individual,
|
||||
standalone programs that are distributed as a whole to function as a
|
||||
cohesive system. Each program may have its own licensing which may be
|
||||
different from other programs within the aggregate.
|
||||
|
||||
In some cases, a single program (e.g., CP/M Operating System) is
|
||||
composed of multiple components with different licenses. It is believed
|
||||
that in all such cases the licenses are compatible with GPL version 3.
|
||||
|
||||
RomWBW encourages code contributions from others. Contributors may
|
||||
assert their own copyright in their contributions by annotating the
|
||||
contributed source code appropriately. Contributors are further
|
||||
encouraged to submit their contributions via the RomWBW source code
|
||||
control system to ensure their contributions are clearly documented.
|
||||
|
||||
All contributions to RomWBW are subject to this license.
|
||||
|
||||
|
||||
|
||||
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
|
||||
|
||||
Submission of issues and bugs are welcome at the RomWBW GitHub
|
||||
Repository.
|
||||
|
||||
Also feel free to email Wayne Warthen at wwarthen@gmail.com.
|
||||
|
||||
@@ -149,7 +149,7 @@ RomWBW package (but easily found on the Internet via Google search).
|
||||
|
||||
| **File** | **Documentation** | **User Area** |
|
||||
|----------|------------------------------------|---------------|
|
||||
| | [OS Specific Files] | 0 |
|
||||
| | [OS General Files] | 0 |
|
||||
| | [General Purpose Applications] | 0 |
|
||||
| | [Testing Applications] | 2 |
|
||||
| | [Sample Audio Files] | 3 |
|
||||
@@ -237,7 +237,7 @@ The following files appear in User Area 0
|
||||
| | **Documentation** | **User Area** |
|
||||
|-----|------------------------------------|---------------|
|
||||
| | [CP/M 2.2 Files] | 0 |
|
||||
| | [OS Specific Files] | 0 |
|
||||
| | [OS General Files] | 0 |
|
||||
| | [General Purpose Applications] | 0 |
|
||||
| | [Testing Applications] | 2 |
|
||||
| | [Sample Audio Files] | 3 |
|
||||
@@ -275,103 +275,57 @@ The following files appear in User Area 0
|
||||
| `!(C)1988` | NZCOM | Original copyright (since placed in public domain) |
|
||||
| `!NZ-COM` | NZCOM | Software marker directory entry (empty file) |
|
||||
| `!VERS--1.2H` | NZCOM | Version marker directory entry (empty file) |
|
||||
| `NZCOM.COM` | NZCOM | NZCOM Loads and launches NZ-COM system |
|
||||
| `NZCOM.ENV` | RomWBW | NZCOM Z-System environment descriptor |
|
||||
| `NZCOM.LBR` | NZCOM | NZCOM Library of NZCOM system modules |
|
||||
| `NZCOM.ZCM` | RomWBW | NZCOM environment descriptor (alternate format) |
|
||||
| `NZCPR.LBR` | NZCOM | NZCOM Library of alternative ZCPR modules |
|
||||
| `NZCOM.COM` | NZCOM | Loads and launches NZ-COM system |
|
||||
| `NZCOM.ENV` | RomWBW | Z-System environment descriptor |
|
||||
| `NZCOM.LBR` | NZCOM | Library of NZCOM system modules |
|
||||
| `NZCOM.ZCM` | RomWBW | Environment descriptor (alternate format) |
|
||||
| `NZCPR.LBR` | NZCOM | Library of alternative ZCPR modules |
|
||||
| `PROFILE.SUB` | RomWBW | Command file to auto-start NZ-COM at system boot |
|
||||
| `RCP.LBR` | NZCOM | NZCOM Library of alternative RCP modules |
|
||||
| `STARTZCM.COM` | NZCOM | Commands to execute after NZ-COM is launched |
|
||||
| `ZRDOS.ZRL` | NZCOM | NZCOM Relocatable version of ZRDOS BDOS module |
|
||||
| `ZSDOS.ZRL` | NZCOM | NCCOM Relocatable version of ZSDOS 1.1 BDOS module |
|
||||
| `RCP.LBR` | NZCOM | Library of alternative RCP modules |
|
||||
| `STARTZCM.COM` | RomWBW | Commands to execute after NZ-COM is launched |
|
||||
| `ZRDOS.ZRL` | ZRDOS | Relocatable version of ZRDOS BDOS module |
|
||||
| `ZSDOS.ZRL` | ZSDOS | Relocatable version of ZSDOS 1.1 BDOS module |
|
||||
| `ZSYS.SYS` | RomWBW | ZSDOS Boot Image for SYSCOPY |
|
||||
|
||||
### NZ-COM Files
|
||||
|
||||
The following files came from the official NZ-COM distribution. These
|
||||
are generally documented in the "NZCOM Users Manual.pdf" document in
|
||||
the Doc/CPM directory of the RomWBW distribution. Note that some of the
|
||||
files included in the NZ-COM distribution are not listed below because
|
||||
they have been superseded by more recent versions listed in other
|
||||
sections below.
|
||||
the Doc/CPM directory of the RomWBW distribution.
|
||||
|
||||
The following file are in User Area 15, and where noted 14 for config files.
|
||||
NOTE: It may appear theat there are not many files, this is because most of the OS
|
||||
files are shared with Z3PLUS. See here for a list [NZ-COM Z3PLUS OS Files]
|
||||
|
||||
The following file are in User Area 15, and where noted
|
||||
10 for help files, or 14 for config files.
|
||||
|
||||
| **File** | **Description** |
|
||||
|----------------|----------------------------------------------------------|
|
||||
| `ALIAS.CMD` | Sample alias definitions for use with ARUNZ |
|
||||
| `ARUNZ.COM` | Alias-RUN-forZ-System command alias exec (v0.9u Type4) |
|
||||
| `CLEDINST.COM` | Command line editing and history shell installer |
|
||||
| `CLEDSAVE.COM` | Save RCP-resident command line editor history |
|
||||
| `BGZRDS19.LBR` | Patch for Backgrounder II (U10) |
|
||||
| `CMDRUN.COM` | Extended Command Processor (copied from ARUNZ) |
|
||||
| `CONFIG.LBR` | Various configuration files for use with ZCNFG. (U14) |
|
||||
| `CPSET.COM` | Displays/defines CRT/PRT characteristics |
|
||||
| `FCP.LBR` | Library of alternative FCP modules |
|
||||
| `FF.COM` | File finder utility |
|
||||
| `HELP.COM` | (HELPC14) is an improved version of the help utility |
|
||||
| `IF.COM` | Extended flow control tester for FCP (v1.5 Type4) |
|
||||
| `JETLDR.COM` | Z-System General-purpose module loader |
|
||||
| `LBRHELP.COM` | Help file viewer for use with help file libraries (.LBR) |
|
||||
| `LDIR.COM` | Directory lister for libraries (.LBR) |
|
||||
| `LPUT.COM` | Puts file(s) into a library (.LBR) |
|
||||
| `LSH.COM` | Command history shell and command line editor |
|
||||
| `LSH-HELP.COM` | Display LSH help when LSH is running |
|
||||
| `LSHINST.COM` | LSH configuration editor |
|
||||
| `LX.COM` | Execute programs directly from a library (.LBR) |
|
||||
| `MKZCM.COM` | Create/update NZ-COM load environment |
|
||||
| `NAME.COM` | Quickly add or remove a name for a single directory |
|
||||
| `NZBLITZ.COM` | Rapid coldboot of complete NZ-COM system image |
|
||||
| `NZBLTZ14.CFG` | ZCNFG configuration file for NZBLITZ. (U14) |
|
||||
| `PATH.COM` | Set/display command search path |
|
||||
| `NZBLTZ14.HZP` | Help file for NZBLITZ (U10) |
|
||||
| `NZ-DBASE.INF` | dBase II application note regarding SUBMIT files (U10) |
|
||||
| `PUBLIC.COM` | Specify ZRDOS public directories/user areas |
|
||||
| `PWD.COM` | Displays DU and Directory Names with paging |
|
||||
| `SHOW.COM` | Display Z-System configuration information |
|
||||
| `RELEASE.NOT` | Update information on NZ-COM (U10) |
|
||||
| `SUB.COM` | Enhanced version of SUBMIT |
|
||||
| `TY3ERA.COM` | Type-3 program to erase a file |
|
||||
| `TY3REN.COM` | Type-3 program to rename a file |
|
||||
| `TY4ERA.COM` | Type-4 program to erase a file |
|
||||
| `TY4REN.COM` | Type-4 program to rename a file |
|
||||
| `TY4SAVE.COM` | Type-4 program to save memory to a file |
|
||||
| `TY4SP.COM` | Type-4 program to display disk space |
|
||||
| `VIEW.COM` | Quad directional file viewer |
|
||||
| `XTCAP.COM` | Interactive Extended TCAP Installer |
|
||||
| `ZERR.COM` | Z34 Error Handler |
|
||||
| `ZF-DIM.COM` | ZFILER shell for dim-video terminals |
|
||||
| `ZF-REV.COM` | ZFILER shell for reverse-video terminals |
|
||||
| `ZFILER.CMD` | Macro script file for ZFILER |
|
||||
| `ZLT.COM` | File lister with support for compressed files |
|
||||
|
||||
The following documentation files are in User Area 10
|
||||
|
||||
| **File** | **Description** |
|
||||
|----------------|----------------------------------------------------------|
|
||||
| `BGZRDS19.LBR` | Patch for Backgrounder II |
|
||||
| `DOCFILES.LBR` | Documentation and help files collected into an LBR file |
|
||||
| `HLPFILES.LBR` | Various app help files for use with LBRHELP |
|
||||
| `LSH.WZ` | User manual for LSH |
|
||||
| `NZ-DBASE.INF` | dBase II application note regarding SUBMIT files |
|
||||
| `NZBLTZ14.HZP` | Help file for NZBLITZ |
|
||||
| `RELEASE.NOT` | NZCOM Update information on NZ-COM |
|
||||
| `TCJ.INF` | List of included articles from The Computer Journal |
|
||||
| `TCJ*.WZ` | Selected articles from The Computer Journal |
|
||||
| `ZFILEB38.LZT` | Brief listing of Z-System support programs |
|
||||
| `ZHELPERS.LZT` | List of volunteers who will help installing Z-System |
|
||||
| `ZNODES66.LZT` | List of Z-Node remote access systems |
|
||||
| `ZSYSTEM.IZF` | Information on Z-System and related products |
|
||||
|
||||
### Additional Files
|
||||
|
||||
| | **Documentation** | **User Area** |
|
||||
|-----|------------------------------------|---------------|
|
||||
| | [Testing Applications] | 2 |
|
||||
| | [Sample Audio Files] | 3 |
|
||||
| | [CP/NET 1.2] | 4 |
|
||||
| | [SIMH Simulator] | 13 |
|
||||
| | [CP/M 2.2 Files] | 15 |
|
||||
| | [ZSDOS 1.1 Files] | 15, 14, 10 |
|
||||
| | [OS Specific Files] | 15, 14, 10 |
|
||||
| | [General Purpose Applications] | 15, 10 |
|
||||
| | **Documentation** | **User Area** |
|
||||
|-----|--------------------------------|---------------|
|
||||
| | [Testing Applications] | 2 |
|
||||
| | [Sample Audio Files] | 3 |
|
||||
| | [CP/NET 1.2] | 4 |
|
||||
| | [SIMH Simulator] | 13 |
|
||||
| | [CP/M 2.2 Files] | 15 |
|
||||
| | [ZSDOS 1.1 Files] | 15, 14, 10 |
|
||||
| | [NZ-COM Z3PLUS OS Files] | 15, 14, 10 |
|
||||
| | [OS General Files] | 15, 14, 10 |
|
||||
| | [General Purpose Applications] | 15, 10 |
|
||||
|
||||
`\clearpage`{=latex}
|
||||
|
||||
@@ -446,7 +400,7 @@ The following files appear in User Area 0
|
||||
|
||||
| | **Documentation** | **User Area** |
|
||||
|-----|------------------------------------|---------------|
|
||||
| | [OS Specific Files] | 0 |
|
||||
| | [OS General Files] | 0 |
|
||||
| | [General Purpose Applications] | 0 |
|
||||
| | [Testing Applications] | 2 |
|
||||
| | [Sample Audio Files] | 3 |
|
||||
@@ -455,6 +409,64 @@ The following files appear in User Area 0
|
||||
|
||||
`\clearpage`{=latex}
|
||||
|
||||
## Z3PLUS
|
||||
|
||||
### Z3PLUS OS Files
|
||||
|
||||
Z3PLUS is not designed to load directly from the boot tracks of a
|
||||
disk. Instead, it expects to be loaded from an already running OS.
|
||||
|
||||
This disk has been configured to boot using CP/M 3 with a PROFILE.SUB
|
||||
command file that automatically loads Z3PLUS. So, Z3PLUS will load completely
|
||||
without any intervention, but you may notice that CP/M 3 loads first.
|
||||
|
||||
The following Z3PLUS files appear in User Area 0
|
||||
|
||||
| **File** | **Source** | **Description** |
|
||||
|----------------|-------------|----------------------------------------------------|
|
||||
| `!(C)1988` | Z3PLUS | Original copyright (since placed in public domain) |
|
||||
| `!VERS--1.02F` | Z3PLUS | Version marker directory entry (empty file) |
|
||||
| `!Z3PLUS` | Z3PLUS | Software marker directory entry (empty file) |
|
||||
| `NAMES.NDR` | RomWBW | Default Directory Names loaded at boot |
|
||||
| `RCP.LBR` | Z3PLUS | Library of alternative RCP modules |
|
||||
| `PROFILE.SUB` | RomWBW | Command file to auto-start Z3PLUS at system boot |
|
||||
| `STARTZ3P.COM` | RomWBW | Commands to execute after Z3PLUS is launched |
|
||||
| `Z3PLUS.COM` | Z3PLUS | Loads and launches Z3PLUS system |
|
||||
| `Z3PLUS.LBR` | Z3PLUS | Library of Z3PLUS system modules |
|
||||
|
||||
### Z3PLUS Files
|
||||
|
||||
The following files came from the official Z3PLUS distribution. These
|
||||
are generally documented in the "Z3PLUS Users Manual.pdf" document in
|
||||
the Doc/CPM directory of the RomWBW distribution. Note:
|
||||
|
||||
NOTE: It may appear theat there are not many files, this is because most of the OS
|
||||
files are shared with NZCOM. See here for a list [NZ-COM Z3PLUS OS Files]
|
||||
|
||||
The following file are in User Area 15, and where noted 10 for help files.
|
||||
|
||||
| **File** | **Description** |
|
||||
|----------------|---------------------------------------------|
|
||||
| `ALIAS.CMD` | Sample alias definitions for use with ARUNZ |
|
||||
| `PATCHSK.SUB` | Patch smartkey II v. 1.0A (U10) |
|
||||
| `PATCH4SK.HEX` | Patch smartkey II v. 1.0A - Hex File (U10) |
|
||||
| `RELEASE.NOT` | Update information on Z3PLUS (U10) |
|
||||
|
||||
### Additional Files
|
||||
|
||||
| | **Documentation** | **User Area** |
|
||||
|-----|--------------------------------|---------------|
|
||||
| | [Testing Applications] | 2 |
|
||||
| | [Sample Audio Files] | 3 |
|
||||
| | [CP/NET 1.2] | 4 |
|
||||
| | [SIMH Simulator] | 13 |
|
||||
| | [CP/M 3 Files] | 15 |
|
||||
| | [NZ-COM Z3PLUS OS Files] | 15, 14, 10 |
|
||||
| | [OS General Files] | 15, 14, 10 |
|
||||
| | [General Purpose Applications] | 15, 10 |
|
||||
|
||||
`\clearpage`{=latex}
|
||||
|
||||
## ZPM3
|
||||
|
||||
This is a generic ZPM3 adaptation for RomWBW.
|
||||
@@ -536,7 +548,7 @@ This is a generic ZPM3 adaptation for RomWBW.
|
||||
| `ZF11.CFG` | 14 | |
|
||||
| `ZFMACRO.HLP` | 10 | |
|
||||
| `ZHELP.COM` | 15 | |
|
||||
| `ZP.COM` | 15 | Z-System Patch utility edits files, disk sectors, or memory |
|
||||
| `ZP.COM` | 15 | Patch utility edits files, disk sectors, or memory |
|
||||
| `ZP.HLP` | 10 | Help File for ZP.COM |
|
||||
| `ZP17.CFG` | 14 | |
|
||||
| `ZSHOW.COM` | 15 | displays amount of information about your Z-System |
|
||||
@@ -549,7 +561,7 @@ This is a generic ZPM3 adaptation for RomWBW.
|
||||
| | [Sample Audio Files] | 3 |
|
||||
| | [SIMH Simulator] | 13 |
|
||||
| | [CP/M 3 Files] | 15 |
|
||||
| | [OS Specific Files] | 15, 14, 10 |
|
||||
| | [OS General Files] | 15, 14, 10 |
|
||||
| | [General Purpose Applications] | 15, 10 |
|
||||
|
||||
## QPM 2.7
|
||||
@@ -620,7 +632,7 @@ look a little strange depending on the terminal emulation you are using.
|
||||
| | **Documentation** | **User Area** |
|
||||
|-----|------------------------------------|---------------|
|
||||
| | [CP/M 2.2 Files] | 0 |
|
||||
| | [OS Specific Files] | 0 |
|
||||
| | [OS General Files] | 0 |
|
||||
| | [General Purpose Applications] | 0 |
|
||||
| | [Testing Applications] | 2 |
|
||||
| | [Sample Audio Files] | 3 |
|
||||
@@ -745,7 +757,7 @@ distribution. Some provide command line help themselves. Some are fairly obvio
|
||||
| `ZMINIT.OVR` | | Overlay file for ZMP |
|
||||
| `ZMCONFIG.OVR` | | Overlay file for ZMP |
|
||||
|
||||
## OS Specific Files
|
||||
## OS General Files
|
||||
|
||||
The following files are spcific files share across several OS's.
|
||||
In general, there is no documentation for these applications included with
|
||||
@@ -768,8 +780,8 @@ The following files are found in
|
||||
| `EDITNDR.COM` | Z3 | Edit named directory register in memory. |
|
||||
| `KERCPM22.COM` | CPM22 | Kermit communication application |
|
||||
| `KERCPM3.COM` | CPM3 | Kermit communication application |
|
||||
| `LBREXT.COM` | Z & Z3 | Extract file from .LBR libraries |
|
||||
| `LBREX36.CFG` | Z & Z3 | ZCNFG configuration file for LBREXT |
|
||||
| `LBREXT.COM` | Z | Extract file from .LBR libraries |
|
||||
| `LBREX36.CFG` | Z | ZCNFG configuration file for LBREXT |
|
||||
| `RZ.COM` | CPM3 | Receive files with X/Y/ZModem (experimental) |
|
||||
| `RZSC.FOR` | CPM3 | Description of RZ/SZ programs |
|
||||
| `SAINST.COM` | Z3 | Install/configure SALIAS. |
|
||||
@@ -786,22 +798,89 @@ The following files are found in
|
||||
| `TCVIEW.COM` | Z3 | View zcpr3 terminal capabilities |
|
||||
| `UMAP.COM` | Z3 | Shows directory usage |
|
||||
| `UMAP18.CFG` | Z3 | ZCNFG configuration file for UMAP program |
|
||||
| `UNARCU1.CFG` | Z & Z3 | ZCNFG configuration file for UNARC program |
|
||||
| `ZCNFG.COM` | Z & Z3 | Configuration tool for programs with .CFG files |
|
||||
| `ZCNFG24.CFG` | Z & Z3 | Configuration file for ZCNFG.COM |
|
||||
| `UNARCU1.CFG` | Z | ZCNFG configuration file for UNARC program |
|
||||
| `ZCNFG.COM` | Z | Configuration tool for programs with .CFG files |
|
||||
| `ZCNFG24.CFG` | Z | Configuration file for ZCNFG.COM |
|
||||
| `ZEX.COM` | Z3 | A memory-based command file processor, like SUBMIT |
|
||||
| `ZEX.CFG` | Z3 | ZCNFG configuration file for ZEX program |
|
||||
| `ZXD.CFG` | Z & Z3 | Configuration file for ZXD.COM |
|
||||
| `ZXD.COM` | Z & Z3 | Extended directory utility w/ date/time stamp support |
|
||||
| `Z3LOC.COM` | Z3 | NZCOM Display info of the ZCPR3 CCP, BDOS, and BIOS |
|
||||
| `Z3TCAP.LBR` | Z3 | NZCOM Database of terminal description |
|
||||
| `ZXD.CFG` | Z | Configuration file for ZXD.COM |
|
||||
| `ZXD.COM` | Z | Extended directory utility w/ date/time stamp support |
|
||||
| `Z3LOC.COM` | Z3 | Display info of the ZCPR3 CCP, BDOS, and BIOS |
|
||||
| `Z3TCAP.LBR` | Z3 | Database of terminal descriptions |
|
||||
|
||||
Applicability:
|
||||
|
||||
* CPM22 - Included in all CP/M 2.2 OS's (CPM2.2, ZSDOS, NZ-COM, QPM)
|
||||
* CPM3 - Included in all CP/M 3 OS's (CPM3, ZPM3)
|
||||
* Z - Included in All Z OS's (ZSDOS, NZ-COM, ZPM3)
|
||||
* Z3 - Included in ZCPR3 OS's (NZCOM, ZPM3)
|
||||
* CPM3 - Included in all CP/M 3 OS's (CPM3, Z3PLUS, ZPM3)
|
||||
* Z - Included in All Z OS's (ZSDOS, NZ-COM, Z3PLUS, ZPM3)
|
||||
* Z3 - Included in ZCPR3 OS's (NZ-COM, Z3PLUS, ZPM3)
|
||||
|
||||
## NZ-COM Z3PLUS OS Files
|
||||
|
||||
The following files are specific files share across two operating systems.
|
||||
|
||||
* NZ-COM - The Automatic Z-System - Alpha Systems
|
||||
* Z3PLUS - The Z-System for CP/M-Plus - Plu*Perfect Systems
|
||||
|
||||
These 2 operating systems are identical in all respects, except for the underlying
|
||||
operating system that they run on.
|
||||
|
||||
The following files are found in
|
||||
|
||||
* /Source/Images/Common/NZ3PLUS
|
||||
|
||||
The following file are in User Area 15, and where noted 14 for config files.
|
||||
|
||||
| **File** | **Description** |
|
||||
|----------------|----------------------------------------------------------|
|
||||
| `ARUNZ.COM` | Alias-RUN-forZ-System command alias exec (v0.9u Type4) |
|
||||
| `CLEDINST.COM` | Command line editing and history shell installer |
|
||||
| `CLEDSAVE.COM` | Save RCP-resident command line editor history |
|
||||
| `CONFIG.LBR` | Various configuration files for use with ZCNFG. (U14) |
|
||||
| `CPSET.COM` | Displays/defines CRT/PRT characteristics |
|
||||
| `FCP.LBR` | Library of alternative FCP modules |
|
||||
| `FF.COM` | File finder utility |
|
||||
| `IF.COM` | Extended flow control tester for FCP (v1.5 Type4) |
|
||||
| `JETLDR.COM` | Z-System General-purpose module loader |
|
||||
| `LBRHELP.COM` | Help file viewer for use with help file libraries (.LBR) |
|
||||
| `LDIR.COM` | Directory lister for libraries (.LBR) |
|
||||
| `LPUT.COM` | Puts file(s) into a library (.LBR) |
|
||||
| `LSH.COM` | Command history shell and command line editor |
|
||||
| `LSH-HELP.COM` | Display LSH help when LSH is running |
|
||||
| `LSHINST.COM` | LSH configuration editor |
|
||||
| `LX.COM` | Execute programs directly from a library (.LBR) |
|
||||
| `NAME.COM` | Quickly add or remove a name for a single directory |
|
||||
| `PATH.COM` | Set/display command search path |
|
||||
| `PWD.COM` | Displays DU and Directory Names with paging |
|
||||
| `TY3ERA.COM` | Type-3 program to erase a file |
|
||||
| `TY3REN.COM` | Type-3 program to rename a file |
|
||||
| `TY4ERA.COM` | Type-4 program to erase a file |
|
||||
| `TY4REN.COM` | Type-4 program to rename a file |
|
||||
| `TY4SAVE.COM` | Type-4 program to save memory to a file |
|
||||
| `TY4SP.COM` | Type-4 program to display disk space |
|
||||
| `VIEW.COM` | Quad directional file viewer |
|
||||
| `XTCAP.COM` | Interactive Extended TCAP Installer |
|
||||
| `ZERR.COM` | Z34 Error Handler |
|
||||
| `ZF-DIM.COM` | ZFILER shell for dim-video terminals |
|
||||
| `ZF-REV.COM` | ZFILER shell for reverse-video terminals |
|
||||
| `ZFILER.CMD` | Macro script file for ZFILER |
|
||||
| `ZHELP.COM` | (HELPC14) is an improved version of the help utility |
|
||||
| `ZLT.COM` | File lister with support for compressed files |
|
||||
| `ZSHOW.COM` | Display Z-System configuration information |
|
||||
|
||||
The following documentation files are in User Area 10
|
||||
|
||||
| **File** | **Description** |
|
||||
|----------------|---------------------------------------------------------|
|
||||
| `DOCFILES.LBR` | Documentation and help files collected into an LBR file |
|
||||
| `HLPFILES.LBR` | Various app help files for use with LBRHELP |
|
||||
| `LSH.WZ` | User manual for LSH |
|
||||
| `TCJ.INF` | Subscription information for The Computer Journal |
|
||||
| `TCJ*.WZ` | Selected articles from The Computer Journal |
|
||||
| `ZFILEB38.LZT` | Brief listing of Z-System support programs |
|
||||
| `ZHELPERS.LZT` | List of volunteers who will help installing Z-System |
|
||||
| `ZNODES66.LZT` | List of Z-Node remote access systems |
|
||||
| `ZSYSTEM.IZF` | Information on Z-System and related products |
|
||||
|
||||
## Sample Audio Files
|
||||
|
||||
|
||||
@@ -2512,6 +2512,11 @@ a host OS. On the RomWBW NZCOM disk images, the boot OS is ZSDOS 1.1.
|
||||
A `PROFILE.SUB` file is included which automatically launches NZCOM
|
||||
as soon as ZSDOS loads.
|
||||
|
||||
NZCOM is a companion product to Z3PLUS, they are almost identical having
|
||||
been written by the same team. The only difference is the base operating
|
||||
system on which they run, but the architecture, the tools, libraries,
|
||||
files, etc are all primarily the same.
|
||||
|
||||
NZCOM is highly configurable. The RomWBW distribution has been
|
||||
configured in the most basic way possible. You should refer to the
|
||||
documentation and use `MKZCM` as desired to customize your system.
|
||||
@@ -2523,6 +2528,8 @@ Manual.pdf" document in order to use this operating system effectively.
|
||||
#### Documentation
|
||||
|
||||
* [NZCOM Users Manual]($doc_root$/CPM/NZCOM Users Manual.pdf)
|
||||
* [Z-System Users Guide]($doc_root$/CPM/Z-System Users Guide.pdf)
|
||||
* [ZCPR3.3 User Guide]($doc_root$/CPM/ZCPR3.3 User Guide.pdf)
|
||||
|
||||
#### Boot Disk
|
||||
|
||||
@@ -2537,6 +2544,10 @@ will need to add a `PROFILE.SUB` file to auto-start NZ-COM itself.
|
||||
* There is no `DIR` command, you must use `SDZ` instead. If you don't
|
||||
like this, look into the `ALIAS` facility.
|
||||
|
||||
* For consistency with other ZCPR3 operating systems (ZPM3, Z3PLUS)
|
||||
the SHOW.COM and HELP.COM command files were renamed to ZSHOW.COM
|
||||
and ZHELP.COM
|
||||
|
||||
## Digital Research CP/M 3
|
||||
|
||||
This is the Digital Research follow-up product to their very popular
|
||||
@@ -2613,6 +2624,52 @@ in the copy command.
|
||||
has not been performed on the CP/M 3 disk image. Follow the
|
||||
CP/M 3 documentation to complete this process, if desired.
|
||||
|
||||
## Z3PLUS Z-System for CP/M-Plus
|
||||
|
||||
Z3PLUS is a much further refined version of Z-System (ZCPR 3.4). Z3PLUS
|
||||
was sold as an enhancement for existing users of CP/M 3.
|
||||
For this reason, (by design) Z3PLUS does not provide a way to boot
|
||||
directly from disk. Rather, it is loaded after the system boots into
|
||||
CP/M 3. A `PROFILE.SUB` file is included which automatically launches
|
||||
Z3PLUS as soon as CP/M 3 loads.
|
||||
|
||||
Z3PLUS is a companion product to NZ-COM, they are almost identical having
|
||||
been written by the same team. The only difference is the base operating
|
||||
system on which they run, but the architecture, the tools, libraries,
|
||||
files, etc are all primarily the same.
|
||||
|
||||
Z3PLUS is highly configurable. The RomWBW distribution has been
|
||||
configured in the most basic way possible. You should refer to the
|
||||
documentation to customize your system.
|
||||
|
||||
Z3PLUS has substantially more functionality than CP/M 3 or the basic
|
||||
Z-System. It is important to read the "Z3PLUS Users Manual.pdf"
|
||||
document in order to use this operating system effectively.
|
||||
|
||||
#### Documentation
|
||||
|
||||
* [Z3PLUS Users Manual]($doc_root$/CPM/Z3PLUS Users Manual.pdf)
|
||||
* [Z-System Users Guide]($doc_root$/CPM/Z-System Users Guide.pdf)
|
||||
* [ZCPR3.3 User Guide]($doc_root$/CPM/ZCPR3.3 User Guide.pdf)
|
||||
|
||||
#### Boot Disk
|
||||
|
||||
Since Z3PLUS boots via CP/M 3, you first must make the disk CP/M 3
|
||||
bootable. This is not a simple process, as well as placing `CPMLDR.SYS` on
|
||||
the system track of the disk there are several files that are required
|
||||
on the disk itself.This is described in [Digital Research CP/M 3]
|
||||
section above.
|
||||
|
||||
You will need to add a `PROFILE.SUB` file to auto-start Z3PLUS itself.
|
||||
|
||||
#### Notes
|
||||
|
||||
* All of the notes for [Digital Research CP/M 3] above generally
|
||||
apply to Z3PLUS.
|
||||
|
||||
* Some applications in the Z3PLUS distribution have been upgraded
|
||||
with newer versions. This is done with in
|
||||
|
||||
## ZPM3
|
||||
|
||||
Simeon Cran's ZPM3 is an interesting combination of the features of both
|
||||
|
||||
@@ -13,6 +13,7 @@ call BuildDisk.cmd zsdos fd wbw_fd144 ..\zsdos\zsys_wbw.sys || exit /b
|
||||
call BuildDisk.cmd nzcom fd wbw_fd144 ..\zsdos\zsys_wbw.sys || exit /b
|
||||
call BuildDisk.cmd cpm3 fd wbw_fd144 ..\cpm3\cpmldr.sys || exit /b
|
||||
call BuildDisk.cmd zpm3 fd wbw_fd144 ..\zpm3\zpmldr.sys || exit /b
|
||||
call BuildDisk.cmd z3plus fd wbw_fd144 ..\cpm3\cpmldr.sys || exit /b
|
||||
call BuildDisk.cmd ws4 fd wbw_fd144 || exit /b
|
||||
call BuildDisk.cmd qpm fd wbw_fd144 ..\qpm\qpm_wbw.sys || exit /b
|
||||
call BuildDisk.cmd z80asm hd wbw_fd144 || exit /b
|
||||
@@ -33,6 +34,7 @@ call BuildDisk.cmd zsdos hd wbw_hd512 ..\zsdos\zsys_wbw.sys || exit /b
|
||||
call BuildDisk.cmd nzcom hd wbw_hd512 ..\zsdos\zsys_wbw.sys || exit /b
|
||||
call BuildDisk.cmd cpm3 hd wbw_hd512 ..\cpm3\cpmldr.sys || exit /b
|
||||
call BuildDisk.cmd zpm3 hd wbw_hd512 ..\zpm3\zpmldr.sys || exit /b
|
||||
call BuildDisk.cmd z3plus hd wbw_hd512 ..\cpm3\cpmldr.sys || exit /b
|
||||
call BuildDisk.cmd ws4 hd wbw_hd512 || exit /b
|
||||
call BuildDisk.cmd dos65 hd wbw_hd512 ..\zsdos\zsys_wbw.sys || exit /b
|
||||
call BuildDisk.cmd qpm hd wbw_hd512 ..\qpm\qpm_wbw.sys || exit /b
|
||||
@@ -60,6 +62,7 @@ call BuildDisk.cmd zsdos hd wbw_hd1k ..\zsdos\zsys_wbw.sys || exit /b
|
||||
call BuildDisk.cmd nzcom hd wbw_hd1k ..\zsdos\zsys_wbw.sys || exit /b
|
||||
call BuildDisk.cmd cpm3 hd wbw_hd1k ..\cpm3\cpmldr.sys || exit /b
|
||||
call BuildDisk.cmd zpm3 hd wbw_hd1k ..\zpm3\zpmldr.sys || exit /b
|
||||
call BuildDisk.cmd z3plus hd wbw_hd1k ..\cpm3\cpmldr.sys || exit /b
|
||||
call BuildDisk.cmd ws4 hd wbw_hd1k || exit /b
|
||||
call BuildDisk.cmd qpm hd wbw_hd1k ..\qpm\qpm_wbw.sys || exit /b
|
||||
call BuildDisk.cmd z80asm hd wbw_hd1k || exit /b
|
||||
|
||||
@@ -5,6 +5,7 @@ SYSTEMS = ../CPM22/cpm_wbw.sys ../ZSDOS/zsys_wbw.sys ../QPM/qpm_wbw.sys ../CPM3/
|
||||
|
||||
FDIMGS = fd144_cpm22.img fd144_zsdos.img fd144_nzcom.img \
|
||||
fd144_cpm3.img fd144_zpm3.img fd144_ws4.img fd144_qpm.img \
|
||||
fd144_z3plus.img \
|
||||
fd144_z80asm.img fd144_aztecc.img fd144_hitechc.img \
|
||||
fd144_bascomp.img fd144_fortran.img fd144_games.img \
|
||||
fd144_tpascal.img fd144_cowgol.img
|
||||
@@ -13,6 +14,7 @@ HD512IMGS = hd512_cpm22.img hd512_zsdos.img hd512_nzcom.img \
|
||||
HD512XIMGS = hd512_z80asm.img hd512_aztecc.img hd512_hitechc.img \
|
||||
hd512_bascomp.img hd512_fortran.img hd512_games.img \
|
||||
hd512_tpascal.img hd512_dos65.img hd512_qpm.img \
|
||||
hd512_z3plus.img \
|
||||
hd512_cowgol.img hd512_msxroms1.img hd512_msxroms2.img \
|
||||
hd512_blank.img
|
||||
HD1KIMGS = hd1k_cpm22.img hd1k_zsdos.img hd1k_nzcom.img \
|
||||
@@ -20,6 +22,7 @@ HD1KIMGS = hd1k_cpm22.img hd1k_zsdos.img hd1k_nzcom.img \
|
||||
HD1KXIMGS = hd1k_z80asm.img hd1k_aztecc.img hd1k_hitechc.img \
|
||||
hd1k_bascomp.img hd1k_fortran.img hd1k_games.img \
|
||||
hd1k_tpascal.img hd1k_qpm.img \
|
||||
hd1k_z3plus.img \
|
||||
hd1k_cowgol.img hd1k_msxroms1.img hd1k_msxroms2.img \
|
||||
hd1k_blank.img
|
||||
HD1KXIMGS += hd1k_bp.img
|
||||
@@ -85,7 +88,7 @@ blankhd1k:
|
||||
(*cpm22*) sys=../CPM22/cpm_wbw.sys;; \
|
||||
(*qpm*) sys=../QPM/qpm_wbw.sys;; \
|
||||
(*zsdos* | *nzcom* | *dos65* | *bp*) sys=../ZSDOS/zsys_wbw.sys;; \
|
||||
(*cpm3*) sys=../CPM3/cpmldr.sys;; \
|
||||
(*cpm3* | *z3plus*) sys=../CPM3/cpmldr.sys;; \
|
||||
(*zpm3*) sys=../ZPM3/zpmldr.sys;; \
|
||||
esac ; \
|
||||
if echo $@ | grep -q ^fd144_ ; then \
|
||||
|
||||
@@ -84,242 +84,14 @@ The following additional customizations were also performed:
|
||||
- Z3LOC.COM
|
||||
- ZCNFG.COM
|
||||
|
||||
While including Z3PLUS disk image the SHOW.COM and HELP.COM
|
||||
files were renamed to ZSHOW.COM and ZHELP.COM for consistency
|
||||
with Z3PLUS, and ZPM3
|
||||
|
||||
== NZ-COM Files ==
|
||||
|
||||
The following files came from the official NZ-COM distribution. These
|
||||
are generally documented in the "NZCOM Users Manual.pdf" document in
|
||||
the Doc/CPM directory of the RomWBW distribution. Note that some of the
|
||||
files included in the NZ-COM distribution are not listed below because
|
||||
they have been superseded by more recent versions listed in other
|
||||
sections below. For example, TCSELECT is not listed here, but a more
|
||||
recent version is included and documented in the General Purpose
|
||||
Applications section below.
|
||||
|
||||
!(C)1988 - Original copyright (since placed in public domain)
|
||||
!NZ-COM - Software marker directory entry (empty file)
|
||||
!VERS--1.2H - Version marker directory entry (empty file)
|
||||
ALIAS.CMD - Sample alias definitions for use with ARUNZ
|
||||
ARUNZ.COM - Alias-RUN-forZ-System command alias execution
|
||||
BGZRDS19.LBR - Patch for Backgrounder II
|
||||
CLEDINST.COM - Configure RCP-resident command line editor
|
||||
CLEDSAVE.COM - Save RCP-resident command line editor history
|
||||
CONFIG.LBR - Various configuration files for use with ZCNFG
|
||||
CPSET.COM - Displays/defines CRT/PRT characteristics
|
||||
DOCFILES.LBR - Documentation and help files collected into an LBR file
|
||||
EDITNDR.COM - Edit named directory register in memory
|
||||
FCP.LBR - Library of alternative FCP modules
|
||||
FF.COM - File finder utility
|
||||
HELP.COM - (HELPC14) is an improved version of the help utility
|
||||
HLPFILES.LBR - Various app help files for use with LBRHELP
|
||||
IF.COM - Extended flow control tester
|
||||
JETLDR.COM - Z-System package loader
|
||||
LBRHELP.COM - Help file viewer for use with help file libraries (.LBR)
|
||||
LDIR.COM - Directory lister for libraries (.LBR)
|
||||
LPUT.COM - Puts file(s) into a library (.LBR)
|
||||
LSH-HELP.COM - Display LSH help when LSH is running
|
||||
LSH.COM - Command history shell and command line editor
|
||||
LSH.WZ - User manual for LSH
|
||||
LSHINST.COM - LSH configuration editor
|
||||
LX.COM - Execute programs directly from a library (.LBR)
|
||||
MKZCM.COM - Create/update NZ-COM load environment
|
||||
NAME.COM - Quickly add or remove a name for a single directory
|
||||
NZ-DBASE.INF - dBase II application note regarding SUBMIT files
|
||||
NZBLITZ.COM - Rapid coldboot of complete NZ-COM system image
|
||||
NZBLTZ14.CFG - ZCNFG configuration file for NZBLITZ
|
||||
NZBLTZ14.HZP - Help file for NZBLITZ
|
||||
NZCOM.COM - Loads and launches NZ-COM system
|
||||
NZCOM.ENV - Z-System environment descriptor
|
||||
NZCOM.LBR - Library containing NZ-COM system modules
|
||||
NZCOM.ZCM - NZ-COM environment descriptor (alternate format)
|
||||
NZCPR.LBR - Library of alternative ZCPR modules
|
||||
PATH.COM - Set/display command search path
|
||||
PROFILE.SUB - Command file to auto-start NZ-COM at system boot
|
||||
PUBLIC.COM - Specify ZRDOS public directories/user areas
|
||||
PWD.COM - Displays DU and Directory Names with paging
|
||||
RCP.LBR - Library of alternative RCP modules
|
||||
RELEASE.NOT - Update information on NZ-COM
|
||||
SAINST.COM - Install/configure SALIAS
|
||||
SALIAS.COM - Screen oriented alias editor
|
||||
SAVENDR.COM - Writes the named directory register to disk
|
||||
SDZ.COM - Enhanced directory lister
|
||||
SHOW.COM - Display Z-System configuration information
|
||||
STARTZCM.COM - Commands to execute after NZ-COM is launched
|
||||
SUB.COM - Enhanced version of SUBMIT
|
||||
TCJ.INF - Description of included articles from The Computer Journal
|
||||
TCJ*.WZ - Selected articles from The Computer Journal
|
||||
TY3ERA.COM - Type 3 erase command
|
||||
TY3REN.COM - Type 3 rename command
|
||||
TY4ERA.COM - Type 4 erase command
|
||||
TY4REN.COM - Type 4 rename command
|
||||
TY4SAVE.COM - Type 4 save command
|
||||
TY4SP.COM - Type 4 disk space command
|
||||
VIEW.COM - Quad directional file viewer
|
||||
XTCAP.COM - Interactive Extended TCAP Installer
|
||||
Z3TCAP.TCP - Database of terminal descriptors
|
||||
ZERR.COM - Z34 Error Handler
|
||||
ZEX.COM - Powerful command line processor
|
||||
ZF-DIM.COM - Point-and-shoot user interface for dim-video terminals
|
||||
ZF-REV.COM - Point-and-shoot user interface for reverse-video terminals
|
||||
ZFILEB38.LZT - Brief listing of Z-System support programs
|
||||
ZFILER.CMD - Macro script file for ZFILER
|
||||
ZHELPERS.LZT - List of volunteers who will help installing Z-System
|
||||
ZLT.COM - File lister with support for compressed files
|
||||
ZNODES66.LZT - List of Z-Node remote access systems
|
||||
ZRDOS.ZRL - Relocatable version of ZRDOS BDOS module
|
||||
ZSDOS.ZRL - Relocatable version of ZSDOS 1.1 BDOS module
|
||||
ZSYSTEM.IZF - Information on Z-System and related products
|
||||
|
||||
== CP/M 2.2 Files ==
|
||||
|
||||
The following files have been included from CP/M 2.2. These files
|
||||
provide various functionality that is not really available from the
|
||||
ZSDOS applications themselves. For example, the CP/M 2.2 application
|
||||
called STAT is useful for modifying the IOBYTE. Most of these
|
||||
applications are documented in the "CPM Manual.pdf" document in the Doc/CPM
|
||||
directory of the RomWBW distribution.
|
||||
|
||||
ASM.COM - DRI 8080 assembler producing Intel hex files
|
||||
LIB.COM - DRI relocatable object file librarian
|
||||
LINK.COM - DRI relocatable object file linker
|
||||
LOAD.COM - DRI loader for Intel hex files
|
||||
MAC.COM - DRI 8080 macro assembler producing Intel hex files
|
||||
RMAC.COM - DRI 8080 macro assembler producing relocatable object files
|
||||
STAT.COM - DRI multi-purpose file/disk/device info & configuration tool
|
||||
SUBMIT.COM - DRI batch file submission tool
|
||||
XSUB.COM - DRI batch file enhancer resident system extension
|
||||
|
||||
== ZSDOS Files ==
|
||||
|
||||
The following files came from the official ZSDOS distribution. These
|
||||
are generally documented in the "ZSDOS Manual.pdf" document in the Doc CPM
|
||||
directory of the RomWBW distribution. These files are relevant under
|
||||
NZ-COM because ZSDOS is a part of the NZ-COM system.
|
||||
|
||||
BGPATCH.HEX - Patches BackGrounder II for ZSDOS 1.1 compatibility
|
||||
CLOCKS.DAT - Library of clock drivers
|
||||
COPY.CFG - ZCNFG configuration file for COPY
|
||||
COPY.COM - Enhanced file copy tool
|
||||
COPY.UPD - Document describing updates to COPY program
|
||||
DATSWEEP.COM - File management utility w/ date/time stamp awareness
|
||||
DSCONFIG.COM - Program to configure DATSWEEP
|
||||
FA16.CFG - ZCNFG configuration file for FILEATTR
|
||||
FA16.DOC - Documentation for FILEATTR
|
||||
FA16A.FOR - Summary of FILEATTR program version 16a
|
||||
FA16CFG.TXT - Document describes FILEATTR configuration options
|
||||
FILEATTR.COM - Set and/or display file attributes
|
||||
FILEDATE.CFG - ZCNFG configuration fie for FILEDATE
|
||||
FILEDATE.COM - Date/time stamping aware disk directory utility
|
||||
INITDIR.CFG - ZCNFG configuration file for INITDIR
|
||||
INITDIR.COM - Prepare disk for P2DOS date/time stamping
|
||||
LDDS.COM - Load DateStamper date/time stamping resident extension
|
||||
LDNZT.COM - Load NZT date/time stamping resident extension
|
||||
LDP2D.COM - Load P2DOS date/time stamping resident extension
|
||||
PUTBG.COM - Updated replacement for BackGrounder II PUTBG program
|
||||
PUTDS.COM - Prepare disk for DateStamper date/time stamping
|
||||
RELOG.COM - Clear fixed disk login vector in ZSDOS (see manual)
|
||||
SETTERM.COM - Terminal configuration utility for DATSWEEP & DSCONFIG
|
||||
SETUPZST.COM - Creates customized date/time stamping resident extensions
|
||||
STAMPS.DAT - Library of available date/time stamping modules for SETUPZST
|
||||
TD.CFG - ZCNFG configuration file for TD
|
||||
TD.COM - Read and set system real-time clock
|
||||
TERMBASE.DAT - Library of terminals used by SETTERM
|
||||
TESTCLOK.COM - Test a selected clock driver
|
||||
ZCAL.COM - Display a small one-month calendar to the screen
|
||||
ZCNFG.COM - Configuration tool for programs with .CFG files
|
||||
ZCNFG24.CFG - ZCNFG configuration file for ZCNFG
|
||||
ZPATH.COM - Set or display ZSDOS and ZCPR search paths
|
||||
ZSCONFIG.COM - Dynamically configure features of ZSDOS operating system
|
||||
ZSVSTAMP.COM - Preserves file date/time stamp across modifications
|
||||
ZSVSTAMP.DOC - Document describes the use and operation of ZSVSTAMP
|
||||
|
||||
== RomWBW Supplemental Applications ==
|
||||
|
||||
The following files provide specific functionality enabled by
|
||||
RomWBW enhancements. These applications are documented in the
|
||||
"RomWBW Applications.pdf" document in the Doc directory of the
|
||||
RomWBW Distribution.
|
||||
|
||||
ASSIGN.COM - Assign,remove,swap drive letters of RomWBW disk slices
|
||||
FAT.COM - MS-DOS FAT filesystem tool (list, copy, delete, format, etc.)
|
||||
FDU.COM - Test floppy hardware and format floppy disks
|
||||
FORMAT.COM - Placeholder application with formatting instructions
|
||||
INTTEST.COM - Test RomWBW interrupt processing on your hardware
|
||||
MODE.COM - Change serial line characteristics (baud rate, etc.)
|
||||
RTC.COM - Test real time clock hardware on your system
|
||||
SURVEY.COM - Display system resources summary
|
||||
SYSCOPY.COM - Copy system tracks to disks (make bootable)
|
||||
SYSGEN.COM - Copy system tracks to disks (DRI version)
|
||||
TALK.COM - Route console I/O to & from specified serial port
|
||||
TIMER.COM - Test and display system timer ticks
|
||||
TUNE.COM - Play .PT2, .PT3, and .MYM audio files on supported hardware
|
||||
XM.COM - XModem file transfer application
|
||||
ZMP.COM - ZModem communications program (requires dedicated comm port)
|
||||
ZMP.DOC - Documentation for ZMP
|
||||
ZMP.HLP - Help file for ZMP
|
||||
ZMXFER.OVR - Overlay file for ZMP
|
||||
ZMTERM.OVR - Overlay file for ZMP
|
||||
ZMINIT.OVR - Overlay file for ZMP
|
||||
ZMCONFIG.OVR - Overlay file for ZMP
|
||||
|
||||
== General Purpose Applications ==
|
||||
|
||||
The following files are commonly used CP/M applications that
|
||||
are generally useful in any CP/M-like system. In general, there is
|
||||
no documentation for these applications included with the RomWBW
|
||||
distribution. Some provide command line help themselves. Some
|
||||
are fairly obvious.
|
||||
|
||||
CLRDIR.COM - Initializes the directory area of a disk
|
||||
COMPARE.COM - Compare content of two files (binary)
|
||||
CRUNCH.COM - Compress file(s) using Crunch algorithm
|
||||
CRUNCH28.CFG - ZCNFG configuration file for CRUNCH & UNCR
|
||||
DDTZ.COM - Z80 debug tool (modified to use RST 6)
|
||||
DDTZ.DOC - Documentation for DDTZ
|
||||
EX.COM - Batch file processor (alternative to DRI SUBMIT)
|
||||
FDISK80.COM - Hard disk partitioning tool (from John Coffman)
|
||||
FIND.COM - Search all drives for a file (from Jay Cotton)
|
||||
FLASH.COM - Program FLASH chips in-situ (from Will Sowerbutts)
|
||||
FLASH.DOC - Documentation for FLASH
|
||||
MBASIC.COM - Microsoft BASIC language interpreter
|
||||
NULU.COM - Library (.LBR) management tool
|
||||
PMARC.COM - Create or add file(s) to .PMA archive
|
||||
PMEXT.COM - Extract file(s) from .PMA/.LZH/.LHA archive
|
||||
RMXSUB1.COM - Remove XSUB1 RSX from memory (from Lars Nelson)
|
||||
SUPERSUB.COM - Enhanced replacement for DRI SUBMIT
|
||||
SUPERSUB.DOC - Documentation for SUPERSUB
|
||||
TDLBASIC.COM - TDL Zapple 12K BASIC language interpreter
|
||||
UNARC.COM - Extract file(s) from .ARC or .ARK archive
|
||||
UNARC.DOC - Documentation for UNARC
|
||||
UNCR.COM - Decompress Crunched file(s)
|
||||
UNZIP.COM - UNZIPZ extracts from all MS-DOS ZIP files (from Lars Nelson)
|
||||
UNZIP.DOC - Documentation for UNZIPZ
|
||||
XSUB1.COM - Replacement for DRI SUB (from Lars Nelson)
|
||||
ZAP.COM - Interactive disk & file utility
|
||||
ZDE.COM - Compact WordStar-like editor
|
||||
ZDENST.COM - Installation/configuration tool for ZDE
|
||||
KERCPM22.COM - Kermit file transfer application
|
||||
LBREXT.COM - Extract file from .LBR libraries
|
||||
LBREXT36.CFG - ZCNFG configuration file for LBREXT
|
||||
ZXD.COM - Enhanced directory lister w/ date/time stamp support
|
||||
ZXD.CFG - ZCNFG configuration file for ZXD
|
||||
BBCBASIC.COM - BBC BASIC CP/M Version by R.T.Russell
|
||||
BBCBASIC.TXT - Help file for BBC BASIC
|
||||
GENHEX.COM - Generates an Intel Hex file from the input file
|
||||
LS.COM - An alternative file listing to DIR
|
||||
LSWEEP.COM - Can extract and view member files of an .LBR archive
|
||||
|
||||
== Testing Applications (User Area 2) ==
|
||||
|
||||
User area 2 contains a variety of hardware testing applications.
|
||||
These are generally user contributed and have no documentation.
|
||||
Additionally, they are frequently not compatible with all RomWBW
|
||||
hardware. They are included here as a convenience. If applicable,
|
||||
your hardware documentation should refer to them and provide usage
|
||||
instructions.
|
||||
|
||||
== Sample Tune Files (User Area 3) ==
|
||||
|
||||
User area 3 contains sample audio files that can be played using
|
||||
the TUNE application.
|
||||
For a description of the files contained in this disk please see the
|
||||
"Rom WBW Disk Catalog.pdf" document contained in the Doc directory
|
||||
of the RomWBW distribution.
|
||||
|
||||
-- WBW 7:14 PM 8/17/2024
|
||||
|
||||
111
Source/Images/d_z3plus/ReadMe.txt
Normal file
111
Source/Images/d_z3plus/ReadMe.txt
Normal file
@@ -0,0 +1,111 @@
|
||||
|
||||
===== Z3PLUS Disk for RomWBW =====
|
||||
|
||||
This disk is one of several ready-to-run disks provided with
|
||||
RomWBW. It contains Z3PLUS, which is an implementation of the
|
||||
Z-System. You may also see Z3PLUS referred to as ZCPR 3.4. This is
|
||||
a powerful replacement for CP/M 3.
|
||||
|
||||
The disk is bootable as is (the operating system image is already
|
||||
embedded in the system tracks) and can be launched from the RomWBW
|
||||
Loader prompt. See the Usage and Notes sections below for more
|
||||
information on how Z3PLUS is loaded.
|
||||
|
||||
The remainder of this document describes the usage and contents of
|
||||
this disk. It is highly recommended that you review the "RomWBW
|
||||
User Guide.pdf" document found in the Doc directory of the
|
||||
RomWBW Distribution.
|
||||
|
||||
The primary documentation for Z3PLUS is the "Z3PLUS Users Manual.pdf"
|
||||
document contained in the Doc/CPM directory of the RomWBW distribution.
|
||||
This document is a supplement to the primary documentation. Additionally,
|
||||
please review the file called RELEASE.NOT on this disk which contains
|
||||
a variety of updates regarding the Z3PLUS distribution.
|
||||
|
||||
The starting point for the disk content was the final official release of
|
||||
Z3PLUS which is generally available on the Internet. A minimal
|
||||
system generation was done just sufficient to get Z3PLUS to run under
|
||||
RomWBW. Z3PLUS is extremely configurable and far more powerful than
|
||||
DRI CP/M. It is almost mandatory that you read the Z3PLUS manual to
|
||||
use the system effectively.
|
||||
|
||||
== Usage ==
|
||||
|
||||
Z3PLUS is not designed to load directly from the boot tracks of a
|
||||
disk. Instead, it expects to be loaded from an already running
|
||||
OS. This disk has been configured to boot using CP/M 3 with a
|
||||
PROFILE.SUB command file that automatically loads Z3PLUS. So, Z3PLUS
|
||||
will load completely without any intervention, but you may notice
|
||||
that CP/M 3 loads first, then CP/M 3 loads Z3PLUS. This is normal.
|
||||
|
||||
== Configration ==
|
||||
|
||||
Z3PLUS is distributed in an unconfigured state. The following was
|
||||
done to create a ready-to-run setup for RomWBW:
|
||||
|
||||
- Created PROFILE.SUB to launch Z3PLUS at startup.
|
||||
- Created STARTZ3P.COM (alias) with
|
||||
Z3PLUS /Q
|
||||
PATH /C $$$$ A15 A0
|
||||
- Replaced DEFAULT.Z3T (IN Z3PLUS.LBR) with VT100 Term Definiton:
|
||||
- Replaced DEFAULT.NDR (IN Z3PLUS.LBR) with new directory names:
|
||||
A0:SYSTEM A10:HELP A14:CONFIG A15: ROOT
|
||||
- Copied ARUNZ.COM to CMDRUN.COM
|
||||
- Added REN, SAVE, and SP commands to ALIAS.CMD
|
||||
|
||||
== Notes ==
|
||||
|
||||
One of the bigger changes when deploying this image was the consoliadation
|
||||
of Files between NZCOM and Z3PLUS. Both of these distributions came
|
||||
from the same vendor and share the Same DNA, the primary difference being the
|
||||
underlying OS (and BDOS) being eithe CP/M 2.2 (NZCOM) or CP/M 3 (Z3PLUS)
|
||||
|
||||
Thus a new "Common/NZ3PLUS" folder was created and sharded files
|
||||
move here, to avoid significant duplication. This was done with NZ-COM files (primarily)
|
||||
to ensure backwards compatability, and any improvements (done in NZ-COM) stick.
|
||||
|
||||
Carried over from the NZCOM Changes
|
||||
- Extract VT100 TCAP from Z3TCAP.LBR and saved it as TCAP.Z3T.
|
||||
- Original TCSELECT.COM was removed and replaced with a newer version
|
||||
from the Z3 files. TCAP.LBR and Z3TCAP.TCP were removed and replaced with
|
||||
Z3TCAP.LBR from new TCSELECT distribution.
|
||||
- Updated HELP.COM to search for help files in A10: instead of A15:
|
||||
- Updated LBRHELP.COM to search for help files in A10: instead of A15:
|
||||
|
||||
Files Moved
|
||||
- Moved all help and documentation files to 10: per ZCPR3 conventions
|
||||
- Moved DOCFILES.LBR to 10:
|
||||
- Moved all TCJ files to 10:
|
||||
- Moved all configuration files to 14: per ZCPR3 conventions
|
||||
- Moved executables to 15: per ZCPR3 conventions
|
||||
|
||||
Files Removed because newer versions are already included:
|
||||
- COPY.COM
|
||||
- CRUNCH.COM
|
||||
- UNCRUNCH.COM
|
||||
- LBREXT.COM
|
||||
- ZCNFG.COM
|
||||
|
||||
== Files ==
|
||||
|
||||
For a description of the files contained in this disk please see the
|
||||
"Rom WBW Disk Catalog.pdf" document contained in the Doc directory
|
||||
of the RomWBW distribution.
|
||||
|
||||
===========================================
|
||||
|
||||
== Suggestions ==
|
||||
|
||||
Some of the files currenty in A15 (NZCOM and Z3PLUS) look more like they
|
||||
should be in A0, as they are part of system definition / config
|
||||
rather than a general purpose utility .e.g.
|
||||
- ALIAS.CMD - this one in particular contains config
|
||||
- CMDRUN.COM - effectivly config since it is a copy of one of 2 files
|
||||
- ?????
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
20
Source/Images/d_z3plus/u0/!(C)1988
Normal file
20
Source/Images/d_z3plus/u0/!(C)1988
Normal file
@@ -0,0 +1,20 @@
|
||||
Z3PLUS COPYRIGHT (c) 1988
|
||||
by
|
||||
Bridger Mitchell
|
||||
|
||||
|
||||
Z3PLUS(tm) - The Z-System for CP/M Plus, is copyright 1988 by
|
||||
Bridger Mitchell, all rights reserved.
|
||||
|
||||
The Z3PLUS files and the Z3PLUS User's Manual may not be
|
||||
reproduced or distributed in any form. A licensed user may
|
||||
make backup/archival copies for his or her own use only.
|
||||
|
||||
Z3PLUS is available from:
|
||||
|
||||
Bridger Mitchell
|
||||
Plu*Perfect Systems
|
||||
410 23rd Street
|
||||
Santa Monica CA 90402
|
||||
|
||||
distributed with Z3PLUS has been patchedŠto
|
||||
0
Source/Images/d_z3plus/u0/!VERS--1.02F
Normal file
0
Source/Images/d_z3plus/u0/!VERS--1.02F
Normal file
0
Source/Images/d_z3plus/u0/!Z3PLUS
Normal file
0
Source/Images/d_z3plus/u0/!Z3PLUS
Normal file
2
Source/Images/d_z3plus/u0/PROFILE.SUB
Normal file
2
Source/Images/d_z3plus/u0/PROFILE.SUB
Normal file
@@ -0,0 +1,2 @@
|
||||
z3plus
|
||||
|
||||
BIN
Source/Images/d_z3plus/u0/RCP.LBR
Normal file
BIN
Source/Images/d_z3plus/u0/RCP.LBR
Normal file
Binary file not shown.
BIN
Source/Images/d_z3plus/u0/STARTZ3P.COM
Normal file
BIN
Source/Images/d_z3plus/u0/STARTZ3P.COM
Normal file
Binary file not shown.
BIN
Source/Images/d_z3plus/u0/Z3PLUS.COM
Normal file
BIN
Source/Images/d_z3plus/u0/Z3PLUS.COM
Normal file
Binary file not shown.
BIN
Source/Images/d_z3plus/u0/Z3PLUS.LBR
Normal file
BIN
Source/Images/d_z3plus/u0/Z3PLUS.LBR
Normal file
Binary file not shown.
BIN
Source/Images/d_z3plus/u10/PATCH4SK.HEX
Normal file
BIN
Source/Images/d_z3plus/u10/PATCH4SK.HEX
Normal file
Binary file not shown.
BIN
Source/Images/d_z3plus/u10/PATCHSK.SUB
Normal file
BIN
Source/Images/d_z3plus/u10/PATCHSK.SUB
Normal file
Binary file not shown.
295
Source/Images/d_z3plus/u10/RELEASE.NOT
Normal file
295
Source/Images/d_z3plus/u10/RELEASE.NOT
Normal file
@@ -0,0 +1,295 @@
|
||||
|
||||
RELEASE.NOT - UPDATE INFORMATION ON Z3PLUS
|
||||
|
||||
|
||||
Please understand that unlike purely commercial enterprises, Z-System is
|
||||
mainly the work of enthusiasts. As such, Z-System never truly reaches
|
||||
completion; each new development is more of a plateau upon which further
|
||||
innovation occurs. Though we have done our best, the printed documentation
|
||||
inevitably lags behind the most recent enhancements. Try to consult as
|
||||
much material as possible about a given command before proceeding; if there
|
||||
is a help or document file pertaining to the command, it supercedes printed
|
||||
instructions, especially with regard to such matters as syntax or technical
|
||||
specifications.
|
||||
|
||||
|
||||
Notes of September 12, 1991
|
||||
===========================
|
||||
|
||||
Release 1.02E involves a significant updating of the support utilities
|
||||
that we distribute as a courtesy with Z3PLUS. We suggest that any Z-System
|
||||
user who is not in regular contact with a Z-Node consider taking advantage
|
||||
of the Z-System Software Update Service (ZSUS). Here are some of the
|
||||
important changes with this release.
|
||||
|
||||
ZCNFG.COM, CONFIG.LBR:
|
||||
Al Hawley has introduced a powerful and convenient method for
|
||||
configuring programs. ZCNFG works either with individual CFG files
|
||||
or with CFG files stored in the CONFIG.LBR library. For example,
|
||||
try running the command "ZCNFG ZLT". ZCNFG will automatically
|
||||
extract ZLT15.CFG from CONFIG.LBR.
|
||||
|
||||
LBREXT.COM:
|
||||
This replaces LGET for extracting member files from LBR library
|
||||
files.
|
||||
|
||||
ZHELP.COM, LBRHELP.COM, HLPFILES.LBR:
|
||||
ZHELP (actually HELPC14) is an improved version of the help utility.
|
||||
It can work with normal help files (HLP) and crunched help files
|
||||
(HZP). LBRHELP can work with normal or crunched help files that are
|
||||
stored in a library (which is where we have put all the help files
|
||||
distributed with NZCOM and Z3PLUS).
|
||||
|
||||
DOCFILES.LBR:
|
||||
Documentation and help files have been collected into an LBR file.
|
||||
|
||||
ZLT.COM:
|
||||
This is a full Z-System replacement for LT, and it handles the
|
||||
latest LZH-compressed files.
|
||||
|
||||
COPY.COM:
|
||||
This is the version of COPY from the ZSDOS/ZDDOS release. Enter
|
||||
"COPY //" for syntax information. It replaces a dangerously
|
||||
defective copy program provided with earlier releases.
|
||||
|
||||
LSH.COM, LSH.WZ, LSH-HELP.COM, LSHINST.COM, ZERR.COM:
|
||||
These are the latest LSH command history shell and command-line
|
||||
editor and the associated error handler (fixed-log versions). These
|
||||
completely replace EASE.
|
||||
|
||||
CLEDINST.COM, CLEDSAVE.COM:
|
||||
A transient history shell like LSH can be slow on floppy systems
|
||||
with sluggish disk drives, even if the files have been placed in
|
||||
optimal locations. Some of the RCP modules supplied no include an
|
||||
RCP-resident command-line editor called CLED. Its features can be
|
||||
configured using CLEDINST.COM, and the history can be saved to a
|
||||
file using CLEDSAVE.COM.
|
||||
|
||||
TCAP.LBR, XTCAP.COM:
|
||||
A number of programs now require a terminal capabilities descriptor
|
||||
(TCAP) with extended functions. The standard TCAPs loaded with
|
||||
TCSELECT do not have these functions. TCAP.LBR is a collection of
|
||||
extended TCAPs for some terminals. XTCAP.COM is a program that can
|
||||
add the most important extensions to a standard TCAP (it is a quick-
|
||||
and-dirty fix until the full set of TCAPs is updated).
|
||||
|
||||
VIEW.COM:
|
||||
This is Bridger Mitchell's file viewing utility. It is very
|
||||
powerful (but it requires an extended TCAP).
|
||||
|
||||
NAME.COM:
|
||||
This program can quickly add or remove a name for a single
|
||||
directory.
|
||||
|
||||
TCJ.INF:
|
||||
TCJ has a new publisher (one of our own Z-Node sysops), and this
|
||||
file tells how to take out a subscription (which all Z-System users
|
||||
absolutely should do!).
|
||||
|
||||
ZFILEB38.LZT:
|
||||
This is the BRIEF listing of all the support programs currently
|
||||
available for use with Z-System. There is another file which
|
||||
includes descriptions of all the programs, but it would fill up an
|
||||
entire diskette!
|
||||
|
||||
|
||||
|
||||
Notes of November 5, 1989
|
||||
=========================
|
||||
|
||||
|
||||
1. TCSELECT PROBLEM.
|
||||
2. LSH REPLACES EASE.
|
||||
3. COPY LDIR.COM TO A0:.
|
||||
4. CHOICE OF MODULE SIZES.
|
||||
5. YOU NEED REN.COM.
|
||||
6. ZHELP.COM.
|
||||
7. OSBORNE EXECUTIVE ROM BUG.
|
||||
8. SMARTKEY BUGS.
|
||||
9. COMPATIBILITY WITH BYE.
|
||||
10. MINOR UPDATE NOTES.
|
||||
11. TO NEW Z-SYSTEM USERS.
|
||||
12. NEW DEFAULTS AND NEW FILES: FCP.LBR, RCP.LBR.
|
||||
|
||||
|
||||
1. TCSELECT PROBLEM.
|
||||
|
||||
A problem has been discovered with the operation of TCSELECT as described
|
||||
in the manual. TCSELECT is a Z-System program and does not function
|
||||
reliably under CP/M (on some systems it causes a crash). Fortunately, there
|
||||
is a simple fix: reverse the order of the instructions in the manual. Boot
|
||||
up Z3PLUS before attempting to create MYTERM.Z3T, and run TCSELECT only
|
||||
after Z3PLUS is running. Remember that you need both TCSELECT.COM and
|
||||
Z3TCAP.TCP to generate your .Z3T file. The entries in the Z3TCAP library
|
||||
for the Xerox computers have been patched to correct a long-standing error.
|
||||
|
||||
|
||||
2. LSH REPLACES EASE.
|
||||
|
||||
EASE has been replaced by a newer, more versatile, and well-behaved program
|
||||
named LSH (Log SHell). Like EASE, LSH allows you to edit command lines
|
||||
using WordStar-like control. Consult LSH.WZ before use for general
|
||||
information and/or run HELPLSH while running LSH for a display of LSH's
|
||||
capabilities. LSHINST installs and customizes LSH to taste. Error
|
||||
handling is now taken care of by ZERR.COM, a separate program. Our great<61>
|
||||
thanks to Rob Friefeld for writing these superb Z-System tools and for<6F>
|
||||
allowing us to include them with NZ-COM.
|
||||
|
||||
|
||||
3. COPY LDIR.COM TO A0:.
|
||||
|
||||
We neglected to include LDIR.COM in the list of files to copy to your A0:
|
||||
directory. Some of the examples in the manual will not work correctly if
|
||||
LDIR is not available as a command.
|
||||
|
||||
|
||||
4. CHOICE OF MODULE SIZES.
|
||||
|
||||
Because of the page alignment of the Z3PLUS system, if the total number of
|
||||
records required by the NDR, FCP, and RCP combined is an odd number, you
|
||||
can generally increase the size of one of the modules by 1 record without
|
||||
losing any additional TPA. We have, therefore, increased the number of
|
||||
names in the NDR from 14, as stated in the manual, to 21. Until you reach
|
||||
a large number of names (more than 60), you can figure one record of memory
|
||||
for each 7 names.
|
||||
|
||||
|
||||
5. YOU NEED REN.COM.
|
||||
|
||||
Because there is no resident REN command with the standard version of
|
||||
Z3PLUS, you should copy the transient version TY4REN.COM to directory A0:
|
||||
under the name REN.COM.
|
||||
|
||||
|
||||
6. ZHELP.COM.
|
||||
|
||||
The standard form of HELP.COM sets up a file control block with the file
|
||||
type H?P in it so that either an HLP or a squeezed HQP file can be opened.
|
||||
While this works with a CP/M-2.2 BDOS (which is happy to open the first
|
||||
file that matches a wildcard FCB), it is trapped as an error by the
|
||||
CP/M-Plus BDOS. The version of ZHELP distributed with Z3PLUS has been
|
||||
patched to look only for HLP files. If you pick up any later releases of
|
||||
this program, it is possible that you will experience this problem. We
|
||||
will try to alert the programming community to this problem so that future
|
||||
Z-System programs will be compatible with CP/M-Plus.
|
||||
|
||||
|
||||
7. OSBORNE EXECUTIVE ROM BUG.
|
||||
|
||||
Testing on an early version (1.20) of the Executive's boot ROM showed that
|
||||
Z3PLUS would not load because the ROM misused the Z80 index registers.
|
||||
Version 1.21 of the Osborne Executive ROM works correctly and is available
|
||||
from FOG (First Osborne Group). Alternatively, a utility named TPATCH is
|
||||
available on bulletin boards. TPATCH can be run after cold-booting the
|
||||
Executive, and before Z3PLUS is loaded.
|
||||
|
||||
|
||||
8. SMARTKEY BUGS.
|
||||
|
||||
Smartkey II version 1.0A will often not run on banked-memory CP/M Plus
|
||||
computers; this problem is more likely to occur if Z3PLUS is loaded. The
|
||||
SUBMIT file PATCHSK.SUB, which installs PATCH4SK.HEX into Smartkey, appears
|
||||
to correct this bug.
|
||||
|
||||
If you use Smartkey, read the submit file carefully, be sure you have
|
||||
exactly this version of Smartkey and the other necessary files, and test on
|
||||
your system.
|
||||
|
||||
We and other users would appreciate hearing from you whether/how-well this
|
||||
works. We cannot support the Smartkey product but will be happy to make
|
||||
the source code of the patch available for others to develop further.
|
||||
|
||||
|
||||
9. COMPATIBILITY WITH BYE.
|
||||
|
||||
BYE, the remote access program for CP/M, causes some difficulties when run
|
||||
with Z3PLUS. In technical terms, BYE alters the bytes in the CP/M-Plus SCB,
|
||||
which Z3PLUS uses to tell when a CP/M-Plus SUBMIT job is running, and BYE
|
||||
does not restore these bytes on exit. Since SUBMIT jobs have a higher
|
||||
priority than shells in the Z-System command hierarchy, BYE causes Z3PLUS
|
||||
to simply return when the user attempts to run shell programs such as
|
||||
ZFILER or LSH under (or after) BYE.
|
||||
|
||||
If you MUST use shells with BYE, you can remove SUBMIT job detection by
|
||||
installing the patch below. The only drawback is that SUBMIT and shells
|
||||
will no longer run concurrently. However, the new ZEX 5.0 (included in
|
||||
this package) surpasses SUBMIT for all purposes except startup of Z3PLUS
|
||||
(not affected by the patch) and extremely TPA-critical situations, so this
|
||||
should not be a problem.
|
||||
|
||||
The patch is as follows. Extract your DEFCP3.ZRL file from Z3PLUS.LBR.
|
||||
Use a patcher to look at the first page of the file. You should find the
|
||||
string "Z3PLUSCP 6/25/88 v 1.00". If so, go to offset 985 hex in the file.
|
||||
The two bytes at this location should be D6 and C3 hex. Change them to AF
|
||||
AF. Now use LPUT or NULU to put DEFCP3.ZRL back in Z3PLUS.LBR and restart
|
||||
Z3PLUS.
|
||||
|
||||
|
||||
10. MINOR UPDATE NOTES.
|
||||
|
||||
- The RCP WHLQ command no longer used. "WHL" alone displays the current
|
||||
wheel status. As before, "WHL password" turns the wheel byte on. "WHL
|
||||
xxx" now turns the wheel byte OFF if xxx is something other than the
|
||||
correct password.
|
||||
|
||||
- ARUNZ is now a type-4 program which loads at the highest possible
|
||||
memory location so as to save lower memory for immediate re-execution
|
||||
with GO. See ARUNZ09R.DZC and TCJ31.MZG (as well as your NZ-COM or
|
||||
Z3PLUS manual) for more on the amazing ARUNZ.
|
||||
|
||||
- VLU is no longer included, as it was not reliable. Please use LDIR,
|
||||
LGET, LPUT, and LT instead to manipulate library files.
|
||||
|
||||
- At this writing, we are sorry to note that both Z-Node Central and the
|
||||
Lillipute Z-Nodes mentioned in Chapter 7 of your manual are out of
|
||||
service. Z-Nodes 2 and 3 are still going strong, however, as are the
|
||||
many others listed in ZNODES.LST. Z-Node 2 is the new Z-Node Central.
|
||||
We cannot recommend highly enough that you get a modem and investigate at
|
||||
least one Z-Node as a source of inspiration and support.
|
||||
|
||||
- Version 5.0 of the ZEX batch processor replaces earlier versions. ZEX
|
||||
now runs under both NZ-COM and Z3PLUS and is a very powerful means of
|
||||
customizing programs and commands. The ZEX.RSX file mentioned in the
|
||||
manual is no longer required. See ZEX50.DZC for help.
|
||||
|
||||
|
||||
11. TO NEW Z-SYSTEM USERS.
|
||||
|
||||
- All files whose middle filetype character is "Z" (e.g., SAMPLE.DZC) are
|
||||
"crunched" files which must be uncompressed with LT.COM or UNCRUNCH.COM
|
||||
before use.
|
||||
|
||||
- As outlined in section 4.3.2 of your manual, most Z-System programs
|
||||
have built-in help; type the name of any program followed by "//" for a
|
||||
short description if you are confused.
|
||||
|
||||
- Finally, it is not at all necessary to master every nuance of the system
|
||||
before it becomes useful. Please don't try to devour all of Z-System at
|
||||
once. Instead, we suggest that you decide what aspects of the system you
|
||||
will find most helpful and try to master one or two of those before
|
||||
exploring further. We think you will find that if you choose wisely,
|
||||
learning one aspect fully not only makes that aspect of your computing
|
||||
world easier, it also equips you with the skills and confidence with
|
||||
which to surmount other aspects of Z-System more confidently.
|
||||
|
||||
|
||||
12. NEW DEFAULTS AND NEW FILES: FCP.LBR, RCP.LBR.
|
||||
|
||||
To minimize disk space requirements, Z3PLUS.LBR contains only some standard
|
||||
configurations of the FCP and RCP modules. Alternative versions of these
|
||||
modules are now supplied in separate libraries. Modules can be loaded
|
||||
directly from these libraries, or individual files can be extracted and put
|
||||
into Z3PLUS.LBR to replace the default files. Each library has a brief DOC
|
||||
file describing the modules (some of which are the default versions included
|
||||
in Z3PLUS.LBR).
|
||||
|
||||
Carson Wilson and Rob Friefeld have made some major changes in the RCP code
|
||||
(see the DOC file in RCP.LBR). The standard RCP module is now 18 records
|
||||
long instead of 16, and the large RCP module is 36 records long. The system
|
||||
configuration files DEFAULT.Z3P and LARGE.Z3P have been edited to reflect
|
||||
these changes. The TPA requirements listed on page 54 of the manual are no
|
||||
longer correct.
|
||||
|
||||
|
||||
- End of RELEASE.NOT -
|
||||
|
||||
BIN
Source/Images/d_z3plus/u15/ALIAS.CMD
Normal file
BIN
Source/Images/d_z3plus/u15/ALIAS.CMD
Normal file
Binary file not shown.
64
Source/Images/fd_z3plus.txt
Normal file
64
Source/Images/fd_z3plus.txt
Normal file
@@ -0,0 +1,64 @@
|
||||
#
|
||||
# Add the ReadMe document
|
||||
#
|
||||
d_z3plus/ReadMe.txt 0:
|
||||
#
|
||||
# Add files from CPM3 build
|
||||
#
|
||||
../CPM3/cpmldr.com 0:
|
||||
../CPM3/cpmldr.sys 0:
|
||||
../CPM3/ccp.com 0:
|
||||
../CPM3/gencpm.com 0:
|
||||
../CPM3/genres.dat 0:
|
||||
../CPM3/genbnk.dat 0:
|
||||
../CPM3/bios3.spr 0:
|
||||
../CPM3/bnkbios3.spr 0:
|
||||
../CPM3/bdos3.spr 0:
|
||||
../CPM3/bnkbdos3.spr 0:
|
||||
../CPM3/resbdos3.spr 0:
|
||||
../CPM3/cpm3res.sys 0:
|
||||
../CPM3/cpm3bnk.sys 0:
|
||||
../CPM3/gencpm.dat 0:
|
||||
../CPM3/cpm3.sys 0:
|
||||
../CPM3/readme.1st 0:
|
||||
../CPM3/cpm3fix.pat 0:
|
||||
#
|
||||
# Include CP/M 3 files
|
||||
#
|
||||
d_cpm3/u0/*.COM 15:
|
||||
d_cpm3/u0/SUBMIT.COM 0:
|
||||
d_cpm3/u0/HELP.HLP 0:
|
||||
#
|
||||
# Add RomWBW utilities
|
||||
#
|
||||
../../Binary/Apps/assign.com 15:
|
||||
../../Binary/Apps/cpuspd.com 15:
|
||||
../../Binary/Apps/reboot.com 15:
|
||||
../../Binary/Apps/fat.com 15:
|
||||
../../Binary/Apps/fdu.com 15:
|
||||
../../Binary/Apps/mode.com 15:
|
||||
../../Binary/Apps/rtc.com 15:
|
||||
../../Binary/Apps/survey.com 15:
|
||||
../../Binary/Apps/syscopy.com 15:
|
||||
../../Binary/Apps/sysgen.com 15:
|
||||
../../Binary/Apps/timer.com 15:
|
||||
../../Binary/Apps/xm.com 15:
|
||||
#
|
||||
# Add Shared NZCOM/Z3PLUS
|
||||
#
|
||||
Common/NZ3PLUS/u10/*.* 10:
|
||||
Common/NZ3PLUS/u14/*.* 14:
|
||||
Common/NZ3PLUS/u15/*.* 15:
|
||||
#
|
||||
# Add Common Applications
|
||||
#
|
||||
# Common/All/u10/*.* 10:
|
||||
# Common/All/u14/*.* 14:
|
||||
# Common/All/u15/*.* 15:
|
||||
Common/CPM3/*.* 15:
|
||||
Common/Z/u14/*.* 14:
|
||||
Common/Z/u15/*.* 15:
|
||||
# Common/Z3/u10/*.* 10:
|
||||
Common/Z3/u14/*.* 14:
|
||||
Common/Z3/u15/*.* 15:
|
||||
# Common/UTILS/*.* 15:
|
||||
@@ -42,7 +42,7 @@ d_cpm3/u0/HELP.HLP 0:
|
||||
../../Binary/Apps/survey.com 15:
|
||||
../../Binary/Apps/syscopy.com 15:
|
||||
../../Binary/Apps/sysgen.com 15:
|
||||
../../Binary/Apps/talk.com 15:
|
||||
#../../Binary/Apps/talk.com 15:
|
||||
#../../Binary/Apps/htalk.com 15:
|
||||
#../../Binary/Apps/tbasic.com 15:
|
||||
../../Binary/Apps/timer.com 15:
|
||||
|
||||
@@ -12,14 +12,14 @@
|
||||
#../../Binary/Apps/*.com 15:
|
||||
../../Binary/Apps/assign.com 15:
|
||||
../../Binary/Apps/bbcbasic.com 15:
|
||||
../../Binary/Apps/bbcbasic.txt 15:
|
||||
../../Binary/Apps/bbcbasic.txt 10:
|
||||
../../Binary/Apps/cpuspd.com 15:
|
||||
../../Binary/Apps/reboot.com 15:
|
||||
../../Binary/Apps/copysl.com 15:
|
||||
../../Binary/Apps/copysl.doc 15:
|
||||
../../Binary/Apps/copysl.doc 10:
|
||||
../../Binary/Apps/fat.com 15:
|
||||
../../Binary/Apps/fdu.com 15:
|
||||
../../Binary/Apps/fdu.doc 15:
|
||||
../../Binary/Apps/fdu.doc 10:
|
||||
../../Binary/Apps/format.com 15:
|
||||
../../Binary/Apps/mode.com 15:
|
||||
../../Binary/Apps/rtc.com 15:
|
||||
@@ -34,7 +34,7 @@
|
||||
../../Binary/Apps/xm.com 15:
|
||||
../../Binary/Apps/zmp.com 15:
|
||||
../../Binary/Apps/zmp.hlp 15:
|
||||
../../Binary/Apps/zmp.doc 15:
|
||||
../../Binary/Apps/zmp.doc 10:
|
||||
../../Binary/Apps/zmxfer.ovr 15:
|
||||
../../Binary/Apps/zmterm.ovr 15:
|
||||
../../Binary/Apps/zminit.ovr 15:
|
||||
|
||||
@@ -75,6 +75,12 @@ Common/Test/*.* 2:
|
||||
#
|
||||
../ZSDOS/zsys_wbw.sys 0:zsys.sys
|
||||
#
|
||||
# Add Shared NZCOM/Z3PLUS
|
||||
#
|
||||
Common/NZ3PLUS/u10/*.* 10:
|
||||
Common/NZ3PLUS/u14/*.* 14:
|
||||
Common/NZ3PLUS/u15/*.* 15:
|
||||
#
|
||||
# Add Common Applications
|
||||
#
|
||||
Common/All/u10/*.* 10:
|
||||
|
||||
100
Source/Images/hd_z3plus.txt
Normal file
100
Source/Images/hd_z3plus.txt
Normal file
@@ -0,0 +1,100 @@
|
||||
#
|
||||
# Add the ReadMe document
|
||||
#
|
||||
d_z3plus/ReadMe.txt 0:
|
||||
#
|
||||
# Add files from CPM3 build
|
||||
#
|
||||
../CPM3/cpmldr.com 0:
|
||||
../CPM3/cpmldr.sys 0:
|
||||
../CPM3/ccp.com 0:
|
||||
../CPM3/gencpm.com 0:
|
||||
../CPM3/genres.dat 0:
|
||||
../CPM3/genbnk.dat 0:
|
||||
../CPM3/bios3.spr 0:
|
||||
../CPM3/bnkbios3.spr 0:
|
||||
../CPM3/bdos3.spr 0:
|
||||
../CPM3/bnkbdos3.spr 0:
|
||||
../CPM3/resbdos3.spr 0:
|
||||
../CPM3/cpm3res.sys 0:
|
||||
../CPM3/cpm3bnk.sys 0:
|
||||
../CPM3/gencpm.dat 0:
|
||||
../CPM3/cpm3.sys 0:
|
||||
../CPM3/readme.1st 0:
|
||||
../CPM3/cpm3fix.pat 0:
|
||||
#
|
||||
# Include CP/M 3 files
|
||||
#
|
||||
d_cpm3/u0/*.COM 15:
|
||||
d_cpm3/u0/SUBMIT.COM 0:
|
||||
d_cpm3/u0/HELP.HLP 0:
|
||||
#
|
||||
# Add RomWBW utilities
|
||||
#
|
||||
#../../Binary/Apps/*.com 15:
|
||||
../../Binary/Apps/assign.com 15:
|
||||
../../Binary/Apps/bbcbasic.com 15:
|
||||
../../Binary/Apps/bbcbasic.txt 10:
|
||||
../../Binary/Apps/cpuspd.com 15:
|
||||
../../Binary/Apps/reboot.com 15:
|
||||
../../Binary/Apps/copysl.com 15:
|
||||
../../Binary/Apps/copysl.doc 10:
|
||||
../../Binary/Apps/fat.com 15:
|
||||
../../Binary/Apps/fdu.com 15:
|
||||
../../Binary/Apps/fdu.doc 10:
|
||||
../../Binary/Apps/format.com 15:
|
||||
../../Binary/Apps/mode.com 15:
|
||||
../../Binary/Apps/rtc.com 15:
|
||||
../../Binary/Apps/survey.com 15:
|
||||
../../Binary/Apps/syscopy.com 15:
|
||||
../../Binary/Apps/sysgen.com 15:
|
||||
../../Binary/Apps/talk.com 15:
|
||||
../../Binary/Apps/htalk.com 15:
|
||||
../../Binary/Apps/tbasic.com 15:
|
||||
../../Binary/Apps/timer.com 15:
|
||||
../../Binary/Apps/tune.com 15:
|
||||
../../Binary/Apps/xm.com 15:
|
||||
../../Binary/Apps/zmp.com 15:
|
||||
../../Binary/Apps/zmp.hlp 15:
|
||||
../../Binary/Apps/zmp.doc 10:
|
||||
../../Binary/Apps/zmxfer.ovr 15:
|
||||
../../Binary/Apps/zmterm.ovr 15:
|
||||
../../Binary/Apps/zminit.ovr 15:
|
||||
../../Binary/Apps/zmconfig.ovr 15:
|
||||
../../Binary/Apps/zmd.com 15:
|
||||
../../Binary/Apps/vgmplay.com 15:
|
||||
#
|
||||
../../Binary/Apps/Test/*.com 2:
|
||||
../../Binary/Apps/Test/*.doc 2:
|
||||
Common/Test/*.* 2:
|
||||
#
|
||||
# Add Tune sample files
|
||||
#
|
||||
../../Binary/Apps/Tunes/*.pt? 3:
|
||||
../../Binary/Apps/Tunes/*.mym 3:
|
||||
../../Binary/Apps/Tunes/*.vgm 3:
|
||||
#
|
||||
# Add CPNET client files
|
||||
#
|
||||
../../Binary/CPNET/cpn3*.lbr 4:
|
||||
../../Binary/CPNET/ReadMe.txt 4:
|
||||
#
|
||||
# Add Shared NZCOM/Z3PLUS
|
||||
#
|
||||
Common/NZ3PLUS/u10/*.* 10:
|
||||
Common/NZ3PLUS/u14/*.* 14:
|
||||
Common/NZ3PLUS/u15/*.* 15:
|
||||
#
|
||||
# Add Common Applications
|
||||
#
|
||||
Common/All/u10/*.* 10:
|
||||
Common/All/u14/*.* 14:
|
||||
Common/All/u15/*.* 15:
|
||||
Common/CPM3/*.* 15:
|
||||
Common/Z/u14/*.* 14:
|
||||
Common/Z/u15/*.* 15:
|
||||
Common/Z3/u10/*.* 10:
|
||||
Common/Z3/u14/*.* 14:
|
||||
Common/Z3/u15/*.* 15:
|
||||
Common/SIMH/*.* 13:
|
||||
Common/UTILS/*.* 15:
|
||||
@@ -33,14 +33,14 @@ d_cpm3/u0/HELP.HLP 0:
|
||||
#../../Binary/Apps/*.com 15:
|
||||
../../Binary/Apps/assign.com 15:
|
||||
../../Binary/Apps/bbcbasic.com 15:
|
||||
../../Binary/Apps/bbcbasic.txt 15:
|
||||
../../Binary/Apps/bbcbasic.txt 10:
|
||||
../../Binary/Apps/cpuspd.com 15:
|
||||
../../Binary/Apps/reboot.com 15:
|
||||
../../Binary/Apps/copysl.com 15:
|
||||
../../Binary/Apps/copysl.doc 15:
|
||||
../../Binary/Apps/copysl.doc 10:
|
||||
../../Binary/Apps/fat.com 15:
|
||||
../../Binary/Apps/fdu.com 15:
|
||||
../../Binary/Apps/fdu.doc 15:
|
||||
../../Binary/Apps/fdu.doc 10:
|
||||
../../Binary/Apps/format.com 15:
|
||||
../../Binary/Apps/mode.com 15:
|
||||
../../Binary/Apps/rtc.com 15:
|
||||
@@ -55,7 +55,7 @@ d_cpm3/u0/HELP.HLP 0:
|
||||
../../Binary/Apps/xm.com 15:
|
||||
../../Binary/Apps/zmp.com 15:
|
||||
../../Binary/Apps/zmp.hlp 15:
|
||||
../../Binary/Apps/zmp.doc 15:
|
||||
../../Binary/Apps/zmp.doc 10:
|
||||
../../Binary/Apps/zmxfer.ovr 15:
|
||||
../../Binary/Apps/zmterm.ovr 15:
|
||||
../../Binary/Apps/zminit.ovr 15:
|
||||
|
||||
Reference in New Issue
Block a user