Skip to main content

Rpi Health

@aaronge/rpi-healthv2026.11.05.4· MIT· 16d agoBEHAVIORSWORKFLOWS
01README

Raspberry Pi 5 firmware and power telemetry (throttle/under-voltage sticky faults, PMIC rail currents/voltages, clocks, EEPROM/bootloader status) via vcgencmd, as a typed, versioned Swamp model with workflow assertions and CEL joins.

02Release Notes

README: NVMe health now lives in @aaronge/nvme-health.

03Behaviors1
@aaronge/rpi-healthv2026.08.26.1rpi_health.ts

Global Arguments

ArgumentTypeDescription
tempSoftLimitCelsius?numberPi 5 soft throttle point in Celsius. Not consumed by any method
tempHardLimitCelsius?numberPi 5 hard throttle point in Celsius. Not consumed by any method
minSupplyVolts?numberEXT5V_V floor before concern. Not consumed by any method directly.
vcgencmdPath?stringPath to the vcgencmd binary. Override for odd installs where it isn't
fn readThrottle()
Run vcgencmd get_throttled, decode the bitfield, and write the
fn readClocks()
Run vcgencmd measure_clock for each domain plus measure_temp and
fn readPmic()
Run vcgencmd pmic_read_adc, pair rails, and write the pmic
fn readFirmware()
Read model id, raw vcgencmd version, and EEPROM/bootloader status

Resources

throttle(infinite)— vcgencmd get_throttled, decoded into named now/sinceBoot flags.
clocks(infinite)— Clock frequencies (arm, core, v3d, isp, hevc), core temperature,
pmic(infinite)— Pi 5 PMIC rail currents/voltages from vcgencmd pmic_read_adc.
firmware(infinite)— Model identification, EEPROM/bootloader status, and raw vcgencmd
04Workflows1
@aaronge/rpi-healthf7bd50dd-160f-453a-8bc9-1b5b5c403632

Collect throttle, clock, and PMIC telemetry from health-local, assert each against a threshold, and print a one-screen summary. Fails when any threshold is breached, including when a sticky under-voltage or throttle fault has ever latched since boot.

collectRead throttle, clock, and PMIC state in parallel. readFirmware is intentionally excluded — it belongs in a separate, much less frequent workflow.
1.readThrottlehealth-local.readThrottle
2.readClockshealth-local.readClocks
3.readPmichealth-local.readPmic
assertFail the run when any threshold is breached.
1.throttle-healthy
2.temp-ok
3.supply-volts-ok
reportPrint a one-screen summary. Depends on collect only (not assert), so it still runs when an assertion fails.
1.summarize
05Previous Versions4
2026.11.05.3MIT

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

2026.11.05.2MIT

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.11.05.1MIT(was none)

Ship an MIT LICENSE file and declare license: MIT in the manifest.

2026.08.26.1
06Stats
A
100 / 100
Downloads
32
Archive size
17.6 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
  • License2/2earned
  • Verified public repository2/2earned
07Platforms