---------------------------------------------
This is the disk for the HP48 I2C Interface
---------------------------------------------

This disk contains the programs and manual text for this system. Here's 
what's on the disk and how to use it : 

hp48/ - HP48 programs
   inter - Main interface directory, used for examples in the main manual
   display - SAA1064 display driver
   range - Polaroid ultrasonic ranging system driver

pic/ - PIC16C84 code for the I2C interface module
   hp-i2c.asm - Assembly source for the 16C84 program. Feed this into the
                Microchip assembler
   hp-i2c.lst - Listing produced by the assembler on my system
   hp-i2c.hex - Intelhex code output to be programmed into the 16C84. This
                can be read by a standard PIC programmer. There's no need
                to reassemble the code unless you want to make changes.

docs/ - TeX and HPGL source for the manual
  doc-tex.tgz - gzipped tar file containing the LaTeX files
  layout.tgz  - gzipped tar file containing the layout diagrams
  pcb.tgz     - gzipped tar file containing the pcb track patterns
  schem.tgz   - gzipped tar file containing the schematics.

Building the docs
-----------------
*** Note : This instructions are for a Linux system. They will probably ***
*** work on other flavours of Unix. Please don't ask me how to build    ***
*** or print the manual on other OS's                                   ***

You will need LaTeX (2e) with the standard packages including epsfig, 
hp2xx (I used v3.1.4), dvips and either a postscript printer or 
ghostscript (or similar).

Copy the .tgz files from the docs directory on this disk into a suitable 
place on yout linux box. Unpack them using gunzip and tar -xvf in the 
standard way.

The diagrams are all hpgl files, but there's a script in each tar file to 
convert them to .eps . Run those scripts, and then run LaTeX _4 times_ on 
hp-doc.tex to get the references sorted out. Use dvips to convert 
hp-doc.dvi into hp-doc.ps.

The supplements can be built by running LaTeX twice on the files 
display.tex and ranger.tex, and then using dvips to convert the dvi files 
to postscript.

Printing the postscript files is machine-dependant, so I can't give any 
hints here.

Tony Duell (ard@p850ug1.demon.co.uk)
-------------------------------------

