THIS IS THE ANSI 1.5 README FILE

As you might have guessed, ANSI is a terminal emulator for the HP48G.

So far it supports an ANSI, a VT52 and a dumb terminal emulation.

It's  easily configurable and should work both on the HP48S(X) and G(X).

1. INSTALLATION:
  Upload MlDisp to the HP48 and install it (If you don't know how to install a
     library refer to the manual).
  Upload the proper version of ANSI (S or G).
  Upload the terminal emulations you want under the ANSI directory
  Look under section 4 of this document.
  Go under ANSI and run tty

2. THE KEYS:
  ANSI supports 4 different keyboard modes: normal, alpha, left_shift
  and right_shift. The keyboard can be reconfigured completely using
  the SETKEY program. SETKEY takes a string from level 2 and a keycode
  from level 1 of the stack.
  The keycode is the same as the one used by the user RPL KEY command.

  If the string is longer than one character setkey assumes the fraction
  part of the keycode is 4. This means that the keys that can send more than
  1 char can only be accessed in right_shift mode (the cursor keys for example).
  
  The default keymap is very close to what's printed on the calculator.
  Right_hift acts as CTRL, left_shift is used as Caps Lock and alpha
  is used for special characters. Fiddle arround with the keyboard a bit- 
  you'll get the idea. The cursor keys are placed on the arrow keys in
  right_shift mode and the \ is on key 9 in left shift.  
  THE MENU KEY (RIGHT_SHIFT+ L) IS A SPECIAL KEY-
  READ THE NEXT SECTION


3. THE SCREEN:
  ANSI uses the PICT grob. It can make it as big as you like (if you have 
  enough RAM). The characters are 3x5 - small but readable. The portion of the
  screeen you're currently viewing can be changed by pressing the menu key
  and then using the arrow keys. Right_shift + arrow key acts as JumpTo
  (just try it!). BEWARE: the default screen size is 80x26 characters -
  this takes a LOT of RAM. Resize it if you have less than 12K free ram left.
  

4. THE DIFFERENCES BETWEEN THE 2 VERSIONS:
  The only difference is that the S version is stripped of any utilities
  that use INFORMS. The S users have to edit the TERMPAR variable manualy
  and need to store the name of the terminal emulation they want to use into
  INUTIL. By default the type is ANSI2.
  
  The structure of the TERMPAR variable:
    
   init string     columns   speed
    {  ""    "ATDT"  33   11   6  1  }
          dial prefix    rows   XON/OFF

   speed: 1-600, 2-1200, 3-2400, 4-4800, 5-9600
   XON/XOFF - 0=off, 1=on.
   init string - sent out every time you start tty after resizing the screen.

   The G version also features a small telephone dialer (DIALER), a GUI
   for changing the terminal settings (SETTERM) and a GUI for choosing
   the terminal type (TCHOOSE).

5. BUGS - The only bug you should look out for is this: 
  if a mode other than normal is set when you exit the program this mode
  will still be set when you start it the next time but no indicator will 
  be turned on.

6. comments, requests, questions, ... :
  gasper.fele@guest.arnes.si