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!