  Traducido el 16-XI-1997.  Pilot COMO
  David H. Silber pilot@orbits.com
  v0.5, 17-VIII-1997.

  Este documento explica cmo usar su PalmPilot con un sistema Linux. A
  pesar de que los documentos COMO estn orientados al uso del sistema
  operativo Linux, ste en particular no depende de la versin de Unix
  utilizada.
  ______________________________________________________________________

  ndice General:

  1.      Introduccin

  1.1.    Este documento

  1.2.    Lista de correo

  1.3.    Archivos de la lista de correo

  1.4.    Servidor FTP

  2.      Informacin General

  2.1.    Qu es un Pilot?

  2.2.    Diferentes tipos de Pilot

  2.3.    Instalacin del Hardware

  3.      Cmo compartir datos del Pilot con su sistema Linux

  3.1.    El programa pilot-link

  3.1.1.  Instalacin 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.  Instalacin 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.  Instalacin de prc-tools

  4.1.2.  Uso de prc-tools

  5.      Gente

  6.      Anexo: El INSFLUG
  ______________________________________________________________________
  1.  Introduccin

  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 sincronizacin 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, dnde obtenerlo y cmo instalarlo y usarlo.

  1.1.  Este documento

  La ltima versin de este documento puede obtenerse en
  parte del Linux Documentation Project (LDP). Vea
  http://sunsite.unc.edu/LDP/ para obtener ms informacin sobre el LDP
  y otros documentos HOWTO.

  Las versiones futuras cubrirn ms herramientas Unix para el
  desarrollo de programas de aplicacin 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 enveme un mensaje de correo electrnico a la
  direccin indicada anteriormente y especifique a qu versin de este
  documento se est refiriendo.

  Este documento es Copyright  1997 David H. Silber. Est publicado
  bajo los trminos 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-
  unix-owner@lists.best.com.  Su introduccin es:

  La lista de correo pilot-unix es para la discusin y comparticin 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 ms informacin, incluyendo el cmo suscribirse a la
  lista, enve un mensaje con la palabra "INFO" a pilot-unix-
  request@lists.best.com. La lnea 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, albert@acm.rpi.edu.

  1.4.  Servidor FTP

  Hay disponible un servidor FTP con herramientas para usar el Pilot en
  sistemas Unix en
  mantenido por Jeff Dionne, jeff@ryeham.ee.ryerson.ca.

  2.  Informacin General

  2.1.  Qu es un Pilot?

  El Pilot es un pequeo Asistente Personal Digital. Est fabricado por
  U.S.  Robotics, ahora parte de 3Com.

  Para los que no estn familiarizados con el trmino, un Asistente
  Personal Digital es uno de esos pequeos dispositivos electrnicos que
  contienen normalmente varios tipos de informacin personal, como
  pueden ser direcciones y nmeros de telfono, un calendario, lista de
  recordatorios y/o apuntes y est diseado para ser transportado
  cmodamente as como estar a mano cuando la informacin se requiera.

  Los PDAs ms verstiles, 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 ms antiguos, el 1000 y el
  5000 tienen 128k y 512k de RAM respectivamente.

  Los dos ms recientes, el PalmPilot Personal y el PalmPilot
  Professional tienen 512k y 1 Mb de RAM respectivamente. Tambin tienen
  una pantalla LCD retroiluminada y la versin 2.0 del sistema
  operativo. El Professional tambin incorpora soporte para el protocolo
  TCP/IP e incluye algunos programas adicionales.

  Es posible actualizar cualquier Pilot cambindole 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.  Instalacin 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 receptculo hecho a medida para colocar el Pilot y con un botn
  de "sincronizacin". 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 botn de sincronizacin para que el
  Pilot sepa que se tiene que comunicar. Si se pulsa el botn estando el
  Pilot apagado, ste se encender automticamente.

  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.  Cmo 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
  permitirn 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 estn tan
  elaborados como los que se distribuyen con el Pilot, le permitirn
  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 solucin ms integrada,
  entre sus caractersticas se incluye la sincronizacin completa de
  varios tipos de datos.

  3.1.1.  Instalacin del programa pilot-link

  Las versiones empaquetadas siempre irn inevitablemente ligeramente
  retrasadas respecto a la distribucin original, pero sern ms fciles
  de instalar y no requieren configuracin. La distribucin original
  ser la mejor eleccin en aquellas raras ocasiones en las que haya
  estado esperando una nueva caracterstica o el arreglo de algn fallo.

  Puede obtener el paquete Debian de la versin 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 versin 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 versin 0.8.2 del
  programa pilot-link de ftp://ryeham.ee.ryerson.ca/pub/PalmOS/pilot-
  link.0.8.2.tar.gz.  El nmero de versin es probable que cambie, pero
  las nuevas versiones estarn en el mismo lugar y con un nombre
  similar.

  Una vez que tenga la distribucin del programa, descomprmalo 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 informacin
  necesaria para compilar el programa. Por defecto la configuracin se
  realizar de tal manera que la instalacin 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 ms tarde, de tal manera que pueda probarlo
  primero. (Si est reemplazando una versin anterior con una nueva
  versin, 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
  opcin --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 aadir a su camino de bsqueda todo directorio nuevo que
  haya creado en el que estn almacenados ejecutables.

  3.1.2.  Uso del programa pilot-link

  La mayora 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 botn de
  sincronizacin 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 botn de
  sincronizacin, por lo tanto debe acordarse usted mismo de hacerlo.

  Para obtener ms detalles, y para cualquier otra opcin de estos
  programas, consulte la correspondiente pgina del manual. Para el
  programa pilot-xfer, por ejemplo, teclee man pilot-xfer en la lnea 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 ms 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 estn en el Pilot a
  un directorio llamado "directorio-backup", crendolo si ste no
  existe.

  Para restaurar datos en el Pilot:

               pilot-xfer /dev/pilot -r directorio-backup

  Normalmente, se tendr nicamente que hacer esta operacin si al Pilot
  se le acaban totalmente las bateras 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 categora ya existente:

               install-memo /dev/pilot -c categoria nota

  El nombre del archivo se insertar en la nota como su primera lnea 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 estndard 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 limitacin del programa de notas incorporado en el Pilot es que no
  maneja bien documentos grandes. Para compensar esto, Rick Bram
  mailto:rbram@concentric.net 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 pat.beirne@sympatico.ca.

  3.2.1.  Instalacin de makedoc

  MakeDoc puede obtenerse de
  http://www.concentric.net/~rbram/makedoc7.cpp.  Complelo con un
  compilador de C++ e instale el ejecutable resultante bajo el nombre
  "makedoc" en cualquier directorio incluido en su camino de bsqueda.
  Parece ser que hay un pequeo fallo en makedoc (versin 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 versin, pero necesita Java. Consulte la pgina 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 tambin opciones para decodificar el fichero .prc resultante y
  para manejar varias opciones de compresin.

  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 versin 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 versin 1.009 Beta 3 cuando es usado conjuntamente
     con la versin 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 versin 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
  incorporacin de algunas otras herramientas especiales.

  No hay mucho en lo referente a documentacin, pero sera recomendable
  que visitase la pgina web Pilot Software development en
  http://www.massena.com/darrin/pilot/

  4.1.1.  Instalacin de prc-tools

  Obtenga la versin ms 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
  versin 0.5.0 de prc-tools. Las versiones posteriores de prc-tools
  podran necesitar versiones ms recientes de las herramientas GNU.

  Ponga todos los archivos en un directorio. Descomprima slo 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 algn 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 documentacin
  para PilRC se encuentra en el archivo pilrc1.5/doc/pilrc.htm incluido
  como parte de la versin 0.5.0 de prc-tools.

  5.  Gente

  Kenneth Albanowski kjahds@kjahds.com Mantiene el conjunto de
  herramientas pilot-link.

  Donnie Barnes djb@redhat.com Empaquet el conjunto de herramientas
  pilot-link como paquete RedHat.

  Rick Bram rbram@concentric.net Autor de Doc.

  Matthew Cravit pilot-unix-owner@lists.best.com Propietario de la lista
  de distribucin pilot-unix.

  Jeff Dionne jeff@ryeham.ee.ryerson.ca Autor original del conjunto de
  herramientas pilot-link. Administra el FTP dedicado al projecto de
  desarrollo PalmOS/Pilot para UNIX.

  Mark W. Eichin eichen@kitten.gen.ma.us Realiz la conversin de pilot-
  link a Debian.

  David H. Silber pilot@orbits.com Autor de este documento.

  Chris Stevens albert@acm.rpi.edu Mantiene los recopilatorios de la
  lista de distribucin pilot-unix.

  6.  Anexo: El INSFLUG

  El INSFLUG forma parte del grupo internacional Linux Documentation
  Project, encargndose de las traducciones al castellano de los Howtos
  (Comos), as como la produccin de documentos originales en aquellos
  casos en los que no existe anlogo en ingls.

  En el INSFLUG se orienta preferentemente a la traduccin de documentos
  breves, como los COMOs y PUFs (Preguntas de Uso Frecuente, las FAQs.
  :) ), etc.

  Dirjase a la sede del INSFLUG para ms informacin al respecto.

  En la sede del INSFLUG encontrar siempre las ltimas versiones de las
  traducciones:  www.insflug.org. Asegrese de comprobar cul es la
  ltima versin disponible en el Insflug antes de bajar un documento de
  un servidor rplica.

  Se proporciona tambin una lista de los servidores rplica (mirror)
  del Insflug ms cercanos a Vd., e informacin relativa a otros
  recursos en castellano.

  Francisco Jos Montilla, pacopepe@insflug.org.

