Documentation for Navigator 0.03

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.03 library in any port of your HP49G.

Overview :

Navigator 0.03 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 link selection mode (selected by pressing Enter), moves the video inversion from a link to another one. Beware, the video inversion may go out of the screen, without any danger though (the screen will be readjusted in the next versions).
• ENTER : in text mode (default mode), selects the link selection mode. The first link on the screen is video inverted. In  link selection mode, allows to "click" on a link. Navigator then 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.
• ON : to get out of the program. In link 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).
• 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.

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 0.19,  TCP/IP sofware by Samuel Thibault.

  In that case, you need, in addition to the parameters for Usinagaz, 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 :

Main parameter of Usinagaz : store in Home a DNS variable corresponding to the primary DNS of your internet service provider. For 213.36.80.1 for instance, use #D5245001h .

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.