A.G.E.S. Pantalla de Arranque

Características principales

• Incluye pyRetro un FrontEnd pequeño, muy rápido y de uso sencillo.
• Ahora funciona con las xorg en lugar de la consola de la vieja versión (0.00.1e), que permitirá nuevos emuladores y aprovecharemos la aceleración OpenGL de las tarjetas modernas.
• Mame 0.143 + hiscore y groovy patches (incluye switchres para generar los modos nativos como antiguamente se hacía con advmame)
• Kernel 2.6.38.8 + ArcadeVGA parches de groovy (permite tener desde el arranque 15Khz).
• xorg-radeon 6.14.99~git 20110811 + ArcadeVGA ages-fix (permite resoluciones menores de 320×240 en las xorg)
• libsdl-1.2 + switchres patch.
• OpenPPJoy 0.4z preconfigurado (Controles Arcade Usando LPT).
• Modos Entrelazados totalmente operativos (en la anterior versión desde consola no funcionaban correctamente).

Todos los parches usados están en el live en la ruta /opt/ages y /opt/pkg

Por Hacer

• RC2: Terminar Ages-Setup y añadir updater.
• RC3/Final: Añadir soporte de otros emuladores en pyRetro y añadirlos a la release final, mame 0.106?

Testeo

Puedes instalarla/probarla desde un pendrive, hay más info en la web de ubuntu: http://www.ubuntu.com/download/ubuntu/download (Try it)

Página Oficial/Bugtracker: https://forja.rediris.es/projects/ages

RC1a fallos conocidos

• En modo arcade no aparece la pantalla de inicio, si lo hace a 30Khz (algo falla en plymouth, investigar)
• Cuando hay un crash de MAME la pantalla continúa a la resolución del juego (añadir un xrandr al volver?)

Downloads, Videos y tutoriales sobre A.G.E.S. abajo

English

Arcade Genuine Entertainment System (A.G.E.S.) is a little live system exclusive for arcade cabinets. The goal is to get a minimal but usable system that allows easy playing emulators and opensource videogames.

A.G.E.S. Boot Screen

Features

• Include pyRetro FrontEnd little but easy, stable and quick work.
• Using xorg  no more console commands are need it to configure the basic system.
• Mame 0.143 + hiscore and groovy patches (includes switchres to generate arcade native modes like advanceMAME)
• Kernel 2.6.38.8 + ArcadeVGA patches from groovy (boot on 15Khz).
• xorg-radeon 6.14.99~git 20110811 + ArcadeVGA ages-fix (resolutions bellow than 320×240 on xorg).
• libsdl-1.2 + switchres patch.
• OpenPPJoy 0.4z preconfigured (Arcade Joysticks using LPT).
• Interlazed modes working with a perfect vsync!

Patches used are included on live, path /opt/ages and /opt/pkg

ToDo

• RC2: To finish ages-setup and his updater.
• RC3/Final: Add support for more emulators on pyRetro Frontend.

Tests

You can try AGES from CD or using a USB/Pendrive, more info at ubuntu site: http://www.ubuntu.com/download/ubuntu/download (Try it)

Oficial Site/Bugtracker: https://forja.rediris.es/projects/ages

RC1a Bugs

• In Installed system (at 15khz) splash do not appear, working on 30Khz test (something wrong on plymouth?)
• When MAME is crashed, screen still on game resolution (add xrandr?)

Downloads bellow…

Videos

Tutorial Videos

La verdad que cuando empiezas a programar para el linux de Dingoo, ves que usando SDL todo funciona a la primera, pero el problema empieza a surgir cuando pasas de SDL e intentas optimizar las cosas por ti mismo, accediendo a los dispositivos directamente y para eso hay que currarselo mucho y lo peor es que la información es escasa y desperdigada.

Pues aprovechando el puente he creado unos tutoriales a partir de todas las consultas que me han llegado de como inicializar, o diferentes modos de usar el pad, etc… espero ayuden a cualquier desarrollador que quiera comenzar a crear o portar su software preferido a dingux.

Aviso que no son un paso a paso son más bien consejos y código hecho, pero espero que ayuden igualmente.
http://www.dingoowiki.com/index.php/Development:Tutorials

Un Saludo y cuando pueda los pasaré a un tutorial en el blog, por si se pierde algún día el wiki

Estoy reventao, la dingoo anoche pudo conmigo, hasta las 6am me tiré trasteando y todavía le queda batería a la condená xD
Pero hago una pequeña introducción para el que no conozca esta pequeña joya china.

La dingoo, es una consola pequeña, poco más o menos como una gameboy micro; muy potente, overclockeable hasta 400 Meganapios, no usa pilas (BIBA!) sino una batería Li-Ion con 7 horas de autonomía según wikipedia, pero que anoche me fundió a mi y estuve toda la tarde/noche/madrugada con ella y aun tiene 2/3 lineas

Lo que más me ha atraído de la consola, no son los números sino el precio (unos 50 euros – envío gratis y llegó en un par de semanas), su tamaño, que tenga una radio FM y como no la gran comunidad que se ha creado alrededor de ella con la salida del Hack (thx Booboo), que permite instalar en ella un Dual Boot Fw-Original/Dingoo-Linux. El cual se realiza en un minutillo y te abre infinitas posibilidades

La verdad que todo lo que he probado me ha ido bien, los emuladores más pesados como el de SNES (Use un Hack de Mario World que posteó Dj_syto) que en el FW original da tirones, en dingux me iba muy bien. El emulador de spectrum (port directo de GP2x), todo lo que probé también me fue bien, el FBA va perfecto que increíblemente suave va el Street Fighter II, el Cadillacs, los juegos de Neogeo (pobré el WindJammers, PowerSpikes).

Luego otros ports como el Hexen o el Heretic, ya si que petardeaban pero al ver lo bien que va Doom, tengo claro que es un problema más debido a ser un port rápido que a la propia consola, seguro que con más tiempo la cosa se arregla

Total, que aun estoy trasteando esta pequeña bestia que sólo le faltaría tener Wifi para ser perfecta (juego online/local tipo NDS sería una pasada), seguro que en los próximos días estaré enseñandoos algo nuevo para ella

Un Saludo dingeroos!

Como características el proyecto incluye un test de ejemplo y permite crear ejecutables de SDL+SDL_mixer+SDL_Image para GP2x (Debug/Release) y Linux (Debug).
Puede ser Fácilmente ampliado, ver más abajo.

Pasos previos

Lo primero que necesitamos es Eclipse, para ello nada más fácil que ir al “Gestor de paquetes Synaptic” e instalarlo, una vez instalado entraremos por primera vez en Eclipse, apareciendo una ventana que nos pedirá la ubicación de la carpeta de trabajo (donde descansarán nuestros proyectos), la seleccionamos y listo

El siguiente paso previo que se requiere es la instalación del plugin que nos permitirá usar la configuración “custom” que he preparado para la GP2X. Si seguís estos pasos no tendréis problema.
Pulsad en: HELP -> Software Updates -> Find and Install… -> Search for new features -> New Remote Site.

Ahora en Name ponemos “CDT” y en URL:
“http://download.eclipse.org/tools/cdt/releases/callisto”
Pulsamos en “Finish”, para que aparezca la lista de mirrors (Rec. Uk).
Finalmente seleccionamos las actualizaciones, esperamos a que se instalen y permitimos que Eclipse se reinicie. Como último paso debemos asegurarnos que la perspectiva C/C++ está seleccionada (Window->Open perspective->Other).

Instalando el proyecto base de GP2x

Una vez descargado (ver abajo), lo descomprimimos en una carpeta que no se encuentre dentro de nuestro directorio de trabajo seleccionado en Eclipse. Por ejemplo mi directorio de trabajo en eclipse es “/home/david/desarrollo” y he descomprimido el fichero en “/home/david/descargas/gp2x”, espero que haya quedado claro, por que es importante

Bien, pues empieza el show: File -> New -> Project… Y seleccionad la opción tal y como aparece en la imagen.

Aparece el diálogo para importar nuestro proyecto de GP2x en Eclipse, seleccionad [Browse]…

Seleccionamos la carpeta descomprimida del proyecto que acabamos de bajar y pulsamos [Aceptar]…

Si todo ha ido bien debería de aparecer algo similar a esto…

Que no se os olvide marcar “Copy project…”

Y poco más, al pulsar [Finish] el proyecto nos aparecerá en la lengüeta de proyectos

Modificando el proyecto base de GP2x

Lo más normal es que cada desarrollador use las herramientas (toolchain) que más le apetezcan. Yo en esta ocasión lo he configurado para que funcione de primeras con el DevKit de Uncanny, pero para que ninguno se tenga que complicar mucho, si desea usar su entorno de desarrollo con Eclipse, dejo unas instrucciones, que seguro también valdrán para que los desarrolladores de Windows puedan adaptar el proyecto base.

Pulsando con el botón derecho encima de nuestro nuevo proyecto de GP2x, seleccionad “Properties” (propiedades) y C/C++ Build…

En el diálogo que aparece por defecto podemos modificar muchos aspectos como agregar librerías o cambiar las opciones de compilación.

Pero para cambiar cosas como el prefijo del compilador (prefix) o la ruta de trabajo he preferido usar variables de entorno que tenéis a vuestra disposición desde la lengüeta “Environment”…

Como se puede observar con cambiar GPPATH y/o PREFIX-TOOL, lo tendríais configurado para la mayoría de entornos de desarrollo

Por Hacer

Seguro que algún fleco se me ha quedado suelto, así que iremos mejorando este tutorial, poco a poco
La verdad que lo suyo sería hacer una especie de perspectiva para desarrollar en GP, y que pudieramos crear también ejecutables de GP32, etc…

Bueno, es un comienzo

Español

See the english version of this text below

La librería no tiene dependencias externas de SDL, libxml o similares, como la librería “oficial” de lectura de INIs que por ejemplo se usa en GP2X. Y lo mejor pesa muy poquito -unos 6kb- y es bastante rápida, aunque seguro que se podría mejorar, así comparte tus mejoras

La librería lee dos tipos de ficheros INI tipo, M$ (los que todos conocemos), o tipo “conf” de linux.

Un fichero INI podría ser algo como esto:

[General]
    name = Junk Config File Test
    version = 2

[Mode]
    StrictMode = yes
    useflags = no
    phase = 5

[OtherSection]
    name = Hello

[AnotherSection]
    name = Bye

Ejemplo Práctico

Su uso es muy simple:
- Primero abrimos el fichero, que podría ser algo como:

    if(!cfgOpen("./configs/ejemplo.ini", MS_STYLE))
    {
       //no encontre el fichero
    }else
    {
        //fichero leido!
    }

- Una vez abierto, hay que elegir una sección que la librería se encargara de buscar. Para seleccionar una sección seria:

    if(cfgSelectSection("General"))
    {
        //haz lo que sea...
    }else
    {
        //pues se ve que no la encontro!!! xD
    }

- Una vez seleccionada se pueden pedir datos de la misma usando funciones para cadenas, números y booleanos… unos ejemplos finales:

        currentVersion = (Uint8) cfgReadInt("version", 1);

Ex: Lee la variable versión del fichero INI y la almacena en nuestra variable, currentVersion.
(El numero del final es un valor por defecto, por si no lo encuentra, etc.)

Finalmente cuando hemos terminado de trastearla debemos hacer, simplemente:

    cfgClose();

La ventaja de usar ficheros INI es que puede hacer cambios en las configuraciones de sus programas y ver los cambios sin que se requiera una nueva compilación. Y si luego lo necesita siempre podría encapsular todo el código “INI” en un fichero binario…

Para acceder a más ejemplos vea la documentación de la libreria

English

LibReadINI is a library to read INI files, developed in C code.

Now you can read your game/program INI files on your GP32 and other embeddeds platforms that can run a C code!!

Dont have any external dependencies (SDL, libxml, etc…)
Little -6kb- and quick code, but if you can make a better code, share your changes

Examples and more info on the library`s documentation

Is used by… / usada por…

• Abalon – The RPG Engine by D_Skywalk (GP32 / GP2x)
• Game Launcher by Monthy (MSDOS)

If you used this lib email me, thanks!
Si usas esta librería mándeme un email, gracias!

SPANISH

English version bellow

GP2X Toolchain

El entorno de desarrollo para GP2X, tiene como objetivo una compilación que permita ejecutables que ocupen casi cien veces menos, un simple programa pasa de 500kb a 5kb si evitamos la compilación estática; y el arranque instantáneo, gracias a utilizar las librerías que todos tenemos instaladas dentro de nuestra GP2X.

No obstante, el entorno no obliga a nada y puedes seguir compilando estáticamente sin problemas

La versión actual incluye:

LINUX HEADERS: 2.4.25-GP2X
BINUTILS: 2.16.1
GLIBC: 2.2.5
GCC: 3.4.6

Y puedes bajarla de aquí.
El espacio ha sido cedido por el proyecto AGES en la Forja de REDIRIS.

Para instalarla abre una consola como root y entra en la carpeta donde hayas bajado el paquete y escribe:

# tar xvjf toolchain-linux*.tar.bz2
# mv gp2x /opt

También puedes bajar el toolchain completo de Uncanny que incluye además sus librerías SDL a parte de los compiladores y utilidades.
El espacio ha sido cedido por el proyecto AGES en la Forja de REDIRIS.

Para instalarla abre una consola como root y entra en la carpeta donde hayas bajado el paquete y escribe:

# tar xvjf toolchain-uncanny*.tgz
# mv gp2xdev /usr/local/

GP2X Development SDL Library

Para esta parte he preparado una librería para escena la escena que llamaremos “Community” y la compararé con la oficial de GPH.

Cada una de ellas contiene, a no ser que se indique lo contrario:

SDL: 1.2.9 (Paeryn) Community - 1.2.7 Oficial
SDL_mixer: 1.2.7 (oficial sin soporte smeg) [WAV, MOD (mikmod), MP3 (smeg), OGG (tremor)]
SDL_image: 1.2.4 [JPG, PNG]
SDL_ttf: 2.0.7
SDL_gfx: 2.0.13 (solo Community)
SDL_sound: 1.0.1 (solo Community) - [WAV, VOC, MP3 (no smeg), MID (timidity), MOD (modplug), OGG (vorbis), RAW, AU, AIFF]
libMAD: 1.15.b
libId3tag: 1.15.b (solo Community)
libUniCodeFont (solo Oficial)

Tened encuenta que si usáis librerías no incluidas en la consola deberéis compilar estáticamente.

La versión de “community” la puedes bajar de aquí.
La versión oficial la puedes encontrar en el foro de desarrolladores de GP2X.

Para instalar la versión de la escena seguid estos pasos como root:

# tar xvjf gp2x-libs-community*.tar.bz2
# cp -R gp2x-libs-community/* /opt/gp2x

GP2X / GP32 IDE

Desde aquí iré preparando platillas o entornos de trabajo para IDEs disponibles en cualquier distribución Linux.

Esta versión aun no es perfecta y aun gustaría añadirle cosas, pero es perfectamente funcional y si os animáis a ayudarme a perfeccionar el entorno para GP32, quizás en poco tiempo podamos compilar, a un click de distancia, para: GP2X, LINUX y GP32

Puedes bajar desde aquí la versión 0.5 (RC1a) de las plantillas para GP2X.

Ahora instalaremos la plantilla. Entra como root en la carpeta donde lo descomprimieras y ejecuta:

# tar xvjf gp2x-template*.tar.bz2

Ahora sería un buen momento para leer el fichero “LEEME.TXT” y así saber las novedades y/o problemas conocidos de las plantillas que te dispones a instalar… Ahora sigue las instrucciones de instalación de las plantillas

Además he preparado un pequeño tutorial para empezar a desarrollar con todo este entorno en linux.

Feliz desarrollo!!

English

GP2X Toolchain

This development enviroment for has two objetives:
- Reduce weight of your binary files (500kb to 5kb using shared linking)
- More quick load (you use the libs installed on your GP2X)

But this toolchain allow static linking if you want

This version includes:

LINUX HEADERS: 2.4.25-GP2X
BINUTILS: 2.16.1
GLIBC: 2.2.5
GCC: 3.4.6

You can download here the last toolchain.
Mirror donated by AGES Project on REDIRIS Forge.

Install instructions: Login as root and in your download directory do:

# tar xvjf toolchain-linux*.tar.bz2
# mv gp2x /opt

Also you can download the Uncanny toolchain with SDL libs included.
Mirror donated by AGES Project on REDIRIS Forge.

Install instructions: Login as root and in your download directory do:

# tar xvjf toolchain-uncanny*.tgz
# mv gp2xdev /usr/local/

GP2X Development SDL Library

SDL: 1.2.9 (Paeryn) Community - 1.2.7 Oficial
SDL_mixer: 1.2.7 (official without smeg support) [WAV, MOD (mikmod), MP3 (smeg), OGG (tremor)]
SDL_image: 1.2.4 [JPG, PNG]
SDL_ttf: 2.0.7
SDL_gfx: 2.0.13 (only Community)
SDL_sound: 1.0.1 (only Community) - [WAV, VOC, MP3 (no smeg), MID (timidity), MOD (modplug), OGG (vorbis), RAW, AU, AIFF]
libMAD: 1.15.b
libId3tag: 1.15.b (only Community)
libUniCodeFont (only Official)

Community Version Download.
You can download the Official libs from GPH development forum.

Community Install instructions: Login as root and in your download directory do:

# tar xvjf gp2x-libs-community*.tar.bz2
# cp -R gp2x-libs-community/* /opt/gp2x

GP2X / GP32 IDE

You can download the templates for KDevelop version 0.5 (RC1a) here.

Install instructions: Login as root and in your download directory do:

# tar xvjf gp2x-template*.tar.bz2

Now its the time to see README.TXT for install and use instructions

Happy Codding!!

Este tutorial supone que tienes instalado ya tu entorno de trabajo (o toolchain) y que el siguiente paso que quieres dar es programar algo y ver como queda

Una vez arrancado KDevelop (por ejemplo en su version C/C++) vamos a proyectos y nuevo proyecto:

C -> GP2X

Ponemos el nombre de nuestro futuro proyecto y siguiente

Ahora personalizaremos nuestro proyecto preparando las plantillas que se incluiran en cada fichero del proyecto.

Una vez esta todo creado aparecera el entorno de trabajo de nuevo con un pequeño ejemplo, lo siguiente sera seleccionar desde el menu de Proyectos el tipo de fichero a generar, tal y como veis en la imagen inferior:

Aunque haya una opcion para GP32 esta aun esta en desarrollo, si la conseguis modificar para que os genere binarios de GP32 enviadme los parches para que los publique

Ahora solo queda generar el ejecutable deseado pulsando F8 o desde el menu:

CONSTRUIR -> CONSTRUIR PROYECTO

Momento en el que aparecera un pequeño monitor que nos ira ofreciendo la informacion sobre la construccion de nuestro proyecto…

Y listo! ya tenemos nuestro ejemplo compilado, el ejemplo que trae por defecto necesita que copieis un BMP en la misma carpeta que el ejecutable. Si quereis verlo… ¡a que esperais!

Rosa, Rosa, Rosae…

UPDATE: Como Documentar y hacer uso de librerías

Para animar un poco más a los indecisos, he preparado un ejemplo que espero que muestre, aunque sólo sea superficialmente, la potencia y profesionalidad que puede dar a nuestros proyectos Kdevelop.

Este ejemplo, que es una modificación del test basico de GP2x y Linux, una de las intenciones es que podáis ver lo fácil que es documentar completamente vuestro código (usando la opcion Build API Documentation), para ello Kdevelop usa doxygen, que permite generarla automaticamente en: PDF, HTML, RTF, XML… Os dejo un ejemplo de la documentación HTML que genera.

Además este ejemplo hace uso de librerías para que también comprobéis otras formas de trabajo; subarrendando tareas a las diferentes partes de vuestro proyecto, como: una libreria gráfica, de personajes, IA, …

Pulsad aquí para bajar el ejemplo de uso de librerías y documentación.
Para instalarlo sólo descomprimidlo en vuestra carpeta de desarrollo y abrid el proyecto desde Kdevelop.

Notas para Usuarios Avanzados

Si quereis usar vuestro toolchain podeis cambiar las opciones de compilacion desde el menu:

PROYECTO -> OPCIONES DEL PROYECTO -> OPCIONES DE CONFIGURE

Desde el menu despegable de Configuracion seleccionais la configuracion a cambiar:

Por ejemplo si vuestro PATH es diferente aqui tendriais seleccionada la parte a cambiar…

Si nuestro compilador tuviera un nombre diferente al oficial (arm-gp2x-linux-gcc) desde la lengüeta C podreis renombrarlo:

Listo, espero que os sea util y lo disfruteis

Empezaremos preguntándonos: ¿Y que es XHTML?
- Básicamente se trata de coger el viejo y maltratado HTM y fijar unas reglas estrictas para devolver la L (Language) a nuestro compañero inseparable en esta gran red de redes

Se trata, por lo tanto, de usar cada etiqueta para el uso que explícitamente se creó. Por ejemplo, un servidor tenía la (mala) costumbre de hacer las típicas cajas de información usando tablas e imágenes dentro de ellas y claro esto, ahora ya no se permitiría…

La idea es que en el XHTML sólo encontremos el CONTENIDO de la web y nada más. Que se dice rápido, pero es algo que sin duda, cuando nos enfrentemos, a ello costará ser fiel… y en realidad yo no lo veo tanto culpa nuestra, sino quizás unos navegadores demasiado “permisivos”, que nos han mal acostumbrado años ha…

Por eso cuando hace pocos días me preguntaba SpankThru: ¿Y no es mejor saber algo de HTML antes de enfrentarte a XHTML?
Pues, evidentemente no. Ya que sufrirás lo mismo que le pasa al conductor que ha cogido el coche por sí mismo (o le ha enseñado otro conductor) que termina cogiendo ciertos malos hábitos, que luego costará sangre y sudor, no cometer

Si seguimos las directrices del W3C obtendremos algo como esto…
- !!¡¡DIOS MIO!!! ¿!¿!HEMOS VUELTO A LOS AÑOS 80!??!?!
- No hombre, no no te pongas nerviosillo, si aun no hemos empezado… xD

El ejercicio que quiero que hagas ahora es que veas el código fuente de la web, que aunque no esté muy bien indentado, verás que todo es perfectamente legible y sobretodo muy liviano. Atrás quedan aquellos HTM de 50Kb, esos mastodontes donde buscar la tabla que se había descuadrado era una tarea de chinos

La verdad que cuando usas esta tecnología te das cuenta de la cantidad de ventajas que rápidamente te da:

• Preguntémonos ¿Que indexará mejor google?
  Una página con miles de tablas y campos donde se mezcla contenido y diseño o…
  El ejemplo anterior, donde además cada etiqueta está cumpliendo su objetivo…
  Evidentemente, google lee ese mismo código que antes vimos y nos indexa antes, más facilmente y nos puntúa mejor… poned en google “David Colmenero” o “D_Skywalk” por si no lo tenéis muy claro aun xD
• Sera más fácil de mantener e incluso añadirle nuevas secciones o contenidos…
• Permitirá que personas con discapacidades puedan acceder sin problema a sus contenidos y la información por lo tanto se convertirá en universal…
• Dada su simplicidad cualquier navegador de mañana o prejurásico puede comprender y mostrarte sin problema el contenido de la web, ej: Visitad la web con Lynks
• Por último, en futuros capitulos veras, que NUNCA MÁS el contenido estropeará o dictará sobre el diseño; ya que como comprobarás ambos serán totalmente independientes. Pero no adelantemos acontecimientos…

- Muy bien todo, pero sigo sin estar del todo convencido: ¿Como meto ahí mis fantásticos diseños?

Pues ahí es donde entrará en juego la segunda parte de estos artículos: CSS2.
Pulsad aquí para comprobar los resultados y fijaos que lo único que cambia entre uno y otro es la línea que define el uso de las reglas CSS:

	@import "/diseno/base.css";

Si he conseguido captar vuestra atención y queréis experimentar empezad instalándoos las extensiones de firefox que veas más útiles desde esta web. Personalmente yo uso: Webdeveloper, MeasureIt, Colorzilla y TidyHTML (animáos a usar este y veréis que pocas webs cumplen el estándar escrupulosamente).

Otros fantásticos sitios donde empezar a leer sobre estos temas son:
- blog.levhita.
- 100 Pixels.
- Escuela W3.

Y Finalmente para que veas la potencia de XHTML+CSS:
http://www.csszengarden.com/?cssfile=024/024.css
http://csszengarden.com/?cssfile=/195/195.css
http://csszengarden.com/?cssfile=/188/188.css

[CONTINUARÁ]

Este entorno esta pensado para que podamos trabajar desde Windows, testeando nuestros programas en Zuindows y cuando realmente queramos ver como “anda” en la GP compilamos para ella ese mismo source y lo pasamos a nuestra SMC viendo el resultado final. Con esto yo me he ahorrado algun quebradero de cabeza y menos gasto de pilas al no tener que compilar cada vez, etc… Todo ello sin contar lo utiles que son las librerias en si

Si quereis mas informacion de como usarlas y aprovechar el trabajo de Chui: www.libsdl.org

Lo primero que debes hacer es decidir la ruta de donde quieres que descanse tu entorno de desarrollo, en este tutorial voy a usar:

C:\DevkitPro

Si tu deseas usar una ruta o unidad diferente, ten encuenta luego los cambios

Primero necesitamos compilador y librerias para gp32:

devkitARM_r11-win32.exe (este es el que uso yo)
o
devkitARM_r15-win32.exe (la ultima version a dia de hoy)

http://sourceforge.net/project/showfiles.php?group_id=114505&package_id=124207 (todas las versiones)

Yo os recomiendo que bajeis la r11, aunque sea mas antigua es la version con la que Chui ha compilado sus librerias de SDL y puede que os de problemas usar una version diferente del compilador, mi recomendacion es que bajeis esto:
http://prdownloads.sourceforge.net/devkitpro/devkitARM_r11-win32.exe?download

Aunque siempre teneis la opcion de bajaros los Sources de Chui y compilarlos para vuestra version de GCC:

http://prdownloads.sourceforge.net/sdl-gp32/sdl4gp32-src-28082005.tar.bz2

Dicho esto, descomprimimos en el directorio donde hayamos elegido anteriormente, en mi ejemplo C:\DevkitPro

Y si ves que el directorio del “devkitARM” tiene un nombre diferente como: “devkitarm_rXX” renombralo para que quede como: “devkitARM“.

Ahora bajamos de http://www.mingw.org/download.shtml

MinGW-4.1.1.exe
Y
MSYS-1.0.10.exe

y los instalamos en nuestro directorio de devkitPRO…

Cuando termine la instalacion de Msys, apareceran unas preguntas que nos preguntaran donde tenemos instalado el MinGW, debes decirle la ruta con la barra del “7” (mira el ejemplo). Yo por ejemplo tengo: “C:/devkitpro/MinGW”

Añadimos las variables necesarias de entorno de usuario y de sistema:

Os dejo un screenshot de ejemplo y mis rutas, solo amoldadlas a la ruta que vosotros hayais elegido…

En sistema cambiamos el PATH:

C:\devkitPro\MinGW\bin;C:\devkitPro\msys\bin;C:\devkitPro\devkitARM\bin

Y en usuario agregamos tres nuevas variables:

DEVKITARM || /C/devkitPro/devkitARM
DEVKITPRO || /c/devkitPro
GP32PATH || /opt

Para saber que tenemos bien instalado el entorno entramos en MSYS y ejecutamos:

skywalker@SSTT ~
$ arm-elf-gcc --version
arm-elf-gcc.exe (GCC) 3.4.3
Copyright (C) 2004 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

skywalker@SSTT ~
$ gcc --version
gcc.exe (GCC) 3.4.2 (mingw-special)
Copyright (C) 2004 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

La version 3.4.4 es de la r11, si bajasteis la r15 o una superior supongo que sera algo como: 4.x.y

Bien si tenemos este resultado ya tenemos nuestro entorno listo, sino volved a repetir los pasos anteriores por que algo habeis olvidado

Antes de continuar necesitamos crear un directorio para alojar nuestros ficheros…

en MSYS ejecutamos:

$ mkdir /opt

Ahora vamos a instalar el SDL oficial (x86), para compilar aplicaciones en Windows y que nos sirva de testeo; Chui usa la version 1.2.8 y aunque la ultima oficial es la 1.2.9 mejor ceñirnos a la version que usaremos en la gp para evitar posibles problemas

http://www.libsdl.org/release/SDL-devel-1.2.8-mingw32.tar.gz y lo guardamos en el directorio /opt (lo encontrareis en msys\opt)

y ahora siguiendo un poco el tutorial que tiene chui en su pagina hacemos:

$ cd /opt/

$ tar xzvf SDL-devel-1.2.8-mingw32.tar.gz

$ cd SDL-1.2.8/

$ mv bin/* /usr/bin/

$ mv include/SDL /mingw/include/

$ mv lib/* /mingw/lib/

(ahora estos pasos creo que no son estrictamente necesarios pero los haremos no obstante )

$ mkdir /usr/share

$ mkdir /usr/share/aclocal

$ mv share/aclocal/* /usr/share/aclocal/

Ahora renombramos el archivo de configuracion que usa SDL:

$ cp /usr/bin/i386-mingw32msvc-sdl-config /usr/bin/sdl-config

Ahora debemos editar el archivo sdl-config que tenemos en MSYS/BIN

En la primera linea tenemos algo como:

prefix=/usr/local/cross-tools/i386-mingw32msvc

Pues lo cambiamos a nuestro entorno:

prefix=/mingw

Guardamos y ejecutamos de nuevo en MSYS:

$ sdl-config --cflags

Que dara como salida:

-I/mingw/include/SDL -Dmain=SDL_main

Por ultimo (paso opcional) vamos a comprobar que el SDL esta correctamente instalado compilando los test, en MSYS ejecutamos:

$ cd /opt/SDL-1.2.8/test/

$ ./configure

y empezara a compilar, si nos diera un problema algo asi como…

Checking for sdl-config... no

Es que no puede encontrar el fichero de configuracion, vuelve a mirar el paso donde lo copiamos mas arriba…

checking for SDL - version >= 1.2.7... no
*** The sdl-config script installed by SDL could not be found
*** If SDL was installed in PREFIX, make sure PREFIX/bin is in
*** your path, or set the SDL_CONFIG environment variable to the
*** full path to sdl-config.
configure: error: *** SDL version 1.2.7 not found!

Es que la ruta del fichero sdl-config no es correcta, revisa el fichero de nuevo

Si todo fue correcto el resultado tiene que ser algo como esto:

checking for sdl-config... /bin/sdl-config
checking for SDL - version >= 1.2.7... yes
checking for OpenGL support... yes
configure: creating ./config.status
config.status: creating Makefile
config.status: executing depfiles commands

skywalker@SSTT /opt/SDL-1.2.8/test
$

Bien, ponemos “make” y a esperar un poquito mas

Es posible (aunque no deberia) que en uno de estos pasos nos dijera que no puede encontrar la SDL.dll (o similar) teneis esa dll en msys\bin os la pide por que no puede encontrarla en el sistema, para solucionarlo copiadla en vuestro directorio de “windows” o en “windows\system” para ser algo mas correctos

Si todo va bien podriamos ejecutar sin problemas, por ejemplo:

$ testsprite.exe
$ testgl.exe
$ testalpha.exe
....

Listo ya podriamos compilar un programa en windows pero aqui hemos venido a trabajar para nuestra querida GP32, ¡¡Pues vamos a ello!! xD

Bajamos los ficheros necesarios de http://prdownloads.sourceforge.net/sdl-gp32/?sort_by=date y los guardamos en opt

http://prdownloads.sourceforge.net/sdl-gp32/sdl4gp32-precompiled-28082005.tar.bz2

Y/O

http://prdownloads.sourceforge.net/sdl-gp32/examples-src-28082005.tar.bz2 (opcional para compilar los ejemplos)

$ cd /opt

$ tar xjvf sdl4gp32-precompiled-28082005.tar.bz2

Y si queremos tambien compilar los ejemplos:

$ cd

$ mkdir gp32

$ cd gp32

$ tar xjvf /opt/examples-src-28082005.tar.bz2

Ahora entramos en cualquier ejemplo y lo compilamos…

$ cd fonts/

skywalker@SSTT ~/gp32/fonts
$ make
arm-elf-as   -o crt0x_gp32.o crt0x_gp32.s
arm-elf-gcc -I/opt/include/SDL -I/opt/include -mtune=arm920 -march=armv4t -marm -mno-thumb-interwork -msoft-float -ffast-math -nostdlib -fno-common -ffreestanding -fno-builtin -fno-exceptions -mstructure-size-boundary=8 -fomit-frame-pointer -fstrict-aliasing -O6  -DGFXST -DGP32 -DGP32_LIBC -Wall -Wno-switch -DUSE_FIXED_POINT    -c -o fonts.o fonts.c
arm-elf-ld -Map fonts.map -nostartfiles --script arm-gp32bin.x -L/opt/lib crt0x_gp32.o  fonts.o -lSDL_gfx -lSDL_image -lSDL -lpng -ljpeg -lz -lc -lm -lgcc -o fonts.elf
arm-elf-objcopy -O binary fonts.elf fonts.gxb
b2fxec fonts.gxb fonts.fxe

b2fxeC v0.5d BETA - (c) 2002-4 Jouni `Mr.Spiv` Korhonen

Crunched 54.3% - total 189808 bytes

El siguiente paso es añadir las librerias especificas para windows de: SDL_Image, SDL_Mixer, SDL_flic, SFont y SDL_gfx…

[TEMPORAL RC-2]

Bajad el fichero de mi web: http://gp32.dantoine.org/ (Noticia del 8 de Septiembre) o directamente de aqui

Leed la documentacion y reemplazad si actualizais de una version anterior.

TODO: Soporte para GPX2? jejej :p

Ahora quizas os venga bien saber como generar un proyecto para SDL, pulsa aqui para acceder al tutorial de MAKEFILEs.

Espero que os sirva, si teneis alguna duda o he cometido algun fallo ya sabeis comentadlo

Un Saludo y EOF

¿Para que sirve un Makefile?

Un Makefile contiene todos los pasos para generar (compilar) nuestro programa. Un programa se compone basicamente de librerias (que son un conjunto de utilidades que facilitan nuestra labor), nuestros ficheros del programa y de como debe “montar” nuestros ficheros (optimizaciones).

Quiero preparar mi proyecto ¿que ficheros necesito para compilarlo?

Lo mejor que podemos hacer es tomar como base alguno de los ejemplos que tenemos en el directorio de GP32, por ejemplo: FONTS.

Lo primero sera crearnos un directorio para nuestro proyecto, que nosotros aqui llamaremos EJEMPLO. Luego de FONTS vamos a coger prestado: “Makefile.win32″, “Makefile”, “crt0x_gp32.s” y “arm-gp32bin.x”.

Ya lo siguiente que necesitariamos seria que codearas un poco y lo guardaras con: “ejemplo.c” (o con el nombre que tu quieras).

¿que necesito conocer para compilar un programa sin problemas?

Bien una vez tenemos nuestro programa codeado y el directorio preparado, necesitamos configurar nuestros MAKEFILEs para que compilen nuestro programa; ya sea para GP32 o para testearlo en Windows.

Tenemos: “Makefile” que son las ordenes/instrucciones necesarias para GP32 y “Makefile.win32″ que seria para generar la version de Win32 (windows).

¿Como creo mi Makefile propio?

Bien para compilar cualquier programa basico solo necesitas modificar 2 secciones de cualquiera de estos dos MAKEFILEs:

Para el Makefile.Win32:

TARGET	=	fonts.exe 

[...]

.CFILES	=	fonts.c

En CFILES debeis poner todos los ficheros que componen vuestro programa, en el nuestro seria solo “ejemplo.c” y en TARGET sera el nombre final que tendra el programa.

Quedando algo como:

TARGET	=	ejemplo.exe 

[...]

.CFILES	=	ejemplo.c

Para GP32 tenemos alguna distincion pero que es practicamente igual, solo que quizas esta menos comodo…

Para el Makefile (GP32):

MAPFILE		=	fonts.map
TARGET_ELF	=	fonts.elf
TARGET_BIN	=	fonts.gxb
TARGET_FXE	=	fonts.fxe

[...]

.CFILES	=	fonts.c

De aqui tenemos que cambiar el nombre de todos los TARGETs de arriba, substituyendo “font” por nuestro nombre, nosotros como de costumbre seguiremos con “ejemplo”, lo demas es como siempre en CFILES poneis todos los “.c” que componen vuestro programa

¿Como compilo para GP32 o para Win32?

Se compila para GP32, usando “make” y “make clean” para limpiar/borrar todo.
Se compila para Win32, usando “make -f Makefile.Win32″ y “make -f Makefile.Win32 clean”, para limpiar/borrar todo.

TODO: Como usar librerias?

Un Saludo y espero que os resuelva algunas dudas, y podais empezar un proyecto básico.