// README //

############################################################
This is the README file distributed with ppa3.c release 0.62
############################################################

!!! This driver remains available, but is not supported anymore.	!!!
!!! Please get the last release of ppbus (parallel port bus) at		!!! 
!!! http://www.prism.uvsq.fr/~son/PPBUS (only R2.2.x or higher)		!!!

   PRINTER INTERFACE
   -----------------
   The ZIP drive printer interface is available in AT and PS/2 modes.

   The ppa3.c driver only probes and attaches the lpt interface.
   For that purpose, a disabled polling lpt driver must be available.

   Be sure your lpt driver is in polling mode. Then disable it via the
   'boot -c' interface.

   Verify:
  	- your ZIP drive is forced to SPP polling mode, i.e.
		0x1, 0x2 or 0x6 mode, see below.

##############
   INSTALL
##############

   Copy ppa3.c file in /sys/i386/isa/ directory then,

   Add the following lines in your kernel configuration files:
   -------------------------------------------------------------------

   in /sys/i386/conf/files.i386,

   i386/isa/ppa3.c optional ppa device-driver
   -------------------------------------------------------------------

   in /sys/i386/conf/MACHINE,

   # These options are compatible with the 'config' interface but,
   # you can modify them directly in the ppa3.c, not to call 'config'
   # each time. More options are available in ppa3.c. Each option which
   # begins with the character '#' should not be in your 'MACHINE' file
   # if you don't know why it should.

   #options	"PPA_PC87332"		# If you have a pc87332 chipset
   #options	"PPA_EPP_SPEED=4096"	# To hardcode your correct EPP speed

   #options	"PPA_LPT"		# To allow lpt in NIBBLE or PS/2
					# NOT COMPATIBLE WITH PPBUS STUFF!

   #options	"PPA_21x_COMPAT"	# With FreeBSD 2.1.x only.

   controller	  scbus0  #base SCSI code
   device	  sd0	 #SCSI disks

   controller	  isa0
   controller	  ppa0	at isa? port 0x278 bio flags 0x0 #First drive
   controller	  ppa1	at isa? port 0x378 bio flags 0x0 #Second drive
   device	  lpt0	at isa? port? tty		 #Polling lpt driver

   Disable the lpt0 driver with the 'boot -c' interface:
	config> disable lpt0
  
   See comments about the 'flags' field later in the text.

   The base address of your parallel port (here 0x278) may be different.
   You have to disable your printer driver - lpt - either in your MACHINE
   config file or at boot with the -c option.

   (see /sys/i386/conf/LINT and config(8) manpage for details)
   -------------------------------------------------------------------

   ** This last patch is optional **
  
   in /sys/i386/i386/userconfig.c, cut and paste '{"ppa", ...},'
   after the line : 'static DEV_INFO device_info[] = {'
{"ppa",		"Iomega PPA3 controller",		0,		CLS_STORAGE}, 
   -------------------------------------------------------------------

###################
   CONFIGURATION
###################

   The device specific 'flags' describe the transfer mode and the speed
   of the chipset in EPP mode:

			  xxxx   <------ EPP transfer mode speed
			      xx <------ Transfer mode
			0x000000
			       ^ Lowest byte of 'flags'

   Available transfer modes
   ------------------------
  	- 0x0 for autodetect mode.		(DEFAULT)
  	- 0x1 to force NIBBLE 4 bit mode.
  	- 0x2 to force PS/2 8 bit mode.	
  	- 0x3 to force EPP 8 bit mode.
  	- 0x4 to force EPP 16 bit mode.
  	- 0x5 to force EPP 32 bit mode.
  	- 0x6 to force PS/2 8 bit mode via ECP.

   To modify 'flags' without recompiling your kernel, use the -c option
   at boot (see boot(8) manpage). But, do not try the visual interface,
   use rather a command like this one:
  
  		config> flags ppa0 0x6


   EPP transfer mode speed
   -----------------------
   You may have to modify 'flags' if you have problems with EPP mode.
   This mode needs profiling, depending on your chipset. You may change
   epp_speed at startup with 'flags'.

   !! IMPORTANT !!
   If your chipset generates TIMEOUTS in EPP mode, use the eppconfig tool
   to increase your epp_speed. See eppconfig.c for info.

   Once your epp_speed is correct, modify the device specific flags in
   your MACHINE configuration file (see INSTALL above) or dynamicaly with
   the boot interface and device specific flags (see above).

############################
   USING MSDOS FILESYSTEM
############################

   Use fdisk to be sure the DOS partition of the disk is the 4th one,
   with the command : fdisk /dev/sd0

   Then, mount -t msdos /dev/sd0s4 /mnt, for exemple.

###########################
   USING UNIX FILESYSTEM
###########################

   Put the following in /etc/disktab

zip|zip 100:\
        :ty=removable:se#512:nc#96:nt#64:ns#32:\
        :pa#196608:oa#0:ba#4096:fa#512:\
        :pb#196608:ob#0:bb#4096:fb#512:\
        :pc#196608:oc#0:bc#4096:fc#512:

   then unixfy the disk

   % disklabel -r -w -B sd0 zip
   % newfs /dev/rsd0a
   % mount /dev/sd0a /mnt

// End of README //