This article was last edited over 3 years ago. Information here may no longer be accurate. Please proceed with caution, and feel free to contact me.
I have been enjoying the Adafruit PiTFT 2.8" Resistive Touchscreen Display for Raspberry Pi. It is a nice, simple, touch display, and it has taught me a few distinctions regarding system power offs.
There is a kernel module called
rpi_power_switch included with the Adafruit Raspbian
Jessie image. That module is used to power the system on and off
when a button on the TFT board is pressed. By default, the button
is tied to GPIO pin
The button works great for me, but I noticed that the screen remains on when the system is powered “off”. This led me to the distinction between halting a system, and powering a system off. Halting stops system activity and brings the machine to a state where the plug could be pulled safely. Powering off a machine means to halt and then also send a signal to cut the power.
Most modern PCs perform a halt, and also cut the power to the machine. I believe that the Pi does not support this because it does not support ACPI. So the Pi cannot really cut off its own power. This can only be done with additional work, or by pulling the plug.
I have never worked with kernel modules, but it
rpi_power_switch module overrides the standard
power off function and simulates halting the system in
such a way that the TFT power button can be used.
… we will leave the CPU powered up here but not executing any code in order to simulate an “off” state.
The Pi enters a runlevel that is essentially halted, but can still respond to the TFT power button to turn the system back on (please correct me in the comments if I’m missing something).
You’ll notice that
shutdown -h now and
halt do not put the system in the
same state as pressing the TFT power button. If you run
shutdown -h now, the power button
can not be used to power the system back on. So
something in that module is doing some magic to quasi-halt the
system, but allow it to still respond to the button.
This is all well and dandy, but if the Pi can’t kill its own
power, how do we turn off the display? I would say the
best answer is to
to cut off power to the screen backlight during shutdown, but that
may not be the desired behavior for all users. Though, that
behavior could probably be made configurable using the
/etc/modprobe.d/adafruit.conf file. Getting a proper
power module for your Pi to kill the power on shutdown is also an
Barring those options, the shutdown behavior can be enhanced with a custom service. We can create a service that runs during shutdown to power off the backlight for the display screen.
Create a script at
will power off the screen’s backlight.
sudo sh -c '\
echo "0" > /sys/class/backlight/soc\:backlight/brightness \
Make that script executable.
chmod +x /usr/local/bin/screen-off.sh
Create a service at
/etc/systemd/system/screen-off.service that will run
The service will call our script that powers off the backlight on the screen.
Description=TFT Screen Off
Enable the service. It will now run at shutdown when the TFT power button is pressed.
systemctl enable screen-off
Reboot the Pi. After it books, power it off using the TFT power button. You should see the screen go blank now when you press the power button.
When you power on the Pi again, the screen should illuminate like normal.I do want to emphasize that you should not confuse the screen being off and your Pi being off. Be very mindful that your screen will power off immediately during shutdown, and your Pi may still need a few seconds before it has safely halted.
You can re-enable the screen by using
1 instead of
0 in the script above. And so you could easily create
screen-on.sh. This is unecessary since the screen
turns back on automatically at boot, but is worth noting.
- Tactile switch as power button
- sudo halt or sudo shutdown
- Is halt the same as “shutdown -H” and poweroff the same as “shutdown -P”?
- Systemd : How to execute script at shutdown only (not at reboot)
- How to run a script with systemd right before shutdown?
- How to execute scripts in /usr/lib/systemd/system-shutdown/ at reboot or shutdown?