  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.
  ______________________________________________________________________

  Table des matires


  1. Introduction

     1.1 A propos de ce document
     1.2 A voir aussi
     1.3 Liste de diffusion
     1.4 Archives de la liste de diffusion
     1.5 Site FTP

  2. Informations gnrales

     2.1 Installation du matriel

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

     3.1 Le logiciel pilot-link
        3.1.1 Installation du logiciel pilot-link
        3.1.2 Utilisation du logiciel pilot-link
           3.1.2.1 pilot-xfer
           3.1.2.2 install-memo
           3.1.2.3 memos
           3.1.2.4 pilot-addresses
     3.2 MakeDoc
        3.2.1 Installation de MakeDoc
        3.2.2 Utilisation de MakeDoc

  4. Personnes

  5. Historique des appareils Palm OS



  ______________________________________________________________________

  11..  IInnttrroodduuccttiioonn


  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..11..  AA pprrooppooss ddee ccee ddooccuummeenntt


  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1..22..  AA vvooiirr aauussssii


  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1..33..  LLiissttee ddee ddiiffffuussiioonn


  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1..44..  AArrcchhiivveess ddee llaa lliissttee ddee ddiiffffuussiioonn


  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1..55..  SSiittee FFTTPP


  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2..  IInnffoorrmmaattiioonnss ggnnrraalleess



  22..11..  IInnssttaallllaattiioonn dduu mmaattrriieell


  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3..  PPaarrttaaggee ddee ddoonnnneess eennttrree ll''aappppaarreeiill PPaallmm OOSS eett LLiinnuuxx



  33..11..  LLee llooggiicciieell ppiilloott--lliinnkk


  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.


  33..11..11..  IInnssttaallllaattiioonn dduu llooggiicciieell ppiilloott--lliinnkk


  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/otherosfs/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.
  33..11..22..  UUttiilliissaattiioonn dduu llooggiicciieell ppiilloott--lliinnkk


  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.


  33..11..22..11..  ppiilloott--xxffeerr


  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




  33..11..22..22..  iinnssttaallll--mmeemmoo


  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.


  33..11..22..33..  mmeemmooss


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

  Pour voir vos mmos :

          memos /dev/pilot




  33..11..22..44..  ppiilloott--aaddddrreesssseess


  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3..22..  MMaakkeeDDoocc


  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>.


  33..22..11..  IInnssttaallllaattiioonn ddee MMaakkeeDDoocc


  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>.


  33..22..22..  UUttiilliissaattiioonn ddee MMaakkeeDDoocc


  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>





     <<ffiicchhiieerr--tteexxttee>>
        Le fichier que vous voulez convertir.


     <<ffiicchhiieerr--pprrcc>>
        Le nom du fichier gnr. (Mettez .prc  la fin du nom.)


     <<nnoomm>>
        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.


  DD..  PPeerrssoonnnneess


  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.


  EE..  HHiissttoorriiqquuee ddeess aappppaarreeiillss PPaallmm OOSS


  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.



























