Una vez instalado el SDK y Cygwin, teniendo actualizadas todas las libreri­as, podremos empezar a plantearnos qué es lo que queremos hacer y como. Doy por supuesto que habra gente que lea este tutorial con unos mi­nimos conocimientos de C o C++, y gente que no. Con él intentaré mostraros la base de como estructurar vuestros propios proyectos para PSP. Se intentaran dar los primeros pasos; eso si, para los no iniciados en programacion, quiero comentarles que el C no es el mejor lenguaje para empezar a programar.

Organizando nuestros proyectos

Lo primero sera crear una jerarqui­a de las carpetas para organizar nuestros proyectos. Abre una consola bash con el CYGWIN, y teclea mkdir projects y pulsa Enter. Los soportes de este comando "mkdir" parten de  "MaKe DIRectory" y creara un directorio, o la carpeta, en su directorio de funcionamiento actual. Bien, ahora tenemos una carpeta nueva para todos nuestros proyectos, navegamos en ella tecleando cd projects. Ahora creamos otro directorio para un proyecto especi­fico. Por ejemplo mkdir helloworld. Y pasamos al nuevo directorio con el comando cd helloworld.

Nota: Recordar a los no iniciados en el bash, para ver el contenido de una carpeta usamos el comando ls. Para ver los todos comandos del bash, usamos el comando help. Y el comando man (usado adecuadamente, ver help), nos dara una explicacion detallada de cada comando.  No es imprescindible conocerlos todos, pero el ls es basico.

Ahora deberemos hacernos con un editor de textos. Realmente no importa cual uses,  puedes usar el Notepad, Wordpad, el que prefieras; yo me quedo con el UltraEdit. Es preferible usar un editor que sea capaz de identificar el código fuente de C/C++ debido a la que la sintaxis se destaca, las opciones quedan mas claras (mucha gente de la scene usa Dev-C++ ). Pero lo dicho, no importa cual uses, siempre que sepas utilizarlo.

Ahora crearemos un archivo nuevo llamado main.c en nuestro directorio helloworld. Este va a contener el codigo fuente de nuestro programa.

• Apunte

Por si alguno no sabe qué es el codigo de fuente (y sé que habra algunos), el codigo de fuente es lo que escribimos para crear un programa. Se escribe de una manera en que los seres humanos pueden entender. En la mayori­a de los lenguajes, el codigo fuente necesita ser convertido a un formato que el ordenador (o en nuestro caso, la PSP) pueda entender. Éstos se llaman los lenguajes compilados, y englobari­amos C y C++ en esta categori­a (la conversion se hace con el recopilador que instalamos previamente, el SDK). Hay algunos otros lenguajes de programacion que utilizan lo que se llama un intérprete para leer el codigo fuente y compilan el codigo automaticamente. Éstos se llaman lenguajes scripting (un ejemplo de lenguaje scripting es PHP).

Los primeros pasos

Bien, ya tenemos el archivo que llevara nuestro codigo fuente. Ahora necesitamos comenzar a escribirlo. La primera parte del programa debe contener comentarios para decir a cualquier persona que lea nuestro codigo cuál es el objetivo del programa, cuando fue escrito, y quién es el autor. Los comentarios son las li­neas del codigo fuente que se omiten del binario compilado (o saltado por el intérprete en lenguajes scripting). Los comentarios son una parte muy importante del codigo, porque cuando tu (o algun otro) los vuelve a leer para corregir el codigo fuente mas adelante, no recordara todas las intrincaciones del programa. Asi­ pues, puedes dejar notas en forma de comentarios. Los comentarios se señalan con los caracteres // y /* . En cualquier momento cuando ves // sabes que el resto de la li­nea sera un comentario. /* se usa como principio del comentario, el compilador  no hara caso de su codigo hasta que alcanza el final, marcado con */. Un apunte interesante, cuando tenemos algun error en el codigo, al compilar podemos intentar omitirlo marcando esa linea como comentario.

Asi­ pues, vamos a empezar nuestro programa; vamos a dejar un comentario al principio acerca de lo que hace, cuándo fue creado, y quién es su autor.

// Hola Mundo - mi primera Aplicacion para PSP
 
/*
Este programa fue creado por (aquí iria tu nombre) el (aquí iria la fecha)
Es una simple aplicacion "Hola Mundo".
*/ 

La siguiente parte del programa es donde decimos a recopilador qué archivos son principales (header) y cuales se incluyen para utilizar en nuestro programa. Basicamente #include copia el codigo del archivo que indiques en el header del programa. Esto permite que crees un programa simple, mientras que usas el codigo avanzado que ya esta escrito. El directorio include puede incluir cualquier archivo header que viniera con el compilador (o que agregues al compilador), o los archivos header específicos para el proyecto en el cual estes trabajando. La forma de indicar cual de éstos quieres incluir se marca con < > para incluir un archivo o si utilizamos " " comillas para hacerlo. Menorque y mayorque incluyen un archivo del recopilador include el directorio, y las comillas incluyen un archivo del mismo directorio que el archivo, incluyendo ellas. Incluiremos dos archivos en nuestro programa. El primero es pspkernel.h. Este archivo debera incluirse en cada programa que escribas para el PSP. Contiene todo lo especi­fico del codigo para PSP. Tu programa no funcionara en la PSP si no incluyes este archivo. El segundo archivo que vamos a incluir es pspdebug.h. Este archivo contiene varias funciones utiles para eliminar errores de tus programas, pero incluye especi­ficamente la funcion que vamos a utilizar para escribir el texto a la pantalla. Asi­ pues, agregamos este codigo a nuestro programa.

#include <pspkernel.h>
#include <pspdebug.h> 

Ahora diremos a la PSP algo sobre el programa. Ésto no es realmente importante (tu programa compilari­a sin él), pero es siempre una buena opcion para mejorar la compatibilidad. La primera cualidad es el nombre del programa, pero no es realmente el nombre del programa que aparecera (cambiaremos eso mas adelante). Los otros valores son otras cualidades (licencia ajustada solamente), version importante, y version de menor importancia. Dejaremos todos los éstos a excepcion del nombre como valores por defecto. Asi­ pues, agregamos la li­nea siguiente al programa:

PSP_MODULE_INFO("Hola Mundo", 0, 1, 1);

Vamos a instalar la funcion que utilizaremos para escribir en pantalla. Este paso es opcional, pero hace que los programas basados texto sean mucho mas faciles de escribir. Una buena base en esa li­nea (simplificar la escritura), trata en cambiar la funcion en que se construye en la PSP, llamada pspDebugScreenPrintf por algo que sea mucho mas facil de teclear. Esta funcion se utiliza para escribir a la pantalla, y ya la veremos mas adelante. Lo que vamos basicamente a hacer aqui­ es redefinir printf en vez de pspDebugScreenPrintf, para que cada vez que utilizamos printf el recopilador lo trate como si hubiéramos tecleado pspDebugScreenPrintf. Definimos dicho parametro en nuestro programa:

#define printf pspDebugScreenPrintf

Bien, el bloque siguiente de codigo es bastante complicado. Las buenas noticias son que por ahora no necesitamos entenderlo. Dejo una breve explicacion de lo que lo hace (dejaremos la sintaxis real y la explicacion li­nea por li­nea para mas adelante). Lo que esta parte del codigo contiene son basicamente las funciones que seran llamadas por nuestro programa. Las funciones instalaran el programa para funcionar en la PSP y permitiran que no nos preocupemos de si la PSP se bloquea o para salir del programa cuando lo deseemos (pulsando Home). Seguimos añadiendo lineas a nuestro programa:

/* Llamada de salida */
int exit_callback(int arg1, int arg2, void *common) {
          sceKernelExitGame();
          return 0;
}
 
/* Llamada thread */
int CallbackThread(SceSize args, void *argp) {
          int cbid;
 
          cbid = sceKernelCreateCallback("Exit Callback", exit_callback, NULL);
          sceKernelRegisterExitCallback(cbid);
 
          sceKernelSleepThreadCB();
 
          return 0;
}
 
/* Configura llamada thread y vuelve a su thread id */
int SetupCallbacks(void) {
          int thid = 0;
 
          thid = sceKernelCreateThread("update_thread", CallbackThread, 0x11, 0xFA0, 0, 0);
          if(thid >= 0) {
                    sceKernelStartThread(thid, 0, 0);
          }
 
          return thid;
} 

Ahora vamos a definir la funcion principal. Cada programa en C y C++ necesita una funcion principal. Aqui­ es desde donde se ejecuta el codigo. Funciones de C (y algo de C++) en el paradigma proceedural. Esto significa que el codigo entra en una trayectoria linear. Por ejemplo, tenemos el codigo siguiente.

//No pongas esto en el programa.
//Solo es un ejemplo.
 
int myFunction() {
          //Print Out 'A'
          return 0;
}
int main() {
          //Print Out 'B'
          myFunction();
          //Print Out 'C'
          return 0;
} 

Los comentarios (ve al principio este turorial si no recuerdas que son los comentarios) suelen hacer lo que dicen. El programa imprimira B entonces, imprimira A y, para acabar, C, porque el recopilador comienza en la funcion principal. Imprime B, entonces ve la llamada myFunction que se define sobre él y va alli­, ve que necesita imprimir A y después vuelve a donde dejo apagado e imprime C. Todos tus programas (hasta que pasemos a C++ avanzado) seguiran esta estructura linear. Asi­ pues, la funcion mainl es vital para nuestro programa. Para definir una funcion, utilizamos la estructura siguiente: [tipo de retorno] [nombre]() de la funcion {. El tipo de retorno es lo que enviara la funcion de nuevo al programa. Para el main siempre debe ir precedida por int (que estara esperando para ser reinterpretado). El nombre de la funcion es su nombre para la funcion principal, y obviamente sera nombrado como main. Asi­ pues, definimos la funcion poniendo la li­nea siguiente en nuestro programa.

int main() {

Ahora necesitamos agregar dos li­neas mas al sistema para limpiar la pantalla y utilizar esas funciones que pusimos anteriormente (las que dijimos que no hacia falta saber que hacian exactamente). Aunque no necesitamos conocer esas funciones de trabajo, es importante conocer los conceptos de como llamar funciones. Es realmente muy simple. Acabamos de poner el nombre de la funcion con paréntesis en el extremo (y si tomamos cualquier parametro, los pondremos entre paréntesis, pero detallaremos eso mas adelante). Cada li­nea en nuestro programa necesitara un punto y coma al final. La razon de esto es porque el compilador no ve ningun espacio blanco. Entre las li­neas, podri­amos tener 100 li­neas vaci­as, y el compilador ni se enteraria. Esto es util porque permite que nos ajustaremos el formato del codigo como deseemos, de una forma que podamos entender. Podemos agrupar li­neas juntas, o hacer paragrafos segun bloques de funciones de nuestro programa. Pero, alternadamente, al terminar una li­nea, necesitamos un punto y coma. Agregaremos estas dos li­neas a nuestro programa, que poco a poco va cogiendo forma:

pspDebugScreenInit();
SetupCallbacks(); 

Por fin ha llegado la hora de escribir nuestro propio codigo, en el cual realmente podremos ver los resultados que de en nuestra PSP. ¿Recuerdas cuando definimos pspDebugScreenPrintf como printf? Bien, ahora es el momento de utilizar dicha funcion. La forma en que imprimiremos el texto en la pantalla  sera llamando la funcion del printf con un parametro (ya dije que lo mirari­amos mas adelante). Un parametro es una variable que podemos pasar a una funcion para su uso. Nos servira de caso practico mas adelante, cuando estemos escribiendo nuestras propias funciones. Asi­ pues, para mostrar printf en la salida a la pantalla, necesitamos pasarle una secuencia. Haremos salir Hola Mundo pasando esa secuencia a la funcion. Printf es una funcion de gran alcance porque podremos también utilizarla para hacer salir otras variables por la pantalla. Pasari­amos éstos como otros parametros, pero como todo, vendra a su debido tiempo. Por ahora, imprimiremos Hola Mundo en la pantalla, que ya es un avance:

printf("Hola Mundo");

Ahora necesitamos acabar algunos detalles, y entonces nuestro codigo de fuente estara listo para ser compilado. Necesitamos detener brevemente nuestro programa de modo que podamos ver la salida. Si no lo hiciéramos asi­, apenas podríamos ver el texto y volveri­amos rapidamente al menu de la PSP. Nunca conseguiri­amos ver nuestra hermosa frase en la pantalla porque se borrari­a tan rapidamente que no nos dari­a tiempo a leerla. Asi­ pues, agregaremos la siguiente línea para detener brevemente el programa, hasta pulsar el boton Home y enviar al usuario de nuevo al menu principal de la PSP.

sceKernelSleepThread();

Ahora necesitamos dar a nuestra funcion un valor de retorno; recordad cuando definimos ("int main()"), dijimos al compilador que volviera un numero entero.  Le decimos que vuelva a 0 (que es un cero, no un O mayuscula') teclando la siguiente li­nea:

return 0;

Y finalmente, terminamos la funcion poniendo el si­mbolo de cierre:

}

¡Y eso es todo!  Ahora tenemos que decirle al compilador como deseamos compilar este proyecto creando un makefile.  Crea un archivo nuevo llamado makefile sin el extension.  Una vez creado, lo abrimos con nuestro editor, e introducimos las siguientes lineas.

TARGET = hello
OBJS = main.o
 
CFLAGS = -O2 -G0 -Wall
CXXFLAGS = $(CFLAGS) -fno-exceptions -fno-rtti
ASFLAGS = $(CFLAGS)
 
EXTRA_TARGETS = EBOOT.PBP
PSP_EBOOT_TITLE = Hola Mundo
PSPSDK=$(shell psp-config --pspsdk-path)
include $(PSPSDK)/lib/build.mak

Podremos utilizar este makefile como base para todos nuestros futuros proyectos simples. Necesitaremos a veces agregar bibliotecas o el whatnot a este archivo, pero por ahora nos funcionara bien éste.  Basicamente, dice al compilador que tome main.c y lo construya usando el PSPSDK en un archivo con extension pbp que la PSP pueda leer. Solo necesitaremos cambiar, en el caso que queramos usar el makefile en otros proyectos, la línea donde dice PSP_EBOOT_TITLE = Hola Mundo. Podemos cambiar donde dice Hola Mundo al ti­tulo que queramos para futuros programas, ese sera el nombre que aparecera en el menu de juego de la PSP cuando seleccionemos el homebrew.

Una vez lo tenemos todo, abrimos un bash shell de CYGWIN en el directorio de projects/helloworld.  Teclea make y en el bash debe mostrarte algo de informacion. Te dira si tu codigo fuente tiene algun error que lo haga incompilable.  Generalmente, si le da algunas advertencias, no muestra mucho texto. Los errores son para lo que se revise el codigo por posibles errores, las advertencias son apenas los puntos posibles que podri­an causar Bugs.  ¡Si no te ha mostrado ningun error, ¡¡Felicidades!!  Hemos creado con éxito y compilado nuestra primera aplicacion para la PSP. Seguro que estas ardiendo en deseos de probarlo en tu PSP.  Asi­ pues, copiamos C:/cygwin/home/yourUserName/projects/helloworld/EBOOT.PBP en una carpeta con el nombre que queramos en la carpeta PSP/GAME de la PSP e intentamos cargarlo como si se tratara de otro homebrew.

Nota: Recordad que para que funcione en firmware 1.50 habria que instalarle el Kxploit, con el PSP Brew es muy facil. Para firmwares 2.0 no hace falta.