Hace unos días anibarro me pidió que resubiera el pequeño parche que preparé para que el GEEPEE (Emulador de GP32 para PC), funcionara con las librerías de MRMirko.

Bueno pues aun con cierto retraso, por culpa de la aglomeración de trabajo de los últimos días, he añadido el fichero junto con un pequeño “ejemplo+makefile” para facilitar su uso, al artículo sobre el entorno de programación para GP32 bajo Windows.

Un Saludo!

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

PituKa es un emulador para la consola portátil Gamepark GP32 del Amstrad CPC6128.

Mi deseo es que todos disfruteis con el emulador y los que no conozcan esta maravillosa maquina, puedan disfrutar de ella, no hay mas que ver que hoy dia aun siguen saliendo remakes de juegos creados hace muchos años, nada mas ver los lanzamientos de GBA de remakes de NES…

Donwloads Abajo

English

PituKa is an Amstrad CPC6128 emulator for the Gamepark GP32 handheld system.

My hope is that you enjoy this emulator and people who do not know this marvellous machine can enjoy it, even today there are new remakes releases, you only have to llok at the NES remakes released for the GBA.

Donwloads Below!!

ScreenShots!!!

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