Raspberry Pi Game HAT User Guide


Please focus on the direction of battery, if you reversely connecting the battery, the charging circuit will be damaged, so please pay attention to it when you mounting the battery.


  • 3.5inch IPS screen, 480×320 resolution
  • 60 frame experience, smoothly display, no more frame loss
  • Compatible with Raspberry Pi A+/B+/2B/3B/3B+/4B (Raspberry Pi Zero/Zero W/Zero WH requires another HDMI cable)
  • Integrates battery charge circuitry, powered from a 18650 lithium battery (NOT included), plays anywhere anytime
  • Battery capacity indicator
  • Onboard speaker and earphone jack, listen to the familiar BGM from the old days

User Gudies

Hardware Connection

  • Insert Raspberry Pi to Game HAT (GPIO pins header)
  • Connect HDMI. Insert the HDMI connector to screen and Raspberry Pi
    If you use Raspberry Pi Zero/Raspberry Pi Zero W, you need to use HDMI cable
  • Toggle the Battery switch of Game HAT to OFF, and mount 18650 battery to it.

Using RetroPie

Method 1, Use Pre-build Image

  • Rertropie Image for Pi4
  • Retropie Image for Pi2/3
  • Retropie Image for Pi 1/Zero
  • Unzip the ZIP and write the image file to TF card
  • Inset the ready TF card to your Raspberry Pi, toggle Battery switch to ON.
    If the battery is low, Raspberry Pi cannot startup. In this case, you can connect a 5V/2A power supply to the Power interface of Game HAT for charging. The charge indicator will flicker when charging. You can play during charging but note that Raspberry Pi will reboot automatically if you disconnect the power supply.
    If the battery is full Raspberry Pi will start up normally.
  • After entering OS, you can choose emulators by joystick. For example, choose the Nintendo emulator and press “A” to confirm.
  • You can see there are some games. Choose one and press “A” to enter. After the cutscene, you can press the “A” or “Start” key to start the game.
  • If you want to exit from the current game, you can press buttons “Start” and ”Select” at the same times
  • You can press the 4 buttons on the right side of Game HAT to adjust volume and brightness of LCD, Press Menu to open the OSD menu, and press Up/Left or Down/Right to choose options, then press Menu to confirm option and adjust it. Finally, press Exit to exit the OSD menu.

Method 2. Install Driver Manually

The driver cannot support Retropie-v4.7, please wait for updating
  • Please download the Retropie image on the Retropie website according to the type of your Raspberry Pi.
  • Download and unzip it to get .img file
  • Write the .img file to TF card by Win32DiskImager.exe
  • After writing, copy the Game HAT driver you download to the root directory of the TF card.
  • Open the config.txt file which is also on the root directory, append these statements to the config file
hdmi_cvt=640 480 60 1 0 0 0
  • Inset the TF card and a USB keyboard to Raspberry Pi, open Battery switch to power on Raspberry Pi. After booting, press F4 to open Terminal.
  • Install the joystick driver according to the image version you are using

1) If are using retropie-v4.7 version, please refer to the following step to install the driver.

【Note】The GanmeHAT must be connected to the network, or else the driver won't be successfully installed.

Enter the following command to enter the configuration interface of RetroPie-Setup:

cd RetroPie-Setup/
sudo ./retropie_setup.sh

Select the Manage Packages in the following interface, and then press "Enter".

After entering the following interface, select the Manage driver Packages and press "Enter".

Select mkarcadejoystick in the following interface and press "Enter".

After entering the next interface, select install from source. And then you can press Ctrl+C to exit the RetroPie-Setup after the driver is installed.

And then enter the following command on the terminal:

sudo nano /etc/modprobe.d/mk_arcade_joystick_rpi.conf

Modify the line in the file to

options mk_arcade_joystick_rpi map=5 gpio=5,6,13,19,21,4,26,12,23,20,16,18

Save the file and reboot the system, then you can start to enter the buttons configuration page.

2) If you are using retropie-v4.6 or the image before this version, please download the previous Game HAT driver and copy it to the TF card/boot directory (you can also use a U disk or network to copy the driver file to the folder of the system ), and then enter the following command:

sudo tar xzvf /boot/Game-HAT-*.tar.gz
cd Game-HAT/
sudo ./Game-HAT
  • Reboot Raspberry Pi. Long press the “A” button (other keys are OK as well) to enter the buttons configuration page. Configure keys as below. You can also long-press “A” or other buttons to pass the configuration.
  • After configuring:
    Press the “A” button to save configurations and exit.
    Or press the “B” button to cancel configurations and exit without saving.
  • The configuration is finished and you can try to play games now.

Using Recalbox

  • Download the newest Recalbox image from the official website:


  • Connect the TF card to the PC, open the Win32DiskImager software, Write the image to your TF card and modify config.txt file

Add lines to config.txt file:

  • Insert the SD card into the Raspberry Pi, then connect the Raspberry Pi to the Game HAT, and connect the HDMI adapter. Turn on the power switch and start the Game HAT
  • Log in to the system via SSH (the Raspberry Pi needs to be connected to the Internet. After entering the system, connect the keyboard to the Pi, press F4 on the keyboard, and press Alt+F2 to enter the terminal interface. Use ifconfig to view the IP address)

User:root Passwird:recalboxroot

Enter the following commands in the terminal:

mount -o remount,rw /
mount -o remount,rw /boot

Modify recalbox file

nano /recalbox/share/system/recalbox.conf

Change the line "controllers.gpio.enabled=0" to "


Comment out the line "controller.gpio.args=map=1,2 ', and add the line "controllers.gpio.args=map=5 gpio=5,6,13,19,21,4,26,12,23,20, 16,18,-1 "

controllers.gpio.args=map=5 gpio=5,6,13,19,21,4,26,12,23,20,16,18,-1
  • Save the file and reboot Raspberry Pi. After booting, the Game HAT can work normally.

Add New Game

Maybe the default games in the test image are not those you want, you can also add games as you like.

  • Size of most games are always large, so we need to expand the filesystem fist. Choose RASPI-CONFIG on configure page and press enter

  • Choose 7 Advanced Options -> A1 Expand Filesystem, Enter->Finish, (physical keyboard is required)

  • Choose OK, and reboot.
  • Download ROMS of games you like

  • Connect your Raspberry Pi to the network (Make sure the network you connect is in the same LAN as your PC). Find SHOW IP in Retropie list, press “A” to query the current IP address of your Raspberry Pi.

  • Open it with the IP address on your PC

  • Then on the emulator choose the page, you can press “Start”->QUIT->RESTART EMULATIONSTAION, press “A” to confirm. Then restart the emulator, you can find the game added.

For more operations, you can read https://retropie.org.uk/docs/

Setup WIFI

Setup WIFI in Retropie or Raspberry Pi OS

  • Download the archive below and unzip it to get the wpa_supplicant.conf file, open and modify the SSID and password, then save it.


  • Copy the modified wpa_supplicant.conf file to the root directory of Raspberry Pi OS/Retropie and reboot.

Setup WIFI in Recalbox OS

  • Press START to enter the MENU
  • Set the ENABLE WIFI to ON
  • Choose "WIFI SSID" and enter the SSID
  • Choose "WIFI KEY" and enter the password

  • After connecting, RecalBox will check updating.


NC: Not connected

13.3V3.3V power input
25V5V Power input
45V5V Power input
173.3V3.3V power input

Price: $39.89
Part Number: Game HAT (PI3 Acc)
Brand: Spotpear
SKU: 0104004