Hats are the extension boards that plug onto the Raspberry Pi's 40-pin GPIO header. Here is what Recalbox 10.1 can handle.
Designed by the Recalbox team and automatically detected at boot:
Recalbox ships the recalbox-wpaf utility, which regulates the fan of these boards according to CPU temperature:
| Hat | Type | Notes |
|---|---|---|
| Waveshare PoE Hat (B) | PoE + fan | Recalbox also drives its small OLED screen (temperature, version) — Pi 3B+ / Pi 4 |
| Raspberry Pi PoE+ (official) | PoE + PWM fan | Pi 3B+ / Pi 4 |
| Pimoroni Fan SHIM | Fan | Clips onto part of the GPIO header |
Enabling it takes two keys in recalbox.conf (hat.wpaf.enabled and hat.wpaf.board) — full procedure on the fan controller page.
PoE (Power over Ethernet): these hats power the Pi through the network cable — no USB power supply needed. You need an IEEE 802.3af (PoE) or 802.3at (PoE+) compatible switch.
Fan control for the Argon One cases and the PiBoy DMG console goes through the same utility — see cases.
Small SPI TFT screens (mounted on the GPIO) are no longer supported since Recalbox 10: the
fbcputility has been removed from the system.
A hat missing from this page is not necessarily incompatible: if it enables through a standard dtoverlay (HiFiBerry-style audio hats, RTC boards…), you can add the required line to the boot configuration — see editing the boot configuration files. This is DIY territory: it is not tested by the team.
Validated a hat that is not listed here? Share your feedback on the Recalbox Discord.