palm@orbits.compavageau@imaginet.fr)Palm Computing Devices a successivement propos� plusieurs mod�les 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 num�riques (Personal Digital Assistants ou PDA), parfois appel�s ordinateurs de paume (palm-top computers). Ils sont vendus comme un �quivalent �lectronique � la fois du carnet d'adresses, du r�pertoire t�l�phonique et du bloc-notes, alors qu'il s'agit en fait d'ordinateurs � part enti�re capables de faire fonctionner des applications de tous genres. Reste � trouver les applications Palm OS correspondant � vos besoins et � �tre capable de partager vos donn�es avec votre syst�me Linux. Les appareils Palm OS contiennent un logiciel permettant de synchroniser leurs donn�es avec des programmes fonctionnant sur une autre machine. L'appareil est g�n�ralement fourni avec ce type de logiciel pour Windows 95. Une version MacOS existe aussi. Si l'autre machine fonctionne sous un autre syst�me d'exploitation, vous devez trouver aupr�s d'autres sources des logiciels pouvant travailler avec votre appareil Palm OS. Ce document d�crit de tels logiciels disponibles pour les syst�mes Linux ou Unix.
La version anglaise la plus r�cente 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 pr�c�dente version, appel�e le Pilot HOWTO. Reportez-vous � http://metalab.unc.edu/LDP/ (ou http://www.freenix.fr/linux/HOWTO/ pour les versions fran�aises) pour plus d'informations sur les autres documents HOWTO.
Si vous trouvez quoi que ce soit dans ce document qui n�cessite une correction ou une explication approfondie, merci de m'envoyer un courrier �lectronique � l'adresse indiqu�e ci-dessus en pr�cisant � quelle version du document vous faites r�f�rence.
Ce document est Copyright © 1997, 1998 par David H. Silber. Il est disponible selon les termes de la licence du document LDP HOWTO-INDEX.
Le document http://www.orbits.com/Palm/PalmDevelompent-HOWTO.html explique comment utiliser un environnement de d�veloppement � base de gcc pour �crire des applications Palm OS.
Le document http://www.orbits.com/Palm/PalmConduit-HOWTO.html explique comment utiliser les biblioth�ques pilot-link pour �crire des programmes de transfert pour Linux fonctionnant avec des appareils Palm OS.
La liste de diffusion pilot-unix est maintenue par Matthew Cravit
pilot-unix-owner@lists.best.com. Son but est d�crit ci-dessous :
La liste de diffusion pilot-unix est l� pour permettre aux personnes int�ress�es par l'utilisation de PDA US Robotics Pilot avec des syst�mes Unix de discuter et partager des id�es. Cela comprend les personnes souhaitant participer au d�veloppement d'outils permettant au Pilot de travailler avec Unix, et �ventuellement au d�veloppement d'un SDK pour le Pilot sous Unix.
Pour plus d'informations, y compris sur la mani�re 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.
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.
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.
Les appareils Palm OS sont fournis avec un "berceau" (station d'accueil) pour �changer les donn�es avec l'ordinateur de bureau. Ce p�riph�rique est en fait un c�ble s�rie avec support adapt� � l'appareil Palm OS ainsi qu'un bouton "HotSync" int�gr�. Branchez votre berceau sur un port s�rie libre de votre machine. Quand vous lancez l'un des programmes ind�pendants, 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, cr�ez un p�riph�rique /dev/pilot comme
nom suppl�mentaire pour le port s�rie 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�.
L'ensemble des outils logiciels pilot-link vous permet de charger
des programmes sur votre appareil Palm OS et de transf�rer des donn�es
pour les diff�rents programmes int�gr�s � celui-ci vers ou depuis
votre syst�me 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 m�me de transf�rer des donn�es dans les deux sens. En
g�n�ral, chaque programme individuel du paquetage pilot-link g�re
un type de donn�es.
Les versions d�j� empaquet�es ont in�vitablement un l�ger retard avec la distribution principale, mais sont plus faciles � installer et ne n�cessitent pas de configuration suppl�mentaire. La distribution principale peut s'av�rer plus int�ressante dans les rares cas o� vous attendez une fonctionnalit� ou une correction particuli�re.
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 r�cente dans le m�me r�pertoire. Si ce n'est pas le cas ou si vous cherchez une version plus r�cente que celle empaquet�e pour Debian, vous pouvez installer la distribution g�n�rique, comme d�crit ci-dessous. Installez ce fichier de la mani�re 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 r�cente dans le m�me r�pertoire. Si ce n'est pas le cas ou si vous cherchez une version plus r�cente que celle empaquet�e pour RedHat, vous pouvez installer la distribution g�n�rique, comme d�crit ci-dessous. Installez ce fichier de la mani�re normale, et passez � la section Utilisation du logiciel pilot-link.
Pour d'autres versions de Linux ou Unix, ou si vous cherchez la toute
derni�re version, r�cup�rez la version 0.9.0 de pilot-link sur
ftp://ryeham.ee.ryerson.ca/pub/PalmOS/pilot-link.0.9.0.tar.gz.
Le num�ro de version aura probablement chang�, mais les nouvelles
versions se trouveront probablement au m�me endroit avec un nom
similaire.
Une fois que vous avec le logiciel, d�compressez-le avec :
tar -xvzf pilot-link.0.9.0.tar.gz
Si votre version de tar ne supporte pas l'option -z,
d�compressez l'archive avec gunzip, comme suit :
gunzip pilot-link.0.9.0.tar.gz | tar -xvf -
Cela va cr�er un r�pertoire (pilot-link-0.9.0) contenant les sources.
Entrez dans ce r�pertoire.
Lancez ./configure. Cela va chercher sur votre syst�me les
informations n�cessaires � la compilation du logiciel. configure
pr�pare pour une installation dans /usr/local par d�faut. Si
vous souhaitez changer le r�pertoire d'installation, lancez
./configure --prefix=REP, o� REP est le nom du r�pertoire
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 fonctionnalit�s que vous utilisez marchent
toujours. En g�n�ral, il n'y a pas de probl�me.)
En tant qu'utilisateur root, lancez make install. Cela va
copier le logiciel dans des r�pertoires situ�s sous
/usr/local (ou tout autre r�pertoire 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
r�pertoire sur lequel vous avez des droits d'�criture.
N'oubliez pas de rajouter les nouveaux r�pertoires contenant les ex�cutables � votre chemin de recherche.
La plupart des programmes de l'ensemble pilot-link font office de
"conduits", c'est-�-dire qu'ils transf�rent des donn�es 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 c�t� 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 pr�sentation appel�e pilot-link. Par
exemple, pour le programme pilot-xfer, vous pouvez taper man
pilot-xfer � l'invite de votre shell Unix.
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 donn�es de votre appareil Palm OS (y
compris les programmes) dans un r�pertoire appel�
"rep-sauvegarde", le cr�ant s'il n'existait pas d�j�.
Pour remettre en place des donn�es sauvegard�es sur l'appareil Palm OS :
pilot-xfer /dev/pilot -r rep-sauvegarde
En g�n�ral, vous n'aurez � faire cela que si votre appareil perd son alimentation ou si vous avez d� faire une remise � z�ro compl�te.
Pour obtenir la liste des programmes pr�sents sur votre appareil :
pilot-xfer /dev/pilot -l
Il installe un fichier Linux sur votre appareil Palm OS en tant que m�mo.
Pour installer un m�mo dans la cat�gorie projet (qui doit d�j� exister) :
install-memo /dev/pilot -c projet projet.memo
Le nom du fichier sera ins�r� dans le m�mo � la premi�re ligne et appara�tra dans le r�pertoire de m�mos de votre appareil.
Ce programme r�cup�re chaque m�mo sur l'appareil Palm OS et l'affiche au format mailbox standard.
Pour voir vos m�mos :
memos /dev/pilot
Transf�rez votre base de donn�es 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
Un des d�fauts du programme de m�mos int�gr� des appareils Palm OS est
son incapacit� � g�rer correctement les gros documents. Pour y
rem�dier, 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 gr�ce � MakeDoc, de Pat
Beirne
mailto:pat.beirne@sympatico.ca.
MakeDoc peut �tre r�cup�r� sur
http://www.concentric.net/~rbram/makedoc7.cpp. Compilez-le avec
votre compilateur C++ et installez l'ex�cutable g�n�r� en tant que
"makedoc" dans un r�pertoire 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 apr�s le dernier caract�re
affich� � l'utilisateur. Cela ne semble pas �tre g�nant pour le
document g�n�r�, mais c'est ennuyeux.
Un nouvelle version existe, mais elle n�cessite Java. Jetez un oeil � la page web MakeDoc de Pat Beirne sur http://cpu563.adsl.sympatico.ca/MakeDocJ.htm.
Lancez MakeDoc de la mani�re suivante :
makedoc data.txt data.prc "Donn�es � afficher avec Doc"
Cela cr�era un fichier data.prc, qui peut �tre alors
install� sur votre appareil Palm OS � l'aide de
pilot-xfer. Le texte "Donn�es � afficher avec Doc" sera affich�
dans le r�pertoire des documents g�r�s par Doc.
MakeDoc a les syntaxes suivantes :
makedoc [-n] [-b] <fichier-texte> <fichier-prc> <nom>ou
makedoc -d [-b] <fichier-prc> <fichier-texte>
Le fichier que vous voulez convertir.
Le nom du fichier g�n�r�. (Mettez .prc
� la fin du nom.)
Le nom que vous voulez voir appara�tre dans le r�pertoire de documents de Doc ou Jdoc.
Il y a aussi des options pour d�coder le fichier .prc g�n�r� et
utiliser diff�rentes options de compression.
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 g�re la liste de diffusion pilot-unix.
Jeff Dionne mailto:jeff@ryeham.ee.ryerson.ca est le premier auteur des outils pilot-link. Il g�re le site FTP pour le projet de d�veloppement 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.
Il existe deux versions du Pilot : les 1000 et 5000 qui ont respectivement 128 et 512 Ko de m�moire vive. Ils sont fournis avec Palm OS 1.0 en m�moire 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 m�moire vive. Ils ont aussi l'�cran � cristaux liquides r�tro-�clair� et la version 2.0 du syst�me d'exploitation. La version Professional a aussi une pile TPC/IP et quelques programmes suppl�mentaires int�gr�s.
(IBM a sorti sa propre version du PalmPilot Professional qu'ils appellent un WorkPad.)
On trouve maintenant le Palm III, dont le bo�tier a �t� redessin� et qui est �quip� d'un port infrarouge, sans oublier les 2 Mo de m�moire vive et Palm OS 3.0.
Il est possible de mettre � jour n'importe quel Pilot en changeant la carte m�moire, qui contient � la fois la m�moire vive et la m�moire morte. Bien s�r, cela ne vous rajoute pas le r�tro-�clairage sur les premiers mod�les de Pilot.