Raspberry Pi Setup Guide - Revision history

Widge: /* Installation */

2024-04-19T19:06:23Z

Installation

ProfessorgLX: checksum of bb9.1

2023-02-21T23:32:09Z

checksum of bb9.1

Widge: /* Installation */ typo

2023-01-28T23:51:12Z

Installation: typo

Widge: /* Installation */ typo

2023-01-28T23:50:13Z

Installation: typo

Widge: /* Installing BIOS and Games */ Link to compatibility list changed to the wiki list rather than the old lightgun.tech website.

2023-01-16T19:53:17Z

Installing BIOS and Games: Link to compatibility list changed to the wiki list rather than the old lightgun.tech website.

Widge: Moved Overscan and Overclocking to the FAQ

2023-01-11T23:15:04Z

Moved Overscan and Overclocking to the FAQ

Widge: /* What changes are applied in the update? */ formatting

2023-01-07T22:12:26Z

What changes are applied in the update?: formatting

Widge: BB9.1 Update

2023-01-07T20:43:08Z

BB9.1 Update

McShufts at 14:46, 31 December 2022

2022-12-31T14:46:43Z

McShufts: Justifier link update, formatting and typos

2022-12-31T14:46:29Z

Justifier link update, formatting and typos

Show changes

@@ Line 41: / Line 41: @@
 ''(The older BB9.0 can still be downloaded from [https://www.mediafire.com/file/akaaukvia7eektk/BB90.img.gz/file Mediafire] or [https://onedrive.live.com/download?cid=A37C84E9DA388D6B&resid=A37C84E9DA388D6B%21432735&authkey=AEdNDP7tgDBJT4I OneDrive], however we strongly recommend using the newer 9.1 image which includes bug fixes and improvements).''
+There's no need to extract the .img file from the .xz. Use software such as [https://www.balena.io/etcher/ BalenaEtcher] or [https://www.raspberrypi.com/software/ Raspberry Pi Imager] to then flash the image to your micro-SD card. The two programs mentioned are capable of writing the image without extracting from the compressed .xz file, but if your image fails to work then it might be more reliable to extract the .img file and reflash it.
-Extract the .img file from the .xz using software such as 7zip or WinRar.
-Use software such as [https://www.balena.io/etcher/ BalenaEtcher] or [https://www.raspberrypi.com/software/ Raspberry Pi Imager] to then flash the image to your micro-SD card. The two programs mentioned are capable of writing the image without extracting from the compressed .xz file, but it can be more reliable to extract the image first. If your image fails to work then reflash the image after extraction.
 === Running for the first time ===

@@ Line 37: / Line 37: @@
 === Installation ===
-'''Download''' the latest '''BareBones 9.1''' image from [https://www.mediafire.com/file/tho10qwx1alaoki/bb91.img.xz/file Mediafire] or [https://onedrive.live.com/download?cid=A37C84E9DA388D6B&resid=A37C84E9DA388D6B%21455499&authkey=ABfXhzxeBOHqikY OneDrive].  ''Filename <code>bb9.1.img.xz</code> md5 checksum <code>b1402b6f62e565e0e575c7d278ccdfe9</code>''
+'''Download''' the latest '''BareBones 9.1''' image from [https://www.mediafire.com/file/tho10qwx1alaoki/bb91.img.xz/file Mediafire] or [https://onedrive.live.com/download?cid=A37C84E9DA388D6B&resid=A37C84E9DA388D6B%21455499&authkey=ABfXhzxeBOHqikY OneDrive].  ''Filename <code>bb9.1.img.xz</code> md5 checksum <code>4F6A8C0EBA484C9B708D4F1CEE25B70A</code>''
 ''(The older BB9.0 can still be downloaded from [https://www.mediafire.com/file/akaaukvia7eektk/BB90.img.gz/file Mediafire] or [https://onedrive.live.com/download?cid=A37C84E9DA388D6B&resid=A37C84E9DA388D6B%21432735&authkey=AEdNDP7tgDBJT4I OneDrive], however we strongly recommend using the newer 9.1 image which includes bug fixes and improvements).''

@@ Line 49: / Line 49: @@
 Once you have your freshly flashed card, carefully slot it into the Micro-SD slot in your pi.
-Connect the TV to your pi using ensuring that you plug the cable into the micro-HDMI port that is nearest to the USB-C port on the pi. Be mindful that some cases (notably ''Argon'' cases) might rearrange the order of the ports, if your pi boots up to a blank screen, or just some plain text, try the other HDMI port.
+Connect the TV to your pi ensuring that you plug the cable into the micro-HDMI port that is nearest to the USB-C port on the pi. Be mindful that some cases (notably ''Argon'' cases) might rearrange the order of the ports, if your pi boots up to a blank screen, or just some plain text, try the other HDMI port.
 [[File:Pi4 USB order.png|thumb|The USB boot order on a Raspberry Pi]]
 Connect your Sinden Lightgun(s) to the pi.  The player order is determined by the USB port so connect them in this order – 1. top-right (blue), 2. bottom-right (blue), 3. top left (black), 4. bottom-left (black).

@@ Line 41: / Line 41: @@
 ''(The older BB9.0 can still be downloaded from [https://www.mediafire.com/file/akaaukvia7eektk/BB90.img.gz/file Mediafire] or [https://onedrive.live.com/download?cid=A37C84E9DA388D6B&resid=A37C84E9DA388D6B%21432735&authkey=AEdNDP7tgDBJT4I OneDrive], however we strongly recommend using the newer 9.1 image which includes bug fixes and improvements).''
-Extract the .img file from the .gz using software such as 7zip or WinRar.
+Extract the .img file from the .xz using software such as 7zip or WinRar.
 Use software such as [https://www.balena.io/etcher/ BalenaEtcher] or [https://www.raspberrypi.com/software/ Raspberry Pi Imager] to then flash the image to your micro-SD card. The two programs mentioned are capable of writing the image without extracting from the compressed .xz file, but it can be more reliable to extract the image first. If your image fails to work then reflash the image after extraction.

@@ Line 89: / Line 89: @@
 All systems that require it will have this folder already in place for you. Daphne is an exception to this which uses Actionmax and Hypseus emulators which do not play nicely with subfolders, so daphne games should be set up as per [[Action Max|the existing guidance in the wiki]].
-Secondly, the filenames must match what the config files are expecting.  We’ve decided to go with the no-intro naming scheme here as a widely recognised standard.  Check the [https://lightgun.tech/game-compatibility-list/ compatibility list] for the filenames expected. The only Retroarch-based exceptions here are the C64 system and Tic-80.  As far as we know there is one online source that provides a working set of C64 lightgun games and we decided to match the filenames from that set for simplicity’s sake, and Tic-80 doesn't follow no-intro naming, so we didn't deviate from the filenames as they are named on the Tic-80 site from where they can be downloaded. Daphne also doesn’t require this rule to be adhered to as it is not a Retroarch-based system.
+Secondly, the filenames must match what the config files are expecting.  We’ve decided to go with the no-intro naming scheme here as a widely recognised standard.  Check the [[Barebones Compatibility|compatibility list]] for the filenames expected. The only Retroarch-based exceptions here are the C64 system and Tic-80.  As far as we know there is one online source that provides a working set of C64 lightgun games and we decided to match the filenames from that set for simplicity’s sake, and Tic-80 doesn't follow no-intro naming, so we didn't deviate from the filenames as they are named on the Tic-80 site from where they can be downloaded. Daphne also doesn’t require this rule to be adhered to as it is not a Retroarch-based system.
 Barebones has been pre-configured to use the most appropriate and best-performing emulator for MAME-based arcade games, and as different arcade emulators require ROMs from different ROMsets it is important to make sure you use the correct ROMs. Using a ROM from a mismatched set may result in poor performance or a non-working game.  Check the compatibility list for the correct ROMset versions needed for each game and any additional files that arcade games might require.

@@ Line 115: / Line 115: @@
 [[File:Pi4 overscan bad.png|thumb|Example of a display with bad overscan settings. Note that you cannot see the white border and part of the image, including the game's title is cut off.]]
 [[File:Pi4 overscan good.png|thumb|Example of a display with good overscan settings. The white border is clearly visible around the edges and fits neatly within the TV's frame.]]
-Overscan is a behaviour in certain television sets, in which part of the input picture is shown outside of the visible bounds of the screen. It exists because cathode-ray tube (CRT) television sets from the 1930s through to the early 2000s were highly variable in how the video image was positioned within the borders of the screen. It then became common practice to have video signals with black edges around the picture, which the television was meant to discard in this way. Today's displays, being driven by digital signals (such as DVI, HDMI and DisplayPort), and based on newer fixed-pixel digital flat panel technology (such as liquid crystal displays), can safely assume that all pixels are visible to the viewer, but this is not always the case and often a TV will cut the edges off an image in a mistaken effort to remove the "unneeded" edges of the image.
+Overscan is a behaviour in certain television sets, in which part of the input picture is shown outside of the visible bounds of the screen. If you start a game and you can see bezels but no border then your TV is not displaying the whole image, but actually cropping off the edges.  Follow the advice in the [[Barebones FAQ|FAQ]] to resolve this.
-You might not realise that your display is doing this until you start a game and notice that you can't see the white border around the edge of the frame necessary for the Sinden Lightgun to work. This might be because your display is positioning the image in such a way that the border is outside of the frame. If you find that the edges of your image are missing, this might be an issue with the way your display handles overscan.
-As all TVs and monitors are widely different and handle this in different ways, there are several courses of action that you can take. Your TV might have an option to disable/enable overscan. If it does, try toggling it to see if it makes a difference. Some TVs might name this setting clearly with the word "Overscan", but others may not - for example, some Samsung TV's have a picture size option called "Screen Fit", which solves this problem if selected.
-If you can't resolve an overscan issue with your TV/monitor settings, then there are settings on the Raspberry Pi which will take care of it. In <code>/boot/config.txt</code> find the section near the top with the four overscan settings. It looks like this:
- # uncomment the following to adjust overscan. Use positive numbers if console
- # goes off screen, and negative if there is too much border
- overscan_left=2
- overscan_right=2
- overscan_top=2
- overscan_bottom=2
-Now, just make those numbers bigger to bring that picture back into frame. A good place to start might be with '''<code>16</code>''' then adjust up or down as necessary. The desired result is to have the image fit neatly inside the frame of your set without cropping out any of it and without creating a new black border around it. It is possible that each of your edges might need different values to achieve it, but this is rare. Remember that each time you make a change you will need to save <code>/boot/config.txt</code> and restart the Pi for it to take effect.
 === Overclocking ===
-Whilst your Pi, as it is can run many games, there are a few games that would benefit from the extra performance that can be gained from overclocking the CPU and GPU. Bear in mind that the Raspberry Pi is a low-cost computer with limited capability, we've tried our best to get as much working as possible, but an overclock may be necessary for some of those outliers.
+Whilst your Pi, as it is, can run many games, there are a few games that would benefit from the extra performance that can be gained from overclocking the CPU and GPU. Bear in mind that the Raspberry Pi is a low-cost computer with limited capability, we've tried our best to get as much working as possible, but an overclock may be necessary for some of those outliers.
-As overclocking will void the warranty on your Pi, we've taken the view that the decision to overclock should not be made for you and will leave it to you to decide to implement it. So we have shipped Barebones with stock clock settings. However, should you choose to overclock, it is easy for you to do.
-We have provided some suggested settings to use, so should you choose to overclock your Pi, it is a relatively straightforward process.
-'''Please note that overclocking your Pi will invalidate any warranty that you may have. You do so at your own risk. We will not be held accountable for any damage caused by overclocking, so please make sure you are comfortable with the risk before proceeding.'''
-The overclock settings can be found in <code>/boot/config.txt</code>. Open the file up in a text editor and scroll down near the bottom of the file where you will see the following section:
- # Uncomment to overclock the arm. 700 MHz is the default.
- # Be advised that overclocking your Pi is done at your
- # own risk and will invalidate your warranty.
- #over_voltage=6
- #arm_freq=2000
- #gpu_freq=700
- #force_turbo=1
- #gpu_mem=256
-<blockquote></blockquote>The hash <code>#</code> at the start of each line means that the line is considered a "comment" for annotation purposes so will be ignored by the system. Remove the <code>#</code> from the beginning of the five lines of settings to "uncomment" them, ensuring that you leave the <code>#</code> in place for the three lines above that form the description.  The result should look like this:
- # Uncomment to overclock the arm. 700 MHz is the default.
- # Be advised that overclocking your Pi is done at your
- # own risk and will invalidate your warranty.
- over_voltage=6
- arm_freq=2000
- gpu_freq=700
- force_turbo=1
- gpu_mem=256
-Once done, save and exit the file. When you next reboot your Pi the overclock will be in place.
-We should note that not all Pi4 boards are created equal so some Pis might be able to stand up to more aggressive settings, and others might require a little dialling back.  The settings we provide should be good for most Pis, but are provided as an example only. Please do some research into overclocking to find your ideal settings.  Some users have reported some crashes with the provided settings, if you do then consider changing the gpufreq to <code>gpufreq=650</code> which might be more universally reliable.
+For advice on overclocking your Pi, please read the detailed section in the [[Barebones FAQ|FAQ]].
-This isn't a magic fix for ''all'' games however.  Some games just don't run well on the pi no matter what we do.
 ===What if I do something wrong!?===
 If you accidentally delete or change one of the config files and want to restore it to its original state, backups of the config files are available an [https://github.com/Widge-5/sinden-barebones-configs '''Widge's github repository''']. You can also download a zip of the whole repo using this link: https://github.com/Widge-5/sinden-barebones-configs/archive/refs/heads/main.zip
@@ Line 201: / Line 160: @@
 Be aware that not all SSH terminal utilities are created equally and we can only really vouch for PuTTY as being reliable.  Some SSH utilities cause the install script to fail when downloading the new files (Windows Terminal is a known culprit), so please either use the command line on the pi itself or SSH with PuTTY.
-'''It would be very wise to make a backup of your image beforehand in case of unexpected side effects'''.  The update script has been thoroughly tested, but it is possible that some customisations you may have made to your image might be undone, cause conflict or have a random unknowable effect.  The update is, first and foremost, an update from a standard BB9.0 image and it isn't possible to account for every personal choices and preference made so keep that in mind if you have made some significant personalisation to your barebones image.
+'''It would be very wise to make a backup of your image beforehand in case of unexpected side effects'''.  The update script has been thoroughly tested, but it is possible that some customisations you may have made to your image might be undone, cause conflict or have a random unknowable effect.  The update is, first and foremost, an update from a standard BB9.0 image and it isn't possible to account for every personal choice and preference made so keep that in mind if you have made some significant personalisation to your barebones image.
 === How to run the update ===
@@ Line 214: / Line 173: @@
  sudo ./bb91update.sh
-You will be asked to confirm that you wish to proceed, then script will check to ensure that you are running it on a BB9.x system before proceeding.
+You will be asked to confirm that you wish to proceed, the script will then check to ensure that you are running it on a BB9.x system before proceeding.
 The script can take around 15minutes to complete but this may vary depending on your internet connection.

@@ Line 175: / Line 175: @@
 * Updated lr-mame2003-plus which fixes alignment in Maximum Force;
 * Updated StormedBubbles versions of the mame cores which introduces support for following ARCADE games:
+** Avalanche, Bomb Bee, Battle Shark, Cutie Q, Destroyer, Gee Bee, Lock On, Monkey Magic, Seawolf, Seawolf 2, Space Harrier, Sky Raider, Tail Gunner, Top Gunner, Wild Pilot;
-** Avalanche
-** Bomb Bee
-** Battle Shark
-** Cutie Q
-** Destroyer
-** Gee Bee
-** Lock On
-** Monkey Magic
-** Seawolf
-** Seawolf 2
-** Space Harrier
-** Sky Raider
-** Tail Gunner
-** Top Gunner
-** Wild Pilot
 * lr-mame-StormedBubbles pre-assigned as the emulator to run the above newly supported games.;
 * Corrections to emulators designated to run the following ARCADE games:
-** Firefox (lr-mame2010-StormedBubbles)
+** Firefox (lr-mame2010-StormedBubbles), Point Blank 2 (lr-mame2010-StormedBubbles), Sports Shooting USA (lr-flycast);
-** Point Blank 2 (lr-mame2010-StormedBubbles)
-** Sports Shooting USA (lr-flycast)
 * An update script at <code>/home/pi/SBupdater.sh</code> which you can run at any time in the future to ensure you are using the latest StormedBubbles MAME versions.
 * A readme.txt file in the daphne rom folder with advice on how to set up the actionmax symbolic links.
@@ Line 202: / Line 186: @@
 ** Supermodel can also be exited by pressing both gun-right-side buttons together. Keyboard <code>Escape</code> also still exits.
 * New precise gun calibrations applied to the following ARCADE games:
+** Sports Shooting USA, Golly Ghost, Point Blank 2, Area 51, Maximum Force, Area 51 / Maximum Force Duo, Police Trainer, Sharpshooter;
-** Sports Shooting USA
-** Golly Ghost
-** Point Blank 2
-** Area 51
-** Maximum Force
-** Area 51 / Maximum Force Duo
-** Police Trainer
-** Sharpshooter
 * Corrections to button configs for a few games (e.g. Alien 3 which previously launched grenades when a coin was inserted)
 * New bezel overlays for all newly supported games and some already-supported games that were missing overlays before. (If you are using a 4:3 display and have taken steps to remove the bezels, you will need to repeat the process for the new games listed);

@@ Line 63: / Line 63: @@
 At this point we recommend that you then connect your Raspberry Pi to your local Wi-Fi as this will likely be the primary way you will transfer games onto your system. You can do this by going to the RetroPie group and the Wi-Fi settings option in the list.
-=== Calibrating your gun(s). ===
+=== Calibrating your gun(s) ===
 [[File:Pi calibration view.png|thumb|The calibration screen in Barebones 9]]
 In the Sinden Lightgun menu you will see a “Test and Calibration” sub-menu.  Enter it then select the test for the port number (as specified above) for the gun you want to calibrate. If a gun is connected, it will load the calibration screen.