PalmOS port/es: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	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	2
3	3		## Estado
4	4
5	5		- La versión 2.1.x del compilador tiene soporte (muy experimental) para compilar para PalmOS.
6	6		- La CPU [[ARM]] CPU está soportada.
7	7		- Las siguientes plataformas serán soportadas:
8	8		- Zire72 – version PalmOS: 5.2.8
9	9		- Las unidades RTL de Base no están convertidas.
10	10
11	11		## Tutoría de Construcción
12	12
13	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	14
15	15		### Utilidades binarias cruzadas (Cross binutils)
16	16
17	17		Estas son las herramientas básicas necesarias para crear ejecutables:
18	18
19	19		- arm-palmos-ld : Enlazador
20	20		- arm-palmos-as : Ensamblador
21	21		- arm-palmos-ar : Archivador (Crea archivos de enlace inteligente (smartlinking) .a)
22	22		- arm-palmos-strip: Eliminador de secciones de los binarios ejecutables
23	23
24	24		y algunos otros.
25	25
26	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	27
28	28		### Compilador cruzado
29	29
30	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	31
32	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	33
34	34		### Entorno
35	35
36	36		Suponemos que las fuentes de Free Pascal están aquí: `${FPC_SRC}`
37	37
38		-	~~` ``PATH="/bin:/usr/bin:/usr/bin/X11:/usr/local/bin:${FPC_SRC}/compiler"`~~
	38	+	```text
	39	+	<tt>PATH="/bin:/usr/bin:/usr/bin/X11:/usr/local/bin:${FPC_SRC}/compiler"</tt>
	40	+	```
39	41
40	42		### El proceso de Construcción
41	43
42	44		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	45
44	46		make all CPU_TARGET=arm OS_TARGET=palmos
45	47
46	48		Al finalizar la compilación no debes ver errores.
47	49
48	50		Ahora tendrás el binario `ppccrossarm` en `${FPC_SRC}/compiler` y varios archivos `.o` y `.ppu` en `${FPC_SRC}/rtl/units/arm-palmos`
49	51
50	52		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	53
52	54		### Archivo de Configuración
53	55
54	56		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	57
56	58		#IFDEF FPC_CROSSCOMPILING
57	59		-Tpalmos
58	60		-Fu${FPC_SRC}/rtl/units/arm-palmos
59	61		-XParm-palmos-
60	62		#ENDIF
61	63
62	64		## Compilar un proyecto de Prueba
63	65
64	66		¡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	67
66	68		### Instalar y configurar el emulador
67	69
68	70		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	71
70	72		Cosas para hacer (ToDo)
71	73
72	74		### Compilar
73	75
74	76		El archivo de ejemplo para compilar:
75	77
76	78		``` pascal
77	79		program prueba;
78	80		{$apptype console}
79	81		var
80	82		Str: string;
81	83		begin
82	84		WriteLn('Programa desarrollado con:');
83	85		WriteLn('El compilador Free Pascal');
84	86		WriteLn('');
85	87		WriteLn('Por favor escribe tu nombre:');
86	88		ReadLn(Str);
87	89		WriteLn('Tu nombre es: ' + Str);
88	90		end.
89	91		```
90	92
91	93		Ejemplo de línea de órdenes para compilar `prueba.pas`:
92	94
93		-	~~`ppcrossarm prueba.pas`~~
	95	+	```text
	96	+	<tt> ppcrossarm prueba.pas</tt>
	97	+	```
94	98
95	99		Ahora debes coger el archivo ejecutable `prueba.prc` y copiarlo en tu aparato Palm y ejecutarlo.
96	100
97	101		## Depurando aplicaciones PalmOS
98	102
99	103		Esta sección todavía no está disponible
100	104
101	105		## Construyendo las librerías de FPC
102	106
103	107		Si quieres construir las librerías disponibles para FPC, por ejemplo, quieres construir la FCL, ejecuta las siguientes órdenes.
104	108
105	109		cd ${FPC_SRC}/fpc
106	110		make OS_TARGET=palmos CPU_TARGET=arm PP=ppcrossarm fcl
107	111
108	112		Tendrás las unidades de la FCL en `${FPC_SRC}/fpc/fcl/units/arm-palmos`.
109	113
110	114		## Documentación
111	115
112	116		### notas de la versión PalmOS
113	117
114	118		- 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	119
116	120		## Enlaces
117	121
118	122		- [Buildfaq](http://www.stack.nl/~marcov/buildfaq.pdf) es un FAQ general acerca de cómo crear y configurar FPC.
119	123
120	124		Éstos son algunos enlaces relacionados con la arquitectura de cpu ARM
121	125
122	126		- [ARM Core Developers Forum](http://www.armcorepro.com/) Aunque no muy activa.
123	127		- [GCC ARM Improvement Project](http://www.inf.u-szeged.hu/gcc-arm/)
124	128		- [ARM ASSEMBLER](http://www.heyrick.co.uk/assembler/index.html) Buena información y código relacionados con el lenguaje ensamblador de ARM.
125	129		- [GNU ARM toolchain for Cygwin, Linux and MacOS](http://www.gnuarm.com/)
126	130		- [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	131		- [El juego de instrucciones ARM](http://web.njit.edu/~baltrush/arm_stuff/ARMInst.ppt) Una buena presentación sobre ARM
128	132
129	133		## Contactos
130	134
131	135		[Mazen NEIFER](mailto:mazen@freepascal.org)
132	136
133	137		---
134	138		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).

Back to history