Skip to content

FPP-Backup 0.2.0

Choose a tag to compare

@SRipaldi SRipaldi released this 30 Oct 21:58
· 36 commits to main since this release

Adds monitoring for ColorLight receiver cards.

New: Show > ColorLight

If a controller drives LED panels through a ColorLight receiver card (such as a 5A-75), the app now finds it and checks it every 5 minutes while the app is running. It only reads from the controllers.

A ColorLight card needs a steady gigabit link to its controller. When a cable, jack or coupler is bad, the link keeps dropping and coming back, sometimes at 100 Mbps, and the panel freezes. fppd only looks for the card when it starts. If it starts while the link is down, the panel stays dark until fppd is restarted. The new page shows, for each card:

  • Link now: whether the link is up and at what speed. 100 Mbps is flagged, because the card needs gigabit.
  • Receiver: whether fppd found the card when it last started, with the card's firmware and panel size.
  • Steady for: time since the last link drop.
  • Link drops: counts for the last hour, day and week; charts of drops per day and by hour of day; and a list of recent drops with how long each lasted. Drops bunched in the warm part of the day point to heat on a connector.
  • Card restarts: worked out from the card's own uptime, so a card that lost power shows up.
  • Sends: slow, failed or dropped frames.

Every controller with an enabled ColorLight output is picked up; nothing is set up per show. Problems also appear on the Dashboard and in the notification bell, and you get a notice when the link is steady again. History is kept for 14 days on the Mac, longer than FPP keeps its own logs. From the command line: tools/colorlight.py [--host <name>].

So far this has been used on one Raspberry Pi 4 running FPP 10.3 with a ColorLight 5A-75. Reports from other setups are welcome, especially a BeagleBone, a USB network adapter, or two cards on one controller.

Upgrading

Run git fetch --tags && git checkout v0.2.0, or download the source zip below. Then restart the app. Nothing needs migrating.

Known limits

Same as 0.1.0:

  • Only BeagleBone Black card images have been built and booted. Raspberry Pi and BB64 images are untested.
  • Password support hasn't been tried against a real FPP with its UI password on.
  • Plugins aren't carried onto a rebuilt card.
  • Backups have no schedule.
  • The web UI is for the Mac it runs on only. Backups and card images contain secrets. See SECURITY.md.

Not affiliated with or endorsed by the Falcon Player project.