| Both sides previous revision Previous revision Next revision | Previous revision |
| add_powerdevices_rpi_only [2021/08/30 12:07] – added missing links, clarified that Kintaro Super Kuma/Roshambo are two different cases that use the same script. atari | add_powerdevices_rpi_only [2025/08/21 22:30] (current) – [Argon One] command line to get current temperature lbrpdx |
|---|
| ====== Add Powerdevices and Buttons to your Raspberry ====== | ====== Add Powerdevices and Buttons to your Raspberry Pi 1 - 5 ====== |
| | |
| | **The Raspberry Pi 5 uses new GPIO code, the details below are not applicable for these boards, except for Argon One V3 at the bottom of the page** |
| |
| To keep the price down, the Raspberry Pi board doesn't ship with a power button, yet it's easy to add your own! This guide will show you how to add a power button to your Raspberry Pi that can turn on/off your BATOCERA system. | To keep the price down, the Raspberry Pi board doesn't ship with a power button, yet it's easy to add your own! This guide will show you how to add a power button to your Raspberry Pi that can turn on/off your BATOCERA system. |
| You should never "yank" the power cord out of your Pi as this can lead to severe data corruption (and in some cases, physically damage your SD card). Even if Batocera is best prepared against file corruption it is recommended to safely shut down your Pi via Batocera's **Shutdown** Menu or even better, use a power button or switch. | You should never "yank" the power cord out of your Pi as this can lead to severe data corruption (and in some cases, physically damage your SD card). Even if Batocera is best prepared against file corruption it is recommended to safely shut down your Pi via Batocera's **Shutdown** Menu or even better, use a power button or switch. |
| |
| <WRAP center round info 60%> | <WRAP center round info> |
| When Batocera "shuts down" the Pi with a simple button/latching switch, it will send it into a halt state, which still consumes a very small amount of power. This is similar to how all modern computers work. In this guide we will only go into a halt state so that we can still power it up again later without having to replug the power source. You can safely disconnect the power supply (should you desire) without the worry of data corruption while in the halt state. | When Batocera "shuts down" the Pi with a simple button/latching switch, it will send it into a halt state, which still consumes a very small amount of power. This is similar to how all modern computers work. In this guide we will only go into a halt state so that we can still power it up again later without having to replug the power source. You can safely disconnect the power supply (should you desire) without the worry of data corruption while in the halt state. |
| </WRAP> | </WRAP> |
| </code> | </code> |
| |
| ===== Commercial Power Switches ===== | ===== Commercial Cases & Power Switches ===== |
| |
| Here are some commercial power switches/commercial cases with power switches that are currently supported. These offer a real power cut, that means the Raspberry is really switched off. Usually these small power devices are plugged on top of the Raspberry using it's 40 Pin header. For further install instruction use the links provided. | Here are some commercial power switches/commercial cases with power switches that are currently supported. These offer a real power cut, that means the Raspberry is really switched off. Usually these small power devices are plugged on top of the Raspberry using it's 40 Pin header. For further install instruction use the links provided. |
| Here are the values you can put as ''system.power.switch=<value_below>'' in ''batocera.conf'': | Here are the values you can put as ''system.power.switch=<value_below>'' in ''batocera.conf'': |
| |
| ^ Device Name ^ system.power.switch ^ Where to buy and additional manufacturer information ^ Notes related to Batocera ^ | ^ Device Name ^ system.power.switch ^ Where to buy and additional manufacturer information ^ Notes related to Batocera ^ |
| | Argon One for RPi4 | ARGONONE | https://www.argon40.com/argon-one-raspberry-pi-4-case.html | [[add_powerdevices_rpi_only#argon_one|Get more details here]] | | | Argon One for RPi4 (v1/v2) | ARGONONE | https://argon40.com/products/argon-one-v2-case-for-raspberry-pi-4 | [[add_powerdevices_rpi_only#argon_one|Get more details here]] | |
| | ATXRaspi | ATX_RASPI_R2_6 | http://lowpowerlab.com/atxraspi/#installation | | | | Argon One for RPi5 (v3) | ARGONONE | https://argon40.com/products/argon-one-v3-case-for-raspberry-pi-5 | [[add_powerdevices_rpi_only#argon_one|Get more details here]] | |
| | DeskPi Pro case | DESKPIPRO | https://deskpi.com/collections/frontpage/products/deskpi-pro-for-raspberry-pi-4 | | | | ATXRaspi | ATX_RASPI_R2_6 | http://lowpowerlab.com/atxraspi/#installation | | |
| | Mausberry Circuits | MAUSBERRY | http://mausberry-circuits.myshopify.com/pages/setup | | | | DeskPi Pro case | DESKPIPRO | https://deskpi.com/collections/frontpage/products/deskpi-pro-for-raspberry-pi-4 | | |
| | msldigital PiBoard r2013 | REMOTEPIBOARD_2003 | http://www.msldigital.com/pages/support-for-remotepi-board-2013 | | | | Mausberry Circuits | MAUSBERRY | http://mausberry-circuits.myshopify.com/pages/setup | | |
| | msldigital PiBoard r2015 | REMOTEPIBOARD_2005 | http://www.msldigital.com/pages/support-for-remotepi-board-plus-2015 | | | | msldigital PiBoard r2013 | REMOTEPIBOARD_2003 | http://www.msldigital.com/pages/support-for-remotepi-board-2013 | | |
| | OneNineDesign Powerhat | POWERHAT | https://github.com/redoakcanyon/HATPowerBoard | | | | msldigital PiBoard r2015 | REMOTEPIBOARD_2005 | http://www.msldigital.com/pages/support-for-remotepi-board-plus-2015 | | |
| | Pimoroni OnOffShim | ONOFFSHIM | https://shop.pimoroni.com/products/onoff-shim | | | | OneNineDesign Powerhat | POWERHAT | https://github.com/redoakcanyon/HATPowerBoard | | |
| | UUGear Witty Pi | WITTYPI | http://www.uugear.com/witty-pi-realtime-clock-power-management-for-raspberry-pi | Script uses WiringPi. | | | Pimoroni OnOffShim | ONOFFSHIM | https://shop.pimoroni.com/products/onoff-shim | | |
| | Retroflag cases | RETROFLAG | http://www.retroflag.com | **NEW** NESPi4 support! [[add_powerdevices_rpi_only#retroflag|Get more details here.]] | | | UUGear Witty Pi | WITTYPI | http://www.uugear.com/witty-pi-realtime-clock-power-management-for-raspberry-pi | Script uses WiringPi. | |
| | Retroflag cases with buttons | RETROFLAG_ADV | http://www.retroflag.com | Same as the previous one, except the button can trigger actions, like stopping emulators | | | Retroflag cases | RETROFLAG | http://www.retroflag.com | **NEW** NESPi4 support! [[add_powerdevices_rpi_only#retroflag|Get more details here.]] | |
| | Retroflag GPIO case | RETROFLAG_GPI | https://www.retroflag.com/GPi-CASE.html | [[:choose_a_handheld#retroflag_gpi_case|Get more details here.]] | | | Retroflag cases with buttons | RETROFLAG_ADV | http://www.retroflag.com | Same as the previous one, except the button can trigger actions, like stopping emulators | |
| | Kintaro Super Kuma/Roshambo Retro Gaming case | KINTARO | https://www.amazon.com/dp/B079T7RDLX/?tag=electromake-20 / https://www.electromaker.io/blog/article/roshambo-retro-gaming-case-review | | | | Retroflag GPIO case | RETROFLAG_GPI | https://www.retroflag.com/GPi-CASE.html | [[:choose_a_handheld#retroflag_gpi_case|Get more details here.]] | |
| | | Kintaro Super Kuma/Roshambo Retro Gaming case | KINTARO | https://www.amazon.com/dp/B079T7RDLX/?tag=electromake-20 / https://www.electromaker.io/blog/article/roshambo-retro-gaming-case-review | | |
| | | Pironman Raspberry Pi 4 Case | PIRONMAN | https://www.sunfounder.com/products/raspberry-pi-4-case | Run pironman from the terminal to configure the OLED, RGB & Fan | |
| | | Pironman Raspberry Pi 5 Case | PIRONMAN5 | https://www.sunfounder.com/collections/cases/products/pironman-5-nvme-m-2-ssd-pcie-mini-pc-case-for-raspberry-pi-5 | Run pironman5 from the terminal to configure the OLED, RGB & Fan | |
| |
| ===== Simple push-button or switches ===== | ===== Simple push-button or switches ===== |
| - Reboot, this will activate the Safe Shutdown feature | - Reboot, this will activate the Safe Shutdown feature |
| |
| <WRAP center round info 80%> | <WRAP center round info> |
| **For the NESPi 4 case only** | **For the NESPi 4 case only** |
| |
| ==== Argon One ==== | ==== Argon One ==== |
| |
| Activate the Argon One fan by adding ''system.power.switch=ARGONONE'' in the configuration file ''batocera.conf''. | <WRAP center round info> |
| | Until Batocera 40, only ArgonOne V1/V2 cases for Raspberry Pi4 are supported. |
| | |
| | **Batocera 41** introduces support for **ArgonOne V3 for Raspberry Pi5**, additionally to ArgonOne V1/V2 for Raspberry Pi4. |
| | </WRAP> |
| | |
| | Activate the Argon One fan by adding ''system.power.switch=ARGONONE'' in the configuration file ''batocera.conf'' and that's it. Upon next reboot, the fan will be controllable by software (fan speed depending on the temperature) and double-clicking the button on the back will kill the running emulator and get you back to EmulationStation. |
| | **Don't use any external script**, the support for Argon One is already included in the Batocera Linux distribution. |
| | |
| | By default, the fan starts at 55 degrees Celsius. Here is the default fan curve configuration: |
| | |
| | <file - argonone.conf> |
| | # Configuration file for Argon One Pi4 case |
| | # temperatures are in Celsius |
| | # fan_speed are from 0-100 percent |
| | # syntax is: temp_threshold=fan_speed |
| | # default is: |
| | 45=0 |
| | 55=10 |
| | 60=55 |
| | 65=100 |
| | </file> |
| | |
| | With this fan curve configuration, the behavior would be as follows: |
| | - At lower than 55°C, the fan is off |
| | - At 55-59°C, the fan runs at 10% speed |
| | - At 60-64°C, the fan runs at 55% speed |
| | - At 65°C and higher, the fan runs at 100% speed |
| | |
| | From the vendor recommendations, it is safe to start the fan at 55 degrees only. Less noisy. ;-) |
| |
| By default, the fan starts at 55 degrees Celsius. Your can define own temperature/fan speed ladder by editing the file ''/userdata/system/configs/argonone.conf'' (it can be also edited from the network, via the SHARE SMB folder). | You can define own temperature/fan speed ladder by creating a new ''argonone.conf'' file at ''/userdata/system/configs/argonone.conf''. |
| |
| # Configuration file for Argon One Pi4 case | To check that the temperature is correctly reported, you can log into [[access_the_batocera_via_ssh|Batocera through SSH]] and run the command ''rpi-argonone''. |
| # temperatures are in Celsius | |
| # fan_speed are from 0-100 percent | |
| # syntax is: temp_threashold=fan_speed | |
| # default is: | |
| 45=0 | |
| 55=10 | |
| 60=55 | |
| 65=100 | |
| |
| With this ladder, fan starts at 10% when reaching 55 degrees, and rises up to 100% when reaching 65 degrees Celsius. | |
| From the vendor recommendations, it is safe to start the fan at 55 degrees only. Less noisy. ;) | |