GASCHEsoft  presents

HP-Encrypt

... designed for HP 48G/GX
... written in 100% system RPL
... compiled on an HP 48GX with Mika Heiskanen's famous Jazz (6.1)
... brought to you by the makers of Agenda 48
...  by GASCHEsoft, 1998

What is HP-Encrypt ?

HP-Encrypt adds the ability to your HP 48 to encrypt your sensitive data
and/or make it invisible. It's very fast and secure because if you encrypt
a string and enter a false password to decrypt, you won't get an error but
a string. This string may or may not be the original one, depending on the
correctness of the password.

Although HP-Encrypt is designed for the HP 48 G Series, it may work on the
S Series too, but since I don't have an S/SX, I couldn't test it. So please let
me know if you have any experience. But use it on an S/SX at your own risc!

How to install the HP48 Encryption Engine:

1. Download the file HPEE.lib to your HP 48.
2. Put it on the stack.
3. Enter port:1664 to the stack. On a G, port is 0,
   on a GX port can be 0 to 33 depending on your expansion cards.
4. Press [STO].
5. Turn your HP off and back on.
   CAUTION: The contents of the stack will be lost!
6. HPEE is self-configuring, so you are now ready to use it.

How to use HP-Encrypt:

The library adds the following commands to the command set of your HP 48.
Press [right-shift] [2] [HPEE] to see them.

Command    Description            Stack diagram (4: 3: 2: 1: --> 4: 3: 2: 1:)

HPECT      HP-EnCrypT   (2: target-string 1: password-string --> 1: result-string)
           lets you encrypt
           or decrypt any string.
           For other objects execute ->STR first
           (OBJ-> after decrypting).

STOHV      STOre as Hidden Variable  (2: any obj 1: 'global' --> )

RCLHV      ReCalL Hidden Variable               (1: 'global' --> 1: any object )

PGHV       PurGe Hidden Variable                (1: 'global' --> )

CAUTION: For security reasons HP-Encrypt doesn't provide any possibility to see
         the hidden variables. So you need to know what you've hidden to recall
         it again.

Version History:

v1.0 (??/??/1997):       FIRST RELEASE

v1.1 (07/02/1997):       FIRST PUBLIC RELEASE, added STOHV, RCLHY and PGHV.

Legal:

HP-Encrypt is freeware.
But please register by mail or email (see at the end of this read-me)
if you use it longer than for a trial period.
You do NOT have to pay anything, but you will encourage me to continue developing
software for your calculator.
Because I spent many nights in HP-Encrypt, I would be very happy about any gift,
especially Macintosh software ! (Didn't you just write a nice shareware ?)

HP-Encrypt is protected by copyright law. You must not disassemble or modify it
except for your PERSONAL use only.

Please feel free to redistribute HP-Encrypt. But you must not sell it or use it
commercially in any other way without my written permission.

HP-Encrypt was developed very carefully and SHOULD not corrupt your HP's memory.
However, GASCHEsoft is not responsible for any damage occurring by the use of HP-Encrypt.

Frequently asked questions:

Do you have plans to expand HP-Encrypt ? - Maybe, if I get enough registrations
  and suggestions!

Can you please send me the source code ? - Generally no (for security reasons).
  Hiding a variable is the more secure, the less less people know how it works.
  But if you want to base your software on HP-Encrypt, feel free to ask !

Contacting GASCHEsoft:

Please feel free to send any comments (and registrations/gifts of course) to:

GASCHEsoft Inc.
c/o Thomas Gasche
Furkastrasse 81
CH-4054 Basel
Switzerland

E-Mail: gasche00@stud.unibas.ch