PCPI / ProDOS Support



All software components in this distribution are (c) 1988-1993 by

Steven N. Hirsch, except where otherwise noted by sign-on messages

and/or notices in the source code.  All recipients of this code are

licensed for non-commercial usage and may redistribute the unmodified

binaries without restriction, so long as this notice remains intact.



It is the author's intent to release all source code under the GPL as

time permits.



======================================================================



Purpose:



Run PCPI Applicard CP/M as a ProDOS application.  This offers the

following features and functionality:



- Boot CP/M from a SYSTEM file, keeping ProDOS live and resident. No

  more requirement for a cold-boot from floppy. 



- Quit directly to ProDOS from CP/M, retaining data on the Applicard

  ramdisk intact and recoverable on the next boot.



- Transfer files back and forth between CP/M and ProDOS using a

  menu-driven utility.  Options exist for renaming during transfer if

  source name is not valid on target filesystem.  Files may be

  transferred to ProDOS as text, binary or system.  If CP/M

  environment supports DateStamper system calls, file time stamps are

  preserved in both directions.



- All ProDOS MLI functionality is available to applications running on

  the Z80 card through the PCPI driver API "other" commands.



- A ProDOS time driver exists to support Z80 environments that

  require real-time clock support.



- All Z80 access to 5.25" floppy drives occurs through ProDOS RWTS, so

  40-track diskettes can be supported on patched ProDOS.   



======================================================================



General Installation Notes:



System generation in this environment will continue to require the use

of the INSTALL.COM utility to create a DRIVERS file and write CP/M to

the boot tracks of a 5.25" floppy diskette.  However, after initial

bootstrapping you can dispense with the boot floppy and start directly

from a ProDOS volume.



Configuring full ProDOS support is a two-step operation. In the first

phase, a ProDOS utility program captures the operating system boot

tracks, patches them and saves the image to a ProDOS file.  This

system is bootstrapped from a second ProDOS application but must load

DRIVERS from the diskette.  Once this transitional environment is

active on the Z80, you complete the process by transferring DRIVERS to

ProDOS with a CP/M utility.  From that point, you can boot CP/M

directly from ProDOS with no reference to the floppy (unless you need

to generate a new system).



=====================================================================



Extra Goodies:



Included on the CP/M diskette are some additional files that may be

useful:



FAST2E80.DVR : Updated version that corrects problem of inverse

               characters displaying as MouseText on enhanced IIe.



DISK35.DVR :   Driver for Apple 3.5" diskette drives.  Support Unidisk

               and Appledisk 3.5" drives.  Works with Apple 'Liron'

               and 3.5" controllers and most Central Point UDC

               controllers.  Does NOT work with Apple 'SuperDrive'

               high-density controller (work in progress to correct

               this).



=====================================================================



Installation Procedure:



While it is possible to run from a floppy-only environment,

configuration and use will be a royal pain (to be quite frank).  This

explanation will assume that a Pro/Partition hard disk volume is

installed and accessible.  We'll also assume that you are familiar and

comfortable with configuration and generation of PCPI operating system

diskettes. 



--------------------------------------------------------------------



==> Phase 1:



Create a working CP/M diskette with the following files from the PCPI

Applicard distribution:



FAST2E80.DVR

INSTALL.COM

DLDRIVER.COM

PDOSHD.DVR     (configured for your hard disk!)

PCPICPM



add any other drivers you typically use in your base system,

e.g. RAMDISK.DVR, DISK35.DVR, etc.



Copy the following files from the PCPI-ProDOS CP/M diskette:



PDOSMLI.DVR

DISK525.DVR

PDOSXFER.COM

PDOSXFER.OVR

QUIT.COM



Create a DRIVERS file with a setup like this:



1 = FAST IIe 80 CLM 19 1 x

2 = ProDOS MLI Drvr 24 1 xx

3 = ProDOS Hard Dsk 0  1 xx

4 = ProDOS 5.25     1  2 xx



(Versions may vary, thus the 'xx')



Save DRIVERS and write CP/M to the boot tracks.  Put this diskette

aside for the moment.



Reboot into ProDOS (minimum version is 1.4).  Copy the following files

from the PCPI-ProDOS ProDOS diskette to your hard disk volume:



PATCHER

LIB

ZPATCH.1

ZPATCH.2

FBOOT1

PCPIBOOT



Insert the CP/M diskette you created earlier into a free floppy drive

(slot 6, drive 2 is the recommended location).  From the ProDOS BASIC

prompt, run the patch program:



]-PATCHER



Follow the prompts and direct the program to the proper location for

the CP/M diskette.  When presented with a screen of:



      0) Image capture only, to suffix ".0"



      1) Patched to suffix ".1"



      2) Patched to suffix ".2"



      3) Patched to suffix ".3"



    Choose the system to be created: 



Hit '1' at the prompt.  The program will read the boot tracks into

memory, apply some patch overlays from 'ZPATCH.1' and save the

resulting image as 'ZIMAGE.1'.



When complete, exit the program by hitting, e.g. space.



Boot the system by running the floppy startup utility:



]-FBOOT1



When prompted, move the CP/M diskette you created to S6,D1 and strike

a key.



You should see the usual 'LOADING DRIVERS' message followed by the

CP/M prompt.



--------------------------------------------------------------------



==> Phase 2:



Change directory from your hard disk to the CP/M floppy (probably

drive B:) and run PDOSXFER.  The default is CP/M --> ProDOS, so hit

enter to proceed.  Accept the default drive and user area (B00:).  You

will see a directory listing of the CP/M diskette.  Using the arrow

keys, highlight 'DRIVERS'.  Enter 'R' for rename.  An entry field will

open up at the bottom of the screen.  Enter 'DRIVERS' followed by a

space to move the cursor past the '.' character.  Enter '2' for the

extension and hit enter.  Now, tag the file for transfer by entering

'B' to move it into ProDOS as a binary file.



Hit enter again, which moves you to the target selection screen.  The

program will try to identify all ProDOS volumes currently online.  Use

the arrow keys to select the hard drive you wish to start from.  Hit

enter again.  Now you can choose a subdirectory if you wish, or simply

hit enter to target the root.  



If all goes well, you will see a series of '>>>' characters at the

bottom of the screen and the DRIVERS file will be copied to ProDOS as

'DRIVERS.2'. 



When complete, exit the utility with ESC.  Return back to ProDOS by

running the QUIT.COM utility, select BASIC.SYSTEM and set your prefix

back to the location where you placed the ProDOS support files and the

new DRIVERS.2 file.



Run the patcher program again, but this time select the option to read

the CP/M diskette and patch to suffix '.2'.  This will read the boot

tracks of the diskette again, apply the overlays from 'ZPATCH.2' and

save the resulting image as 'ZIMAGE.2'.  Exit the patcher and verify

that both 'ZIMAGE.2' and 'DRIVERS.2' are present in the same directory

as PCPIBOOT.



Run the PCPIBOOT program:



]-PCPIBOOT



When prompted for the suffix, enter '2'.  CP/M and drivers should load

directly from ProDOS and bring you into a working CP/M environment.

From here you can use the PDOSXFER program to move files back and

forth, quitting to ProDOS at any point you wish with QUIT.COM.



Enjoy!



