RETROPIE INSTALLATION GUIDE CONTENTS THE FOLLOWING GUIDE WILL COVER THE INSTALLATION, SETUP AND CONFIGURATION OF THE RASPBERRY PI, RASPBIAN OS AND RETROPIE Author: http://rpiarcadebuild.wordpress.com/ Version: June 2014. Introduction... 2 Considerations and Notes... 2 What you need for this guide... 2 Hardware:... 2 Software... 2 Optional... 3 Step 1: Raspberry Pi Hardware Setup... 4 Step 2: SD Card Setup Transferring NOOBS... 5 SD Card Formatting... 5 Transferring NOOBS... 5 Step 3: Raspbian OS Installation... 6 Optional Step: Connect to your RPi Remotely... 7 Step 4: Raspbian OS Configuration... 8 raspi-config... 8 STEP 5: Updating the Raspbian OS... 10
NOTE: Super Easy Mode RetroPie and PiPlay both have pre-installed images with everything ready to go, these include the Raspbian OS. Check out the websites for more information. INTRODUCTION This guide will cover the installation and setup of your Raspberry Pi for use as a retro gaming machine. The guide is in sequential order, just continue reading. Firstly, the Raspberry Pi will be setup, and then the operating system known as Raspbian OS will be installed. Secondly, RetroPie will be installed with a script, and then we will do some basic configuration. WHAT IS RETROPIE? *placeholder* CONSIDERATIONS AND NOTES Each step in the guide will start on a new page, making it easier to navigate. Throughout the guide are red NOTE sections (like the one above) which highlight important information. Setup a separate folder on your computer for the raspberry pi, then setup separate folders for downloads, software, images, roms, configuration files and backups. This guide takes some time, get some food, coffee and play some background music. This guide does not cover the setup of joysticks, do a Google search or check out the RetroPie forums This guide takes the long route, this is because many RPi owners also purchase a NOOBS pre-installed SD card, this guide considers those users so that they can install the OS from the SD card and continue from there. If you want an easier installation, see Note: Super Easy Mode above. WHAT YOU NEED FOR THIS GUIDE NOTE: NOOBS SD Card Owners If you have a NOOBS pre-installed SD card then you do not need an additional SD card or the SD card reader (though having one is very useful). In addition, you can skip Step 2: SD Card Setup Transferring NOOBS HARDWARE: 1. Windows PC I used Windows 8 2. Raspberry Pi Model B I used the revision with 512mb RAM 3. Power Adapter For the Raspberry Pi, I suggest a 5v 1500mA to provide enough power 4. Monitor, Keyboard and Mouse If you have a spares this saves some hassle, however the guide will explain the process of connecting remotely to the Raspberry Pi (see Optional Step: Connect to the RPi via LAN) 5. SD Card and SD Card Reader The SD Card should be a suitable size for the installation and your roms, minimum of 6GB suggested on the RPi Website, I used a 32GB Class 10 SD Card. 6. RJ45/Ethernet Cable You need to connect the Pi to the internet for this guide. 7. HDMI or RCA Cable For video output. SOFTWARE
1. NOOBS Offline and Network Install http://downloads.raspberrypi.org/noobs_latest 2. SD Formatter v.4.0 https://www.sdcard.org/downloads/formatter_4/ 3. USB Stick/SD Card Image Writer http://sourceforge.net/projects/win32diskimager/ OPTIONAL Raspberry Pi Case keeps it safe from any accidents that may occur, makes it a bit sturdier and makes it look nice. PuTTY a terminal emulator that allows you to connect remotely to the RPi via SSH. http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
STEP 1: RASPBERRY PI HARDWARE SETUP Probably the easiest part of this guide, plugging everything in: 1. Place your RPi somewhere suitable. 2. Plug the keyboard and mouse into the USB ports. 3. Plug the HDMI cable or RCA cable into the correct output on the RPi. 4. Plug the RJ45/Ethernet cable into the LAN port. No need for power or the SD card just yet, move on to the next step to setup a fresh SD card. NOTE: Shutting down your RPi http://www.raspberrypi.org/help/faqs/ Failure to shut down the Raspberry Pi correctly may corrupt your SD card, and you will have to re-image it. If you are in the graphical environment, either exit to the bash prompt or open the terminal. From the bash prompt or terminal shut down the Raspberry Pi by entering: sudo halt -h Wait until all the LEDs except the power LED are off, then wait an additional second to make sure the SD card can finish its wear levelling tasks and write actions. You can now safely unplug the Raspberry Pi.
STEP 2: SD CARD SETUP TRANSFERRING NOOBS *SKIP THIS STEP IF YOU HAVE A PRE-INSTALLED NOOBS SD CARD* This step will format the SD card and transfer the NOOBS installation files to the card. SD CARD FORMATTING 1. Plug in your SD card reader 2. Plug your SD card into the reader o Make sure the SD card shows in Windows. 3. Run SDFormatter, the following screen will show: 4. Make sure to choose the correct drive! 5. Click on Option o You can adjust Format Type to what you like, I choose QUICK to save time. o Make sure Format Size Adjustment is set to ON. This option formats the entire SD card. o Click OK 6. Now click Format o The program may advise you that data may be retrieved with a quick format, as I am the only one who is likely to use this SD card I am happy with that. Click OK o Are you sure you want to format? yes I am, click OK o A status box will appear confirming that the card has been formatted. 7. Close SDFormatter So we now have an empty SD card to work with, now to get NOOBS on there. TRANSFERRING NOOBS You should have the NOOBS archive downloaded (the version I used was NOOBS_v1_3_5). 1. Open the NOOBS zip archive. 2. Open your SD Card in windows. 3. Move the entire contents from the NOOBS archive to the SD Card. If that worked, you now have an SD card that you can plug into your RPi, move onto the next step to install the operating system.
STEP 3: RASPBIAN OS INSTALLATION So you should have your NOOBS SD card ready to go. 1. Make sure the monitor, keyboard, mouse and RJ45/Ethernet cable are plugged into the RPi 2. Plug the SD card into the RPi 3. Plug your power cable into the RPi a. The RPi will now start booting 4. The NOOBS installer should load and you should see a GUI on your monitor 5. Tick the box next to Raspbian from the list 6. At the bottom of the screen are two dropdown boxes; language and keyboard. Adjust these now according to your country and keyboard setup 7. Click Install Raspbian is now installing and should show a progress bar. Once the operating system is installed, the RPi should reboot into the Raspberry Pi Software Configuration Tool, also known as raspi-config. Now for Step 4: Raspbian OS Configuration and Update NOTE: Connecting to your RPi remotely Raspbian has a neat piece of software that runs during boot that allows you to connect remotely to it via SSH. This means you can disconnect your monitor, keyboard and mouse from the RPi and go back to your main PC, from there you can run a great piece of software that will connect to the RPi via SSH and emulate the terminal, allowing you to control everything from the comfort of your PC. Go to the next page for more information.
OPTIONAL STEP: CONNECT TO YOUR RPI REMOTELY Once the OS is installed, you can actually connect to the RPi via SSH (if you know the IP for the RPi). This allows you to complete the remaining steps of the guide from the comfort of your own computer, this step is optional but makes things easier if you only have the one monitor/keyboard/mouse setup. On your Windows PC do the following: 1. Download Putty a. Go to http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html b. Download PuTTY.exe 2. Find the IP Address of the Pi Two options here, a. or b. a. Run a cmd terminal from the start menu i. Type arp a and hit enter, a list of IP addresses on the network should show, one of these will be the RPi. b. Login to the web based GUI of your router - Normally this will be the gateway IP such as 192.168.0.1 i. Find the list of attached devices connected to the LAN. The RPi will show as raspberrypi and the IP address should show. 3. Run Putty a. Run the PuTTY application downloaded earlier. b. Enter the IP address for the RPi c. Make sure SSH is selected d. Click Open i. Now, login to the RPi - username: pi password: raspberry You should now be greeted with the following You have successfully logged in over the network! Now for the next step, you will need to run raspi-config, in the putty terminal, enter the following: sudo raspi-config Now go to the next step Step4: Raspbian OS Configuration
STEP 4: RASPBIAN OS CONFIGURATION Once the OS has installed you will be greeted with raspi-config, a configuration utility that runs inside the terminal. From here, you have a number of options for configuring your Raspberry Pi, I will not explain every option as it is mostly self-explanatory. Here is the raspi-config screen: Remember, if you need to run this program from the terminal you can enter this command: sudo raspi-config RASPI-CONFIG NOTE: File System Expansion and Internationalisation Options If you installed via NOOBs, your file system will be expanded already, in addition the locale settings will be the ones chosen at installation, and you can adjust these by choosing option 4 Internationalisation Options. Here are the steps to get Raspbian setup. 1. Overscan If you are using the HDMI output then you may have black border around the screen, if not you can skip this step. a. Select 8 Advanced Options b. Select A1 Overscan c. Select Disable 2. Memory Split This will set the amount of memory available to the GPU. a. Select 8 Advanced Options b. Select A3 Memory Split c. Set this to 128 Why 128? This is what is suggested in the RetroPie setup script, this can be adjusted later to increase performance in some emulators. d. Hit OK 3. Overclock overclock the RPi to make it run faster! a. For now we will leave this set to none Why none? Depending on the emulators and roms you intend to use this option can be very useful to increase performance, for the time being we will leave this set to none while we install and configure the RPi and RetroPie. 4. Finish
a. Press the right arrow twice to select finish, now hit enter. b. You will be asked Would you like to reboot now? Select Yes i. If you are connected via PuTTY your connection will be disconnected as the RPi is rebooting, don t worry, close and open PuTTY again after 45 seconds or so. So that s it, Raspbian OS is installed and setup, now to install all the updates. Onto the next step, installing updates to Raspbian OS. NOTE: Running the desktop environment If you really want to see the shiny Raspbian OS GUI desktop you can use the following command in the terminal: startx Do not run this command if you are in PuTTY, it will cause an error and you will have to
STEP 5: UPDATING THE RASPBIAN OS NOTE: every command is case sensitive, file names included. *Make sure that your RPi is connected to the internet via the Ethernet cable* sudo apt-get update This will download package lists from the Raspbian online repositories (and a few others) and update the package lists on your RPi. So now your system knows which packages need updating, you need to enter the command to actually update them: sudo apt-get upgrade y This command tells the system to download and install the packages (the command will normally ask you if you wish to continue, the y enters yes for this so you don t have to) So now your system will be downloading all the updates for the various packages, this will take a while, go grab a drink and come back in 10-15 minutes. RetroPie requires that your system has the Git and dialog packages installed and up to date. sudo apt-get install -y git dialog This will install the latest packages for git and dialog, pretty easy if I say so myself. Don t worry if the Git package doesn t install, this may be already installed and upgraded. Now the system is fully updated and everything is ready to install retropie, go to the next step.
STEP 6: INSTALLING RETROPIE Now that Raspbian is installed and updated, we can go ahead and install retropie. This is relatively, all we have do to is download the retropie script from github, and then execute it To download the script use this command: git clone --depth=0 git://github.com/petrockblog/retropie-setup.git This should take 15-20 seconds, depending on the connection. Now to execute the script, firstly we have to navigate to the folder that has the script cd RetroPie-Setup now we have to execute a change mode command, this will adjust access permissions so that the script can install everything. chmod +x retropie_setup.sh You won t get any confirmation that this has worked, but it is fine, continue with executing the script. sudo./retropie_setup.sh You should see this screen: It may look a bit different (I am using PuTTY) So you have two options to choose from, both will install the complete RetroPie setup, but each is different. Option 1 Binaries (faster) This will download pre-compiled binaries for the various emulators and install them. This means that your emulators may not be upto date. Option 2 Source (much slower) This will download the source files and the compile them into the binaries, this will make sure you have the most recent versions of each emulator, but takes a very very long time. I would suggest Option 1, but if you have the time and patience then go for Option 2. This part takes a while, go have lunch. Right, now that s done you should be returned to the main setup screen. A good idea would be to update the RPi firmware, the RetroPie setup script can do this for you.
Go to 3 SETUP and select 2 Install latest Rasperry Pi firmware This will take a few minutes, once it is done you need to go back to the main setup screen and select 7 Perform REBOOT Restart the setup script Go back to setup and do some more changes, install xbox drivers if you want those.