mirror of https://github.com/wwarthen/RomWBW.git
Wayne Warthen
6 years ago
11 changed files with 330 additions and 173 deletions
@ -0,0 +1,167 @@ |
|||||
|
*********************************************************************** |
||||
|
*** *** |
||||
|
*** R o m W B W *** |
||||
|
*** *** |
||||
|
*** Z80/Z180 System Software *** |
||||
|
*** *** |
||||
|
*********************************************************************** |
||||
|
|
||||
|
This directory ("Binary") is part of the RomWBW System Software |
||||
|
distribution archive. Refer to the ReadMe.txt file in this |
||||
|
directory for more information on the overall contents of the |
||||
|
directory. |
||||
|
|
||||
|
RomWBW includes a set of disk images that are ready to copy onto |
||||
|
a floppy or hard/CF/SD disk. You can use your modern computer |
||||
|
(Windows/Linux/Mac) to copy the disk image file onto your disk |
||||
|
media. The disk media will then be ready to use in your RomWBW |
||||
|
System. |
||||
|
|
||||
|
A description of the disk images is provided later in this file. |
||||
|
For more information on the creatioin of these images including |
||||
|
instructions for customizing them or creating your own, refer to |
||||
|
the ReadMe.txt file in the Source\Images directory. |
||||
|
|
||||
|
Installing Images |
||||
|
----------------- |
||||
|
|
||||
|
The following instructions apply to Windows computers. Alternatively, |
||||
|
you can use the "dd" command on Linux or Mac. |
||||
|
|
||||
|
First of all, a MAJOR WARNING!!!! The tools described below are |
||||
|
quite capable of obliterating your running Windows system drive. Use |
||||
|
with extreme caution and make sure you have backups. |
||||
|
|
||||
|
To install a floppy image on floppy media, you can use the tool |
||||
|
called RaWriteWin. This tool is included in the Tools directory of |
||||
|
the distribution. This tool will write your floppy image (fd_xxx.img) |
||||
|
to a floppy disk using a raw block transfer. The tool is GUI based |
||||
|
and it's operation is self explanatory. |
||||
|
|
||||
|
To install a hard disk image on a CF card or SD card, you must have |
||||
|
the appropriate media card slot on your computer. If you do, you can |
||||
|
use the tool called Win32DiskImager. This tool is also included in |
||||
|
the Tools directory of the distribution. It will write your |
||||
|
hard disk image (hd_xxx.img) to the designated media card. This tool |
||||
|
is also GUI based and self explanatory. |
||||
|
|
||||
|
The use of the SIMH emulator is outside of the scope of this document. |
||||
|
However, if you use SIMH, you will find that you can attach the hard |
||||
|
disk images to the emulator with lines such as the following in your |
||||
|
SIMH configuration file: |
||||
|
|
||||
|
| attach hdsk0 hd_cpm22.img |
||||
|
| set hdsk0 format=HDSK |
||||
|
| set hdsk0 geom=T:2048/N:256/S:512 |
||||
|
| set hdsk0 wrtenb |
||||
|
|
||||
|
Making Disk Images Bootable |
||||
|
--------------------------- |
||||
|
|
||||
|
The Operating System disk images below are ready to boot by the |
||||
|
RomWBW Boot Loader. However, if you update your RomWBW ROM, then |
||||
|
you should also update the system tracks of your bootable disk |
||||
|
images. You would use SYSCOPY to do this. SYSCOPY can also be |
||||
|
used to make a disk bootable if it is not already bootable. |
||||
|
|
||||
|
You would use a command like the following to make drive C bootable: |
||||
|
|
||||
|
| B>SYSCOPY C:=CPM.SYS |
||||
|
|
||||
|
The system file to use depends on the operating system you are trying |
||||
|
to boot from the slice you are initializing with SYSCOPY: |
||||
|
|
||||
|
CP/M 2.2 - cpm.sys |
||||
|
ZSDOS 1.1 - zsys.sys |
||||
|
CP/M 3 - cpmldr.sys |
||||
|
ZPM3 - cpmldr.sys |
||||
|
|
||||
|
Slices |
||||
|
------ |
||||
|
|
||||
|
A RomWBW CP/M filesystem is fixed at 8MB. This is because it is the |
||||
|
largest size filesystem supported by all common CP/M variants. Since |
||||
|
all modern hard disks (including SD Cards and CF Cards) are much |
||||
|
larger than 8MB, RomWBW supports the concept of "slices". This |
||||
|
simply means that you can concatenate multiple CP/M filesystems (up |
||||
|
to 256 of them) on a single physical hard disk and RomWBW will allow |
||||
|
you to assign drive letters to them and treat them as multiple |
||||
|
independent CP/M drives. |
||||
|
|
||||
|
With the exception of the hd_combo image, each of the disk images |
||||
|
includes a single CP/M file system (i.e., a single slice). However, |
||||
|
you can easily create a multi-slice disk image by merely concatenating |
||||
|
multiple images together. For example, if you wanted to create a 2 |
||||
|
slice disk image that has ZSDOS in the first slice and Wordstar in |
||||
|
the second slice, you could use the following command from a Windows |
||||
|
command prompt: |
||||
|
|
||||
|
| C:\RomWBW\Binary>copy /b hd_zsdos.img + hd_ws.img hd_multi.img |
||||
|
|
||||
|
You can now write hd_multi.img onto your SD or CF Card and you will |
||||
|
have ZSDOS in the first slice and Wordstar in the second slice. |
||||
|
|
||||
|
The hd_combo disk image is an example of this. It contains several |
||||
|
slices in one image file. The contents of this special disk image |
||||
|
are described below. |
||||
|
|
||||
|
The concept of slices applies ONLY to hard disks. Floppy disks are |
||||
|
not large enough to support multiple slices. |
||||
|
|
||||
|
Disk Image Contents |
||||
|
------------------- |
||||
|
|
||||
|
What follows is a brief description of the contents of the |
||||
|
disk images automatically provided in the RomWBW distribution. |
||||
|
Note that all of the OS images include the RomWBW custom |
||||
|
support apps. |
||||
|
|
||||
|
cpm22 - DRI CP/M 2.2 (Bootable Floppy and Hard Disk) |
||||
|
|
||||
|
Standard DRI CP/M 2.2 distribution files along with a few commonly |
||||
|
used utilities. |
||||
|
|
||||
|
zsdos - ZCPR1 + ZSDOS 1.1 (Bootable Floppy and Hard Disk) |
||||
|
|
||||
|
Contains ZCPR1 and ZSDOS 1.1. This is roughly equivalent to the |
||||
|
ROM boot contents, but provides a full set of the applications |
||||
|
and related files that would not all fit on the ROM drive. |
||||
|
|
||||
|
nzcom - NZCOM (Bootable Floppy and Hard Disk) |
||||
|
|
||||
|
Standard NZCOM distribution. Note that you will need to run the |
||||
|
NZCOM setup before this will run properly. You will need |
||||
|
to refer to the NZCOM documentation. |
||||
|
|
||||
|
cpm3 - DRI CP/M3 (Bootable Floppy and Hard Disk) |
||||
|
|
||||
|
Standard DRI CP/M 3 adaptation for RomWBW that is ready to run. |
||||
|
It can be started by running CPMLDR. |
||||
|
|
||||
|
zpm3 - ZPM3 (Bootable Floppy and Hard Disk) |
||||
|
|
||||
|
Simeon Cran's ZCPR 3 compatible OS for CP/M 3 adapted for RomWBW and |
||||
|
ready to run. It can be started by running CPMLDR (which seems |
||||
|
wrong, but ZPMLDR is somewhat broken). |
||||
|
|
||||
|
ws4 - WordStar 4 (Floppy and Hard Disk) |
||||
|
|
||||
|
Micropro Wordstar 4 full distribution. This image is not bootable |
||||
|
and is intended to be added as an additional slice to an OS image. |
||||
|
|
||||
|
bp - BPBIOS (Hard Disk only) |
||||
|
|
||||
|
Adaptation of BPBIOS for RomWBW. This is NOT complete and NOT |
||||
|
useable in it's current state. |
||||
|
|
||||
|
combo - Multi-Boot Combination (Bootable Hard Disk) |
||||
|
|
||||
|
A pre-created combo image that contains the following slices. The |
||||
|
slices are identical to the individual images listed above. |
||||
|
|
||||
|
Slice 0: cpm22 (bootable) |
||||
|
Slice 1: zsdos (bootable) |
||||
|
Slice 2: nzcom (bootable) |
||||
|
Slice 3: cpm3 (bootable) |
||||
|
Slice 4: zpm3 (bootable) |
||||
|
Slice 5: ws4 (not bootable) |
||||
@ -0,0 +1,55 @@ |
|||||
|
; |
||||
|
;================================================================================================== |
||||
|
; SC131 STANDARD CONFIGURATION |
||||
|
;================================================================================================== |
||||
|
; |
||||
|
; THE COMPLETE SET OF DEFAULT CONFIGURATION SETTINGS FOR THIS PLATFORM ARE FOUND IN THE |
||||
|
; CFG_<PLT>.ASM INCLUDED FILE WHICH IS FOUND IN THE PARENT DIRECTORY. THIS FILE CONTAINS |
||||
|
; COMMON CONFIGURATION SETTINGS THAT OVERRIDE THE DEFAULTS. IT IS INTENDED THAT YOU MAKE |
||||
|
; YOUR CUSTOMIZATIONS IN THIS FILE AND JUST INHERIT ALL OTHER SETTINGS FROM THE DEFAULTS. |
||||
|
; EVEN BETTER, YOU CAN MAKE A COPY OF THIS FILE WITH A NAME LIKE <PLT>_XXX.ASM AND SPECIFY |
||||
|
; YOUR FILE IN THE BUILD PROCESS. |
||||
|
; |
||||
|
; THE SETTINGS BELOW ARE THE SETTINGS THAT ARE MOST COMMONLY MODIFIED FOR THIS PLATFORM. |
||||
|
; MANY OF THEM ARE EQUAL TO THE SETTINGS IN THE INCLUDED FILE, SO THEY DON'T REALLY DO |
||||
|
; ANYTHING AS IS. THEY ARE LISTED HERE TO MAKE IT EASY FOR YOU TO ADJUST THE MOST COMMON |
||||
|
; SETTINGS. |
||||
|
; |
||||
|
; N.B., SINCE THE SETTINGS BELOW ARE REDEFINING VALUES ALREADY SET IN THE INCLUDED FILE, |
||||
|
; TASM INSISTS THAT YOU USE THE .SET OPERATOR AND NOT THE .EQU OPERATOR BELOW. ATTEMPTING |
||||
|
; TO REDEFINE A VALUE WITH .EQU BELOW WILL CAUSE TASM ERRORS! |
||||
|
; |
||||
|
; PLEASE REFER TO THE CUSTOM BUILD INSTRUCTIONS (README.TXT) IN THE SOURCE DIRECTORY (TWO |
||||
|
; DIRECTORIES ABOVE THIS ONE). |
||||
|
; |
||||
|
#DEFINE PLATFORM_NAME "SC131" |
||||
|
; |
||||
|
#include "cfg_scz180.asm" |
||||
|
; |
||||
|
CPUOSC .SET 18432000 ; CPU OSC FREQ IN MHZ |
||||
|
; |
||||
|
Z180_CLKDIV .SET 1 ; Z180: CHK DIV: 0=OSC/2, 1=OSC, 2=OSC*2 |
||||
|
Z180_MEMWAIT .SET 0 ; Z180: MEMORY WAIT STATES (0-3) |
||||
|
Z180_IOWAIT .SET 1 ; Z180: I/O WAIT STATES TO ADD ABOVE 1 W/S BUILT-IN (0-3) |
||||
|
; |
||||
|
LEDENABLE .SET TRUE ; ENABLES STATUS LED (SINGLE LED) |
||||
|
; |
||||
|
DIAGENABLE .SET FALSE ; ENABLES OUTPUT TO 8 BIT LED DIAGNOSTIC PORT |
||||
|
; |
||||
|
DSRTCENABLE .SET FALSE ; DSRTC: ENABLE DS-1302 CLOCK DRIVER (DSRTC.ASM) |
||||
|
; |
||||
|
ASCIENABLE .SET TRUE ; ASCI: ENABLE Z180 ASCI SERIAL DRIVER (ASCI.ASM) |
||||
|
; |
||||
|
ACIAENABLE .SET FALSE ; ACIA: ENABLE MOTOROLA 6850 ACIA DRIVER (ACIA.ASM) |
||||
|
; |
||||
|
SIOENABLE .SET FALSE ; SIO: ENABLE ZILOG SIO SERIAL DRIVER (SIO.ASM) |
||||
|
; |
||||
|
FDENABLE .SET FALSE ; FD: ENABLE FLOPPY DISK DRIVER (FD.ASM) |
||||
|
FDMODE .SET FDMODE_RCWDC ; FD: DRIVER MODE: FDMODE_[DIO|ZETA|DIDE|N8|DIO3] |
||||
|
; |
||||
|
IDEENABLE .SET FALSE ; IDE: ENABLE IDE DISK DRIVER (IDE.ASM) |
||||
|
; |
||||
|
PPIDEENABLE .SET FALSE ; PPIDE: ENABLE PARALLEL PORT IDE DISK DRIVER (PPIDE.ASM) |
||||
|
; |
||||
|
SDENABLE .SET TRUE ; SD: ENABLE SD CARD DISK DRIVER (SD.ASM) |
||||
|
; |
||||
Loading…
Reference in new issue