RomWBW Applications

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.

This page is under construction!!!

ASSIGN Command

The ASSIGN command assigns operating system drive letters to desired hardware disk devices.

Syntax
ASSIGN {/?|/L|D:[=[{D:|<device> [<unitnum>]:[<slicenum>]}]]}[,…]

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

Examples
ASSIGN display all current drive assignments
ASSIGN /? display version and usage
ASSIGN /L display all possible devices
ASSIGN C:=D: swaps drive C: with drive D:
ASSIGN C:=FD0: assign drive C: to floppy unit 0
ASSIGN C:=IDE0:1 assign drive C: to IDE unit0, slice 1
ASSIGN C:= unassign drive C:
Notes

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.

This command will allow you to unassign any drive including drives that contain system files and programs. Be careful to avoid losing access to critical files or programs.

SYSCOPY Command

The SYSCOPY command allows you make a specified disk bootable by transferring the operating system image to the disk.

Syntax
SYSCOPY <dest> [=<src>]

<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

Examples
SYSCOPY C:=CPM.SYS transfer OS image in CPM.SYS file to system area of drive C:
SYSCOPY C:=A: transfer OS image from system area of drive A: to system area of drive C:
SYSCOPY OS.SYS=C: transfer OS image from system area of drive C: to file OS.SYS
Notes

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.

MODE Command

The MODE command allows you to adjust the operating characteristics of serial ports dynamically.

Syntax
MODE COM<n>: [<baud> [,<parity> [,<databits> [,<stopbits>]]]] [/P]
MODE /?

<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

Examples
MODE /? display command usage
MODE display configuration of all serial ports
MODE COM0: display configuration of serial unit 0
MODE COM1: 9600,N,8,1 set serial unit 1 configuration
Notes

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.

FDU Command

OSLDR Command

FORMAT Command

XM Command

FLASH Command

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.

RTC Command

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:

E)xit Return to CP/M command line.
T)ime Display the date and time in the format YY-MM-DD HH:MM:SS-NN (NN is the day of the week)
st(A)rt Will restart the RTC program.
S)et Set the previously entered time and date details into the RTC chip and starts the clock. See (I)nit
R)aw Display the current time every time the space key is pressed until any other key is pressed.
L)oop Display the current date and time every time the space key is pressed until any other key is pressed.
C)harge Turn on the RTC facility to charge the battery or super capacitor connected to the RTC.
N)ocharge Turn off the RTC facility to charge the battery or super capacitor.
D)elay 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.
I)nit Allows the entry of the date, time and day of week and stored it in preparation of the S)et command to be issued. The prompt for the entry of the date, time and day of week does not allow for ANY editing and requires each field to be typed as a two digit number. Any error entering this data will require you to enter all field requested and then restart the I)nit command.

Example: Entering the date and time Saturday 10th November 2018 19:35PM (Day 00=Sunday .. Day 07=Saturday)

www.retrobrewcomputers.org_lib_plugins_ckgedit_fckeditor_userfiles_image_software_firmwareos_romwbw_apps_rtc.jpg
G)et Allows you to read and display one byte from DS1302 non-volatile memory area. Enter a two digit hex address in uppercase.
P)ut 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.
B)oot Reboot from the operating system back to the boot loader.
H)elp Redisplays the menu options.


software/firmwareos/romwbw/apps.txt · Last modified: 2018/11/11 07:40 by b1ackmai1er
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0