
                  -----------------------------            
                       MOCHA POCKET TELNET 

                           USER GUIDE

                          Version 2.0
             
                  -----------------------------            

Contents
========

1.0 Product Overview
2.0 Functionality
2.1  Connecting/Disconnecting
2.2  Function keys
2.3  Macros
2.4  Hardware buttons
2.5  Auto Login

3.0 Limitations 

4.0 License System

1.0 Product overview
====================
Mocha Pocket Telnet is an application for the Palm Computing(R) Platform.
There is support for PALM OS 3 or newer.

Mocha Pocket Telnet makes it possible to connect to an UNIX host with 
the TCP/IP/TELNET protocol and emulate a VT220 terminal.

Version 1.1 includes support for the SPT1700 device from Symbol. It is
a PALM III with a bar code scanner.

2.0 Functionality
=================
 - Supports VT100/VT220 emulation. 
 - User defined functions keys.
 - SSH-1 (Secure Shell)
 - Autologin with scripting parameter.
 - Possible to use Graffiti or build in keyboard. 
 - User defined macros.
 - User defined function keys.
 - Use Scroll and hardware buttons on the PalmPilot
   as cursor keys (+ return and delete).
 - Screen size 24*80. Possible to navigate the view with a
   Tap on the screen or moving a small screen window.
 - 2 font types, giving a view screen size 16*32 or 24*40 characters.
 - Bar code reader with SPT1700 (tested with Palm OS 3.2)

The Telnet screen contains a large view window for the VT220
terminal (16*32 or 24*40 characters) and at the bottom are a set 
of buttons plus a small window

   on off ctrl esc keys macros [window]

on     : Make a session to the UNIX host
off    : Close a session
ctrl   : Next key typed on the graffiti or the build in keyboard will
         be a ctrl character
esc    : send an ESC character to the UNIX host
keys   : select a function key in the pop-up list
macros : select a macro in the pop-up list
window : Tap or move the small window to change the view of
         the VT220 terminal window. It is also possible to tap the main
         screen to change the view.

2.1 Connecting/Disconnecting
============================

Tap on the On/Off buttons at the lower left part of the screen to
control a session with the UNIX host. 

A Tap on "on" will start a session with the UNIX host. If there is not 
already defined an IP address for the UNIX host, a dialog window will 
pop-up asking for an UNIX host name. Enter an IP address and a port number. 
The default port number for the Telnet protocol is 23.

It is possible to select "Show Negotiation".  Using this option
will display the Telnet protocol information's. It should only
be used in a debugging situation.

If you many UNIX hosts, it is possible to define up to 4 different
IP names in Menu - Host List. When "On" is tapped a pop up
menu will display a list of the hosts.

2.2 Function keys
=================
In the menu - Options - Keys it is possible to change the
default VT220 values for the function keys. In most cases it
cannot be a good idea. It is better to configure the UNIX host to
use a VT220 terminal.
It is possible to enter any value in octal notation. An octal
value must start with a \ followed of 3 digits.

Examples:

ESC : \033
CR  : \015
LF  : \012
 
As default following mapping is used:

ESCAPE    :  \033
UP        :  \033[A
DOWN      :  \033[B
RIGHT     :  \033[C
LEFT      :  \033[D
F1        :  \217P
F2        :  \217Q
F3        :  \217R
F4        :  \217S
F5        :  \033[15~
F6        :  \033[17~
F7        :  \033[18~
F8        :  \033[19~
F9        :  \033[20~
F10       :  \033[21~
F11       :  \033[23~
F12       :  \033[24~
F13       :  \033[25~
F14       :  \033[26~
F15       :  \033[28~
F16       :  \033[29~
F17       :  \033[31~
F18       :  \033[32~
F19       :  \033[33~
F20       :  \033[34~
DELETE    :  \177
RETURN    :  \015\012


2.3 Macros
==========
In the menu - Options - Macros it is possible to define some
simple macros. A Macro is just a text which is send to the 
UNIX host when the user select the macro from the pop-up list.

It is possible to enter any value as macro data in octal notation. 
An octal value must start with a \ followed of 3 digits.

Examples:

CR  : \015
LF  : \012

2.4 Hardware buttons
====================
It is possible to use the hardware buttons on the PalmPilot
to navigate the UNIX application.

A PalmPilot has 5 hardware keys with following use in Mocha Pocket Telnet:


DELETE  LEFT  UP/DOWN   RIGHT   RETURN

It is not possible to change this selection.

2.5 Auto Login
==============
To make it easier for the novice to use Mocha Pocket Telnet to connect 
to a single host, it is possible to define an automatic login sequence.
Of course there is not much security involved doing it!

In menu - options - Auto login, it is possible to define a search 
string, and a response string which is send back to the host on a match.

Example:

Search : Login          Answer : anonymous\012
Search : Password       Answer : mypassword\012

To include characters as CR and LF, use the octal notation :

\abc = octal value. (LF = \012 and CR = \015)
 

3.0 Limitations
===============
As to the limited screen and keyboard on a PalmPilot organizer
following limitations compared to a real VT220 terminal
have been implemented:

  - Supports only PALM OS 3.x or later (PALM III, PALM V). 
  - only 24*80 screen mode
  - no support for large character set
  - no support for print
  - no support for blink/increased intensity or underscored
  - no support for keypad and editing keys (can be defined as macros)

You Palm Pilot must have access to a PPP network. Either with a
modem or a cable connected direct to a host with PPP support. It
is not possible to use the HotSync software to get a connection
to an UNIX Host.

4.0 License System
=================
The license system for Mocha Pocket Telnet is very user friendly. It is
possible to run in Demo mode for some time to test the product. At every 
session start the program, will tell it is a Demo. Otherwise there
will be no limitations to the product.

When you order, we will send a software license key, which must 
be entered into the product together with a license name. 

Visit http://www.mochasoft.dk for details about how to order


                    ( ----   E N D ---- )
