Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
playground:wwarthen:start [2018/01/31 15:28] wwarthen |
playground:wwarthen:start [2023/03/16 19:44] (current) wwarthen |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== RomWBW ====== | ||
- | === Z80/Z180 System Software === | + | **RomWBW ReadMe**\\ |
+ | Version 3.2\\ | ||
+ | Wayne Warthen | ||
+ | 16 Mar 2023\\ | ||
- | Version 2.8.1, 2017-07-05 | + | ====== Overview ====== |
- | Wayne Warthen\\ | + | 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: |
- | [[mailto: | + | |
- | __Download:__ | + | * [[https:// |
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
- | * {{:software: | + | General features include: |
- | * {{: | + | |
- | __Related pages:__ | + | * Banked memory services for several banking designs |
+ | * Disk drivers for RAM, ROM, Floppy, IDE, CF, and SD | ||
+ | * Serial drivers including UART (16550-like), | ||
+ | * 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 |
- | * [[: | + | |
- | * [[:software:firmwareos: | + | |
- | * [[: | + | |
- | ===== Summary ===== | + | * System Monitor |
+ | * Operating Systems (CP/M 2.2, ZSDOS) | ||
+ | * ROM BASIC (Nascom BASIC and Tasty BASIC) | ||
+ | * ROM Forth | ||
- | RomWBW provides a complete software | + | A dynamic disk drive letter assignment mechanism allows mapping operating |
- | In addition to a simple system monitor, RomWBW includes robust adaptations of both CP/M-80 2.2 and Z-System (ZCPR + ZSDOS). Either operating system can be loaded directly from ROM or installed and loaded from disk storage. A selection of standard/ | + | The pre-built ROM firmware images are generally suitable for most users. However, it is also very easy to modify |
- | A pre-built ROM image is included for each platform. If desired, system | + | 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, |
- | John Coffman' | + | By design, |
- | ===== Installation ===== | + | A tool is provided that allows you to access a FAT-12/ |
- | In general, you will just program your system' | + | ====== Acquiring |
- | The pre-built | + | The [[https:// |
- | RomWBW is distributed as a package (zip archive) containing the pre-built ROM images, | + | All source code and distributions are maintained on GitHub. Code contributions are very welcome. |
- | ^Platform^ROM Image File^Built-in Device Support| | + | ====== Installation & Operation ====== |
- | |SBC V1/ | + | |
- | |Zeta V1|ZETA_std.rom|Supports ParPortProp (video, kbd, SD Card)| | + | |
- | |Zeta V2|ZETA2_std.rom|Supports ParPortProp (video, kbd, SD Card)| | + | |
- | |N8|N8_std.rom|Supports onboard SD Card, video, keyboard; production board assumed (date code >= 2312)| | + | |
- | |Mark IV|MK4_std.rom|Supports onboard SD Card, IDE Disk, VGA3/CVDU video/kbd, PropIO (video, kbd, SD Card)| | + | |
- | Your system does **not** | + | In general, installation of RomWBW on your platform is very simple. You just need to program your ROM with the correct |
- | Connect a serial terminal or computer with terminal emulation software to the primary RS-232 port of your CPU board. A null-modem connection will generally be required. Set the line characteristics to 38400 baud, 8 data bits, 1 stop bit, no parity, and no flow control. Select VT-100 terminal emulation. | + | Complete instructions for installation and operation of RomWBW are found in the [[https:// |
- | Upon power-up, your terminal should display a sign-on banner within 2 seconds followed by hardware inventory and discovery information. When hardware initialization is completed, a boot loader prompt allows you to choose a ROM-based operating system, system monitor, or boot from a disk device. | + | ===== Documentation ===== |
- | ===== CPU Speed ===== | + | Documentation for RomWBW includes: |
- | RomWBW ROM images support virtually any CPU speed your system is running. However, there are some hardware-oriented caveats to be aware of. | + | * [[https:// |
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
- | The use of high density floppy disks requires a CPU speed of 8 MHz or greater. | + | ====== Acknowledgments ====== |
- | The latest X-Modem file transfer programs (XM.COM, XM-A0.COM, and XM-A1.COM) require | + | 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! |
- | ===== Upgrading | + | * Andrew Lynch started it all when he created the N8VEM Z80 SBC which became the first platform RomWBW supported. Some of his 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, | ||
+ | * David Giles created support for the Z180 CSIO which is now included SD Card driver. | ||
+ | * Ed Brindley contributed some of the code that supports the RCBus platform. | ||
+ | * 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 enhancements. | ||
+ | * 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. | ||
+ | * 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 the sound driver interface and the SN76489 sound driver. | ||
+ | * The RomWBW Disk Catalog document was produced by Mykl Orders. | ||
- | Program a new ROM chip from an image in the new distribution. Install the new ROM chip and boot your system. At the boot loader " | + | Contributions of all kinds to RomWBW are very welcome. |
- | If you have spare ROM chips for your system, it is always safest to keep your existing, working ROM chip and program a new. If the new one fails to boot, you can easily return to the known working ROM. | + | ====== |
- | + | ||
- | If you use a customized ROM image, it is recommended that you first try a pre-built ROM image first and then move on to generating a custom image. | + | |
- | + | ||
- | It is entirely possible to reprogram your system ROM using the FLASH utility from Will Sowerbutts on your ROM drive (B:). In this case, you would need to transfer the new ROM image to your system using XModem. Obviously, there is some risk to this approach since any issues with the programming or ROM image could result in a non-functional system. | + | |
- | + | ||
- | Once you have successfully booted your system with the new ROM, you should update the system software from previous releases that you may have copied to disk drives. This is described below. | + | |
- | + | ||
- | If your system has any bootable drives, then update the OS image on each drive using SYSCOPY. For example, if C: is a bootable drive with the Z-System OS, you would update the OS image on this drive with the command: | + | |
- | + | ||
- | < | + | |
- | B> | + | |
- | </ | + | |
- | + | ||
- | If you have copies of any of the system utilities on drives other than the ROM disk drive, you need to copy the latest version of the programs from the ROM drive (B:) to any drives containing these programs. For example, if you have a copy of the ASSIGN.COM program on C:, you would update it from the new ROM using the COPY command: | + | |
- | + | ||
- | < | + | |
- | B>COPY B: | + | |
- | </ | + | |
- | + | ||
- | The following programs are maintained with the ROM images and all copies of these programs should be updated when upgrading to a new ROM version: | + | |
- | + | ||
- | * ASSIGN.COM | + | |
- | * FORMAT.COM | + | |
- | * OSLDR.COM | + | |
- | * SYSCOPY.COM | + | |
- | * TALK.COM | + | |
- | * FD.COM (previously FDTST.COM) | + | |
- | * XM*.COM | + | |
- | + | ||
- | ===== Usage Instructions | + | |
- | + | ||
- | A typical set of CP/M-80 2.2 and Z-System applications are included on the ROM file system. The Doc directory of the distribution contains the CP/M, ZSDOS, and ZCPR user manuals which provide the primary usage information. Note that the Z-System applications will generally not run under CP/M. | + | |
- | + | ||
- | The following custom applications are included on the ROM disk to enhance the operation of RomWBW: | + | |
- | + | ||
- | ^Appplication^Description| | + | |
- | |ASSIGN.COM|Add, | + | |
- | |SYSCOPY.COM|Copy system image to a device to make it bootable. Use SYSCOPY with no parms for usage instructions.| | + | |
- | |FD.COM|Format and test floppy disks. Menu driven interface.| | + | |
- | |OSLDR.COM|Load a new OS on the fly. For example, you can switch to Z-System when running CP/M. Use OSLDR with no parms for usage instructions.| | + | |
- | |FORMAT.COM|Will someday be a command line tool to format floppy disks. Currently does nothing!| | + | |
- | |XM.COM|XModem file transfer program adapted to hardware. Note that N8 and Mark IV have XM-A0 and XM-A1 corresponding to the two serial ports on those systems.| | + | |
- | |FLASH.COM|Will Sowerbutts' | + | |
- | + | ||
- | ===== UNA Hardware BIOS ===== | + | |
- | + | ||
- | John Coffman has produced a new generation of hardware BIOS called UNA. In addition to the classic ROM images described above, RomWBW comes with a UNA-based image that combines the UNA BIOS with the RomWBW OS implementations and applications. | + | |
- | + | ||
- | UNA is customized dynamically using a ROM based setup routine and the setup is persisted in the system NVRAM of the RTC chip. This means that a single UNA-based ROM image can be used on most of the RetroBrew platforms and is easily customized. UNA also supports FAT file system access that can be used for in-situ ROM programming and loading system images. | + | |
- | + | ||
- | While John is likely to enhance UNA over time, there are currently a few things that UNA does not support: | + | |
- | + | ||
- | * Floppy Drives | + | |
- | * Video/ | + | |
- | * Zeta 1 and N8 Systems | + | |
- | * Some older support boards | + | |
- | + | ||
- | If you wish to try the UNA variant of RomWBW, then just program your ROM with the ROM image called " | + | |
- | + | ||
- | Please refer to the [[: | + | |
- | + | ||
- | ===== CP/M vs. Z-System ===== | + | |
- | + | ||
- | There are two OS variants included in this distribution and you may choose which one you prefer to use. Both variants are now included in the pre-built ROM images. You will be given the choice to boot either CP/M or Z-System at startup. | + | |
- | + | ||
- | The traditional Digital Research (DRI) CP/M OS is the first choice. The Doc directory contains a manual for CP/M usage ("CPM Manual.pdf" | + | |
- | + | ||
- | The other choice is to use the most popular non-DRI CP/M " | + | |
- | + | ||
- | ===== ROM Customization ===== | + | |
- | + | ||
- | The pre-built ROM images are configured for the basic capabilities of each platform. If you add board(s) to your system, you will need to customize your ROM image to include support for the added board(s). | + | |
- | + | ||
- | Essentially, | + | |
- | + | ||
- | For those who are interested in more than basic system customization, | + | |
- | + | ||
- | Note that the ROM customization process does not apply to UNA. All UNA customization is performed within the ROM setup script. | + | |
- | + | ||
- | Complete documentation of the customization process is found in the ReadMe.txt file in the Source directory. | + | |
- | + | ||
- | ===== Source Code Respository ===== | + | |
- | + | ||
- | All source code and distributions are maintained on GitHub. Code contributions are very welcome. | + | |
- | [[https:// | + | RomWBW |
- | ===== Distribution Directory Layout ===== | + | 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. |
- | The RomWBW distribution is a compressed zip archive file organized in a set of directories. Each of these directories has it's own ReadMe.txt file describing | + | You should have received |
- | ^Directory^Description| | + | Portions |
- | |Binary|The final output files of the build process are placed here. Most importantly, are the ROM images with the file names ending in " | + | |
- | |Doc|Contains various detailed documentation including the operating systems, RomWBW architecture, | + | |
- | |Source|Contains | + | |
- | |Tools|Contains the MS Windows programs | + | |
- | ===== Acknowledgements ===== | + | If anyone feels their work is being used outside of it’s intended licensing, please notify: |
- | While I have heavily modified much of the code, I want to acknowledge that much of the work is derived or copied from the work of others in the RetroBrew Computers Community including Andrew Lynch, Dan Werner, Max Scane, David Giles, John Coffman, and probably many others I am not clearly aware of (let me know if I omitted someone!). | + | > Wayne Warthen\\ |
+ | > < | ||
- | I especially want to credit Douglas Goodall for contributing code, time, testing, and advice. He created an entire suite of application | + | RomWBW is an aggregate work. It is composed |
- | David Giles has contributed support for the CSIO support | + | 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. |
- | UNA BIOS is a product of John Coffman. | + | 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. |
- | ===== Getting Assistance ===== | + | All contributions to RomWBW are subject to this license. |
- | The best way to get assistance with RomWBW or any aspect of the RetroBrew Computers projects is via the community forum. | + | ====== Getting Assistance ====== |
- | [[https:// | + | The best way to get assistance with RomWBW or any aspect of the RetroBrew Computers projects is via one of the community forums: |
- | Also feel free to email Wayne Warthen at [[wwarthen@gmail.com|]]. | + | * [[https:// |
+ | * [[https:// | ||
+ | * [[https:// | ||
- | \\ | + | Submission of issues and bugs are welcome at the [[https:// |
+ | Also feel free to email Wayne Warthen at < | ||