Skip to main content

Rpi Boot Config

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

Raspberry Pi boot configuration drift detection — EEPROM bootloader settings (BOOT_ORDER, PSU_MAX_CURRENT, etc.), config.txt, and cmdline.txt as a typed, versioned Swamp model, built to catch boot-breaking drift before/after the NVMe SSD migration.

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-boot-configv2026.08.26.1rpi_boot_config.ts

Global Arguments

ArgumentTypeDescription
bootFilesBasePath?stringDirectory containing config.txt and cmdline.txt. Override for older
rpiEepromConfigPath?stringPath to the rpi-eeprom-config binary. Override for odd installs.
fn readEeprom()
Run rpi-eeprom-config, parse BOOT_ORDER/BOOT_UART/
fn readConfigTxt()
Read config.txt verbatim, parse [section]/key=value structure,
fn readCmdline()
Read cmdline.txt verbatim, parse whitespace-separated params,

Resources

eeprom(infinite)— rpi-eeprom-config bootloader settings: BOOT_ORDER (decoded),
configTxt(infinite)— /boot/firmware/config.txt, raw and parsed, sections preserved.
cmdline(infinite)— /boot/firmware/cmdline.txt, raw and parsed, root= hoisted.
04Workflows1
@aaronge/rpi-boot-configf39b2744-755e-4275-af6d-9741b4f5c7ac

Collect EEPROM bootloader settings, config.txt, and cmdline.txt from bootconfig-local, and assert two low-frequency sanity checks: BOOT_ORDER still contains every device the operator expects to be tried, and cmdline.txt still names a root= device. Boot configuration changes rarely, so this runs once a day rather than every 5 minutes like the telemetry extensions. It intentionally does not check EEPROM firmware current-vs-latest (that's @aaronge/rpi-health's readFirmware) or that cmdline's root=

collectRead EEPROM config, config.txt, and cmdline.txt in parallel.
1.readEeprombootconfig-local.readEeprom
2.readConfigTxtbootconfig-local.readConfigTxt
3.readCmdlinebootconfig-local.readCmdline
assertFail the run when a boot-configuration sanity check fails.
1.boot-order-contains-expected
2.cmdline-root-present
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. Test readCmdline against /proc/cmdline instead of a hardcoded PARTUUID.

Added 1 workflows

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