Flash your sd-card with 2021-05-07-raspios-buster-armhf.zip as this version has been tested with this hardware configuration.

Setup your WiFi connection preferences. My recommendations are you add your home network and your phone's hotspot. You should ssh in from some other device to do the installs, you will need a monitor later on to setup Kodi and RetroPie.

Enable Camera

sudo raspi-config

Install the audio hat driver

The Audio Hat Manual is here. The manual was missing a step, install rpi-source before following the steps, this will take a bit.

sudo apt update
sudo apt install rpi-source
git clone https://github.com/waveshare/WM8960-Audio-HAT
cd WM8960-Audio-HAT
sudo ./install.sh

Reboot.

Check that driver was installed:

cd WM8960-Audio-HAT
sudo dkms status

You should see
wm8960-soundcard, 1.0: added

Pair The Bluetooth Pro Controller then repeat the pairing steps for the keyboard.

bluetoothctl

Type scan on then
pair mac of 'Pro Controller'
trust mac of 'Pro Controller'
connect mac of 'Pro Controller'

Pro Controller UDev rules

sudo nano /etc/udev/rules.d/99-input.rules

Replace the file with:

KERNEL=="event*", SUBSYSTEM=="input", GROUP="input", MODE="0660"
KERNEL=="event*", ATTRS{name}=="Pro Controller", SYMLINK+="input/by-id/Gamepad"

Edit this file to allow the programs to have access to the xserver:

sudo nano /usr/share/dispsetup.sh

Add the next line above the last line and below the first:

Edit this file to change the default sound card to be the waveshare hat at index 1:

sudo nano /usr/share/alsa/alsa.conf

Look for these lines:
defaults.ctl.card 0
defaults.pcm.card 0
Replace with:

defaults.ctl.card 1
defaults.pcm.card 1

Edit this file to set the default display.

sudo nano /etc/environment

Add:

DISPLAY=:0

Install ttyecho:

git clone https://github.com/osospeed/ttyecho.git
cd ttyecho/
make
sudo make install

Add these lines to /boot/config.txt to set the framebuffer and overclock.

framebuffer_width=640
framebuffer_height=480
over_voltage=4
arm_freq=1300
core_freq=500

Remove the welcome to Raspberry Pi wizard:

sudo rm /etc/xdg/autostart/piwiz.desktop

Lightdm is disabled to save resources, it is not needed for Kodi, RetroPie or the programs.

sudo systemctl disable lightdm.service

The message of the day can be customized, you can make one or you can use mine.

sudo nano /etc/motd
______  _  _____ _                      ___  
|  __ \(_)/ ____| |                    |__ \ 
| |__)  _| |  __| | __ _ ___ ___  __   __ ) |
|  ___/| | | |_ | |/ _` / __/ __| \ \ / // / 
| |    | | |__| | | (_| \__ \__ \  \ V // /_ 
|_|    |_|\_____|_|\__,_|___/___/   \_/|____|
                                                     
Made with love by Matt the Maker

This guide was first published on Apr 05, 2022. It was last updated on Mar 08, 2024.

This page (Prerequisite Software Setup) was last updated on Mar 08, 2024.

Text editor powered by tinymce.