Tutorial: OpenPPjoy - Usa y configura tus mandos arcade LPT bajo Linux. Ayudas compilación y uso

Tutorial: OpenPPjoy - Usa y configura tus mandos arcade LPT bajo Linux. Ayudas para compilación y uso

- Introducción

“OpenPPjoy” es un proyecto open source encabezado por David Colmenero. Se trata de un módulo para poder implementar nuestros joystick arcade conectados al puerto paralelo en máquinas arcade con Linux. El fundamento del interface es el mismo que el del IPP para Windows, salvando la diferencia que en el driver de Linux de momento no es configurable 100% y hay que ajustarse a unos patrones preestablecidos.

En este documento expondré como compilar el módulo e instalarlo, y explicaré cómo van pre-configurados los conductores del cable db25 para poder realizar nuestro IPP y así poder cablear adecuadamente nuestros joysticks.

Las pruebas de OpenPPjoy las he realizado compilando el módulo versión r16 del source con la distribución Ubuntu 10.04 (lucid) y kernel 2.6.32-28-generic (arquitectura i386).

El paquete de distribución de OpenPPjoy dispone de una ayuda en forma de "leeme.txt", sin la que no hubiera podido poner en marcha el módulo (para nada soy un experto en estas cosas) y la cual voy a tomar como base, aclarándolo aún más en la medida de lo que pueda.

El código fuente se ha modificado hace relativamente poco y actualmente el módulo es funcional para las distribuciones de ubuntu 10.04 y 10.10.


- OpenPPjoy - Usa y configura tus mandos arcade LPT bajo Linux. Ayudas para compilación y uso de OpenPPJoy

Vayamos por partes.


El hardware

La construcción del IPP es la misma que se expone en este hilo enfocado para su implementación en Windows: Tutorial: Construcción sencilla de interface de puerto paralelo (IPP) para panel de control arcade (Pincha). La única diferencia para implementarlo en Linux es que los botones no se asignan arbitrariamente a la hora de asignar contactos en el IPP, sino que los botones de los joysticks ya están pre-establecidos.

Si echamos un vistazo a los pines del db25, las conexiones se consiguen cruzando los pines de estado (10, 11, 12, 13 y 15) con los pines de datos (2,3,4,5,6,7,8,9, 1,14, 16,17).



El módulo tiene posibilidad de configurar hasta un total de 5 dispositivos conectados a la vez en un mismo puerto paralelo, a elegir joysticks de 2 axis con 8 botones y/o hasta dos configuraciones preestablecidas de teclado.

Las conexiones de cada dispositivo están asignadas a un pin de estado (pines 10,11,12,13 y 15). Cada uno de los botones del dispositivo se corresponden con cada uno de los pines de datos (2,3,4,5,6,7,8,9, 1,14, 16,17). Así, las conexiones del primer joystick que podremos configurar las sacaremos del primer pin de estado, el nº10; la del segundo joystick del nº11 y así sucesivamente con los pines de estado.

Cruzando un pin de estado con los pines de datos tendremos hasta 12 contactos para un mismo dispositivo. En el caso de joysticks virtuales, los 4 primeros corresponden a la cruceta del joystick y el resto a los botones. Si configuramos una distribución virtual de teclado, tendremos pulsaciones de teclas pre-establecidas. Todo queda reflejado en la siguiente tabla.



Distribución de las conexiones en el db25 en relación con la colocación del diodo. Quedan como sigue (prestar especial atención a la orientación del diodo):




- Compilación del código fuente

Vamos a por el módulo, lo mejor es compilarlo en nuestro sistema. Puedes bajarte el código fuente (source) de la página del proyecto. https://code.google.com/p/openppjoy/. De todas formas, os dejo en este link, el paquete con la versión r16:

OpenPPJoy-r16: www.megaupload.com/?d=K92ASOZ9

Nota: Los comandos expuestos a continuación son para Debian/Ubuntu.

Para compilar el módulo, pon todos los archivos en una carpeta llamada "arcade-modulo".



Luego abre una ventana del terminal y navega hasta donde has puesto la carpeta en tu sistema de archivos (puedes pulsar CTRL+ALT+T para abrir el terminal).

Una vez allí y para compilar el módulo, primero necesitas las cabeceras (HEADERS) del kernel que estas usando actualmente. Por lo general el código fuente del Kernel se descarga y se va actualizando en el propio sistema y no os hará falta este paso, pero, por si acaso, el siguiente comando es para bajarlo e instalarlo:

sudo apt-get install linux-headers-`uname -r`

Una vez instaladas las cabeceras (o el mismo source completo, si lo deseas), hacemos:

make

Si todo ha terminado bien, tendríamos que tener un “arcade.ko” en el directorio donde compilaste el módulo.



Antes de continuar, y debido a que el módulo se puede cargar con 1, 2, 3, 4, ó 5 dispositivos a elegir entre joysticks y/o hasta dos configuraciones de teclado, vamos a explicar cómo se configura a través del argumento: "map=".

El módulo se carga en el sistema con el comando "insmod". Su uso es:

insmod archivo [argumentos]

El archivo del módulo es:

"arcade.ko"

Los argumentos se hacen con la siguiente sintaxis:

map=p , j1 , j2 , j3, j4 , j5

p es el nº puerto LPT al que tenemos conectado el interfaz.

Normalmente tendremos un único LPT y su valor será 0. Separados por comas, le diremos los valores (1, 2 ó 3) de j1, j2, j3, j4, j5, que son los 5 dispositivos a cargar de entre los 3 preconfigurados.

Valor - Dispositivo:

1 - joystick de 8 botones
2 - Distribución de teclado 1 (ver arriba)
3 - Distribución de teclado 2 (ver arriba)

Unos ejemplos para aclarar esto, que es muy sencillo:

Para cargar el módulo con un joystick de 8 botones conectado en la línea 10 de estado:

sudo insmod arcade.ko map=0,1

Para cargar el módulo con 5 joysticks de 8 botones conectados a los pines de estado 10,11, 12, 13, 15:

sudo insmod arcade.ko map=0,1,1,1,1,1

Para cargar el módulo con 4 joysticks de 8 botones conectados a los pines de estado 10, 11, 12, 13 y una de las configuraciones básicas de teclado en el pin 15:

sudo insmod arcade.ko map=0,1,1,1,1,2


- Otros comandos y ayudas de utilidad

Si al cargar el módulo os reporta el error de que el puerto está ocupado: “insmod: error inserting 'arcade.ko': -1 Device or resource busy”. podremos liberarlo descargando el módulo "lp" con el siguiente comando:

sudo rmmod lp

Para ver si tenemos el módulo correctamente cargado haremos:

lsmod | grep arcade

Puedes descargar el módulo haciendo:

sudo rmmod arcade

El dispositivo de joystick queda registrado como otro cualquiera en tu sistema, en ubuntu están en: “/dev/input/js0 js1 js2...” tantos como hayamos configurado.

Puedes testear el control y sus botones con la utilidad “jstest” (tendrás que descargártela antes) haciendo:

jstest /dev/input/js0



¡Y hasta aquí todo! ¡Linuxeros, a disfrutar de esta interfaz!


Enlaces:

Página del proyecto y sus últimas revisiones: https://code.google.com/p/openppjoy/source/list

Blog personal de David Colmenero: http://david.dantoine.org/


- Por pablo33 -