Rasp-Retro-Games-Arcade-Control

Ajouter un controleur d'Arcade

Si vous êtes arrivé ici, vous disposez d'un (ou plusieurs) jeux auquel vous pouvez jouer au clavier. La prochaine étape consiste à ajouter les contrôles d'Arcade...

C'est maintenant que les choses prennent un tournant créatif. Il n'existe pas une disposition idéale des contrôles (manette et boutons) qui puisse convenir à tous les jeux. Par contre il existe quelques dispositions plus fréquentes qui conviennent à de nombreux cas. Et pour le reste, vous pouvez encore utiliser un clavier.

Vous aurez également besoin de réaliser votre panneau de commande en utilisant les matérieux et outils correspondant au mieux à vos compétences. Chez AdaFruit, nous avons la chance de pouvoir utiliser une découpeuse laser qui fonctionne avec de l’acrylique (plexyglass) mais cela resterait un défi de taille pour la plupart des gens. Du contreplaqué ou boite métallique sont des matériaux viable (une grande boite à cigare peut aussi convenir) pour faire les trous, vous pouvez utiliser une foreuse, une scie a trou, une Dremel ou une lime à bois. n'hésitez pas improviser!

Si vous ne disposez pas d'un fournisseur de bouton sous la main, sachez que MCHobby propose aussi un joli assortiment de bouton d'arcade:

Les éléments

Crédit pour les images ci-dessous à AdaFruit Industries - All images here under are credited to AdaFruit Industries

	Le joystick d'arcade petit modèle que nous proposons est l'équivalent du clavier IBM Modèle M — il clique et construit comme un tank! C'est un joystick "digital" à 8 positions. Une majorité des jeux classiques sont conçu pour ce type de contrôleur,. Cela tombe bien qu'il soit digital parce que Raspberry Pi ne sait pas lire directement un joystick de type analogique.
	Les boutons d'Arcade 30mm (que nous proposons également) existe en différente couleur et est similaire a sont équivalent industriel. Mais tous les boutons momentanés (à contacts "normalement ouvert") fonctionneront parfaitement.
	Les contrôles seront branchés sur le connecteur GPIO 26 broches (GPIO = general-purpose input/output) de la carte Raspberry Pi.

Le joystick d'un ordinateur Atari ou Commodore peut aussi être utilisé. Les joysticks des consoles plus récentes utilise un protocole série... et malheureusement, cela ne fonctionnera pas ici. Les gamepads USB est une autre option viable.

Broches du GPIO

Chaque broche du connecteur dispose d'un "numéro GPIO" unique qui diffère de l'ordre des broches sur le connecteur. Les boutons et joystick (chacun ayant 4 directions) seront connectés parmi les différentes broches GPIO disponible et la masse (GND).

La plupart des cartes Raspberry Pi suivent maintenant l'arrangement des broches de la "Revision 2":

Crédit: AdaFruit Industries www.adafruit.com

Si vous disposez toujours d'un ancien modèle (prédécesseur de la carte Modèle B) est facile à reconnaitre car elle n'a pas de trou de montage. Dans ce cas le numéro des broches est différent:

Crédit: AdaFruit Industries www.adafruit.com

Notez que les broches GPIO 14 et 15 sont hors sujet et interdite d'utilisation. Par défaut, elles sont configurées comme port série. Il est possible de désactiver le port série (pour récupérer les broches) mais cela nécessite de modifier la configuration de votre Pi (c'est un peu ennuyant, pas nécessaire puisque nous de nombreuses broches et surtout plus facile).

Les cartes de révision 2 dispose de 4 broches GPIO complémentaires (28–31) sur un connecteur adjacent mais cela nécessite quelques opérations de soudure. Si vous avez désespérément besoin d'entrées supplémentaires, vous trouverez des information sur Embedded Linux Wiki (réservé aux utilisateurs avancés).

Il y a seulement 5 broches de masse (GND) disponibles sur le connecteur, mais certain gamers aurons besoin de plus de contrôles que cela. Une des cartes cartes Perma-Proto peut être utilisée pour fournir un "grand rail de masse" où l'un des côtés de tous les boutons peut être connecté. En alternative, si vous avez des broches GPIO en extra (et non utilisée) et que vous avez besoin de broches de masse (GND) complémentaires.... nous montrerons plus loin qu'il existe une solution logicielle pour transformer une broche du GPIO en broche de masse.

Le processeur du Raspberry Pi à la possibilité d'activer une résistance PullUp 'interne'. Par conséquent, vous n'avez pas besoin de résistance PullUp externe pour les boutons et le contrôleur d'Arcade

Tout comme pour la réalisation de votre panneau de contrôle où vous êtes libre de la technique de construction et interprétation créative... le branchement des contrôles sur le GPIO peut être réaliser à l'aide de différentes méthodes. Vous devez donc opter pour votre propre méthodologie de câblage. Nous proposons néanmoins quelques éléments/produits qui peuvent vous aider. En plus des cartes Perma-Proto déja mentionnées, il y a les fils de connexion rapide qui fonctionne avec les boutons et assortiment de fil de connexion multifonctionnel qui peuvent être utilisés avec les joysticks et branchés directement sur le GPIO (sans avoir besoin d'une carte Perma-Proto). Les options sont abondantes! Vous aurez probablement besoin d'une combinaison d'entre eux et quelques soudures seront certainement nécessaire.

Raccordement

Le joystick

Crédit: AdaFruit Industries www.adafruit.com

Voici le diagramme du connecteur de notre joystick d'arcade. Un fil doit être connecté sur la masse/GND. Ensuite, chacune des 4 autres broches seront raccordée sur des broches différentes du GPIO.

Les indications de direction ne sont valable que si le joystick est orienté avec le connecteur vers le haut. Il est tout a fait possible d'installer le joystick sous différente orientation... pensez seulement à adapter le raccordement sur le GPIO pour correspondre au changement de direction (orienté de 90° sur la droite, le "haut" devient la "droite", ...).

Raccordement sur le GPIO

Les fiches au bout des câbles de connexion rapide tendent à bloquer les broches adjacentes sur le connecteur GPIO. Vous pouvez les tailler avec un cutter ou une Dremel afin de les amincir, ou planifier votre cablage pour éviter d'utiliser les broches adjacentes.

Voici une proposition de câblage pour un joystick et deux boutons: elle utilise 5 fils multifonctionnel femelle-vers-femelle pour le joystick et deux câbles de connexion rapide non modifié pour les boutons. C'est une disposition très élémentaire mais qui convient déjà à quelques jeux classiques. Un clavier USB a proximité sera parfait pour prendre en charge les fonctions plus rarement utilisées (insertion de pièces, démarrer le jeux).

Vous pauvez aussi vous connecter sur d'autres broches du GPIO si les opérations de soudure ne vous effrayent pas - assurez vous de connecter l'une des broches du bouton sur une broche du GPIO et l'autre broche du bouton sur la broche de masse/GND. Vous aurez aussi besoin d'éditer et modifier la programme de commande proposé par AdaFruit (rassurez vous, cela n'est pas bien compliqué).

Crédit: AdaFruit Industries www.adafruit.com

	Voici un exemple de boitier réalisé en acrylique (plexiglas), mais tout autre matériel usinable fera l'affaire. Une grande boite à cigare fait parfairement l'affaire! The case should be at least 50mm (2 in.) deep to accommodate the buttons and solderless connectors.
	The shelf at the top of the case holds a small USB keyboard. This is a catch-all for seldom-used functions (e.g. game start). Only the essential controls were assigned to arcade buttons. Add others if you like!
	Here’s the joystick and two buttons plugged directly into the Raspberry Pi GPIO header as previously described.

Un dernier élément

Our “retrogame” utility is the software glue that joins these keyboard-driven games to our GPIO-connected controls.

Download retrogame from GitHub. Select the “download ZIP” button and uncompress this file on your Raspberry Pi.

A pre-built version of retrogame is included in the ZIP file. If using the joystick and button layout described above, this program can be used as-is. Otherwise, the C source code needs some editing, and you’ll need to compile it (a Makefile is provided) after making changes. The GPIO pin to keyboard remapping is currently handled with a table in the source…this should be edited to match your unique wiring setup.

cd Adafruit-Retrogame
nano retrogame.c

(Of course you can substitute your editor of preference there — “nano” is easier for beginners.)

Starting around line 77 you’ll see a table resembling this:

struct {
        int pin;
        int key;
} io[] = {
//        Input    Output (from /usr/include/linux/input.h)
        { 25,      KEY_LEFT     },
        {  9,      KEY_RIGHT    },
        { 10,      KEY_UP       },
        { 17,      KEY_DOWN     },
        { 23,      KEY_LEFTCTRL },
        {  7,      KEY_LEFTALT  }
};

Each line in this table contains two elements. The first is a GPIO pin number (where a button or one direction from a joystick is attached), the second is the corresponding key code to be generated by this control. A list of valid key code names can be found in the file /usr/include/linux/input.h starting around line 178. Remember to enclose each pin/key pair in {curly braces} with a comma between them.

By default, the code is set up to match our example “no solder” controller wiring. This also works directly with the standard MAME controls. So you might not need to change anything; the pre-built version may have you covered.

If you need an extra ground pin (and have extra GPIO pins available that you’re not using for controls), set the key code to GND instead.

Write your changes to the file and exit the editor, then type:

make

This should build the executable retrogame utility. If you instead get an error message, there’s a problem in the edited table — most likely a missing curly brace, comma or semicolon.

But wait...we’re not ready to run yet! Retrogame requires the uinput kernel module. This is already present on the system but isn’t enabled by default. For testing, you can type:

sudo modprobe uinput

To make this persistent between reboots, append a line to /etc/modules:

sudo sh -c 'echo uinput >> /etc/modules'

Now we’re in good shape to test it!

Retrogame needs to be run as root, i.e.:

sudo ./retrogame

Give it a try. If it seems to be working, press control+C to stop the program and we’ll then set up the system to launch this automatically in the background at startup.

sudo nano /etc/rc.local

Before the final “exit 0” line, insert this line:

/home/pi/Adafruit-Retrogame/retrogame &

If you placed the software in a different location, this line should be changed accordingly. “sudo” isn’t necessary here because the rc.local script is already run as root.

Reboot the system to test the startup function:

sudo reboot

The software will now be patiently waiting in the background, ready for use with any emulators.

Each emulator will have its own method for configuring keyboard input. Set them up so the keys match your controller outputs. Up/down/left/right from the arrow keys is a pretty common default among these programs, but the rest will usually require some tweaking.

---

Source: Adafruit Retro Gaming with Raspberry Pi
Créé par Phillip Burgess pour AdaFruit Industries.

Traduction réalisée par Meurisse D pour MCHobby.be.

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.

Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com