devices(teltonika): the RUT276's PoE ran backwards - a phantom PSE on its LAN port #2428

Merged
jaylouisw merged 1 commit from catalogue/1121-1322 into main 2026-11-21 13:38:01 +00:00
Owner

Refs #130 (the Dream Wall Pro request stays blocked: no Ubiquiti page for UDW-PRO exists; re-measured this run - https://techspecs.ui.com/unifi/cloud-gateways/udw-pro -> 307, 1 byte, Location: /; https://store.ui.com/us/en/products/udw-pro -> 404).

The defect

devices/teltonika/rut276.json declared lan1 with poeOut: true and poeOutClass: "PoE+", plus poe-pse in the capability list. Teltonika's own datasheet says the opposite: this box takes power on that socket and has no PoE output at all.

The vendor's rows

RUT276 datasheet v1.05, 2026-07-24, p.7 - https://download.kamami.pl/p1207999-Datasheet_RUT276_1.05.pdf (HTTP 200, 4,182,657 B, 14 pp, text layer read 2026-11-21). Same rows in v1.04, 2026-05-15, p.8 - https://cdn.bueromarkt-ag.de/downloads/produktdatenblaetter/rut276000000.pdf (HTTP 200, 4,320,815 B, 15 pp):

POE IN
PoE IN ports    1 x PoE In
PoE standards   Active PoE input 802.3af Class 0 (12.94 W) on LAN port
PoE (passive)   Passive PoE over spare pairs 4,5 (+) / 7,8 (-).
                Possibility to power up through LAN port. 16 - 57 VDC.
Power consumption  Idle: < 2 W, Max: < 3.5 W

and p.2: WAN 1 x WAN port 10/100 Mbps / LAN 1 x LAN port, 10/100 Mbps.

Neither revision has a POE OUT section, a per-port PSE wattage or a PoE budget. v1.04 prints that value row as PoE OUT ports - a template leftover that v1.05 corrects to PoE IN ports - and it is the only place a "PoE out" reading could have come from.

What it cost, measured

Before: poeDraw() added the bare direction bit as 1 W, pseDraw() counted it against a budget nobody published, show power inline on the router answered budget not modelled on RUT276: the ports are reported, the power they could supply is not, and a PSE switch cabled to lan1 printed port1 auto off - the far end is not a powered device. The router could not be powered by the cable the datasheet says powers it.

After: the same switch prints port1 auto on 12.9 RUT276 with Used:12.9(w), and the router answers % No PoE on RUT276: no port on this device can supply power.

Also in the same file

  • lan1 -> poeIn: 12.94, no poeOut/poeOutClass; capabilities lose poe-pse, gain 802.3af (Class 0), keep poe-pd.
  • wan1 role "wan", lan1 role "lan". With neither declared, ownsIpOn()'s separation (owner.role && inIface.role && owner.role !== inIface.role) never fired: an address on lan1 was answered from wan1 - the defect #2385 and #2419 fixed on the UXG and EFG gateways. Measured after: ownsIpOn(wan1, '192.168.1.1') is false, ownsIpOn(lan1, ...) is true.
  • sourceUrl re-pointed: https://teltonika-networks.com/product/rut276/ now 404s; the live page is https://www.teltonika-networks.com/products/routers/rut276 (HTTP 200, 3,082,758 B).
  • research/incoming/devices-teltonika-batch59.json carries the same corrected rows, so a re-import cannot reintroduce the PSE.

Gates

  • node scripts/syntax-check.js - 535 files, all OK
  • node scripts/audit-port-types.js - 0 gated, 0 contradiction
  • node scripts/audit-poe-budget.js - silent PSEs 20 -> 19, PSE sources 411 -> 410
  • node test/teltonika-rut276-poe.test.js - 15 assertions, 0 failed
  • node scripts/regen-registry-doc.js - catalogue current, no doc change
  • full suite: 455 suites, 15,430 assertions, 0 failed
Refs #130 (the Dream Wall Pro request stays blocked: no Ubiquiti page for UDW-PRO exists; re-measured this run - `https://techspecs.ui.com/unifi/cloud-gateways/udw-pro` -> 307, 1 byte, `Location: /`; `https://store.ui.com/us/en/products/udw-pro` -> 404). ## The defect `devices/teltonika/rut276.json` declared `lan1` with `poeOut: true` and `poeOutClass: "PoE+"`, plus `poe-pse` in the capability list. Teltonika's own datasheet says the opposite: this box **takes** power on that socket and has no PoE output at all. ## The vendor's rows RUT276 datasheet v1.05, 2026-07-24, p.7 - `https://download.kamami.pl/p1207999-Datasheet_RUT276_1.05.pdf` (HTTP 200, 4,182,657 B, 14 pp, text layer read 2026-11-21). Same rows in v1.04, 2026-05-15, p.8 - `https://cdn.bueromarkt-ag.de/downloads/produktdatenblaetter/rut276000000.pdf` (HTTP 200, 4,320,815 B, 15 pp): ``` POE IN PoE IN ports 1 x PoE In PoE standards Active PoE input 802.3af Class 0 (12.94 W) on LAN port PoE (passive) Passive PoE over spare pairs 4,5 (+) / 7,8 (-). Possibility to power up through LAN port. 16 - 57 VDC. Power consumption Idle: < 2 W, Max: < 3.5 W ``` and p.2: `WAN 1 x WAN port 10/100 Mbps` / `LAN 1 x LAN port, 10/100 Mbps`. Neither revision has a POE OUT section, a per-port PSE wattage or a PoE budget. v1.04 prints that value row as `PoE OUT ports` - a template leftover that v1.05 corrects to `PoE IN ports` - and it is the only place a "PoE out" reading could have come from. ## What it cost, measured Before: `poeDraw()` added the bare direction bit as **1 W**, `pseDraw()` counted it against a budget nobody published, `show power inline` on the router answered `budget not modelled on RUT276: the ports are reported, the power they could supply is not`, and a PSE switch cabled to `lan1` printed `port1 auto off - the far end is not a powered device`. The router could not be powered by the cable the datasheet says powers it. After: the same switch prints `port1 auto on 12.9 RUT276` with `Used:12.9(w)`, and the router answers `% No PoE on RUT276: no port on this device can supply power`. ## Also in the same file * `lan1` -> `poeIn: 12.94`, no `poeOut`/`poeOutClass`; capabilities lose `poe-pse`, gain `802.3af` (Class 0), keep `poe-pd`. * `wan1` role `"wan"`, `lan1` role `"lan"`. With neither declared, `ownsIpOn()`'s separation (`owner.role && inIface.role && owner.role !== inIface.role`) never fired: an address on `lan1` was answered from `wan1` - the defect #2385 and #2419 fixed on the UXG and EFG gateways. Measured after: `ownsIpOn(wan1, '192.168.1.1')` is false, `ownsIpOn(lan1, ...)` is true. * `sourceUrl` re-pointed: `https://teltonika-networks.com/product/rut276/` now 404s; the live page is `https://www.teltonika-networks.com/products/routers/rut276` (HTTP 200, 3,082,758 B). * `research/incoming/devices-teltonika-batch59.json` carries the same corrected rows, so a re-import cannot reintroduce the PSE. ## Gates * `node scripts/syntax-check.js` - 535 files, all OK * `node scripts/audit-port-types.js` - 0 gated, 0 contradiction * `node scripts/audit-poe-budget.js` - silent PSEs **20 -> 19**, PSE sources **411 -> 410** * `node test/teltonika-rut276-poe.test.js` - 15 assertions, 0 failed * `node scripts/regen-registry-doc.js` - catalogue current, no doc change * full suite: **455 suites, 15,430 assertions, 0 failed**
devices(teltonika): the RUT276's PoE ran backwards - a phantom PSE on its LAN port
All checks were successful
CI / Server smoke and Docker build (pull_request) Successful in 30s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 6s
CI / Test (Node 18) (pull_request) Successful in 1m4s
CI / Test (Node 20) (pull_request) Successful in 1m4s
CI / Test (Node 22) (pull_request) Successful in 1m3s
CI / Arm auto-merge (pull_request) Successful in 3s
281a09c957
`devices/teltonika/rut276.json` declared `lan1` with `poeOut: true` and
`poeOutClass: "PoE+"`, and `poe-pse` in the capability list. Teltonika's own
datasheet says the opposite: the box *takes* power on that socket.

RUT276 datasheet v1.05, 2026-07-24, p.7
(https://download.kamami.pl/p1207999-Datasheet_RUT276_1.05.pdf, HTTP 200,
4,182,657 B, 14 pp; same rows in v1.04 2026-05-15, p.8,
https://cdn.bueromarkt-ag.de/downloads/produktdatenblaetter/rut276000000.pdf):

  POE IN / PoE IN ports: 1 x PoE In
  PoE standards: Active PoE input 802.3af Class 0 (12.94 W) on LAN port
  PoE (passive): ... Possibility to power up through LAN port. 16 - 57 VDC.

Neither revision has a POE OUT section, a per-port PSE wattage or a budget.
(v1.04 prints that value row as "PoE OUT ports" - a template leftover v1.05
corrects to "PoE IN ports", and the only place a "PoE out" reading could have
come from.)

What it cost: `poeDraw()` added the bare direction bit as 1 W, `pseDraw()`
counted it against a budget nobody published, `show power inline` answered
"budget not modelled on RUT276", and a PoE switch cabled to it printed "the far
end is not a powered device" - the box could not be powered by the cable the
datasheet says powers it. Now: switch port1 reads "on 12.9 RUT276", Used
12.9(w), and the router answers "% No PoE on RUT276: no port on this device can
supply power".

The two sockets also carry the roles the sheet names on p.2 ("WAN 1 x WAN port
10/100 Mbps" / "LAN 1 x LAN port, 10/100 Mbps"): with neither declared,
`ownsIpOn()`'s separation never fired and an address held on lan1 was answered
on wan1 - the defect #2385 and #2419 fixed on the UXG and EFG gateways.

Also fixes the sourceUrl (teltonika-networks.com/product/rut276/ is now 404;
the live page is /products/routers/rut276) and the matching research entry.

Gate: test/teltonika-rut276-poe.test.js (15 assertions), full suite 455 suites
/ 15,430 assertions, 0 failed; audit-poe-budget silent PSEs 20 -> 19, PSE
sources 411 -> 410.
forgejo-actions scheduled this pull request to auto merge when all checks succeed 2026-11-21 13:33:51 +00:00
jaylouisw deleted branch catalogue/1121-1322 2026-11-21 13:38:06 +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!2428
No description provided.