devices(ubiquiti): the ES-16XP is two 8XP systems - eight of sixteen sockets were missing #2433

Merged
jaylouisw merged 2 commits from catalogue/1121-1422 into main 2026-11-21 14:40:40 +00:00
Owner

Refs #130 (does not close it - the Dream Wall Pro itself is still unbuilt).

The defect

devices/ubiquiti/es-16xp.json modelled an eight-port switch. The EdgeSwitch 16XP is two EdgeSwitch 8XP systems in one 1U chassis: Ubiquiti's own datasheet at https://dl.ui.com/datasheets/edgemax/EdgeSwitch_XP_DS.pdf (HTTP 200, application/pdf, 3,915,117 B, 7 pp, text layer) says on

  • p.2 - "EdgeSwitch 16XP features dual EdgeSwitch 8XP systems in a rack-mountable, 1U form factor with 300 watts of power supporting up to 16 devices"
  • p.4 - "16 Gigabit PoE Ports", "24V/48V Configurable Passive PoE", "300 W Power", "1U Rack-Mount Form Factor"
  • p.7 - "Hardware Configuration (2) EdgeSwitch 8XPs", 480 x 44.5 x 186 mm, 3.95 kg

The per-port rows live on the ES-8XP page (p.6): "(8) 10/100/1000 Ethernet Ports", "(1) 10/100 Ethernet Port", "Max PoE Wattage Per Data Port 11.5 W (24 V), 23 W (48V)", "PoE Method Passive", and the tech-spec page (https://techspecs.ui.com/uisp/wired/es-16xp, HTTP 200, 575,584 B) heads them with "* Specifications apply to each 8-Port EdgeSwitch ES-8XP unit".

The old note read that asterisk as a chassis fact and filed the shortfall as a trap ("the model name says 16 XP but the sheet lists eight data ports"). The model name was right: eight of sixteen data sockets were missing, so a lab could cable half the switch. It also had no poe.budgetW and a bare poeOut: true on every data port.

What changes

before after
sockets 9 (8 data + 1 mgmt) 18 (16 data + 2 mgmt)
PSE ports 9 (mgmt inferred at 15.4 W) 16
per data port true -> 1 W 11.5 W (24 V figure)
poeDraw() full fill 23.4 W 184 W
budget 0 / source name (unlimited) 300 W / source research
  • 16 data ports eth1-eth16, per-port 11.5 W (the vendor's 24 V figure; the 48 V configuration is 23 W and the engine bills one number per port - recorded in the note).
  • 2 management ports mgmt0/mgmt1, one per 8XP system, "poeOut": false because p.6 prints "PoE Configurable Per Port: Management Port N/A". Left silent, engine/media.js infers a 15.4 W 802.3af PSE on any copper port of a poe-pse device - which is why the old nine-socket file was counted as nine PSE ports.
  • poe.budgetW: 300 from the datasheet's chassis figure, with the note stating exactly what is quoted ("with 300 watts of power supporting up to 16 devices") and what is not (Ubiquiti never labels a PoE-budget row or says whether chassis draw sits inside the 300 W). At 24 V, 16 x 11.5 = 184 W fits; at 48 V, 16 x 23 = 368 W does not, so the supply binds before the ports do. Flagged as an input envelope, not a measured budget.

Gates

  • node scripts/syntax-check.js - 535 files, all OK
  • node scripts/audit-port-types.js - 29,784 ports, 0 offending devices/ports
  • node scripts/audit-devices.js - 2,352 models, 0 hard defects, 0 uncablable ethernet ports
  • node scripts/audit-poe-budget.js - silent PSEs 19 -> 18, 0 name-inferred budgets
  • node test/hardware-invariants.test.js - 26 passed, 0 failed
  • node test/poe.test.js, node test/poe-inference.test.js - 21 passed each
  • node scripts/regen-registry-doc.js --check - pages current (2,352 models, 29,784 sockets, 978 shapes); docs/CONNECTORS.md regenerated, not hand-edited
Refs #130 (does not close it - the Dream Wall Pro itself is still unbuilt). ## The defect `devices/ubiquiti/es-16xp.json` modelled an eight-port switch. The EdgeSwitch 16XP is **two EdgeSwitch 8XP systems in one 1U chassis**: Ubiquiti's own datasheet at `https://dl.ui.com/datasheets/edgemax/EdgeSwitch_XP_DS.pdf` (HTTP 200, `application/pdf`, 3,915,117 B, 7 pp, text layer) says on - **p.2** - "EdgeSwitch 16XP features dual EdgeSwitch 8XP systems in a rack-mountable, 1U form factor with 300 watts of power supporting up to 16 devices" - **p.4** - "16 Gigabit PoE Ports", "24V/48V Configurable Passive PoE", "300 W Power", "1U Rack-Mount Form Factor" - **p.7** - "Hardware Configuration (2) EdgeSwitch 8XPs", 480 x 44.5 x 186 mm, 3.95 kg The per-port rows live on the **ES-8XP** page (p.6): "(8) 10/100/1000 Ethernet Ports", "(1) 10/100 Ethernet Port", "Max PoE Wattage Per Data Port 11.5 W (24 V), 23 W (48V)", "PoE Method Passive", and the tech-spec page (`https://techspecs.ui.com/uisp/wired/es-16xp`, HTTP 200, 575,584 B) heads them with "* Specifications apply to each 8-Port EdgeSwitch ES-8XP unit". The old note read that asterisk as a chassis fact and filed the shortfall as a trap ("the model name says 16 XP but the sheet lists eight data ports"). The model name was right: **eight of sixteen data sockets were missing**, so a lab could cable half the switch. It also had no `poe.budgetW` and a bare `poeOut: true` on every data port. ## What changes | | before | after | |---|---|---| | sockets | 9 (8 data + 1 mgmt) | 18 (16 data + 2 mgmt) | | PSE ports | 9 (mgmt inferred at 15.4 W) | 16 | | per data port | `true` -> 1 W | 11.5 W (24 V figure) | | `poeDraw()` full fill | 23.4 W | 184 W | | budget | `0` / source `name` (unlimited) | `300 W` / source `research` | - 16 data ports `eth1`-`eth16`, per-port 11.5 W (the vendor's 24 V figure; the 48 V configuration is 23 W and the engine bills one number per port - recorded in the note). - 2 management ports `mgmt0`/`mgmt1`, one per 8XP system, `"poeOut": false` because p.6 prints "PoE Configurable Per Port: Management Port N/A". Left silent, `engine/media.js` infers a 15.4 W 802.3af PSE on any copper port of a `poe-pse` device - which is why the old nine-socket file was counted as nine PSE ports. - `poe.budgetW: 300` from the datasheet's chassis figure, with the note stating exactly what is quoted ("with 300 watts of power supporting up to 16 devices") and what is not (Ubiquiti never labels a PoE-budget row or says whether chassis draw sits inside the 300 W). At 24 V, 16 x 11.5 = 184 W fits; at 48 V, 16 x 23 = 368 W does not, so the supply binds before the ports do. Flagged as an input envelope, not a measured budget. ## Gates - `node scripts/syntax-check.js` - 535 files, all OK - `node scripts/audit-port-types.js` - 29,784 ports, 0 offending devices/ports - `node scripts/audit-devices.js` - 2,352 models, 0 hard defects, 0 uncablable ethernet ports - `node scripts/audit-poe-budget.js` - silent PSEs 19 -> 18, 0 name-inferred budgets - `node test/hardware-invariants.test.js` - 26 passed, 0 failed - `node test/poe.test.js`, `node test/poe-inference.test.js` - 21 passed each - `node scripts/regen-registry-doc.js --check` - pages current (2,352 models, 29,784 sockets, 978 shapes); `docs/CONNECTORS.md` regenerated, not hand-edited
The spec modelled eight data ports and one management port, and its notes
recorded the gap as a trap: 'the model name says 16 XP but the sheet lists
eight data ports'. The sheet lists eight ports per 8XP system:

  dl.ui.com/datasheets/edgemax/EdgeSwitch_XP_DS.pdf
    p.2  'dual EdgeSwitch 8XP systems ... 300 watts of power supporting up
          to 16 devices'
    p.4  '16 Gigabit PoE Ports' / '300 W Power'
    p.7  'Hardware Configuration (2) EdgeSwitch 8XPs', 1U
    p.6  per ES-8XP: 8 data ports + 1 management port, 11.5 W at 24 V,
         23 W at 48 V passive PoE

The tech-spec page heads those per-port rows with '* Specifications apply to
each 8-Port EdgeSwitch ES-8XP unit'.

Now 16 data ports + 2 management ports; per-port 11.5 W instead of the bare
true bit (which billed 1 W); poe.budgetW 300 W from the datasheet's chassis
figure, noted as an input envelope rather than a labelled PoE budget.
devices(ubiquiti): the ES-16XP's management ports are not PSEs
All checks were successful
CI / Server smoke and Docker build (pull_request) Successful in 13s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 7s
CI / Test (Node 20) (pull_request) Successful in 1m0s
CI / Test (Node 18) (pull_request) Successful in 1m2s
CI / Test (Node 22) (pull_request) Successful in 1m2s
CI / Arm auto-merge (pull_request) Successful in 3s
3d9ce46303
p.6 of the EdgeSwitch XP datasheet prints 'PoE Configurable Per Port:
Management Port N/A'. Left silent, media.js infers 15.4 W on any copper
port of a poe-pse device - which is why the nine-socket version of this
spec was reported as nine PSE ports. mgmt0/mgmt1 now carry poeOut:false;
the sixteen data ports carry 11.5 W each (184 W of a 300 W envelope).
forgejo-actions scheduled this pull request to auto merge when all checks succeed 2026-11-21 14:30:14 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
jaylouisw/packetforge!2433
No description provided.