poe(ubiquiti): the Fiber XG's 2.5G jack is a passive PoE inlet, not a 1 W PSE #2456

Merged
jaylouisw merged 1 commit from catalogue/1121-1722 into main 2026-11-21 17:37:55 +00:00
Owner

Refs #130 (the Dream Wall Pro SKU is still absent from every Ubiquiti surface, so that issue stays open) - this pass takes one phantom PSE off scripts/audit-poe-budget.js's silent list.

The defect

devices/ubiquiti/uisp-fiber-xg.json declared poeOut: true and poeOutClass: "PoE" on eth0 - the ONU's only copper jack, and the port it is powered from. A bare poeOut: true is billed as 1 W by poeDraw(), so the box advertised an 802.3af (negotiated 48 V) PSE while its budget was 0 (poeBudgetSource: name): a downstream radio cabled to it would be promised power by a 6 W XGPON ONU.

What the vendor prints

Read 2026-11-21; all three surfaces carry the same rows.

  • https://techspecs.ui.com/uisp/fiber/uisp-fiber-xg (200, rendered spec table)
  • https://dl.ui.com/ds/uisp-fiber-xg_ds.pdf (200, application/pdf, 1,056,083 B, 3 pp, text layer)
  • https://store.ui.com/us/en/products/uisp-fiber-xg (200, US store listing)
Networking interface   (1) SC/APC, ITU-G.987 XGPON WAN port
                       (1) 100/1,000/2,500 MbE RJ45 LAN ports
PoE interface          (1) PoE in, 24V DC passive PoE
Power supply           Passive PoE 2-pair (4, 5+; 7, 8-)
Supported voltage      10-30V DC passive PoE
Max. power consumption 6W

One PoE interface, and it is an input. There is no passthrough and no 802.3 detection on this hardware.

The fix

  • eth0: poeOut / poeOutClass removed; poeIn: 6 (the vendor's max consumption, same shape as devices/ubiquiti/ER-X.json's poeIn: 5).
  • capabilities: poe-pse dropped; poe-pd and passive-poe kept (24 V passive inlet).
  • description/notes rewritten to quote the rows above.
  • test/uisp-fiber-xg-poe.test.js added: 16 assertions, including that an NBE-5AC-Gen2 cabled to eth0 is absent from sim.poe and poeDraw() is 0 W.

Gates

node scripts/syntax-check.js                    542 files: all OK
node scripts/audit-port-types.js                Gated: 0 port(s) contradict their declared type.
node test/hardware-invariants.test.js           26 passed, 0 failed
node scripts/regen-registry-doc.js              catalogue pages current, 2,352 models (no diff)
node scripts/run-tests.js --filter=poe          38 suites, 1,198 assertions, 0 failed
node scripts/run-tests.js --filter=catalogue    3 suites, 66 assertions, 0 failed

audit-poe-budget.js: silent 12 -> 11, sourcing 410 -> 409.

Refs #130 (the Dream Wall Pro SKU is still absent from every Ubiquiti surface, so that issue stays open) - this pass takes one phantom PSE off `scripts/audit-poe-budget.js`'s silent list. ## The defect `devices/ubiquiti/uisp-fiber-xg.json` declared `poeOut: true` and `poeOutClass: "PoE"` on `eth0` - the ONU's only copper jack, and the port it is *powered from*. A bare `poeOut: true` is billed as 1 W by `poeDraw()`, so the box advertised an 802.3af (negotiated 48 V) PSE while its budget was 0 (`poeBudgetSource: name`): a downstream radio cabled to it would be promised power by a 6 W XGPON ONU. ## What the vendor prints Read 2026-11-21; all three surfaces carry the same rows. - `https://techspecs.ui.com/uisp/fiber/uisp-fiber-xg` (200, rendered spec table) - `https://dl.ui.com/ds/uisp-fiber-xg_ds.pdf` (200, application/pdf, 1,056,083 B, 3 pp, text layer) - `https://store.ui.com/us/en/products/uisp-fiber-xg` (200, US store listing) ``` Networking interface (1) SC/APC, ITU-G.987 XGPON WAN port (1) 100/1,000/2,500 MbE RJ45 LAN ports PoE interface (1) PoE in, 24V DC passive PoE Power supply Passive PoE 2-pair (4, 5+; 7, 8-) Supported voltage 10-30V DC passive PoE Max. power consumption 6W ``` One PoE interface, and it is an **input**. There is no passthrough and no 802.3 detection on this hardware. ## The fix - `eth0`: `poeOut` / `poeOutClass` removed; `poeIn: 6` (the vendor's max consumption, same shape as `devices/ubiquiti/ER-X.json`'s `poeIn: 5`). - `capabilities`: `poe-pse` dropped; `poe-pd` and `passive-poe` kept (24 V passive inlet). - description/notes rewritten to quote the rows above. - `test/uisp-fiber-xg-poe.test.js` added: 16 assertions, including that an `NBE-5AC-Gen2` cabled to `eth0` is absent from `sim.poe` and `poeDraw()` is 0 W. ## Gates ``` node scripts/syntax-check.js 542 files: all OK node scripts/audit-port-types.js Gated: 0 port(s) contradict their declared type. node test/hardware-invariants.test.js 26 passed, 0 failed node scripts/regen-registry-doc.js catalogue pages current, 2,352 models (no diff) node scripts/run-tests.js --filter=poe 38 suites, 1,198 assertions, 0 failed node scripts/run-tests.js --filter=catalogue 3 suites, 66 assertions, 0 failed ``` `audit-poe-budget.js`: silent **12 -> 11**, sourcing **410 -> 409**.
poe(ubiquiti): the Fiber XG's 2.5G jack is a passive PoE inlet, not a 1 W PSE
All checks were successful
CI / Server smoke and Docker build (pull_request) Successful in 23s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 8s
CI / Test (Node 18) (pull_request) Successful in 1m10s
CI / Test (Node 20) (pull_request) Successful in 1m10s
CI / Test (Node 22) (pull_request) Successful in 1m11s
CI / Arm auto-merge (pull_request) Successful in 2s
6644b88911
eth0 carried `poeOut: true` and `poeOutClass: "PoE"`, so the ONU advertised
an 802.3af PSE on the single RJ45 jack it is powered from. Ubiquiti lists
exactly one PoE interface - "(1) PoE in, 24V DC passive PoE" - on the
tech-spec page, the datasheet and the store listing. Modelled as poeIn 6 W
(the vendor's max consumption) with no poeOut, and poe-pse dropped.

audit-poe-budget: silent 12 -> 11, sourcing 410 -> 409.
forgejo-actions scheduled this pull request to auto merge when all checks succeed 2026-11-21 17:28:11 +00:00
forgejo-actions canceled auto merging this pull request when all checks succeed 2026-11-21 17:31:04 +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!2456
No description provided.