Assembly & Install

To ensure stability you will need a good power supply (as recommended anyway), at least a 5V 2A power supply to power the ATXRaspi. If you plan to use the Pi touchscreen/LCD and/or fan, use a 2.5A supply (eg. the CanaKit 2.5A supply is great)

Cheap eBay/chinese jumper wire is not good for powering your Pi from ATXRaspi especially if you have a Pi3 or any other peripherals like a touch screen, fan, etc. They are very thin and poorly crimped, and will drop voltage and trigger the Pi low voltage warning.

You should use a high quality stranded jumper cable, at least for the GND and 5V connections.

You should not plug in power to the RaspberryPi directly while ATXRaspi is powering the Pi

First get familiar with the basic operation and setup of ATXRaspi. Here is a video walkthrough, showing the operation with a momentary button (this demo uses Raspbian):

1. Connect your RaspberryPi to ATXRaspi.

Remember: ensure RaspberryPi is disconnected from power since ATXRaspi will power your Pi. The GPIO 7 & 8 pins are given as examples, you may change them to others as convenient (update the script as well), or if you have a Rev 2.0 Pi you can use the P5 header instead.

There are a few ways to wire your ATXRaspi to your Pi. The most common and supported in all versions is the single momentary button operation – this is the out-of-box default behavior. Here is a wiring example using micro USB for input and GPIO for powering the Pi:

You can also use the optional 2.1mm jack for input and the USB-A and cable for output, instead of the micro USB and GPIO:

Slide / latching switch operation

In ATXRaspi R2.8 you have a jumper setting on the bottom of the PCB, which if shorted (bridged with solder) will put the board in latching button operation, no other parts are required. This is very useful for folks who want to incorporate ATXRaspi in their SNES consoles which have a slide POWER switch.

Here is how you would wire your latching/push-pull/slide switch to ATXRaspi:

In latching mode, if you would like a dedicated reset button, separate from the main power button, you can wire it as shown below:

In ATXRaspi R2.7 only (or R2.6 with gold dot) you can also use a slide switch (or rocker, toggle, latching switch), but you will need to solder an external 10K resistor as shown below (in R2.8 this is included on the board and only a jumper is required, see section above). In addition, you can wire a separate reset button in latching mode. Note this mode requires the additional resistor(s):

As mentioned before you should use high quality wires (especially for the power signals), and keep them short. They should make strong connections to the headers on both ends. Poor wiring of power connections may cause voltage drops, and while your Pi may run just fine at 4.65v low voltage threshold, it will trigger the annoying low voltage warning (rainbow or thunderbolt in upper corner of the screen).

2. Install required script

  • On Raspbian or Debian based distro:
sudo wget https://raw.githubusercontent.com/LowPowerLab/ATX-Raspi/master/shutdownchecksetup.sh
sudo bash shutdownchecksetup.sh
sudo rm shutdownchecksetup.sh
sudo reboot

This will install a bash script (/etc/shutdowncheck) and register it to be started at the end of the boot process (adds a line to /etc/rc.local). So once your Pi reboots it should start the shutdowncheck script and you should see this message (if you’re not booting to the GUI):

ATXRaspi shutdowncheck script started: asserted pins (7=input,LOW; 8=output,HIGH). Waiting for GPIO7 to become HIGH…

That indicates the script has started and is running, waiting for a shutdown signal from ATXRaspi. The shutdown script will take on average 0.7% of the CPU:

CPU_percent

  • On OpenElec:
wget https://raw.githubusercontent.com/LowPowerLab/ATX-Raspi/master/shutdownchecksetupOpenElec.sh
bash shutdownchecksetupOpenElec.sh
rm shutdownchecksetupOpenElec.sh
reboot

This will install a bash script (/storage/.config/shutdowncheck.sh) and register it to be started at the end of the boot process (via /storage/.config/autostart.sh). So once your Pi reboots it should start the shutdowncheck.sh script, and the BootOK LED should turn ON. Here’s a quick check via SSH that the scripts were installed and shutdowncheck.sh is running (after the reboot):

3. Done! Your Pi should now be able to turn on, reboot and shutdown from the power button.