Skip to main content

Rpi Pcie

@aaronge/rpi-pciev2026.11.05.3· 16d agoBEHAVIORSWORKFLOWS
01README

Raspberry Pi 5 PCIe link health (negotiated vs. capable speed/width per device, HAT+ ID EEPROM, recent pcie dmesg lines) via sysfs, as a typed, versioned Swamp model — catches link training down to a lower speed/width, the common silent cause of a mysteriously slow NVMe SSD.

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-pciev2026.08.26.1rpi_pcie.ts

Global Arguments

ArgumentTypeDescription
pciDevicesBasePath?stringsysfs path enumerating PCI devices.
hatBasePath?stringDevice-tree path for HAT+ ID EEPROM data. Its absence is a normal,
dmesgLineLimit?numberMaximum number of pcie-matching dmesg lines to keep, most recent last.
fn readPcie()
Enumerate PCI devices and their negotiated/capable link speed

Resources

pcie(infinite)— Negotiated vs. capable PCIe link speed/width per device, HAT+
04Workflows1
@aaronge/rpi-pcie7389ec84-3c72-4fc2-96f0-73a96cb3faf5

Read PCIe device link state from pcie-local and assert linkDegraded == false — the silent-performance-loss signal this model exists to catch (link training down to a lower speed/width presents only as "my SSD is mysteriously slow"). On this machine (no NVMe base attached yet) the assert exercises the always-present internal RP1 link, which is expected to stay healthy; re-verify against the actual NVMe device once the base is physically attached. Scheduled every 5 minutes, the same cadence as the

collectRead PCIe device link state.
1.readPciepcie-local.readPcie
assertFail the run when any PCIe device's link is degraded.
1.link-not-degraded
reportPrint a one-screen summary. Depends on collect only (not assert), so it still runs when an assertion fails.
1.summarize
05Previous Versions3
2026.11.05.2

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.1

Judge link degradation against the upstream port's max speed/width as well as the device's own, so an x4 NVMe behind the Pi 5's x1 port is no longer reported as degraded.

2026.08.26.1
06Stats
A
93 / 100
Downloads
33
Archive size
10.3 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