Traducido el 16-XI-1997. Pilot COMO
David H. Silber
[email protected]
v0.5, 17-VIII-1997.
Este documento explica c�mo usar su PalmPilot con un sistema Linux. A
pesar de que los documentos COMO est�n orientados al uso del sistema
operativo Linux, �ste en particular no depende de la versi�n de Unix
utilizada.
______________________________________________________________________
�ndice General:
1. Introducci�n
1.1. Este documento
1.2. Lista de correo
1.3. Archivos de la lista de correo
1.4. Servidor FTP
2. Informaci�n General
2.1. �Qu� es un Pilot?
2.2. Diferentes tipos de Pilot
2.3. Instalaci�n del Hardware
3. C�mo compartir datos del Pilot con su sistema Linux
3.1. El programa pilot-link
3.1.1. Instalaci�n del programa pilot-link
3.1.2. Uso del programa 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. Instalaci�n de makedoc
3.2.2. Uso de makedoc
3.3. PilotManager
4. Herramientas para desarrollo de software para el Pilot
4.1. prc-tools
4.1.1. Instalaci�n de prc-tools
4.1.2. Uso de prc-tools
5. Gente
6. Anexo: El INSFLUG
______________________________________________________________________
1. Introducci�n
El Pilot se distribuye con software para sincronizar su memoria con
los datos de un sistema Microsoft Windows. Opcionalmente se puede
adquirir software para realizar la sincronizaci�n con ordenadores
Macintosh de Apple. La comunidad Linux/Unix ha sido ignorada por los
fabricantes del Pilot. Afortunadamente, ha sido desarrollado una
serie de software gratuito para cubrir esta necesidad. Este documento
describe dicho software, d�nde obtenerlo y c�mo instalarlo y usarlo.
1.1. Este documento
La �ltima versi�n de este documento puede obtenerse en
parte del Linux Documentation Project (LDP). Vea
http://sunsite.unc.edu/LDP/ para obtener m�s informaci�n sobre el LDP
y otros documentos HOWTO.
Las versiones futuras cubrir�n m�s herramientas Unix para el
desarrollo de programas de aplicaci�n que puedan ser ejecutados en el
Pilot, as� como sistemas para la transferencia de datos entre el
sistema Unix y el Pilot.
Si encuentra algo en este documento que necesite ser corregido o mejor
explicado, por favor env�eme un mensaje de correo electr�nico a la
direcci�n indicada anteriormente y especifique a qu� versi�n de este
documento se est� refiriendo.
Este documento es Copyright � 1997 David H. Silber. Est� publicado
bajo los t�rminos de copyright que aparecen en el documento LDP HOWTO-
INDEX.
1.2. Lista de correo
La lista de correo pilot-unix es mantenida por Matthew Cravit pilot-
[email protected]. Su introducci�n es:
La lista de correo pilot-unix es para la discusi�n y compartici�n de
ideas de aquellos interesados en el uso de los PDAs Pilot de US
Robotics con sistemas UNIX. Esto incluye a la gente que est�
interesada en ayudar a desarrollar herramientas que permitan al Pilot
operar con UNIX, y posiblemente desarrollar un SDK para el Pilot en
entornos Unix.
Para obtener m�s informaci�n, incluyendo el c�mo suscribirse a la
lista, env�e un mensaje con la palabra "INFO" a pilot-unix-
[email protected]. La l�nea de tema no importa.
1.3. Archivos de la lista de correo
Puede encontrar un archivo con todos los mensajes de la lista de
correo pilot-unix en
mantenido por Chris Stevens,
[email protected].
1.4. Servidor FTP
Hay disponible un servidor FTP con herramientas para usar el Pilot en
sistemas Unix en
mantenido por Jeff Dionne,
[email protected].
2. Informaci�n General
2.1. �Qu� es un Pilot?
El Pilot es un peque�o Asistente Personal Digital. Est� fabricado por
U.S. Robotics, ahora parte de 3Com.
Para los que no est�n familiarizados con el t�rmino, un Asistente
Personal Digital es uno de esos peque�os dispositivos electr�nicos que
contienen normalmente varios tipos de informaci�n personal, como
pueden ser direcciones y n�meros de tel�fono, un calendario, lista de
recordatorios y/o apuntes y est� dise�ado para ser transportado
c�modamente as� como estar a mano cuando la informaci�n se requiera.
Los PDAs m�s vers�tiles, como el Pilot, permiten que los datos
almacenados en el PDA sean copiados a otro ordenador y que otros datos
y nuevos programas sean instalados en el PDA desde un ordenador.
2.2. Diferentes tipos de Pilot
Hay cuatro versiones del Pilot. Los dos m�s antiguos, el 1000 y el
5000 tienen 128k y 512k de RAM respectivamente.
Los dos m�s recientes, el PalmPilot Personal y el PalmPilot
Professional tienen 512k y 1 Mb de RAM respectivamente. Tambi�n tienen
una pantalla LCD retroiluminada y la versi�n 2.0 del sistema
operativo. El Professional tambi�n incorpora soporte para el protocolo
TCP/IP e incluye algunos programas adicionales.
Es posible actualizar cualquier Pilot cambi�ndole la tarjeta de
memoria, la cual incluye tanto la RAM como la ROM. Por supuesto, esto
no har� que los pilots antiguos tengan una pantalla retroiluminada.
2.3. Instalaci�n del Hardware
Los Pilot vienen con un "soporte" para el intercambio de datos con el
ordenador de sobremesa. Este dispositivo es realmente un cable serie
con un recept�culo hecho a medida para colocar el Pilot y con un bot�n
de "sincronizaci�n". Conecte su soporte a un puerto serie libre del
ordenador. Cuando ejecute alguno de los programas, necesitar� colocar
su Pilot en el soporte y pulsar el bot�n de sincronizaci�n para que el
Pilot sepa que se tiene que comunicar. Si se pulsa el bot�n estando el
Pilot apagado, �ste se encender� autom�ticamente.
Por comodidad, cree un dispositivo, /dev/pilot que ser� un nombre
alternativo para el puerto serie donde el soporte del Pilot est�
conectado. Ejecute lo siguiente como root:
ln /dev/cua0 /dev/pilot
Sustituya cua0 con el nombre del puerto al cual tenga conectado su
soporte del Pilot.
3. C�mo compartir datos del Pilot con su sistema Linux
3.1. El programa pilot-link
El conjunto de utilidades disponibles en el paquete pilot-link le
permitir�n instalar programas en su Pilot, y transferir datos
relativos a varias de las aplicaciones instaladas en el Pilot entre su
sistema Linux y el Pilot. Aunque estos programas no est�n tan
elaborados como los que se distribuyen con el Pilot, le permitir�n
copiar sus datos en ambas direcciones. En general, cada programa
individual maneja un tipo de datos. El programa PilotManager est�
construido sobre el pilot-link y ofrece una soluci�n m�s integrada,
entre sus caracter�sticas se incluye la sincronizaci�n completa de
varios tipos de datos.
3.1.1. Instalaci�n del programa pilot-link
Las versiones empaquetadas siempre ir�n inevitablemente ligeramente
retrasadas respecto a la distribuci�n original, pero ser�n m�s f�ciles
de instalar y no requieren configuraci�n. La distribuci�n original
ser� la mejor elecci�n en aquellas raras ocasiones en las que haya
estado esperando una nueva caracter�stica o el arreglo de alg�n fallo.
Puede obtener el paquete Debian de la versi�n 0.7.2 del programa
pilot-link en
ftp://ftp.debian.org/pub/debian/hamm/hamm/binary-
i386/otherosfs/pilot-link_0.7.2-1.deb Instale este archivo de la
manera habitual y pase directamente a usar el programa.
Puede obtener el paquete RedHat de la versi�n 0.7.6 del programa
pilot-link en
ftp://ftp.redhat.com/pub/contrib/i386/pilot-link-0.7.6-2.i386.rpm.
Instale este archivo de la manera habitual y pase directamente a usar
el programa.
Para otras versiones de Linux o Unix, obtenga la versi�n 0.8.2 del
programa pilot-link de
ftp://ryeham.ee.ryerson.ca/pub/PalmOS/pilot-
link.0.8.2.tar.gz. El n�mero de versi�n es probable que cambie, pero
las nuevas versiones estar�n en el mismo lugar y con un nombre
similar.
Una vez que tenga la distribuci�n del programa, descompr�malo con:
tar -xvzf pilot-link.0.8.2.tar.gz
Esto crear� un directorio (pilot-link.0.8.2) conteniendo los fuentes.
Ejecute ./configure. Esto buscar� por su sistema la informaci�n
necesaria para compilar el programa. Por defecto la configuraci�n se
realizar� de tal manera que la instalaci�n posterior se realizar� en
el directorio /usr/local. Si quiere cambiar el directorio, ejecute
nombre del directorio en el cual quiera que se instale el programa.
Ejecute make. Con esto compilar� el programa. El programa no se
instalar� hasta un poco m�s tarde, de tal manera que pueda probarlo
primero. (Si est� reemplazando una versi�n anterior con una nueva
versi�n, debe asegurarse que todas las funcionalidades que necesite
funcionan correctamente. Generalmente, esto no es un problema.)
Siendo el usuario root, ejecute make install. Este comando copiar� los
ficheros del programa en /usr/local (o donde haya indicado mediante la
opci�n --prefix). Si no puede acceder al sistema como root, puede
instalar el programa en cualquier directorio en el que tenga derechos
de escritura.
No olvide a�adir a su camino de b�squeda todo directorio nuevo que
haya creado en el que est�n almacenados ejecutables.
3.1.2. Uso del programa pilot-link
La mayor�a de programas incluidos en el paquete pilot-link transfieren
datos desde o hacia su Pilot.
Cada vez que se use uno de estos programas, pulse el bot�n de
sincronizaci�n HotSync del soporte de su Pilot. Esto iniciar� la
transferencia de datos en lo concerniente al Pilot. Observe que no
todos estos programas le avisan de que pulse el bot�n de
sincronizaci�n, por lo tanto debe acordarse usted mismo de hacerlo.
Para obtener m�s detalles, y para cualquier otra opci�n de estos
programas, consulte la correspondiente p�gina del manual. Para el
programa pilot-xfer, por ejemplo, teclee man pilot-xfer en la l�nea de
comandos.
Si va a usar PilotManager, no se tiene que preocupar en aprender a
usar estas utilidades.
3.1.2.1. pilot-xfer
Posiblemente �ste sea el programa m�s �til de los que se compone el
paquete pilot-link. pilot-xfer permite instalar programas en el Pilot,
realizar copias de seguridad, y restaurar esas copias de seguridad.
Para instalar un programa:
pilot-xfer /dev/pilot -i programa.prc
Para realizar una copia de seguridad del Pilot:
pilot-xfer /dev/pilot -b directorio-backup
Este comando copiar� todas las bases de datos que est�n en el Pilot a
un directorio llamado "directorio-backup", cre�ndolo si �ste no
existe.
Para restaurar datos en el Pilot:
pilot-xfer /dev/pilot -r directorio-backup
Normalmente, se tendr� �nicamente que hacer esta operaci�n si al Pilot
se le acaban totalmente las bater�as o si ha sido necesario
reinicializarlo.
Para listar los programas instalados en el Pilot:
pilot-xfer /dev/pilot -l
3.1.2.2. install-memo
Instala un archivo en el Pilot como una nota.
Para instalar una nota en una categor�a ya existente:
install-memo /dev/pilot -c categoria nota
El nombre del archivo se insertar� en la nota como su primera l�nea y
aparecer� en el directorio de notas del Pilot.
3.1.2.3. memos
Este programa captura cada nota presente en el Pilot y la muestra en
el formato est�ndard de fichero de correo.
Para ver las notas:
memos /dev/pilot
3.1.2.4. pilot-addresses
pilot-addresses transfiere la base de datos de direcciones hacia o
desde el Pilot.
Para leer la base de datos de direcciones del Pilot y escribirla en un
archivo:
pilot-addresses /dev/pilot -w archivo
Para leer la base de datos de direcciones de un fichero y almacenarla
en el Pilot:
pilot-addresses /dev/pilot -r archivo
3.2. makedoc
Una limitaci�n del programa de notas incorporado en el Pilot es que no
maneja bien documentos grandes. Para compensar esto, Rick Bram
mailto:
[email protected] escribi� Doc, un lector de documentos para
el Pilot (consulte
http://www.concentric.net/~rbram/doc.shtml).
Cualquier documento puede ser convertido al formato de Doc con
MakeDoc, de Pat Beirne
[email protected].
3.2.1. Instalaci�n de makedoc
MakeDoc puede obtenerse de
http://www.concentric.net/~rbram/makedoc7.cpp. Comp�lelo con un
compilador de C++ e instale el ejecutable resultante bajo el nombre
"makedoc" en cualquier directorio incluido en su camino de b�squeda.
Parece ser que hay un peque�o fallo en makedoc (versi�n 0.7a) que
ocasiona que no se muestre un retorno de carro como �ltimo caracter
mostrado al usuario. Esto parece que no afecta al documento que se
obtiene en el archivo, pero es molesto.
Hay una nueva versi�n, pero necesita Java. Consulte la p�gina web que
tiene Pat Beirne sobre MakeDoc en
http://cpu563.adsl.sympatico.ca/MakeDocJ.htm.
3.2.2. Uso de makedoc
Use MakeDoc de la siguiente forma:
makedoc documento.txt documento.prc "Titulo del documento"
Este comando crear� un archivo documento.prc que puede ser instalado
en el Pilot usando pilot-xfer. El texto "Titulo del documento" se
mostrar� en el directorio de documentos que maneje Doc.
La sintaxis de MakeDoc es como sigue:
makedoc [-n] [-b] <archivo-texto> <archivo-prc> <titulo-documento>
o bien
makedoc -d [-b] <archivo-prc> <archivo-texto>
archivo-texto
es el archivo que se desea convertir.
archivo-prc
es el nombre del archivo resultante. (El nombre debe terminar en
".prc").
titulo-documento
el nombre que se quiere que sea mostrado en el directorio de
documentos de Doc o Jdoc.
Hay tambi�n opciones para decodificar el fichero .prc resultante y
para manejar varias opciones de compresi�n.
3.3. PilotManager
PilotManager es una herramienta de uso general que permite sincronizar
varias bases de datos en una �nica transferencia.
No me ha sido posible compilar e instalar PilotManager a tiempo para
escribir sobre �l en esta versi�n del Pilot-COMO.
Algunos enlaces que pueden ser de ayuda:
� El paquete PilotManager:
http://playground.sun.com/~bharat/pilotmgr.html
� Un parche:
ftp://ftp.orbits.com/pub/Pilot/pilotmgr,v1.009-BETA-3.patch
Este parche para el PilotManager est� �nicamente pensado para ser
aplicado a la versi�n 1.009 Beta 3 cuando es usado conjuntamente
con la versi�n 0.8.0 del pilot-link. Instale los fuentes del
PilotManager y aplique el parche con los siguientes comandos:
tar -xvzf pilotmgr,v1.009-BETA-3.dev.tar.gz
cd pilotmgr,v1.009-BETA-3
patch -p1 < ../pilotmgr,v1.009-BETA-3.patch
Espero poder instalar este programa en breve y comentarlo en una
futura versi�n de este documento.
4. Herramientas para desarrollo de software para el Pilot
4.1. prc-tools
El paquete prc-tools es un entorno de desarrollo completo construido a
partir de las utilidades, compilador y depurador de GNU con la
incorporaci�n de algunas otras herramientas especiales.
No hay mucho en lo referente a documentaci�n, pero ser�a recomendable
que visitase la p�gina web Pilot Software development en
http://www.massena.com/darrin/pilot/
4.1.1. Instalaci�n de prc-tools
Obtenga la versi�n m�s reciente de prc-tools de
ftp://ryeham.ee.ryerson.ca/pub/PalmOS. Las herramientas GNU se pueden
conseguir en
ftp://prep.ai.mit.edu/pub/gnu. Debe coger los archivos
binutils-2.7.tar.gz, gcc-2.7.2.2.tar.gz y gdb-4.16.tar.gz. Las
versiones indicadas de las herramientas GNU son las correctas para la
versi�n 0.5.0 de prc-tools. Las versiones posteriores de prc-tools
podr�an necesitar versiones m�s recientes de las herramientas GNU.
Ponga todos los archivos en un directorio. Descomprima s�lo el archivo
de prc-tools. El archivo Makefile de prc-tools usar� el resto de los
archivos. Por defecto, prc-tools ser� instalado en /usr/local/gnu. Si
quiere que sea instalado en alg�n otro lugar, deber� cambiar el valor
de INSTALLDIR en el archivo Makefile. Los pasos a dar son:
tar -xvzf prc-tools.0.5.0.tar.gz
cd prc-tools-0.5.0
Editar el archivo Makefile si es necesario.
make doeverything
4.1.2. Uso de prc-tools
Una buena referencia para el uso general de prc-tools es el directorio
de ejemplos, y el archivo Makefile en particular. La documentaci�n
para PilRC se encuentra en el archivo pilrc1.5/doc/pilrc.htm incluido
como parte de la versi�n 0.5.0 de prc-tools.
5. Gente
Kenneth Albanowski
[email protected] Mantiene el conjunto de
herramientas pilot-link.
Donnie Barnes
[email protected] Empaquet� el conjunto de herramientas
pilot-link como paquete RedHat.
Rick Bram
[email protected] Autor de Doc.
Matthew Cravit
[email protected] Propietario de la lista
de distribuci�n pilot-unix.
Jeff Dionne
[email protected] Autor original del conjunto de
herramientas pilot-link. Administra el FTP dedicado al projecto de
desarrollo PalmOS/Pilot para UNIX.
Mark W. Eichin
[email protected] Realiz� la conversi�n de pilot-
link a Debian.
David H. Silber
[email protected] Autor de este documento.
Chris Stevens
[email protected] Mantiene los recopilatorios de la
lista de distribuci�n pilot-unix.
6. Anexo: El INSFLUG
El INSFLUG forma parte del grupo internacional Linux Documentation
Project, encarg�ndose de las traducciones al castellano de los Howtos
(Comos), as� como la producci�n de documentos originales en aquellos
casos en los que no existe an�logo en ingl�s.
En el INSFLUG se orienta preferentemente a la traducci�n de documentos
breves, como los COMOs y PUFs (Preguntas de Uso Frecuente, las FAQs.
:) ), etc.
Dir�jase a la sede del INSFLUG para m�s informaci�n al respecto.
En la sede del INSFLUG encontrar� siempre las �ltimas versiones de las
traducciones: www.insflug.org. Aseg�rese de comprobar cu�l es la
�ltima versi�n disponible en el Insflug antes de bajar un documento de
un servidor r�plica.
Se proporciona tambi�n una lista de los servidores r�plica (mirror)
del Insflug m�s cercanos a Vd., e informaci�n relativa a otros
recursos en castellano.
Francisco Jos� Montilla,
[email protected].