Skip to main content

Rpi Cooling

@aaronge/rpi-coolingv2026.11.05.2· 16d agoBEHAVIORSWORKFLOWS
01README

Raspberry Pi official-case PWM fan telemetry (RPM, PWM duty cycle, discrete cooling state) via hwmon/thermal sysfs, as a typed, versioned Swamp model — catches a fan that's been commanded to spin but the tachometer reports it isn't.

02Release Notes

Documentation, descriptions and setup brought up to date with running every workflow under a single swamp serve (2026-11-05).

03Behaviors1
@aaronge/rpi-coolingv2026.08.26.1rpi_cooling.ts

Global Arguments

ArgumentTypeDescription
hwmonBasePath?stringBase sysfs path to search for the fan's hwmon device.
thermalBasePath?stringBase sysfs path to search for the fan's cooling_device.
fanHwmonName?stringThe hwmon "name" file value identifying the fan device. Confirmed as
fanCoolingDeviceType?stringThe thermal cooling_device "type" file value identifying the fan\
fn readCooling()
Locate the fan's hwmon device by name and read fan1_input/pwm1,

Resources

cooling(infinite)— PWM fan RPM, duty cycle, and discrete cooling state from sysfs
04Workflows1
@aaronge/rpi-cooling3e27914c-408d-4d2a-9098-3f8619be11cd

Read PWM fan RPM/duty/cooling-state from cooling-local and assert the fan hasn't stalled — commanded to spin (pwmDuty > 0) but the tachometer reports 0 RPM. That combination is the entire point of this extension: it's a real failure mode that produces no other symptom until the SoC starts thermal throttling. Scheduled every 5 minutes, same cadence as the telemetry-focused @aaronge/host-health/@aaronge/rpi-health workflows, since a stalled fan is time-sensitive in a way boot configuration isn't.

collectRead fan RPM/duty/cooling-state.
1.readCoolingcooling-local.readCooling
assertFail the run when the fan has stalled.
1.fan-not-stalled
reportPrint a one-screen summary. Depends on collect only (not assert), so it still runs when an assertion fails.
1.summarize
05Previous Versions2
2026.11.05.1

Ship the workflow in the package so a single ops repo can pull it and run it under swamp serve's own scheduler.

Added 1 workflows

2026.08.26.1
06Stats
A
93 / 100
Downloads
33
Archive size
8.2 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License1/2partial

    no SPDX license declared

  • Verified public repository2/2earned
07Platforms