
                                Bureau Palm OS

par David H. Silber palm@orbits.com
(traduction : Frank Pavageau, pavageau@imaginet.fr)

   v1.0.0, 20 septembre 1998
     _________________________________________________________________

   _Ce document HOWTO explique comment utiliser votre appareil sous Palm
   OS avec votre systme Linux. Bien que les documents HOWTO concernent
   le travail avec le systme d'exploitation Linux, celui-ci ne dpend
   pas de la version d'Unix utilise._
     _________________________________________________________________

Appendix

1. Introduction

   Palm Computing Devices a successivement propos plusieurs modles de
   ses produits : le Pilot, puis le PalmPilot, et enfin le Palm III. IBM
   vend sa propre version du PalmPilot Professional qu'ils appellent le
   WorkPad. Que sont ces gadgets ? Ce sont des assistants personnels
   numriques (Personal Digital Assistants ou PDA), parfois appels
   ordinateurs de paume (palm-top computers). Ils sont vendus comme un
   quivalent lectronique  la fois du carnet d'adresses, du rpertoire
   tlphonique et du bloc-notes, alors qu'il s'agit en fait
   d'ordinateurs  part entire capables de faire fonctionner des
   applications de tous genres. Reste  trouver les applications Palm OS
   correspondant  vos besoins et  tre capable de partager vos donnes
   avec votre systme Linux. Les appareils Palm OS contiennent un
   logiciel permettant de synchroniser leurs donnes avec des programmes
   fonctionnant sur une autre machine. L'appareil est gnralement fourni
   avec ce type de logiciel pour Windows 95. Une version MacOS existe
   aussi. Si l'autre machine fonctionne sous un autre systme
   d'exploitation, vous devez trouver auprs d'autres sources des
   logiciels pouvant travailler avec votre appareil Palm OS. Ce document
   dcrit de tels logiciels disponibles pour les systmes Linux ou Unix.

1.1 A propos de ce document

   La version anglaise la plus rcente de ce document peut tre obtenue 
   http://www.orbits.com/Palm/PalmOS-HOWTO.html et fait partie du Projet
   de Documentation Linux (Linux Documentation Project ou LDP). Ce
   document remplace la prcdente version, appele le Pilot HOWTO.
   Reportez-vous  http://metalab.unc.edu/LDP/ (ou
   http://www.freenix.fr/linux/HOWTO/ pour les versions franaises) pour
   plus d'informations sur les autres documents HOWTO.

   Si vous trouvez quoi que ce soit dans ce document qui ncessite une
   correction ou une explication approfondie, merci de m'envoyer un
   courrier lectronique  l'adresse indique ci-dessus en prcisant 
   quelle version du document vous faites rfrence.

   Ce document est Copyright  1997, 1998 par David H. Silber. Il est
   disponible selon les termes de la licence du document LDP HOWTO-INDEX.

1.2 A voir aussi

   Le document http://www.orbits.com/Palm/PalmDevelompent-HOWTO.html
   explique comment utiliser un environnement de dveloppement  base de
   gcc pour crire des applications Palm OS.

   Le document http://www.orbits.com/Palm/PalmConduit-HOWTO.html explique
   comment utiliser les bibliothques pilot-link pour crire des
   programmes de transfert pour Linux fonctionnant avec des appareils
   Palm OS.

1.3 Liste de diffusion

   La liste de diffusion pilot-unix est maintenue par Matthew Cravit
   pilot-unix-owner@lists.best.com. Son but est dcrit ci-dessous :

     La liste de diffusion pilot-unix est l pour permettre aux
     personnes intresses par l'utilisation de PDA US Robotics Pilot
     avec des systmes Unix de discuter et partager des ides. Cela
     comprend les personnes souhaitant participer au dveloppement
     d'outils permettant au Pilot de travailler avec Unix, et
     ventuellement au dveloppement d'un SDK pour le Pilot sous Unix.

   Pour plus d'informations, y compris sur la manire de s'inscrire  la
   liste de diffusion, envoyez un courrier lectronique contenant le mot
   "INFO"  pilot-unix-request@lists.best.com. La ligne de sujet ne
   compte pas.

1.4 Archives de la liste de diffusion

   On peut trouver une archive de la liste de diffusion pilot-unix sur
   http:///www.acm.rpi.edu/~albert/pilot/. Elle est maintenue par Chris
   Stevens albert@acm.rpi.edu.

1.5 Site FTP

   Le site FTP ftp://ryeham.ee.ryerson.ca/pub/PalmOS/ contient une
   archive d'outils Palm OS fonctionnant sous Unix. Il est maintenu par
   Jeff Dionne jeff@ryeham.ee.ryerson.ca.

2. Informations gnrales

2.1 Installation du matriel

   Les appareils Palm OS sont fournis avec un "berceau" (station
   d'accueil) pour changer les donnes avec l'ordinateur de bureau. Ce
   priphrique est en fait un cble srie avec support adapt 
   l'appareil Palm OS ainsi qu'un bouton "HotSync" intgr. Branchez
   votre berceau sur un port srie libre de votre machine. Quand vous
   lancez l'un des programmes indpendants, vous devez placer votre
   appareil Palm OS dans le berceau et appuyer sur le bouton "HotSync"
   pour que celui-ci sache qu'il doit effectuer la communication. S'il
   est teint au moment o vous appuyez sur le bouton, il s'allumera
   automatiquement.

   Pour simplifier, crez un priphrique /dev/pilot comme nom
   supplmentaire pour le port srie sur lequel votre appareil Palm OS
   est connect. En tant qu'utilisateur root, tapez la commande suivante
    l'invite du shell :

        ln /dev/cua0 /dev/pilot

   Remplacez cua0 par le nom du port sur lequel le berceau est connect.

3. Partage de donnes entre l'appareil Palm OS et Linux

3.1 Le logiciel pilot-link

   L'ensemble des outils logiciels pilot-link vous permet de charger des
   programmes sur votre appareil Palm OS et de transfrer des donnes
   pour les diffrents programmes intgrs  celui-ci vers ou depuis
   votre systme Linux. Bien que ces programmes ne soient pas aussi
   simples d'emploi que le Desktop livr avec l'appareil Palm OS, ils
   vous permettent quand mme de transfrer des donnes dans les deux
   sens. En gnral, chaque programme individuel du paquetage pilot-link
   gre un type de donnes.

  Installation du logiciel pilot-link

   Les versions dj empaquetes ont invitablement un lger retard avec
   la distribution principale, mais sont plus faciles  installer et ne
   ncessitent pas de configuration supplmentaire. La distribution
   principale peut s'avrer plus intressante dans les rares cas o vous
   attendez une fonctionnalit ou une correction particulire.

   Vous pouvez trouver la version Linux Debian (i386) de pilot-link 0.8.7
   sur
   ftp://ftp.debian.org/pub/debian/dists/stable/main/binary-i386/otherosf
   s/pilot-link_0.8.7-2.deb. Si ce fichier n'existe pas, vous trouverez
   probablement une version plus rcente dans le mme rpertoire. Si ce
   n'est pas le cas ou si vous cherchez une version plus rcente que
   celle empaquete pour Debian, vous pouvez installer la distribution
   gnrique, comme dcrit ci-dessous. Installez ce fichier de la manire
   normale, et passez  la section Utilisation du logiciel pilot-link.

   Vous pouvez trouver la version Linux RedHat (i386) de pilot-link 0.8.9
   sur ftp://ftp.redhat.com/pub/contrib/i386/pilot-link-0.8.9-1.i386.rpm.
   Si ce fichier n'existe pas, vous trouverez probablement une version
   plus rcente dans le mme rpertoire. Si ce n'est pas le cas ou si
   vous cherchez une version plus rcente que celle empaquete pour
   RedHat, vous pouvez installer la distribution gnrique, comme dcrit
   ci-dessous. Installez ce fichier de la manire normale, et passez  la
   section Utilisation du logiciel pilot-link.

   Pour d'autres versions de Linux ou Unix, ou si vous cherchez la toute
   dernire version, rcuprez la version 0.9.0 de pilot-link sur
   ftp://ryeham.ee.ryerson.ca/pub/PalmOS/pilot-link.0.9.0.tar.gz. Le
   numro de version aura probablement chang, mais les nouvelles
   versions se trouveront probablement au mme endroit avec un nom
   similaire.

   Une fois que vous avec le logiciel, dcompressez-le avec :
        tar -xvzf pilot-link.0.9.0.tar.gz

   Si votre version de tar ne supporte pas l'option -z, dcompressez
   l'archive avec gunzip, comme suit :
        gunzip pilot-link.0.9.0.tar.gz | tar -xvf -

   Cela va crer un rpertoire (pilot-link-0.9.0) contenant les sources.

   Entrez dans ce rpertoire.

   Lancez ./configure. Cela va chercher sur votre systme les
   informations ncessaires  la compilation du logiciel. configure
   prpare pour une installation dans /usr/local par dfaut. Si vous
   souhaitez changer le rpertoire d'installation, lancez ./configure
   --prefix=REP, o REP est le nom du rpertoire dans lequel le logiciel
   sera install.

   Lancez make. Cela compilera le logiciel. Il ne sera par contre
   install que plus tard, ce qui vous permet de l'essayer d'abord. (Si
   vous remplacez une version plus ancienne, vous voulez sans doute vous
   assurer que les fonctionnalits que vous utilisez marchent toujours.
   En gnral, il n'y a pas de problme.)

   En tant qu'utilisateur root, lancez make install. Cela va copier le
   logiciel dans des rpertoires situs sous /usr/local (ou tout autre
   rpertoire que vous avez indiqu avec l'option --prefix). Si vous ne
   pouvez pas vous loguer en tant que root, vous pouvez installer le
   logiciel dans un autre rpertoire sur lequel vous avez des droits
   d'criture.

   N'oubliez pas de rajouter les nouveaux rpertoires contenant les
   excutables  votre chemin de recherche.

  Utilisation du logiciel pilot-link

   La plupart des programmes de l'ensemble pilot-link font office de
   "conduits", c'est--dire qu'ils transfrent des donnes depuis ou vers
   votre appareil Palm OS.

   A chaque fois que vous utilisez l'un de ces programmes, appuyez sur le
   bouton HotSync du berceau. Cela initialisera le transfert du ct de
   l'appareil Palm OS. Attention, tous les programmes ne vous demandent
   pas explicitement d'appuyer sur le bouton "HotSync", il vous faudra
   donc penser  le faire.

   Pour plus d'informations, ainsi que pour les autres options de ces
   programmes, reportez-vous  la page de manuel correspondante. Il y a
   une page de manuel de prsentation appele pilot-link. Par exemple,
   pour le programme pilot-xfer, vous pouvez taper man pilot-xfer 
   l'invite de votre shell Unix.

  pilot-xfer

   Il s'agit probablement du programme le plus utile de l'ensemble
   pilot-link, puisque pilot-xfer vous permet d'installer des programmes
   sur votre appareil Palm OS, de faire des sauvegardes et de les
   remettre en place.

   Pour installer un programme :
        pilot-xfer /dev/pilot -i program.prc

   Pour sauvegarder votre appareil Palm OS :
        pilot-xfer /dev/pilot -b rep-sauvegarde

   Cela copiera toutes les bases de donnes de votre appareil Palm OS (y
   compris les programmes) dans un rpertoire appel "rep-sauvegarde", le
   crant s'il n'existait pas dj.

   Pour remettre en place des donnes sauvegardes sur l'appareil Palm OS
   :
        pilot-xfer /dev/pilot -r rep-sauvegarde

   En gnral, vous n'aurez  faire cela que si votre appareil perd son
   alimentation ou si vous avez d faire une remise  zro complte.

   Pour obtenir la liste des programmes prsents sur votre appareil :
        pilot-xfer /dev/pilot -l

  install-memo

   Il installe un fichier Linux sur votre appareil Palm OS en tant que
   mmo.

   Pour installer un mmo dans la catgorie projet (qui doit dj
   exister) :
        install-memo /dev/pilot -c projet projet.memo

   Le nom du fichier sera insr dans le mmo  la premire ligne et
   apparatra dans le rpertoire de mmos de votre appareil.

  memos

   Ce programme rcupre chaque mmo sur l'appareil Palm OS et l'affiche
   au format mailbox standard.

   Pour voir vos mmos :
        memos /dev/pilot

  pilot-addresses

   Transfrez votre base de donnes d'adresses depuis ou vers l'appareil
   Palm OS.

   Pour crire vos adresses dans un fichier Linux depuis l'appareil :
        pilot-addresses /dev/pilot -w fichier.stockage

   Pour lire vos adresses dans un fichier Linux et les mettre sur
   l'appareil :
        pilot-addresses /dev/pilot -r fichier.stockage

3.2 MakeDoc

   Un des dfauts du programme de mmos intgr des appareils Palm OS est
   son incapacit  grer correctement les gros documents. Pour y
   remdier, Rick Bram mailto:rbram@concentric.net a crit Doc, un
   lecteur de document pour appareils Palm OS (voir
   http://www.concentric.net/~rbram/doc.shtml). Les documents peuvent
   tre convertis au format Doc grce  MakeDoc, de Pat Beirne
   mailto:pat.beirne@sympatico.ca.

  Installation de MakeDoc

   MakeDoc peut tre rcupr sur
   http://www.concentric.net/~rbram/makedoc7.cpp. Compilez-le avec votre
   compilateur C++ et installez l'excutable gnr en tant que "makedoc"
   dans un rpertoire de votre chemin de recherche. Il semble y avoir une
   petite bogue dans makedoc (version 0.7a) qui fait qu'il n'y a pas de
   retour chariot aprs le dernier caractre affich  l'utilisateur.
   Cela ne semble pas tre gnant pour le document gnr, mais c'est
   ennuyeux.

   Un nouvelle version existe, mais elle ncessite Java. Jetez un oeil 
   la page web MakeDoc de Pat Beirne sur
   http://cpu563.adsl.sympatico.ca/MakeDocJ.htm.

  Utilisation de MakeDoc

   Lancez MakeDoc de la manire suivante :
        makedoc data.txt data.prc "Donnes  afficher avec Doc"

   Cela crera un fichier data.prc, qui peut tre alors install sur
   votre appareil Palm OS  l'aide de pilot-xfer. Le texte "Donnes 
   afficher avec Doc" sera affich dans le rpertoire des documents grs
   par Doc.

   MakeDoc a les syntaxes suivantes :
        makedoc [-n] [-b] <fichier-texte> <fichier-prc> <nom>

   ou
        makedoc -d [-b] <fichier-prc> <fichier-texte>

   _<fichier-texte>_
          Le fichier que vous voulez convertir.

   _<fichier-prc>_
          Le nom du fichier gnr. (Mettez .prc  la fin du nom.)

   _<nom>_
          Le nom que vous voulez voir apparatre dans le rpertoire de
          documents de Doc ou Jdoc.

   Il y a aussi des options pour dcoder le fichier .prc gnr et
   utiliser diffrentes options de compression.

4. Personnes

   Kenneth Albanowski mailto:kjahds@kjahds.com assure la maintenance des
   outils pilot-link.

   Donnie Barnes mailto:djb@redhat.com a empaquet pilot-link sous forme
   de fichiers RPM Red Hat.

   Rick Bram mailto:rbram@concentric.net est l'auteur de Doc.

   Matthew Cravit mailto:pilot-unix-owner@lists.best.com gre la liste de
   diffusion pilot-unix.

   Jeff Dionne mailto:jeff@ryeham.ee.ryerson.ca est le premier auteur des
   outils pilot-link. Il gre le site FTP pour le projet de dveloppement
   Unix Palm OS/Pilot.

   Mark W. Eichin mailto:eichen@kitten.gen.ma.us a effectu le portage de
   pilot-link sur Linux Debian.

   David H. Silber mailto:pilot@orbits.com est l'auteur de ce document.

   Chris Stevens mailto:albert@acm.rpi.edu assure la maintenance des
   archives de la liste de diffusion pilot-unix.

5. Historique des appareils Palm OS

   Il existe deux versions du Pilot : les 1000 et 5000 qui ont
   respectivement 128 et 512 Ko de mmoire vive. Ils sont fournis avec
   Palm OS 1.0 en mmoire morte.

   Sont alors apparus deux appareils sous le nom PalmPilot : le PalmPilot
   Personal et le PalmPilot Professional qui ont respectivement 512 Ko et
   1 Mo de mmoire vive. Ils ont aussi l'cran  cristaux liquides
   rtro-clair et la version 2.0 du systme d'exploitation. La version
   Professional a aussi une pile TPC/IP et quelques programmes
   supplmentaires intgrs.

   (IBM a sorti sa propre version du PalmPilot Professional qu'ils
   appellent un WorkPad.)

   On trouve maintenant le Palm III, dont le botier a t redessin et
   qui est quip d'un port infrarouge, sans oublier les 2 Mo de mmoire
   vive et Palm OS 3.0.

   Il est possible de mettre  jour n'importe quel Pilot en changeant la
   carte mmoire, qui contient  la fois la mmoire vive et la mmoire
   morte. Bien sr, cela ne vous rajoute pas le rtro-clairage sur les
   premiers modles de Pilot.
