Skip to content

Prepare scene playback for every layout and add Pro Max and SONiC groundwork - #48

Merged
Views2k merged 2 commits into
mainfrom
feature/lineup-groundwork
Nov 18, 2026
Merged

Views2k merged 2 commits into
mainfrom
feature/lineup-groundwork

Conversation

@Views2k

@Views2k Views2k commented Nov 18, 2026

Copy link
Copy Markdown
Owner

Summary

This finishes the uncommitted work left after #33: scene playback data for every connector layout, and offline groundwork for Pro Max and Campus Aggregation/Core (SONiC) lighting. Supported switches do not change. Switch playback stays limited to the USW-Pro-XG-8-PoE, and Pro Max and SONiC output stays blocked.

Resident scenes

  • resident_scene.py takes over the scene compiler from device_playback.py and uses the hardware profile's canonical connector count, so a scene covers every connector of all 25 layouts without stacking or internal records. It rejects ports outside the profile, duplicate ports and an optical sync source that is not copper.
  • player.sh gets its port count and optical masks from the profile through a generated layout block, and frames.awk takes the port count as an argument. A player started by an earlier version passes no count and keeps the ten-port format.
  • Reconnecting checks the renderer's hash as well as the player's before reusing a running player, so the first connection after an update replaces the player once through the existing drained replacement, keeping its saved scene.
  • On the Pro XG 8 PoE the scene data is unchanged: the compiler matches the old code line for line except for the new input checks and rules that only apply to optical ports EE does not manage, and a test checks that the generated player equals resident/player.sh.

Pro Max and SONiC groundwork

  • pro_max.py: a bounded packet codec and transaction planner for the six Pro Max connector layouts. It separates transfer acceptance from a matching register snapshot, checks exact lengths, bounds read retries and never retransmits an uncertain write. It performs no I/O.
  • tools/device-helpers/pro-max-io.c: the fixed-device I2C_RDWR transfer core. The test build excludes device access and the Linux device wrapper needs an explicit build macro. EE does not package or run it.
  • sonic_lighting.py: binds the captured MCU hash and board ID to the 54- or 32-port layout and decodes the selector/RGBW snapshot. It adds no transport.
  • docs/HARDWARE-QUALIFICATION.md records what each part establishes and what remains before output on those models: target integration, controller ownership and physical acceptance. docs/DEVELOPMENT.md lists the C compiler the helper tests need.

Verification

  • Python: 3,659 tests passed, including the helper tests built with the installed compiler; ruff check clean.
  • JavaScript: 878 passed, 0 failed. tools/check-repository.py and tools/check-fixtures.py passed.
  • Not tested on a physical switch. The first connection after updating replaces a running switch player once.

…undwork

The resident scene compiler moves to resident_scene.py and uses the
canonical connector count of the hardware profile, so a scene covers every
connector of all 25 layouts without stacking or internal records. The
player script gets its port count and optical masks from the profile, the
AWK renderer takes the port count as an argument, and reconnecting checks
the renderer's hash as well as the player's before reusing a running
player. On the Pro XG 8 PoE the scene data and the player commands are
unchanged; switch playback stays limited to that model.

pro_max.py adds a bounded packet codec and transaction planner for the six
Pro Max connector layouts, sonic_lighting.py decodes Campus
Aggregation/Core MCU snapshots, and tools/device-helpers/pro-max-io.c holds
a fixed-device I2C transfer core whose test build excludes device access.
None of them performs I/O from EE or enables output on those models.
HARDWARE-QUALIFICATION.md records what each establishes and what remains.
@Views2k
Views2k merged commit 9384d13 into main Nov 18, 2026
3 checks passed
@Views2k
Views2k deleted the feature/lineup-groundwork branch November 18, 2026 05:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant