You should use a high quality stranded jumper cable, at least for the GND and 5V connections.
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:
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):
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:
- 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.