<!-- 0,1 -->
<!-- Pilot,1 -->
<!-- David H.,Silber,pilot@orbits.com -->
<!-- 0.5,1997-08-17 -->
<!-- Pilot -->
<!-- Angel,López,alogo@mx2.redestb.es --> 
<!-- 1.0,1997-11-16 -->
<!-- 3com,pilot,PDA,PalmPilot -->
<!-- Hardware,PDA -->

<!doctype linuxdoc system>

<!-- Revisión sgml-gramatico-ortográfica del 21/12/97            -->
<!-- Francisco J. Montilla, pacopepe@insflug.org                 -->

<article>

<title>Pilot COMO

<author>David H. Silber <tt><htmlurl url="mailto:pilot@orbits.com"
name="pilot@orbits.com"></tt>&nl;  Traducido por Angel López <tt><htmlurl
url="mailto:alogo@mx2.redestb.es" name="alogo@mx2.redestb.es"></tt>

<date>v0.5, 17-VIII-1997.
Traducido el 16-XI-1997.

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

<toc>

<sect>Introducción
<p>

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.

<sect1>Este documento
<p>

La última versión de este documento puede obtenerse en &nl; <tt><htmlurl
url="http://www.orbits.com/Pilot/Pilot-HOWTO.html" 
name="http://www.orbits.com/Pilot/Pilot-HOWTO.html"></tt>, también forma
parte del <it>Linux Documentation Project (LDP)</it>. Vea <tt><htmlurl
url="http://sunsite.unc.edu/LDP/" name="http://sunsite.unc.edu/LDP/"></tt>
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 &copy; 1997 David H. Silber. Está publicado
bajo los términos de copyright que aparecen en el documento LDP
HOWTO-INDEX. 

<sect1>Lista de correo
<p>

La lista de correo <tt/pilot-unix/ es mantenida por Matthew Cravit
<tt><htmlurl url="mailto:pilot-unix-owner@lists.best.com" 
name="pilot-unix-owner@lists.best.com"></tt>.  Su introducción es: 

La lista de correo <tt/pilot-unix/ es para la discusión y compartición de
ideas de aquellos interesados en el uso de los <it/PDA/s 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 "<tt/INFO/" a <tt><htmlurl
url="mailto:pilot-unix-request@lists.best.com" 
name="pilot-unix-request@lists.best.com"></tt>. La línea de tema no
importa. 

<sect1>Archivos de la lista de correo
<p>

Puede encontrar un archivo con todos los mensajes de la lista de correo
pilot-unix en &nl; <tt><htmlurl
url="http://www.acm.rpi.edu/&tilde;albert/pilot/" 
name="http://www.acm.rpi.edu/&tilde;albert/pilot/"></tt>. Este archivo es
mantenido por Chris Stevens, <tt><htmlurl url="mailto:albert@acm.rpi.edu" 
name="albert@acm.rpi.edu"></tt>. 

<sect1>Servidor FTP
<p>

Hay disponible un servidor FTP con herramientas para usar el Pilot en
sistemas Unix en &nl; <tt><htmlurl
url="ftp://ryeham.ee.ryerson.ca/pub/PalmOS/" 
name="ftp://ryeham.ee.ryerson.ca/pub/PalmOS/"></tt>. Este servidor está
mantenido por Jeff Dionne, <tt><htmlurl
url="mailto:jeff@ryeham.ee.ryerson.ca" 
name="jeff@ryeham.ee.ryerson.ca"></tt>. 

<sect>Información General
<p>

<sect1>¿Qué es un Pilot?
<p>

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. 

<sect1>Diferentes tipos de Pilot
<p>

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. 

<sect1>Instalación del Hardware
<p>

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, <tt>/dev/pilot</tt> que será un nombre
alternativo para el puerto serie donde el soporte del Pilot esté
conectado. Ejecute lo siguiente como root: 

<tscreen><verb>
	ln /dev/cua0 /dev/pilot
</verb></tscreen>

Sustituya <tt/cua0/ con el nombre del puerto al cual tenga conectado su
soporte del Pilot.

<sect>Cómo compartir datos del Pilot con su sistema Linux
<p>

<sect1>El programa pilot-link
<p>

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. 

<sect2>Instalación del programa pilot-link
<p>

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 <tt><htmlurl
url="ftp://ftp.debian.org/pub/debian/hamm/hamm/binary-i386/otherosfs/pilot-link&lowbar;0.7.2-1.deb" 
name="ftp://ftp.debian.org/pub/debian/hamm/hamm/binary-i386/otherosfs/pilot-link&lowbar;0.7.2-1.deb"></tt>
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 &nl;
<tt><htmlurl url="ftp://ftp.redhat.com/pub/contrib/i386/pilot-link-0.7.6-2.i386.rpm" 
name="ftp://ftp.redhat.com/pub/contrib/i386/pilot-link-0.7.6-2.i386.rpm"></tt>. 
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 <tt><htmlurl
url="ftp://ryeham.ee.ryerson.ca/pub/PalmOS/pilot-link.0.8.2.tar.gz" 
name="ftp://ryeham.ee.ryerson.ca/pub/PalmOS/pilot-link.0.8.2.tar.gz"></tt>. 
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:

<tscreen><verb>
	tar -xvzf pilot-link.0.8.2.tar.gz
</verb></tscreen>

Esto creará un directorio (<tt/pilot-link.0.8.2/) conteniendo los fuentes.

Ejecute <tt>./configure</tt>. 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 <tt>/usr/local</tt>. Si quiere cambiar el directorio, ejecute
<tt>./configure --prefix=DIR</tt>, donde pone <tt>DIR</tt> debe indicar el
nombre del directorio en el cual quiera que se instale el programa. 

Ejecute <tt>make</tt>. 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 <tt>root</tt>, ejecute <tt>make install</tt>. Este
comando copiará los ficheros del programa en <tt>/usr/local</tt> (o donde
haya indicado mediante la opción <tt>--prefix</tt>). Si no puede acceder
al sistema como <tt/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. 

<sect2>Uso del programa pilot-link
<p>

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 <it>HotSync</it> 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
<tt/pilot-xfer/, por ejemplo, teclee <tt>man pilot-xfer</tt> en la línea
de comandos.

Si va a usar PilotManager, no se tiene que preocupar en aprender a usar
estas utilidades. 

<sect3><tt>pilot-xfer</tt>
<p>
 
Posiblemente éste sea el programa más útil de los que se compone el
paquete pilot-link. <tt/pilot-xfer/ permite instalar programas en el
Pilot, realizar copias de seguridad, y restaurar esas copias de seguridad. 

Para instalar un programa:

<tscreen><verb>
	pilot-xfer /dev/pilot -i programa.prc
</verb></tscreen>

Para realizar una copia de seguridad del Pilot:

<tscreen><verb>
	pilot-xfer /dev/pilot -b directorio-backup
</verb></tscreen>

Este comando copiará todas las bases de datos que estén en el Pilot a un
directorio llamado "<tt/directorio-backup/", creándolo si éste no existe. 

Para restaurar datos en el Pilot:

<tscreen><verb>
	pilot-xfer /dev/pilot -r directorio-backup
</verb></tscreen>

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:

<tscreen><verb>
	pilot-xfer /dev/pilot -l
</verb></tscreen>

<sect3><tt>install-memo</tt>
<p>

Instala un archivo en el Pilot como una nota.

Para instalar una nota en una categoría ya existente:

<tscreen><verb>
	install-memo /dev/pilot -c categoria nota
</verb></tscreen>

El nombre del archivo se insertará en la nota como su primera línea y
aparecerá en el directorio de notas del Pilot. 

<sect3><tt>memos</tt>
<p>

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:

<tscreen><verb>
	memos /dev/pilot
</verb></tscreen>

<sect3><tt>pilot-addresses</tt>
<p>

<tt/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:

<tscreen><verb>
	pilot-addresses /dev/pilot -w archivo
</verb></tscreen>

Para leer la base de datos de direcciones de un fichero y almacenarla en
el Pilot: 

<tscreen><verb>
	pilot-addresses /dev/pilot -r archivo
</verb></tscreen>

<sect1><tt>makedoc</tt>
<p>

Una limitación del programa de notas incorporado en el Pilot es que no
maneja bien documentos grandes. Para compensar esto, Rick Bram
<tt><htmlurl url="mailto:rbram@concentric.net" 
name="mailto:rbram@concentric.net"></tt> escribió <tt/Doc/, un lector de
documentos para el Pilot (consulte <tt><htmlurl
url="http://www.concentric.net/&tilde;rbram/doc.shtml" 
name="http://www.concentric.net/&tilde;rbram/doc.shtml"></tt>).  Cualquier
documento puede ser convertido al formato de <tt/Doc/ con <tt/MakeDoc/, de
Pat Beirne <tt><htmlurl url="mailto:pat.beirne@sympatico.ca" 
name="pat.beirne@sympatico.ca"></tt>.

<sect2>Instalación de <tt>makedoc</tt>
<p>

<tt/MakeDoc/ puede obtenerse de <tt><htmlurl
url="http://www.concentric.net/&tilde;rbram/makedoc7.cpp" 
name="http://www.concentric.net/&tilde;rbram/makedoc7.cpp"></tt>. 
Compílelo con un compilador de C++ e instale el ejecutable resultante bajo
el nombre "<tt/makedoc/" en cualquier directorio incluido en su camino de
búsqueda. Parece ser que hay un pequeño fallo en <tt/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 <tt><htmlurl
url="http://cpu563.adsl.sympatico.ca/MakeDocJ.htm"
name="http://cpu563.adsl.sympatico.ca/MakeDocJ.htm"></tt>. 

<sect2>Uso de <tt>makedoc</tt>
<p>

Use MakeDoc de la siguiente forma:

<tscreen><verb>
	makedoc documento.txt documento.prc "Titulo del documento"
</verb></tscreen>

Este comando creará un archivo <tt/documento.prc/ que puede ser instalado
en el Pilot usando <tt/pilot-xfer/. El texto "<tt/Titulo del documento/" 
se mostrará en el directorio de documentos que maneje <tt/Doc/. 

La sintaxis de MakeDoc es como sigue:

<tscreen><verb>
	makedoc [-n] [-b] <archivo-texto> <archivo-prc> <titulo-documento>
</verb></tscreen>
	
	o bien

<tscreen><verb>
	makedoc -d [-b] <archivo-prc> <archivo-texto>
</verb></tscreen>

<descrip>
<tag/archivo-texto/ es el archivo que se desea convertir.
<tag/archivo-prc/ es el nombre del archivo resultante. (El nombre debe
terminar en "<tt/.prc/"). 
<tag/titulo-documento/ el nombre que se quiere que sea mostrado en el
directorio de documentos de <tt/Doc/ o <tt/Jdoc/. 
</descrip>

Hay también opciones para decodificar el fichero <tt/.prc/ resultante y
para manejar varias opciones de compresión.

<sect1><tt>PilotManager</tt>
<p>

<tt/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 <tt/PilotManager/ a tiempo para
escribir sobre él en esta versión del <it/Pilot-COMO/.

Algunos enlaces que pueden ser de ayuda:

<itemize>

<item>El paquete PilotManager: <tt><htmlurl
url="http://playground.sun.com/&tilde;bharat/pilotmgr.html"
name="http://playground.sun.com/&tilde;bharat/pilotmgr.html"></tt>

<item>Un parche: <tt><htmlurl
url="ftp://ftp.orbits.com/pub/Pilot/pilotmgr,v1.009-BETA-3.patch"
name="ftp://ftp.orbits.com/pub/Pilot/pilotmgr,v1.009-BETA-3.patch"></tt>

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 <tt/pilot-link/. Instale los fuentes del <tt/PilotManager/ y
aplique el parche con los siguientes comandos: 

<tscreen><verb>
	tar -xvzf pilotmgr,v1.009-BETA-3.dev.tar.gz
	cd pilotmgr,v1.009-BETA-3
	patch -p1 < ../pilotmgr,v1.009-BETA-3.patch
</verb></tscreen>

</itemize>

Espero poder instalar este programa en breve y comentarlo en una futura
versión de este documento. 

<sect>Herramientas para desarrollo de software para el Pilot
<p>

<sect1><tt>prc-tools</tt>
<p>

El paquete <tt/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 <it>Pilot Software development</it> en <tt><htmlurl
url="http://www.massena.com/darrin/pilot/" 
name="http://www.massena.com/darrin/pilot/"></tt>

<sect2>Instalación de <tt/prc-tools/
<p>

Obtenga la versión más reciente de prc-tools de <tt><htmlurl
url="ftp://ryeham.ee.ryerson.ca/pub/PalmOS"
name="ftp://ryeham.ee.ryerson.ca/pub/PalmOS"></tt>. Las herramientas GNU
se pueden conseguir en <tt><htmlurl url="ftp://prep.ai.mit.edu/pub/gnu"
name="ftp://prep.ai.mit.edu/pub/gnu"></tt>. Debe coger los archivos
<tt/binutils-2.7.tar.gz/, <tt/gcc-2.7.2.2.tar.gz/ y <tt/gdb-4.16.tar.gz/.
Las versiones indicadas de las herramientas GNU son las correctas para la
versión 0.5.0 de <tt/prc-tools/. Las versiones posteriores de
<tt/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
<tt/prc-tools/. El archivo <tt/Makefile/ de <tt/prc-tools/ usará el resto
de los archivos. Por defecto, <tt/prc-tools/ será instalado en
<tt>/usr/local/gnu</tt>. Si quiere que sea instalado en algún otro lugar,
deberá cambiar el valor de <tt>INSTALLDIR</tt> en el archivo
<tt>Makefile</tt>. Los pasos a dar son: 

<tscreen><verb>
	tar -xvzf prc-tools.0.5.0.tar.gz
	cd prc-tools-0.5.0
</verb></tscreen>

Editar el archivo <tt/Makefile/ si es necesario.

<tscreen><verb>
	make doeverything
</verb></tscreen>

<sect2>Uso de <tt>prc-tools</tt>
<p>

Una buena referencia para el uso general de <tt/prc-tools/ es el
directorio de ejemplos, y el archivo <tt/Makefile/ en particular. La
documentación para <tt/PilRC/ se encuentra en el archivo
<tt>pilrc1.5/doc/pilrc.htm</tt> incluido como parte de la versión
<tt/0.5.0/ de <tt/prc-tools/. 

<sect>Gente
<p>

Kenneth Albanowski <tt><htmlurl url="mailto:kjahds@kjahds.com"
name="kjahds@kjahds.com"></tt> Mantiene el conjunto de herramientas
pilot-link. 

Donnie Barnes <tt><htmlurl url="mailto:djb@redhat.com"
name="djb@redhat.com"></tt> Empaquetó el conjunto de herramientas
<tt/pilot-link/ como paquete RedHat. 

Rick Bram <tt><htmlurl url="mailto:rbram@concentric.net"
name="rbram@concentric.net"></tt> Autor de Doc. 

Matthew Cravit <tt><htmlurl url="mailto:pilot-unix-owner@lists.best.com"
name="pilot-unix-owner@lists.best.com"></tt> Propietario de la lista de
distribución <tt/pilot-unix/. 

Jeff Dionne <tt><htmlurl url="mailto:jeff@ryeham.ee.ryerson.ca"
name="jeff@ryeham.ee.ryerson.ca"></tt> Autor original del conjunto de
herramientas <tt/pilot-link/. Administra el FTP dedicado al projecto de
desarrollo PalmOS/Pilot para UNIX. 

Mark W. Eichin <tt><htmlurl url="mailto:eichen@kitten.gen.ma.us" 
name="eichen@kitten.gen.ma.us"></tt> Realizó la conversión de
<tt/pilot-link/ a Debian.

David H. Silber <tt><htmlurl url="mailto:pilot@orbits.com"
name="pilot@orbits.com"></tt> Autor de este documento. 

Chris Stevens <tt><htmlurl url="mailto:albert@acm.rpi.edu"
name="albert@acm.rpi.edu"></tt> Mantiene los recopilatorios de la lista de
distribución pilot-unix. 

<sect>Anexo: El INSFLUG <label id="Grupos">
<p>

El <em/INSFLUG/ forma parte del grupo internacional 
<it/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 <bf/INSFLUG/ se orienta preferentemente a la traducción de documentos
breves, como los <em/COMOs/ y <em/PUFs/ (<bf/P/reguntas de
<bf/U/so <bf/F/recuente, las <it/FAQs/. <tt/:)/ ), etc.

Diríjase a la sede del INSFLUG para más información al respecto.

En la sede del INSFLUG encontrará siempre las <bf/últimas/ versiones 
de las traducciones:  <tt><htmlurl url="http://www.insflug.org" 
name="www.insflug.org"></tt>. 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 (<it/mirror/) del Insflug más cercanos a Vd.,  
e información relativa a otros recursos en castellano.

Francisco José Montilla, <tt><htmlurl url="mailto:pacopepe@insflug.org"
name="pacopepe@insflug.org"></tt>.

</article>
