Table of Contents
In addition to the standard applications provided by the included operating systems, RomWBW provides several custom applications that enhance the operation of RomWBW. These applications are briefly documented here.
The ASSIGN command assigns operating system drive letters to desired hardware disk devices.
D represents any valid drive letter
<device> is any of the system devices, such as FD, IDE, PPIDE, etc.
<unitnum> specifies the device unit, defaults to 0
<slicenum> specifies the slice within a hard disk unit, defaults to 0
|display all current drive assignments|
|display version and usage|
|display all possible devices|
|swaps drive C: with drive D:|
|assign drive C: to floppy unit 0|
|assign drive C: to IDE unit0, slice 1|
|unassign drive C:|
The changes made by this command are not permanent. The assignments will persist through a warm start, but when you reboot your system, all drive letters will return to their default assignments. A SUBMIT batch file can be used to setup desired drive assignments automatically at boot.
All assigned drives utilize disk buffer space from a limited pool. The ASSIGN command will display the amount of buffer space remaining after an assign command is executed. Buffer space is freed if a drive is unassigned.
Floppy disk drives and RAM/ROM drives do not have slices. A slice should only be specified for hard disk devices (SD, IDE, PPIDE).
Only one drive letter may be assigned to a specific device/unit/slice at a time. Attempts to assign a duplicate drive letter will fail and display an error. If you wish to assign a different drive letter to a device/unit/slice, unassign the the existing drive letter first.
The SYSCOPY command allows you make a specified disk bootable by transferring the operating system image to the disk.
<dest> is the disk drive to receive the operating system image or alternatively a filename to store the operating system image
<src> is the disk drive or filename containing the system image to be placed on the destination
|transfer OS image in CPM.SYS file to system area of drive C:|
|transfer OS image from system area of drive A: to system area of drive C:|
|transfer OS image from system area of drive C: to file OS.SYS|
The target drive must have sufficient space in it's reserved tracks to accommodate the OS image being transferred. ROM drives and RAM drives have no reserved tracks and therefore cannot be made bootable by SYSCOPY. This is by design since the ROM allows directly loading either CP/M or Z-System from the ROM without using RAM or ROM drive space. The standard floppy and hard disk formats for RomWBW do contain reserved tracks with sufficient space for OS images.
Normally, the ROM drive of RomWBW systems will contain two OS image files that are ready to transfer to a target drive to make the drive bootable. CPM.SYS contains the DRI CPM-80 2.2 system image and ZSYS.SYS contains the Z-System OS image made up of ZSDOS and ZCPR.
The MODE command allows you to adjust the operating characteristics of serial ports dynamically.
<n> is the serial port unit number
<baud> is numerical baudrate
<parity> is (N)one, (O)dd, (E)ven, (M)ark, or (S)pace
<databits> is number of data bits, typically 7 or 8
<stopbits> is number of stop bits, typically 1 or 2
/P prompts user prior to setting new configuration /? displays command usage and version information
|display command usage|
|display configuration of all serial ports|
|display configuration of serial unit 0|
|set serial unit 1 configuration|
Specified baud rate and line characteristics must be supported by the serial unit. Any parameters not specified will remain unchanged.
Changes are not persisted and will revert to system defaults at next system boot.
FLASH is a CP/M program which can read, write and verify Flash ROM contents to or from an image file stored on a CP/M filesystem. It is intended for in-system programming of Flash ROM chips
See Will Sowerbutts site https://github.com/willsowerbutts/flash for more information.
The RTC command provides the facility to set the date and time and access the other facilities of the DS1302 Real Time Clock. Most systems can be configured with battery backup to retain the date and time
The Z-System O/S can be configured to use file timestamping but CP/M does not support this capability.
RTC does not have any command line options. Menu options are:
|Return to CP/M command line.|
|Display the date and time in the format YY-MM-DD HH:MM:SS-NN (NN is the day of the week)|
|Will restart the RTC program.|
|Set the previously entered time and date details into the RTC chip and starts the clock. See
|Display the current time every time the space key is pressed until any other key is pressed.|
|Display the current date and time every time the space key is pressed until any other key is pressed.|
|Turn on the RTC facility to charge the battery or super capacitor connected to the RTC.|
|Turn off the RTC facility to charge the battery or super capacitor.|
|Test the timing delay in the RTC software using a stopwatch. Instructions will be given to start and stop testing. Correct timing is indicated by an elapse time of ~43s. If your board is overclocked i.e. 8Mhz your elapse time will half of this, in which case correct timing constrains are not being maintained when accessing the RTC.|
|Allows the entry of the date, time and day of week and stored it in preparation of the
Example: Entering the date and time Saturday 10th November 2018 19:35PM (Day 00=Sunday .. Day 07=Saturday)
|Allows you to read and display one byte from DS1302 non-volatile memory area. Enter a two digit hex address in uppercase.|
|Allows you to save one byte in the DS1302 non-volatile memory. Enter a two digit hex uppercase address and a two digit hex value at the data prompt.|
|Reboot from the operating system back to the boot loader.|
|Redisplays the menu options.|