Bureau Palm OS
par David H. Silber
[email protected]
(traduction : Frank Pavageau,
[email protected])
v1.0.0, 20 septembre 1998
Ce document HOWTO explique comment utiliser votre appareil sous Palm
OS avec votre syst�me Linux. Bien que les documents HOWTO concernent
le travail avec le syst�me d'exploitation Linux, celui-ci ne d�pend
pas de la version d'Unix utilis�e.
______________________________________________________________________
Table des mati�res
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 g�n�rales
2.1 Installation du mat�riel
3. Partage de donn�es 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
______________________________________________________________________
11.. IInnttrroodduuccttiioonn
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.
11..11.. AA pprrooppooss ddee ccee ddooccuummeenntt
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.
11..22.. AA vvooiirr aauussssii
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.
11..33.. LLiissttee ddee ddiiffffuussiioonn
La liste de diffusion pilot-unix est maintenue par Matthew Cravit
[email protected]. 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" �
[email protected]. La ligne de sujet ne
compte pas.
11..44.. AArrcchhiivveess ddee llaa lliissttee ddee ddiiffffuussiioonn
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
[email protected].
11..55.. SSiittee FFTTPP
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
[email protected].
22.. IInnffoorrmmaattiioonnss gg��nn��rraalleess
22..11.. IInnssttaallllaattiioonn dduu mmaatt��rriieell
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�.
33.. PPaarrttaaggee ddee ddoonnnn��eess eennttrree ll''aappppaarreeiill PPaallmm OOSS eett LLiinnuuxx
33..11.. LLee llooggiicciieell ppiilloott--lliinnkk
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.
33..11..11.. IInnssttaallllaattiioonn dduu llooggiicciieell ppiilloott--lliinnkk
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.
33..11..22.. UUttiilliissaattiioonn dduu llooggiicciieell ppiilloott--lliinnkk
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.
33..11..22..11.. ppiilloott--xxffeerr
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
33..11..22..22.. iinnssttaallll--mmeemmoo
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.
33..11..22..33.. mmeemmooss
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
33..11..22..44.. ppiilloott--aaddddrreesssseess
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
33..22.. MMaakkeeDDoocc
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:
[email protected]> 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:
[email protected]>.
33..22..11.. IInnssttaallllaattiioonn ddee MMaakkeeDDoocc
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>.
33..22..22.. UUttiilliissaattiioonn ddee MMaakkeeDDoocc
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>
<<ffiicchhiieerr--tteexxttee>>
Le fichier que vous voulez convertir.
<<ffiicchhiieerr--pprrcc>>
Le nom du fichier g�n�r�. (Mettez .prc � la fin du nom.)
<<nnoomm>>
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.
DD.. PPeerrssoonnnneess
Kenneth Albanowski <mailto:
[email protected]> assure la maintenance
des outils pilot-link.
Donnie Barnes <mailto:
[email protected]> a empaquet� pilot-link sous
forme de fichiers RPM Red Hat.
Rick Bram <mailto:
[email protected]> est l'auteur de Doc.
Matthew Cravit <mailto:
[email protected]> g�re la liste
de diffusion pilot-unix.
Jeff Dionne <mailto:
[email protected]> 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:
[email protected]> a effectu� le portage
de pilot-link sur Linux Debian.
David H. Silber <mailto:
[email protected]> est l'auteur de ce
document.
Chris Stevens <mailto:
[email protected]> assure la maintenance des
archives de la liste de diffusion pilot-unix.
EE.. HHiissttoorriiqquuee ddeess aappppaarreeiillss PPaallmm OOSS
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.
