NAME

hptrans - transfers and allows editing of HP49 files


SYNOPSIS

hptrans [options...] [command filename]


DESCRIPTION

This program transfers and allows remote editing of HP49 calculator files. There are two modes available:

Command Line

If a command option and filename are selected, a file is then immediately transferred without any user interaction. By default, HP49 strings transferred from the calculator are converted to ASCII text files. Whereas, text files sent are converted to HP49 strings.

Graphical User Interface

<<Not Yet Implemented>>


COMMANDS

Only one command can be selected at a time:

-r
Receive a file from the HP49 calculator.

-s
Send a file to the HP49 calculator.

-h, --help
Display brief information about command line usage.

-V, --version
Display version information.


OPTIONS

-b rate
Select baud rate of file transfer. The only available baud rates are 1200, 2400, 4800, and 9600 (default).

-o
Enables overwriting of files. The original file is saved as filename.old if this option is not specified.

-n
Disables automatic conversions between HP49 files and text files. This takes place before sending a text file or after receiving a file from the calculator.

-t tty
Select serial I/O device. The default tty is /dev/ttyS0. Chances are if this fails then try ttyS1, ttyS2, and ttyS3. If none of these work, then reference your manual on how to access your serial I/O device.

-v level
Turns on and selects the verbose level which is displayed to the error console. This helps a user to realize the current state of hptrans as it is running. The level argument of 1 gives a general overview, 2 gives informant states of progress, and 3 displays EVERYTHING which is excellent for debugging. If -v is not selected then verbose mode will not be turned on.


EXAMPLES

Some basic examples which might be useful:

hptrans -s -t/dev/ttyS1 fileh49.bin

Sends a HP49 binary file at the default speed of 9600 baud to the serial I/O device /dev/ttyS1.

hptrans -n -b 4800 -v2 -r file49.bin

Receives a HP49 binary file at 4800 baud from default serial I/O device /dev/ttyS0 while displaying progress of transfer to console.

Note how arguments can be either given next to the declared option or with a space seperation in between. Also, the order of the command, options, and filename do not matter.


CAVEATS

Only things about hptrans which work so far:


REPORTING BUGS

In the endeavor to make hptrans run smoothly and error-free, please contribute as much as you can to killing bugs and ironing out annoyances.

If hptrans is not working properly and you are a developer and have time to spare, please try to make a fix for the problem and submit it to http://hptrans.sourceforge.net. Otherwise, please submit a bug report to the web site describing the problem and a step by step procedure as to what happened to cause the problem. Make sure to include a segment of the console logs around the problematic area which is available by using the option -v 3.

For everything else, such as problems with the documentation, hard to use features, or just down right useful suggestion, email to esche@users.sourceforge.net.


AUTHORS

Eric R. Schendel <esche@users.sourceforge.net>


COPYRIGHT

Copyright (C) 2000-2001 Eric R. Schendel

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.