How to setup Arcade Machine

Existing Image

Download current arcade Image from here (accessible to Thoth-Tech Team Members): https://deakin365.sharepoint.com/:u:/r/sites/ThothTech2/Shared%20Documents/SplashKit/Arcade%20Machine%20Image/ArcadeMachine.img?csf=1&web=1&e=7cuS7Z

SHA256 Hash 31f0ea11c8492000d003108bf84afbb261ad6ee7c1be989f52a2b4add9d8821e

Use a program like etcher to create a bootable USB or SD card with the Arcade image.

Open etcher
Select image
select target USB or SD Card
Click FLASH

These are the Credentials setup on the image

Local User Name: deakin Password: qwerty
SSH Uses Local user name and password
SMB Share uses Name deakin password deakin
WiFi SSID Arcade1 Password GamesAreFun

Manual Setup

Load OS

Install Raspberry Pi OS
- See Raspberry Pi OS Installation Instructions.
Plug USB into PI or Arcade Machine and follow the setup wizard
- Current username and password are deakin and qwerty
Update all Software to the latestes version

Connect to eduroam

Two changes need to be made to allow the Pi to access the eduroam network. One to network interfaces and one to wpa_supplicant:

Modify /etc/network/interfaces to bring the wlan0 interface up automatically, use DHCP and read from the wpa_supplicant config
- From the console open the interfaces file:
  Terminal window
```
sudo nano /etc/network/interfaces
```
- Copy the following text to the bottom of the interfaces file
```
allow-hotplug wlan0
iface wlan0 inet manual
    wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
iface wlan0 inet dhcp
```
- Press Ctrl+X to exit and press y when prompted to save your changes

Modify the wpa_supplicant with the custom eduroam config

From the console open the wpa_supplicant config file:
Terminal window
```
sudo nano /etc/wpa_supplicant/wpa_supplicant.conf
```

Copy the following text into the wpa_supplicant file

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1

network={
    ssid="eduroam"
    priority=1
    proto=RSN
    key_mgmt=WPA-EAP
    pairwise=CCMP
    auth_alg=OPEN
    eap=PEAP
    identity="YOURUSERNAME@deakin.edu.au"
    password="YOURPASSWORD"
    phase1="peaplabel=0"
    phase2="auth=MSCHAPV2"
}

Replace YOURUSERNAME and YOURPASSWORD with the arcade machine’s eduroam login credentials. Ensure you include the domain I.E. “arcademachine@deakin.edu.au”
Press Ctrl+X to exit and press y when prompted to save your changes.

Reboot and test network connectivity
- Reboot the Raspberry Pi by issuing the below command:
  Terminal window
```
sudo reboot
```
- Test network connectivity by pinging an external site, for example Google’s DNS:
  Terminal window
```
ping 8.8.8.8
```

Install Software

1. Install SplashKit

Follow the Linux (Ubuntu) Installation Guide on the SplashKit website.
Primarly perform steps 1 and 2, VS code is optional unless you whish to adjust programming on the PI directly.

2. Install .NET (dotnet)

You can refer to this page but these are the core commands:
1. Run this install script
  Terminal window
```
curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --channel STS
```
2. Add the following to the end of the file ~/.bashrc with these commands
  Terminal window
```
echo 'export DOTNET_ROOT=$HOME/.dotnet' >> ~/.bashrc
echo 'export PATH=$PATH:$HOME/.dotnet' >> ~/.bashrc
source ~/.bashrc
```
3. Verify the insalation with this command
  Terminal window
```
dotnet --version
```

3. Install Git

Run the following command
Terminal window
```
sudo apt update
sudo apt install git
```

4. Install Emulation Station (using RetroPi)

git clone retroPI setup

git clone --depth=1 https://github.com/RetroPie/RetroPie-Setup.git

Run the setup script

cd RetroPie-Setup
sudo ./retropie_setup.sh

Select manage packages
Select core
Select emulationstation
Exit retroPie setup
Create Emulation Station es_systems.cfg file
Terminal window
```
nano ~/.emulationstation/es_systems.cfg
```

Add the following configuration code to the es_systems.cfg file: Or, you can download a copy from here: Click to Download

<!-- This is the EmulationStation Systems configuration file. All systems must be contained within the <systemList> tag.-->

<systemList>
    <!-- Here's an example system to get you started. -->
    <system>

        <!-- A short name, used internally. Traditionally lower-case. -->
        <name>pc</name>

        <!-- A "pretty" name, displayed in menus and such. -->
        <fullname>PC</fullname>

        <!-- The path to start searching for ROMs in. '~' will be expanded to $HOME on Linux or %HOMEPATH% on Windows. -->
        <path>/home/deakin/Games/LaunchScripts</path>

        <!-- A list of extensions to search for, delimited by any of the whitespace characters (", \r\n\t").
        You MUST include the period at the start of the extension! It's also case sensitive. -->
        <extension>.exe .sh</extension>

        <!-- The shell command executed when a game is selected. A few special tags are replaced if found in a command:
        %ROM% is replaced by a bash-special-character-escaped absolute path to the ROM.
        %BASENAME% is replaced by the "base" name of the ROM.  For example, "/foo/bar.rom" would have a basename of "bar". Useful for MAME.
        %ROM_RAW% is the raw, unescaped path to the ROM. -->
        <command>%ROM%</command>

        <!-- The platform to use when scraping. You can see the full list of accepted platforms in src/PlatformIds.cpp.
        It's case sensitive, but everything is lowercase. This tag is optional.
        You can use multiple platforms too, delimited with any of the whitespace characters (", \r\n\t"), eg: "genesis, megadrive" -->
        <platform>PC</platform>

        <!-- The theme to load from the current theme set.  See THEMES.md for more information.
        This tag is optional. If not set, it will default to the value of <name>. -->
        <theme>N64</theme>
    </system>
</systemList>

Create a folder for the games
Terminal window
```
mkdir ~/Games
```
Create a folder for the launch scripts
Terminal window
```
mkdir ~/Games/LaunchScripts
```

Configure Software

Configure Emulation Station

Start Emulation Station enter the following command:
Terminal window
```
emulationstation
```
First time setup you will need to configure the controller
1. Hold Down any key to start
2. Press any key to configure input
  
  Recommend the Following for the Arcade Machine the rest can be skipped
  - up = up arrow
  - down = down arrow
  - left = left arrow
  - right = right arrow
  - start = escape
  - select = enter
  - A = left control
  - B = left alt
3. It will note a hotkey was not selected say yes to accept using select
Press Escape to bring up the menu
Select UI Settings
Scroll down to start on system and set it to PC
Go back and Quit Emulation Station

Configure Start CLI on Boot and Network Manager

Launch Rasberry Pi Configuration
Terminal window
```
sudo raspi-config
```
Select System Options
Select Boot / Auto Login
Select Console Autologin
Return to main menu
Select Advanced Options
Select Network Config
Select Network Manager
Select OK
Select Interface Options
Select SSH
Select Yes
Select Ok and Finshed to exit Rasberry Pi Configuration
You can reboot now or later

Setup WiFi Access Point (Optional)

This will set the PI up as a WiFi Access Point so you can SSH in when the USB ports are not accessible.

Basic Guide Availble Here

Enter the following commands, the SSID is set to Arcade1 - change the number for the machine you are working on.

nmcli con add type wifi ifname wlan0 con-name Hostspot autoconnect yes ssid Arcade1
nmcli con modify Hostspot 802-11-wireless.mode ap 802-11-wireless.band bg ipv4.method shared
nmcli con modify Hostspot wifi-sec.key-mgmt wpa-psk
nmcli con modify Hostspot wifi-sec.psk "GamesAreFun"
nmcli con up Hostspot

The Pi will now be broadcasting a WiFi network called Arcade1 with the password GamesAreFun

The IP address of the Pi will be 10.42.0.1/24 this current setup does not allow for DHCP so any
connecting client will need to manually set an IP address in use the following settings:

IP Address: 10.42.0.2 Subnet Mask: 255.255.255.0 Gateway: 10.42.0.1

Set Emulation Station as the Default Shell

Change to the Retro Pi Setup Folder
Terminal window
```
cd ~/RetroPie-Setup
```
Run the Retro Pi Setup Script
Terminal window
```
sudo ./retropie_setup.sh
```
Select Configuration / Tools
Select Autostart
Select Start Emulation Station at boot
Select Ok
Select Finish
Select Perform Reboot

Installing the Splashkit Theme

Download the Themes folder located at: docs/Splashkit/Applications/Arcade Machines/Arcade Machine Setup/Files
Copy the Themes folder into your .emulationstation folder, located at ~/.emulationstation on the Raspberry Pi or at %HOMEPATH%/.emulationstation on windows devices.
In the es_systems.cfg file, located in the file paths mentioned in step 2, you will need to change the XML code for the theme to be “sk.”
Launch EmulationStation, open the start menu, and under UI settings change Theme set to “Splashkit.”