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