Redesign device front panel: 8-port SFP aggregation switch (USL8A) #8

New Issue

2026-11-05T10:26:19-05:00

jared commented

2026-11-05 10:26:19 -05:00

Make the front panel on the device page match the real hardware. This covers one model so it can be checked port by port against the physical unit.

Device: 8SFP-AGG (UniFi model code USL8A, 8 ports reported by UniFi)

Current state

SWITCH_LAYOUTS in static/port-inspector.js:

'USL8A': { rows: [[1,2,3,4],[5,6,7,8]], sfp_ports: [1,2,3,4,5,6,7,8] }

This draws two rows of four SFP ports.

README calls this model "UniFi Switch Lite 8 PoE", which looks wrong for an 8-port SFP aggregation switch. Correct it once the model is confirmed.

Things the panel should show

This is the core switch, so optics and bonds matter more here than on the other models:

Module presence, and optical readings where UniFi reports them.
Bonded ports as a group. Bond members share a MAC, so neighbor matching currently identifies only one port per bond and the others look like they have no neighbor.

Verify against the unit or datasheet

Whether the cages sit in one row or two, and their numbering order. The current two-row layout is unconfirmed.
The maximum speed of each cage.

Acceptance criteria

Cage order and numbering match a reference photo of the unit
SFP cages look different from RJ45 ports, and an empty cage is distinguishable from a module with no link
Bond members are grouped, and every member shows the bond's neighbor
README's model description is corrected
Clicking a port or using the keyboard opens the existing port panel, and #port-N links still work
No sideways page scroll at phone width
Reference photo or datasheet link is recorded on this issue

Make the front panel on the device page match the real hardware. This covers one model so it can be checked port by port against the physical unit. **Device:** `8SFP-AGG` (UniFi model code `USL8A`, 8 ports reported by UniFi) ## Current state `SWITCH_LAYOUTS` in `static/port-inspector.js`: ```js 'USL8A': { rows: [[1,2,3,4],[5,6,7,8]], sfp_ports: [1,2,3,4,5,6,7,8] } ``` This draws two rows of four SFP ports. README calls this model "UniFi Switch Lite 8 PoE", which looks wrong for an 8-port SFP aggregation switch. Correct it once the model is confirmed. ## Things the panel should show This is the core switch, so optics and bonds matter more here than on the other models: - Module presence, and optical readings where UniFi reports them. - Bonded ports as a group. Bond members share a MAC, so neighbor matching currently identifies only one port per bond and the others look like they have no neighbor. ## Verify against the unit or datasheet - Whether the cages sit in one row or two, and their numbering order. The current two-row layout is unconfirmed. - The maximum speed of each cage. ## Acceptance criteria - [ ] Cage order and numbering match a reference photo of the unit - [ ] SFP cages look different from RJ45 ports, and an empty cage is distinguishable from a module with no link - [ ] Bond members are grouped, and every member shows the bond's neighbor - [ ] README's model description is corrected - [ ] Clicking a port or using the keyboard opens the existing port panel, and `#port-N` links still work - [ ] No sideways page scroll at phone width - [ ] Reference photo or datasheet link is recorded on this issue

jared referenced this issue

2026-11-05 11:12:07 -05:00

Draw realistic front panels for every device model #13

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: LotusGuild/gandalf#8