README for HPGComm ported to Unix/Mac OS X

This program allows communication between HP38/39/40G graphing calculators and the
Unix operating systems (including Linux and Mac OS X).

It currently allows transfer of all types of files and additionally screen
captures (since version 1.1). Screen captures are saved in Windows .BMP format
as in the Windows version.

You will need a serial cable such as that supplied with HP's Connectivity Kit in
order to use this software. Mac users who do not have a serial port will also
need a *supported* USB-Serial convertor cable and driver.

This program is derived from the public source code for HPGComm for Windows,
and is licensed under the GNU General Public License (see the COPYING file).

Acknowledgements go to HP, Jean-Pierre Bergamin and Colin Croft for the
Windows version from which this is derived.

Known Issues
* This program has no user interface. It is purely a command-line tool at this
stage. For a user interface, you can now download CommUI from my website. This
program interfaces with version 1.2 or later of HPGComm Unix version.
* The communications are incomplete - while you can SEND/RECV from the calculator,
support for HP39/40 (Wire) (XMODEM) is limited.
* You must have permission to read/write to the serial port. (Some Linuxes have
this set to root user only)
* Only one program can access the serial port at a time -- you may have to
disable other programs like mouse or modem drivers. Mac users be warned --
make sure HotSync Manager is disabled when you try to run this program.
* This program has not been significantly tested -- use at your own risk.

Installation and Usage

You should be able to install this program like any other Linux program --
Try typing './configure' and then 'make install'.

You should then be able to run the program from a Console (Mac users should
open the Terminal application) by changing to the directory containing the
calculator files (or where you want to save them) and typing

hpgcomm <path to serial port>

where the path to the serial port is typically one of the following:
	/dev/ttyS0 (COM1 on Linux)
	/dev/ttyS1 (COM2 on Linux) etc
or	/dev/tty.USB Serial (USB adapter on Mac OS X)
	/dev/tty.usbserial (Different USB adapter on Mac OS X)

You should put the path in quotes(") if it contains a space.

(Other optional command line options are detailed in the man page).

To use the program, just use the SEND/RECV features the same
way as you would on Windows.

If you choose RECV and then HP39/40 (Wire) on a HP39/40G, you
will be asked to enter the filename to transmit. Note that if
you are too slow typing it, the transfer will probably fail!

To send a screen capture press [ON] and [1] simultaneously
on the calculator. A prompt will appear on the computer's
screen asking for the name of the file. Type a valid file name,
and press Enter. (I suggest you use the .BMP extension so
your programs more easily recognize the files).

To quit the program, press Control+C (at the same time) or
Control+/.

There is further information in the man page. To read the
man page type

man hpgcomm

at a console prompt. Some users (eg, Mac OS X) may have to type 
something along the lines of the following:

man -M /usr/local/man hpgcomm

Contact me at http://www.geocities.com/jking_ok or
jkingkard@hotmail.com if you have any comments or problems.

Joshua King
December 2003

