TermHP v0.9beta

By J.Y Avenard
(c) 1994-1998
GHERKIN Productions

Download it. Size: 1252.5 Checksum: # 4CAAh

English Doc

I- Description

TermHP is a terminal emulator for your HP48GX.

You must have the MetaKernel (version >= 1.15) installed on your HP48GX in port 1.

TermHP is very small (1.2kb), and as far as I know, the only terminal for your HP48, which won't lose any characters. Full-Duplex, you can type and receive characters at the same time. I've started this program four years ago (1994), but didn't have the time to release it.

TermHP use its own interrupt handler and its own serial buffer management (512bytes). Fully written in ML, it is very fast. Unfortunately, the emulation itself is not very good. If somebody has the VT100 description, then I will improve it. Actually, only very few special characters are handled.

To make comments, questions, or suggestions for new functions, you may write to me at
Avenard Jean-Yves
2/20 George Road
Vermont South, VIC 3133
Australia
or email to : avenar_j@epita.fr (prefered)

II- General Overview

TermHP is a program, not a library. To use it, save it wherever you want (including a covered port).

To configure the I/O, check the IOPAR menu (read your HP48GX documentation). TermHP can use both the IR port, or the serial port.

There are two different modes while using TermHP.

  1. Non-Alpha mode
  2. Alpha mode

The Non-Alpha mode, is the default mode. The ALPHA indicator is off. If you press a key, the corresponding control character will be sent.

Example:
If you press [A], Ctrl-A will be sent. Ctrl-L will erase the screen.
Pressing [ENTER] will send the CR character (ascii 13)
Pressing [+] will send the ESC (escape) character (useful for VI !)

In Alpha-Mode (the alpha indicator is on), when you press a key, the corresponding character will be sent. By default it use lowercase letter. To enter an uppercase letter, press LeftShift and simultaneously the key (eg; LeftShift+A)

a) The screen

The screen can contain 25 lines * 80 characters. The screen will always show the current curseur position
Since the HP48 screen is only 33*10 lines, you can scroll the virtual screen using LeftShift+Arrow Keys, while in non-alpha mode.
When the cursor will attempt to go after the last line, TermHP will automatically scroll the screen, and the first line will be lost.

III- Conclusion

TermHP is a preview beta alpha of a demo, of what may be an emulator for the HP48GX

What's need to be done:

 

Doc Francaise

I- Presentation et Description.

TermHP est un logiciel d'emulation de terminal pour votre HP48GX.

Il est imperatif que MetaKernel (version >= 1.15) soit installer dans le port 1 du HP48GX.

TermHP est tres petit, et a ce que je sache, c'est l'unique terminal pour HP48 qui ne perdra aucun caractere, quelque soit la vitesse de transmissiong. Il est Full-Duplex, vous pouvez ecrire et recevoir des caracteres simultanement. J'avais commence ce programme il y a plus de quatre ans, mais je n'ai jamais eu le temps de le publier.

TermHP utilise son propre gestionnairese d'interruption et son propre buffer serie (512 octets). Entierement ecrit en assembleur, il est tres rapide. Malheuresement, l'emulation elle-meme est loin d'etre ideale. Actuellement, seuls quelques caracteres speciaux sont geres.

Pour tous commentaires, questions, suggestions, vous pouvez m'ecrire a:
Avenard Jean-Yves
2/20 George Road
Vermont South, VIC 3133
Australie
ou par email a : avenar_j@epita.fr (preferer)

 

II- Utilisation

TermHP est un programme, pas une librairie. Pour l'utiliser sauvegarder le ou vous voulez (y compris les ports couvert).

Pour configurer les entrees/sorties, utiliser le menu IOPAR (faut lire la doc de la 48GX quand meme !). TermHP peut utiliser a la fois le port infrarouge (2400 bauds) ou le port serie (9600).

Il y a deux mode d'utilisation pour le terminal.

  1. Le mode non-alpha
  2. Le mode alpha

Le mode non-alpha est le mode par defaut, l'indicateur ALPHA est eteint. Si vous pressez une touche, alors le caractere de control correspondant est envoye.

Exemple:
Si vous pressez [A], Ctrl-A sera envoye.
[ENTER] enverra le caractere CR (code ascii 13)
[+] enverra le caractere ESC (escape) (utile pour VI !)

En mode-alpha, l'indicateur ALPHA est allume, et le caractere correspondant sera envoye. Par defaut on est en mode minuscule. Pour envoyer un caractere majuscle, presser simultanement ShiftGauche et la touche (i.e ShiftGauche+A)

a) l'ecran

Il fait 25 lignes de 80 caracteres. L'ecran affiche toujours la position courante du curseur
Puisque l'ecran de la 48 ne fait que 33*10 caracteres, vous pouvez vous deplacer dans l'ecran virtuel en utilisant ShiftGauche+Fleches, ceci en mode non-alpha.
Si le curseur essaye d'aller apres la derniere ligne, alors l'ecran sera automatiquement deplace vers le haut, et la premiere ligne sera perdue.

III- Conclusion

TermHP est une "preview beta alpha" d'une demo, bref, il n'est pas termine.

Ce qui reste a faire: