This is a configurable Python service to run on Raspberry Pi and use pin GPIO3 to trigger system shutdown.
raspi-gpio3-shutdown runs a Python script as a service on Raspberry Pi. It uses the GPIO Zero package which allows selecting among various underlying pin factories. Tested with pigpio library only. The service expects a NO (normally open) button connected to GPIO3 (SCL) and any GND (ground) pin on the Raspberry pin header. This will on one hand shutdown the system when the button triggers a configured event, and on the other hand allows automatically restarting the system with another press of the button.
- pigpiod (or another supported pin factory library)
- GPIO Zero
- python3-systemd
After download, configure the serive by editing the file raspi-gpio3-shutdown.conf (see Configuration). Then simply run the script install in the script sub-folder. It will download and install the required packages, copy the files to their destinations, will register the service, and finally start it.
For uninstall, use the second provided script uninstall.
If you like to change the configuration while your system is running, you might use the script restart. This will copy the changed configuration file to /etc folder (overwrites previous version!), and then restart the service.
The configuration is defined in the file raspi-gpio3-shutdown.conf. Before installation, you will find it in the folder where you unzipped the package files. After installation, the active version is in /etc folder.
The configuration file requires a section [GPIO] with one mandatory key Button. The Button key must be created based on this pattern:
Button = press|release|hold|holdrelease[,holdtime_s]press|release|hold|holdreleaseDetermines the event for triggering the system shutdown.
holdtime_s(optional) Defines the time in seconds to trigger an hold button event; default is 2 seconds.
e.g.
Button = holdrelease,1.5
configures pin GPIO3 to trigger the shutdown after the button has been held for at least 1.5s and was finally released.