Installing RetroPie on CM4 eMMC with RetroFlag GPi CASE 2

Disclaimer: Raspberry Pi CM4 is NOT meant for beginner. This tutorial assumes you are familiar and have prior knowledge on Raspberry Pi boards, CM4 boards, how to use raspi-config, what is eMMC, what is SSH and how to use Raspberry Pi Imager.


GPi CASE is one of the popular retro handheld casing that use Raspberry Pi boards. While GPi CASE use Raspberry Pi Zero / Zero W, the new GPi CASE 2 use the more powerful Raspberry Pi Compute Module 4. You could find many tutorials online on how to install any retro gaming OS on GPi CASE 2 CM4 with no eMMC, using SD Card. But it is hard to find a tutorial for CM4 with eMMC. Due to the nature of the CM4, the SD Card slot is not useable on GPi CASE 2 if you are using a CM4 with eMMC. In this tutorial you will learn how to install RetroPie OS on CM4 eMMC with GPi CASE 2.

Note: Due to the nature of the CM4, the SD Card slot is NOT useable if you are using a CM4 with eMMC. This is the same case as any expansion or carrier board, if you use CM4 with eMMC, the SD Card slot is not useable. GPi CASE 2 also support CM4 Lite. If you decide to use CM4 with eMMC, make sure to consider the eMMC size before you buy as you will be stuck with that size and cannot be expanded via microSD card. We recommend the largest size eMMC which is 32GB as you can store the game ROM inside. Of course the best is still to use it with CM4 Lite. 

Components and Requirements

NoteYou cannot use a cheap Micro B USB charger cable. Only use Data Cable or an original phone brand charger cable.

Setting Up GPi CASE 2


1: Open the back slider of the case

You should see a white marking that looks identical with the CM4 Board.


2: Carefully place your CM4 Board inside

CM4 got 2 set of pins on each of the longer edge. Make sure the CM4 pins are lined up correctly with the sockets on the case.


3: Make sure your CM4 orientation is correct.

Remember the white ‘marking’ on the case? Make sure your CM4 are placed exactly like the marking


4: Gently press the CM4

Press the CM4 on the surface where the pins is underneath it. Gently press until you hear a ‘snap’ for each side of pins.

Software Setup

1: Downloand rpiboot software from Github

rpiboot software =

Download and unzip the folder.


2: Install rpiboot in your PC / Laptop

Open the folder that you unzipped. Go into the win32 folder and run rpiboot_setup.exe.


Press next and agree to all prompts. Wait for a while and rpiboot should be successfully installed.


3: Download and install Raspberry Pi Imager

You should already familiar with Raspberry Pi Imager. If not, you can watch this video to learn how to download and install the Imager. In this video, only follow until the Imager installation process complete because we will do different steps afterwards.

4: Download and install Putty

We will use Putty for SSH later. You can download Putty from this link. Choose the 64-bit x86 Windows Installer.


Run the installer, press next and agree to all prompt. Putty should be installed successfully.


5: Download GPi CASE 2 Patch

Download and unzip the GPi CASE 2 Patch.


Flashing RetroPie OS

We have finished preparing the software and hardware, now lets flash the RetroPie OS into the CM4 eMMC.

1: Launch rpiboot

Click your windows logo and search for rpiboot, run it. A new window will pop up but still waiting for something.


2: Plug in your cables

GPi CASE 2 have 2 ports:

  • Type-C for Power Supply
  • USB Micro B for firmware upgrade and modification

3: Power on your GPi CASE 2

Push the switch to the right to turn on the GPi CASE 2. Remember the pop up window from Step 1? It will display some new lines of stuffs, and it will close the window by itself. This indicates that rpiboot has detected CM4 in the GPi Case 2.

If yours didn’t happen like this, please check your CM4 board placement. Make sure it placed correctly, and snap into the place properly. Turn off your case, open rpiboot again, and turn on your case again. Repeat until it detect the case.


4: Flash RetroPie using Raspberry Pi Imager

Once your case is detected by rpiboot, you can proceed to Flash RetroPie into the CM4. If your case is not detected, check your CM4 placement and repeat step 1-3.

Choose RetroPie for Raspberry Pi 4/400.


Choose your board eMMC storage and write the RetroPie OS.

NoteIf your board is detected by rpiboot, it should appear in the storage option. If not, repeat step 1-3


5: Installing GPi CASE 2 Patch

After Raspberry Pi Imager finish writing the OS, do not plug out anything yet

You need to repeat step 1-3 which is turn off your case, open rpiboot and then turn your case back on. rpiboot should detect the case again. Once your case is detected, open “This PC” on your laptop/PC and you should see the boot partition of your RetroPie.


Remember that we have download and unzip GPi CASE 2 Patch? Go into that folder.


Copy the GPi_Case2_patch_retropie folder into the boot partition of the CM4


Once you copied the folder into boot partition, open that folder, and run install_patch.bat . A new window will popup. Press any key to close that window.


Now you are done! Turn off your case, unplug all cables and turn your case back on. It should take a couple minute before your cute little console will boot up.


Setting Up Your GPi Case

1: Configure Gamepad


When you first time booting up your RetroPie, it will ask you to configure your gamepad, just like you install RetroPie on Raspberry Pi 4, etc.


Configure your gamepad properly. When you ran out of button to map, just hold any button to skip the mapping process. 

For the last button, ‘Hotkey’, you can map it to any key even its already mapped. Using Select key for Hotkey is recommended.

After finish configuring your gamepad, you should see RetroPie main menu. Keep in mind for further setting up process, the button is as follow:

  • In RetroPie Menu:
    • A : Activate / Launch / Select
    • B : Back
  • In raspi-config Menu:
    • A : Back
    • B : Activate / Launch / Select

2: Setting Up Wifi and SSH


Enter the RetroPie Configuration menu, Select Wifi. You will be asked to set up the WLAN Country. RetroPie will bring you to raspi-config menu.

Note: Choose your correct country. If you choose a wrong country your RetroPie will be unable to connect to the WiFi.


After you finish setting your WLAN Country, do not press finish yet. While you are in raspi-config menu, proceed to Interface Options to enable SSH setting.

NoteRetroPie will automatically attempt to connect to the Wifi network you set up everytime it boot up.


After you enable SSH, press Finish ont the raspi-config menu, and RetroPie will ask for reboot. Press Yes and RetroPie will automatically reboot for you.

3: Setting Safe Shutdown Script

Now you are ready to access your GPi CASE 2 using SSH. You will be using Putty on your Laptop/PC that you prepared before.

On your GPi CASE 2, enter the RetroPie configuration menu and select Show IP. Scroll down until you see ‘wlan0’ and ‘inet’. Note down this ‘inet’ IP Address because you will need it soon.


Next, launch Putty on your Laptop/PC. Write your RetroPie IP Address in the IP Address bar.

Note: From now on, the red marks you will see in the picture is where you IP Address will be shown.


Press Accept and login to your RetroPie. Default credentials are:

  • Username: pi
  • Password: raspberry

Next you will see a familiar RetroPie command line. You can do basically all command line stuff from here on your RetroPie. 


Next, we will download and install the Safe Shutdown scripts. You can get the command on the link here or just copy the command below to type on the SSH.

					wget -O - "" | sudo bash

You are all set!!

You are done! Your GPi CASE 2 will automatically reboot. And from now, you can easily and safely turn on and off your GPi CASE 2 by just using the switch on the case.

Have fun! You will need to use SCP to add games into your GPi CASE 2. Don’t know what is SCP? Follow this tutorial on how to add games to RetroPie using SCP, wirelessly.

RetroPie on Raspberry Pi boards can supports games from Atari 1977 up to Playstation 1 games. Some later games like Nintendo Wii, Playstation 2, etc cannot run on Raspberry Pi boards. Anyway you can enjoy many retro games with your brand new powerful handheld console, GPi CASE 2!

Leave a Comment

Your email address will not be published.

Share this Tutorial

Share on facebook
Share on whatsapp
Share on email
Share on print
Share on twitter
Share on pinterest
Share on facebook
Share on whatsapp
Share on email
Share on print
Share on twitter
Share on pinterest

Latest Tutorial

WIFI Robot Maneuver With MDDS10
I2C Communication between micro:bit and Arduino
Quadruped Robot with SC08A Servo Controller
DIY Wooden Robotic Dinosaur (with Remote Control)
micro:bit with external motor driver – MD13S
Tutorials of Cytron Technologies Scroll to Top