Documentation for Navigator 0.04

Email : yoanndesir@yahoo.com
URL : http://www.hp-sources.com/navigator/
Adress : Yoann Désir, 67 rue Courloison 77160 PROVINS, FRANCE

To use this second version, you have to install the Navigator 0.04 library in any port of your HP49G.

Overview :

Navigator 0.04 is only one of the first versions, which bugs have not been fixed all, despite an intensive debugging. Some HTML may lead to severe software failure of the HP, so backup your IRAM first... Avoid low memory conditions which would induce a Garbage Collection during the execution :  Navigator dislikes Garbage Collecions... that's a quite quick-tempered program.

Keys :

• Up and down arrows : perform vertical text scrolling. They're to be used at first to read the text.
• Left and right arrow : to come back to previous page or go to the next one. In selection mode (selected by pressing Enter), moves the video inversion from a link to another one, and from a form to another. If the video inversion goes "out" of the screen, the screen is readjusted.
• ENTER : in text mode (default mode), selects the selection mode. The first link or the first form on the screen is video inverted (a cursor appears in the text areas). In  selection mode, allows to "click" on a link, check/uncheck a checkbox, select an option or press a radio button. When you click on an link, Navigator goes to the page located at the end of the link. So, pressing Enter twice in the default mode allows to "click" on the first link on the screen (if there is no input form before). Pressing ENTER in selection mode when a text area is selected puts Navigator in editing mode (cf later).
• ON : to get out of the program. In selection mode, so after having pressed Enter, comes back to text mode (which allows to use the lateral arrows to move to the previous or next page in the history). In editing mode, comes back to selection mode.
• Red shift then vertical arrows : to access to the beginning or the end of the text.
• S key (speed) : modifies the scrolling speed : once to accelerate, one more time to slow. The busy annunciator indicates fast speed mode.

The editing mode :

Present in version 0.04 and next ones, the editing mode allows you to type in text using the normal keyboard of the HP49G. You access to the editing mode with selecting a text area (press ENTER to go to selecting mode, then the left and right arrows to move the selection on a text area) then pressing ENTER again : the Alpha annunciator lights on. The shifts, the alpha key and the rest of the keyboard are to be used like in the normal editing mode of the calculator. To get out of the editing mode without submit, press ON. To get out of the editing mode and submit the form (option which is not operationnal for the time now), press ENTER.

Then, two options :

• Offline use :

  You need HTML pages stored in HOME and its subdirectories. One can for instance use this documentation guaranteed compatible with Navigator, transfering it with Xmodem (use HyperTerminal under Windows or C-Kermit for example under Unix).
  Put a string containing HTML on stack level 1 to display it. If no object is present on level 1, or if it isn't an HTML string, Navigator launches the filer and invites you to select an HTML file and to open it (OPEN icon).
  For a simple use, links must be relative : <a href=../docs/fichier.html> for example. 
  In case of an absolute link, Navigator tries to launch the connection executing the Connection program that you have stored in HOME or its subdirectories included in the current path. If the connection succeeds, the page asked is downloaded and displayed. 

• Online use : 

  Needs to connect the HP48 or 49 to an external phone modem with an HP-modem connector that you can build or buy : I sell some $3 plus $5 of shipping, to make it easy to preform online tests.
  Online use needs to install the remarkable library Usinagaz pre-0.3,  TCP/IP sofware by Samuel Thibault.

  In that case, you need to define 4 variables :
  Connection : program to launch to connect to internet via the modem
  URL : internet adress with which to start the connection (note that you cannot yet type in a new URL while the program is running, you have to stop Navigator pressing ON and handly modifiy URL).
  example : "http://www.hp-sources.com/navigator/index.html"
  Domain : domain name. example : "www.hp-sources.com"
  Path : current path. example : "www.hp-sources.com/navigator" (no slash at the end)

Note : example of program for Connection
with a Sportster Flash V.90 Voice PnP modem :

Once those parameters are defined, you can connect to internet with the HP49 and launch Navigator to surf from the specified page. While surfing, the I/O annunciator blinks. In case of temporary receiving error, the Alarm or the left shift annunciators are lightened.

Yoann Désir.