Software installation for the Super Rasptendo Case
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
halt_wake.py
halt_wake_non_gpiozero.py
install.sh
recalbox_install.sh

README.md

RASPTENDO Case with SNES inspired Power and Reset Buttons

RASPTENDO Case is an SNES inspired enclosure for your Raspberry Pi 3. Esthetically, the case seamlessly aligns with the retro themed RetroPie game station OS. The RASPTENDO case includes a built-in POWER and RESET buttons, and a Status LED to signal power status. The section below provides a step by step guide on how to make it work.

Getting Started

The RASPTENDO POWER button safely switches off your Raspberry Pi 3 to avoid corrupting your SD card when you cut off the power supply. The button is programmed to be held for a second before executing the shutdown command to prevent accidental power off.

There are two ways you can mod the RASPTENDO RESET button, one for soft reboot and one for hard reset. For more information about choosing the right mod for you, please visit this page.

To install the software for your Rasptendo you can choose from the following options.

Option 1: Executing a one line bash script in the terminal

Option 2: Editing configuration files and running a python script on startup in the terminal

Option 1 is the simplest way to install necessary software for your Rasptendo case. The script automatically configures your RetroPie for the Rasptendo buttons to work.

Prerequisites

  1. RetroPie

    To install Retropie you may download the image for Raspberry Pi 3 and follow installation instruction at the Argon40 website.

  2. Internet connection

    To set up your internet via WiFi, you can follow instructions here.

  3. Keyboard and screen, or any computer/laptop (via SSH)

    To access your Pi via SSH, you can also follow instructions here.

  4. Rasptendo SNES Case

    You may purchase from the link here.

Installation

(NOTE: This assumes that you have already connected the jumper wires to the correct PINS and ports. It's very important to follow the right pin configuration to prevent damage to your Pi. If you haven't, you can follow the instructions here.)

This instruction is a step-by-step guide to install necessary software for your RASPTENDO Case. You can setup this via SSH or using the command line interface in your RetroPie. To enter the command line interface of RetroPie, PRESS F4 just after booting up.


Option 1: via Bash

Open your terminal and type the one-line installation command below:

$ wget -O - "https://raw.githubusercontent.com/Argon40Tech/Super-Rasptendo-Case-Power-Switch/master/install.sh" | sudo bash

The script will automatically install pertinent files and configure your Raspberry Pi to enable RASPTENDO POWER Button. Installation will automatically reboot once all processes are completed.

Testing the buttons

After rebooting, your RASPTENDO Case Buttons are now fully functional. To test if your buttons work, try holding the POWER button. The status LED should start blinking and if you held the button for a second, your Raspberry Pi should shutdown. To "wake" it up, you can press the POWER button again.


Option 2: Installing manually

Open your terminal and follow instructions below.

Step 1 - Enabling UART

The Status LED should be connected to the GPIO 14 or PIN 8 serial port so make sure it is enabled. In your terminal, type:

$ sudo nano /boot/config.txt

Check if UART is already enabled by searching for a line at the config.txt with

enable_uart=1

if it's not, add that line at the bottom. Save the file by typing CTRL + X, hit Y, then Enter.

Step 2 - Update your repository

Type

$ sudo apt-get update

to make sure your list of packages and PPA's is up to date.

Step 3 - Install the GPIOZero module

In order for the POWER button to work, you have to install GPIOZero.

$ sudo apt-get install python3-gpiozero

If you want to know more about GPIOZero, you can read the official documentation.

Step 4 - Set up the python script

Change to the /opt/ directory

$ cd /opt/

and create a directory for the script,

$ sudo mkdir Rasptendo

Change to the newly created directory and download the python script using wget.

$ cd /opt/Rasptendo
$ wget "https://raw.githubusercontent.com/Argon40Tech/Super-Rasptendo-Case-Power-Switch/master/halt_wake.py"

Step 5 - Enable the python script to run on background every start up

In order for the script to run on every boot up, you have to add a command in /etc/rc.local.

$ sudo nano /etc/rc.local

Before the line,

exit 0

add the following command,

sudo python3 /opt/Rasptendo/halt_wake.py

Save the file by typing CTRL + X, hit Y, then Enter.

Step 6 - Reboot to apply changes

$ sudo reboot

Testing the buttons

After rebooting, your RASPTENDO Case Buttons are now fully functional. To test if your buttons work, try holding the POWER button. The status LED should start blinking and if you held the button for a second, your Raspberry Pi should shutdown. To "wake" it up, you can press the POWER button again.

Notes

[1]: Wake from halt