docs(schema): poeOutClass is a vendor class list - passive and PoE+++ included #2237

Merged
jaylouisw merged 1 commit from docs/1120-0117 into main 2026-11-20 01:38:43 +00:00
Owner

docs/DEVICE_SCHEMA.md listed poeOutClass as PoE / PoE+ / PoE++ and described it as "the standard this port sources". The catalogue says otherwise:

  • 261 ports declare PoE+++ (e.g. devices/ubiquiti/ecs-24-poe.json)
  • 74 ports across 26 specs declare passive (e.g. devices/ubiquiti/uisp-r.json)
  • 36 write PoE+ (802.3at)

Nothing in the engine reads the key at all: derivePortHardware() (engine/media.js) builds a port's hardware from poeOut, poeIn, the cage and speedCaps, and drops poeOutClass. So the field is a record of the datasheet, its vocabulary is the catalogue's, and the page now says both - with the reason it matters: a passive 24/27/54 V port labelled PoE is the precise fault test/uisp-r-poe.test.js and test/ep-s16-poe.test.js were written for (802.3af is a negotiated 48 V standard).

Docs-only. Guards run before and after: syntax-check 474 files OK; docs-show-commands 7/7 (62 forms, 124 commands, 74 refusals); help-completeness 8/8 (102 advertised rows, 19 mechanisms, 16 show commands); docs-cli-transcript 9/9; no-form-help-key 81/81; doc-catalog-counts 43 checks; regen-registry-doc.js --check current (2,355 models / 258 vendors).

`docs/DEVICE_SCHEMA.md` listed `poeOutClass` as `PoE` / `PoE+` / `PoE++` and described it as "the standard this port sources". The catalogue says otherwise: * 261 ports declare `PoE+++` (e.g. `devices/ubiquiti/ecs-24-poe.json`) * 74 ports across 26 specs declare `passive` (e.g. `devices/ubiquiti/uisp-r.json`) * 36 write `PoE+ (802.3at)` Nothing in the engine reads the key at all: `derivePortHardware()` (`engine/media.js`) builds a port's `hardware` from `poeOut`, `poeIn`, the cage and `speedCaps`, and drops `poeOutClass`. So the field is a record of the datasheet, its vocabulary is the catalogue's, and the page now says both - with the reason it matters: a passive 24/27/54 V port labelled `PoE` is the precise fault `test/uisp-r-poe.test.js` and `test/ep-s16-poe.test.js` were written for (802.3af is a negotiated 48 V standard). Docs-only. Guards run before and after: syntax-check 474 files OK; docs-show-commands 7/7 (62 forms, 124 commands, 74 refusals); help-completeness 8/8 (102 advertised rows, 19 mechanisms, 16 `show` commands); docs-cli-transcript 9/9; no-form-help-key 81/81; doc-catalog-counts 43 checks; `regen-registry-doc.js --check` current (2,355 models / 258 vendors).
docs(schema): poeOutClass is a vendor class list, and passive and PoE+++ are in it
All checks were successful
CI / Classify the change (pull_request) Successful in 14s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 15s
CI / Server smoke and Docker build (pull_request) Has been skipped
CI / Test (Node 20) (pull_request) Successful in 58s
CI / Test (Node 22) (pull_request) Successful in 1m0s
CI / Test (Node 18) (pull_request) Successful in 1m3s
CI / Arm auto-merge (pull_request) Successful in 4s
a3a2c1d221
The interface-field table listed `poeOutClass` as `PoE` / `PoE+` / `PoE++`
and called it "the standard this port sources". The catalogue the page
describes uses five values: 261 ports declare `PoE+++`
(devices/ubiquiti/ecs-24-poe.json), 74 across 26 specs declare `passive`
(devices/ubiquiti/uisp-r.json), and 36 write `PoE+ (802.3at)`.

Nothing in the engine reads the key - derivePortHardware() (engine/media.js)
builds hardware from poeOut, poeIn, the cage and speedCaps and drops
poeOutClass - so the string is a record of the datasheet, not a validated
vocabulary, and the page now says so. Spelling a passive port `PoE` is the
exact fault test/uisp-r-poe.test.js and test/ep-s16-poe.test.js were written
for: 802.3af is a negotiated 48 V standard and a 24 V passive port does not
speak it.
forgejo-actions scheduled this pull request to auto merge when all checks succeed 2026-11-20 01:27:56 +00:00
jaylouisw deleted branch docs/1120-0117 2026-11-20 01:38:45 +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!2237
No description provided.