PalmOS port/es: what changed
Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.
Title: PalmOS port/es
| Old | New | Line | |
|---|---|---|---|
| 1 | + | La versión PalmOS está en un estado muy inicial. Esta versión ha sido puesta en marcha y es mantenida por Mazen Neifer. Peter Vreman ha convertido las cabeceras del API de PalmOS. | |
| 2 | + | ||
| 3 | + | ## Estado | |
| 4 | + | ||
| 5 | + | - La versión 2.1.x del compilador tiene soporte (muy experimental) para compilar para PalmOS. | |
| 6 | + | - La CPU [[ARM]] CPU está soportada. | |
| 7 | + | - Las siguientes plataformas serán soportadas: | |
| 8 | + | - Zire72 – version PalmOS: 5.2.8 | |
| 9 | + | - Las unidades RTL de Base no están convertidas. | |
| 10 | + | ||
| 11 | + | ## Tutoría de Construcción | |
| 12 | + | ||
| 13 | + | Durante la tutoría algunos pasos se presuponen para demostrar el proceso de construcción. Sustituye las rutas con las adecuadas de tu sistema. | |
| 14 | + | ||
| 15 | + | ### Utilidades binarias cruzadas (*Cross binutils*) | |
| 16 | + | ||
| 17 | + | Estas son las herramientas básicas necesarias para crear ejecutables: | |
| 18 | + | ||
| 19 | + | - **arm-palmos-ld** : Enlazador | |
| 20 | + | - **arm-palmos-as** : Ensamblador | |
| 21 | + | - **arm-palmos-ar** : Archivador (Crea archivos de enlace inteligente (*smartlinking*) .a) | |
| 22 | + | - **arm-palmos-strip**: Eliminador de secciones de los binarios ejecutables | |
| 23 | + | ||
| 24 | + | y algunos otros. | |
| 25 | + | ||
| 26 | + | Estas herramientas puedes encontrarlas en un paquete listo para utilizar de debian linux (sid) **[prc-tools-utils](http://packages.debian.org/unstable/otherosfs/prc-tools)**. Utiliza el mandato "apt-get install prc-tools-utils" para obtenerlo e instalarlo. De lo contrario, es necesario obtenerlos de <http://www.palmos.com/dev/dl/dl_tools/>. Extrae en un directorio de tu máquina. En una máquina con Debian se instalan en `/usr/bin/arm-palmos-*` | |
| 27 | + | ||
| 28 | + | ### Compilador cruzado | |
| 29 | + | ||
| 30 | + | Vamos a suponer que estás usando una instalación Linux Debian (sid) y que el compilador FPC ya está instalado y configurado correctamente. En debian debemos instalar el paquete **[fp-compiler](http://packages.debian.org/unstable/devel/fp-compiler)** con la orden *apt-get install fp-compiler*. | |
| 31 | + | ||
| 32 | + | Ahora hay que construir el compilador cruzado FPC para el procesador ARM. Para llevarlo a cabo necesitamos las últimas fuentes (desde la versión 2.1.x) además de la instalación de trabajo de FPC 2.0.2 o 2.0 antes mencionadas. Obtendremos las fuentes del repositorio de fuentes Subversion: <http://www.freepascal.org/develop.html#svn> | |
| 33 | + | ||
| 34 | + | ### Entorno | |
| 35 | + | ||
| 36 | + | Suponemos que las fuentes de Free Pascal están aquí: `${FPC_SRC}` | |
| 37 | + | ||
| 38 | + | ` ``PATH="/bin:/usr/bin:/usr/bin/X11:/usr/local/bin:${FPC_SRC}/compiler"` | |
| 39 | + | ||
| 40 | + | ### El proceso de Construcción | |
| 41 | + | ||
| 42 | + | A fin de construir el compilador cruzado, es necesario tener una variable de entorno `PATH` correcta. Haz el favor de asegurarte de que las rutas de *PATH* son las adecuadas: | |
| 43 | + | ||
| 44 | + | make all CPU_TARGET=arm OS_TARGET=palmos | |
| 45 | + | ||
| 46 | + | Al finalizar la compilación no debes ver errores. | |
| 47 | + | ||
| 48 | + | Ahora tendrás el binario `ppccrossarm` en `${FPC_SRC}/compiler` y varios archivos `.o` y `.ppu` en `${FPC_SRC}/rtl/units/arm-palmos` | |
| 49 | + | ||
| 50 | + | Copia estos archivos a tu instalación FPC de trabajo. El compilador cruzado `ppccrossarm` debe ir a `/usr/local/bin/arm-palmos` y las unidades a `/usr/local/lib/fpc/units/arm-palmos` | |
| 51 | + | ||
| 52 | + | ### Archivo de Configuración | |
| 53 | + | ||
| 54 | + | Ahora tienes que editar el archivo de configuración de FPC `${HOME}/.fpc.cfg` a fin de utilizar `ppccrossarm` de forma fácil, para ello añade estas líneas al mismo: | |
| 55 | + | ||
| 56 | + | #IFDEF FPC_CROSSCOMPILING | |
| 57 | + | -Tpalmos | |
| 58 | + | -Fu${FPC_SRC}/rtl/units/arm-palmos | |
| 59 | + | -XParm-palmos- | |
| 60 | + | #ENDIF | |
| 61 | + | ||
| 62 | + | ## Compilar un proyecto de Prueba | |
| 63 | + | ||
| 64 | + | ¡Has compilado el compilador! ahora, ¿qué puedo hacer con él? Este es una tutoría para crear un programa *hola mundo* con su nuevo compilador. | |
| 65 | + | ||
| 66 | + | ### Instalar y configurar el emulador | |
| 67 | + | ||
| 68 | + | En primer lugar, es necesario instalar el emulador de dispositivos Palm. Se trata de un binario de Windows, pero funciona bien con WINE en un linux Debian (sid). | |
| 69 | + | ||
| 70 | + | Cosas para hacer (*ToDo*) | |
| 71 | + | ||
| 72 | + | ### Compilar | |
| 73 | + | ||
| 74 | + | El archivo de ejemplo para compilar: | |
| 75 | + | ||
| 76 | + | ``` pascal | |
| 77 | + | program prueba; | |
| 78 | + | {$apptype console} | |
| 79 | + | var | |
| 80 | + | Str: string; | |
| 81 | + | begin | |
| 82 | + | WriteLn('Programa desarrollado con:'); | |
| 83 | + | WriteLn('El compilador Free Pascal'); | |
| 84 | + | WriteLn(''); | |
| 85 | + | WriteLn('Por favor escribe tu nombre:'); | |
| 86 | + | ReadLn(Str); | |
| 87 | + | WriteLn('Tu nombre es: ' + Str); | |
| 88 | + | end. | |
| 89 | + | ``` | |
| 90 | + | ||
| 91 | + | Ejemplo de línea de órdenes para compilar `prueba.pas`: | |
| 92 | + | ||
| 93 | + | `ppcrossarm prueba.pas` | |
| 94 | + | ||
| 95 | + | Ahora debes coger el archivo ejecutable `prueba.prc` y copiarlo en tu aparato Palm y ejecutarlo. | |
| 96 | + | ||
| 97 | + | ## Depurando aplicaciones PalmOS | |
| 98 | + | ||
| 99 | + | Esta sección todavía no está disponible | |
| 100 | + | ||
| 101 | + | ## Construyendo las librerías de FPC | |
| 102 | + | ||
| 103 | + | Si quieres construir las librerías disponibles para FPC, por ejemplo, quieres construir la FCL, ejecuta las siguientes órdenes. | |
| 104 | + | ||
| 105 | + | cd ${FPC_SRC}/fpc | |
| 106 | + | make OS_TARGET=palmos CPU_TARGET=arm PP=ppcrossarm fcl | |
| 107 | + | ||
| 108 | + | Tendrás las unidades de la FCL en `${FPC_SRC}/fpc/fcl/units/arm-palmos`. | |
| 109 | + | ||
| 110 | + | ## Documentación | |
| 111 | + | ||
| 112 | + | ### notas de la versión PalmOS | |
| 113 | + | ||
| 114 | + | - PalmOS no tiene soporte para aplicaciones de consola por defecto. Pero puedes instalar el soporte de consola tú mismo. Ten en cuenta que FPC crea aplicaciones GUI para PalmOS de forma predeterminada. Para crear la aplicación de consola se debes utilizar la opción `-WC` del compilador o poner la directiva `{$APPTYPE CONSOLE}` en el código fuente. | |
| 115 | + | ||
| 116 | + | ## Enlaces | |
| 117 | + | ||
| 118 | + | - [Buildfaq](http://www.stack.nl/~marcov/buildfaq.pdf) es un *FAQ* general acerca de cómo crear y configurar FPC. | |
| 119 | + | ||
| 120 | + | Éstos son algunos enlaces relacionados con la arquitectura de cpu ARM | |
| 121 | + | ||
| 122 | + | - [ARM Core Developers Forum](http://www.armcorepro.com/) Aunque no muy activa. | |
| 123 | + | - [GCC ARM Improvement Project](http://www.inf.u-szeged.hu/gcc-arm/) | |
| 124 | + | - [ARM ASSEMBLER](http://www.heyrick.co.uk/assembler/index.html) Buena información y código relacionados con el lenguaje ensamblador de ARM. | |
| 125 | + | - [GNU ARM toolchain for Cygwin, Linux and MacOS](http://www.gnuarm.com/) | |
| 126 | + | - [ARM Instruction Sets & Programs](http://soc.csie.ndhu.edu.tw/source/intro_embedded/ch2-arm-2.ppt) Muy buena y concisa información sobre la arquitectura ARM | |
| 127 | + | - [El juego de instrucciones ARM](http://web.njit.edu/~baltrush/arm_stuff/ARMInst.ppt) Una buena presentación sobre ARM | |
| 128 | + | ||
| 129 | + | ## Contactos | |
| 130 | + | ||
| 131 | + | [Mazen NEIFER](mailto:mazen@freepascal.org) | |
| 132 | + | ||
| 133 | + | --- | |
| 134 | + | *From the Free Pascal wiki, page "PalmOS port/es", as it stood on 2020-02-23 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |