AVANTGO.COM AND *NIX DESKTOPS
=============================

AvantGo.com is a web capture and browsing service for handheld devices.
The setup incudes software on both your Palm device and your desktop and
an account on the AvantGo.com site.  If you have a modem (wireless or
wired) for your Palm, you technically do not need the desktop software,
though you'll probably want it anyway. 

This readme includes instructions for using a desktop *nix system to sync your Palm V, III, IIIx, VII, or PalmPilot Professional (collectively, "Palm device") to an AvantGo.com account.

There is currently no method for synchronizing your Windows CE device to AvantGo.com through a *nix desktop. 

Support: 
--------

THIS PRODUCT IS NOT OFFICIALLY SUPPORTED BY AVANTGO.  IT IS PROVIDED AS IS FOR THE BENEFIT OF THE *NIX COMMUNITY.

For support, please use one of the following:

- The pilot-unix mailing list.  To participate in this list, send a message to pilot-unix-request@lists.best.com with the body containing (on separate lines) "subscribe" or "help".

- The newsgroups news://comp.sys.palmtops.pilot, news://alt.soft-sys.avantgo, or news://de.comp.sys.palmtops.pilot (German)

What You'll Need:
-----------------

malsync

   This is the actual synchronization executable.
   Get it from ftp://ryeham.ee.ryerson.ca/pub/PalmOS 
   Available in source or binary forms
   View the README in the source/binary directory for build instructions.

Palm OS .prc files 

   Specifically libmal.prc, MobileLink.prc, and avantgo.prc
   You will need to install these using pilot-xfer or Mac/Win Hotsync
   Included with malsync, or from http://www.avantgo.com/download/unsupported

pilot-xfer

   *nix utility to install .prc files to Palm OS devices.
   Included with the pilot-link utility.  V 0.9.3 is known to work.
   Get it from ftp://ryeham.ee.ryerson.ca/pub/PalmOS/
   Use 'make pilot-xfer' once uncompressed


Instructions:
-------------

1) Copy the built executable (malsync) to the chosen directory and change it to an executable permission, e.g.:

    chmod ugo+x ./malsync

2) Determine the correct serial port to which your Palm device is connected.  Two common options are /dev/ttyS0 and /dev/ttyS1.  Do one of two things:

   - set the PILOTPORT environment variable to that device, e.g.

      setenv PILOTPORT /dev/ttyS1
  
   - OR, bind the /dev/pilot port to the serial device, e.g. 

      ln -s /dev/ttyS1 /dev/pilot  (root access required)

3) Determine and set the correct communication speed.  Taking no action will result in 9600 baud connection.  An alternative might be:

      setenv PILOTRATE 57600

4) Transfer the .prc's to the Palm device with pilot-xfer:

      pilot-xfer -i MobileLink.prc libmal.prc avantgo.prc

When the sync is finished, click on the Applications button of the Palm device.  A successful pilot-xfer will result in AvantGo and Mobile Link icons appearing in this list.

5) Now you will need to set up your AvantGo account.  

- Go to http://avantgo.com/setup/account_only.html and select the Palm
Computing link.
- Continue through the install pages until you hit the page where you'll
enter account information.
- Enter your account information and submit the page.  Write down the
username and password you used here.

Note: The site changes periodically, so the exact URL may be different.  

5) Tap the Mobile Link icon on the Palm device.  Enter this information:

        Server:  AvantGo Server
   Server Addr:  sync.avantgo.com
          Port:  80
     User Name:  <your AvantGo.com username>
      Password:  <your AvantGo.com password>
       Enabled:  Should be checked

6) In the directory in which you've put malsync, enter

      ./malsync (use options if necessary)

This should retrieve the stated channels from AvantGo.com.  A successful sync will result in these channels showing on your Palm device.  


   



