Instructions to configure Custom GPIO pins for waveshare gamehat

cheungbx

If you have a Waveshare game hat, the one with a 4" HDMI LCD display and GPIO joysticks on top that works with RaspberryPi3B/B+, you can configure your Batocera to make it work as follows:
Youtube video demonstration:

Note: This instruction has been tested with Batoceria 5.25 (batocera-5.25-rpi3-20200309.img.gz)
If WIFI has not yet been set up for your Batoceria, connect it to a LAN cable first instead of using WIFI.

From your PC/Mac, ssh root@batocera.local (password for the first time login is linux)
If there is no response, you may want to first "ping batocera.local" to see if there is any response.
Otherwise, try to check your router to find out the ip address of your batocera. (e.g. 192.168.1.32)
then type "ssh root@192.168.1.32"

type "nano batocera.conf" to edit the configuration
use Control+W Key command to search for "gpio"
Once found, remove the # and change the following lines

controllers.gpio.enabled=1
controllers.gpio.args="map=4 gpio=5,6,13,19,21,4,26,12,23,20,16,18,4"

press Control+X to save the file.
type "reboot" to reboot.

Note that the HOT key is being assigned to the same pin 4 as the SELECT key. So, select key will also function as the HOT key.

Once rebooted, the buttons on waveshare gamehat should work right away. You will not need to start the systems menu to configure the controllers.

But in case you need, press "START" button to see if you can see the system menu, then select "Controllers Settings". Then select to configure the controller.
You should see "1 gamecontroller detected"
Then go ahead to configure your game controller by pressing the right buttons.
SELECT button will be configured as the hot key.

If the above does not work, then you might have some typo error in the configuration file.
Pls repeat and check again.
You can also check the log file to see whether mk_arcade has been loaded properly by typing this command.
cat /userdata/system/logs/batocera.log | grep mk_arcade

You should see something like this in the log when the mk_arcade driver has been loaded successfully for waveshare game hat
loading module mk_arcade_joystick_rpi args = map=4 gpio=5,6,13,19,21,4,26,12,23,20,16,18,4

spakel

Est ce possible avec rasberry pi 4?

cheungbx

spakel , I haven't got a pi4 to test. The Pi 4 has a mini HDMI output port instead of the big HDMI port used in Pi3 and it's at a different spot of the circuit board. According to this post
waveshare may sell an adaptor cable for Pi4. But not sure when.
Or you can try to find a short convertor cable, but it'll be ugly and uncool.
Putting the HDMI video connection aside, since the GPIO pin layouts of Pi4 and Pi3 are the same, it should work.

Dragu

My is configurated with map 5, but may be because based on an older soft.
I also have one button more, as I connected the button under joystick as Hotkey.

controllers.gpio.enabled=1
" Map5 of the gpios : up, down, left, right, start, select, a, b, tr, y, x, tl, hk"
" controllers.gpio.args="map=5 gpio=5,6,13,19,21,4,26,12,23,20,16,18,-1" (12 Buttons)"
controllers.gpio.args= "map=5 gpio=5,6,13,19,21,4,26,12,23,20,16,18,17"

https://forum.batocera.org/public/d/3187-one-more-button-hotkey-for-waveshare-game-hat

cheungbx

Dragu, you are right, it may be due to the different version of the mk_arcade_joystick_rpi_ko file used. When I was using recalbox 6.1.1, I used the same command as you did "map=5". Then when I try to use map=5 for the Batocera 5.25 and using the mk_arcade_joystick_rpi.ko that comes with it, I got device not available error. Then it works when I change to map=4.

failrunner

I can't get this working. I did everything I could and the gamehat is not seen. =( I give up.

spakel

Merci, je vais essayer de passer par l'interface usb et non par les gpio, a voir...

spakel

Bon par interface usb, tout marche bien,donc si vous le pouvez brancher par usb.