1
1
openwrt/target/linux/realtek/dts/macros.dtsi
Jonas Jelonek 43562f97e7
realtek: dts: add link index cell to pcs-handle phandles
A SerDes can host multiple PCS links: QSGMII binds four ports to one
SerDes, USXGMII variants up to eight. Today pcs-handle references the
SerDes as a whole, with no way to express which link inside the SerDes
a port wants. The driver gets away with this because it carries its own
port->link bookkeeping and the link slot is implicit in DSA's port
iteration order -- functional, but the wiring information lives nowhere
in DT.

The upcoming fwnode_pcs migration moves PCS lookup to the generic
fwnode provider API, which disambiguates multiple instances per fwnode
via phandle cells. To make that landable as small, code-only commits,
the DT needs to carry the link index ahead of time.

Bump #pcs-cells from 0 to 1 on every SerDes node in the four SoC DTSIs
and append the link cell to every pcs-handle reference across boards
and the SWITCH_PORT_* macros. Cell values match the existing wiring:
0 for single-link SerDes (10GBase-R, SGMII, fiber, single-link
USXGMII), 0..3 per SerDes for QSGMII and USXGMII-QX, 0..7 for the
RTL9311 octal USXGMII layout.

No code reads the new cell yet -- of_parse_phandle_with_args() in the
PCS driver already cooperates with cells = 0 or 1, and the DSA glue
uses of_parse_phandle() which ignores cells entirely. The change is
runtime-neutral on its own; it exists so the follow-up code patches
can be a few lines each instead of dragging a bridge counter into the
driver to invent slot numbers DT could have provided directly.

Link: https://github.com/openwrt/openwrt/pull/23539
Signed-off-by: Jonas Jelonek <jelonek.jonas@gmail.com>
2026-05-31 12:52:40 +02:00

93 lines
2.4 KiB
Plaintext

// SPDX-License-Identifier: GPL-2.0-or-later OR MIT
/dts-v1/;
#define STRINGIZE(s) #s
#define LAN_LABEL(p, s) STRINGIZE(p ## s)
#define SWITCH_PORT_LABEL(n) LAN_LABEL(lan, n)
#define PHY_C22(p, n) \
phy##p: ethernet-phy@n { \
reg = <##n>; \
compatible = "ethernet-phy-ieee802.3-c22"; \
};
#define PHY_C22_SFP(p, n, s) \
phy##p: ethernet-phy@n { \
reg = <##n>; \
compatible = "ethernet-phy-ieee802.3-c22"; \
sfp = <&sfp##s>; \
};
#define PHY_C45(p, n) \
phy##p: ethernet-phy@n { \
reg = <##n>; \
compatible = "ethernet-phy-ieee802.3-c45"; \
};
#define PHY_C45_PAIR_ORDER(p, n, po) \
phy##p: ethernet-phy@n { \
reg = <##n>; \
compatible = "ethernet-phy-ieee802.3-c45"; \
enet-phy-pair-order = <##po>; \
};
#define SWITCH_PORT(p, l, m) \
port##p: port@##p { \
reg = <##p>; \
label = SWITCH_PORT_LABEL(l) ; \
phy-handle = <&phy##p>; \
phy-mode = #m ; \
};
#define SWITCH_PORT_SDS(p, l, s, i, m) \
port##p: port@##p { \
reg = <##p>; \
label = SWITCH_PORT_LABEL(l) ; \
pcs-handle = <&serdes##s i>; \
phy-handle = <&phy##p>; \
phy-mode = #m ; \
};
#define SWITCH_PORT_LED(p, l, s, i, c, m) \
port##p: port@##p { \
reg = <##p>; \
label = SWITCH_PORT_LABEL(l) ; \
led-set = <##c>; \
pcs-handle = <&serdes##s i>; \
phy-handle = <&phy##p>; \
phy-mode = #m ; \
};
#define SWITCH_PORT_SFP(p, l, s, c, g) \
port##p: port@##p { \
reg = <##p>; \
label = SWITCH_PORT_LABEL(l) ; \
led-set = <##c>; \
pcs-handle = <&serdes##s 0>; \
phy-mode = "1000base-x"; \
sfp = <&sfp##g>; \
managed = "in-band-status"; \
};
/* LED Set mode definitions */
#define RTL93XX_LED_SET_NONE (0)
#define RTL93XX_LED_SET_10G (1 << 0)
#define RTL93XX_LED_SET_5G (1 << 1)
#define RTL93XX_LED_SET_2P5G (1 << 3)
#define RTL93XX_LED_SET_1G (1 << 5)
#define RTL93XX_LED_SET_100M (1 << 7)
#define RTL93XX_LED_SET_10M (1 << 8)
#define RTL93XX_LED_SET_LINK (1 << 9)
#define RTL93XX_LED_SET_LINK_BLINK (1 << 10)
#define RTL93XX_LED_SET_ACT (1 << 11)
#define RTL93XX_LED_SET_RX (1 << 12)
#define RTL93XX_LED_SET_TX (1 << 13)
#define RTL93XX_LED_SET_COLLISION (1 << 14)
#define RTL93XX_LED_SET_DUPLEX (1 << 15)
/* LED Interface modes */
#define RTL93XX_LED_MODE_SERIAL 1
#define RTL93XX_LED_MODE_SINGLE_COLOR_SCAN 2
#define RTL93XX_LED_MODE_BI_COLOR_SCAN 3