linux/Documentation/devicetree/bindings/net
Andrew Lunn c360eb0c3c dt-bindings: net: ethernet-controller: Add informative text about RGMII delays
Device Tree and Ethernet MAC driver writers often misunderstand RGMII
delays. Rewrite the Normative section in terms of the PCB, is the PCB
adding the 2ns delay. This meaning was previous implied by the
definition, but often wrongly interpreted due to the ambiguous wording
and looking at the definition from the wrong perspective. The new
definition concentrates clearly on the hardware, and should be less
ambiguous.

Add an Informative section to the end of the binding describing in
detail what the four RGMII delays mean. This expands on just the PCB
meaning, adding in the implications for the MAC and PHY.

Additionally, when the MAC or PHY needs to add a delay, which is
software configuration, describe how Linux does this, in the hope of
reducing errors. Make it clear other users of device tree binding may
implement the software configuration in other ways while still
conforming to the binding.

Fixes: 9d3de3c583 ("dt-bindings: net: Add YAML schemas for the generic Ethernet options")
Signed-off-by: Andrew Lunn <andrew@lunn.ch>
Acked-by: Conor Dooley <conor.dooley@microchip.com>
Link: https://patch.msgid.link/20250430-v6-15-rc3-net-rgmii-delays-v2-1-099ae651d5e5@lunn.ch
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
2025-05-05 16:49:18 -07:00
..
bluetooth dt-bindings: net: bluetooth: nxp: Add support to set BD address 2025-03-25 12:45:37 -04:00
can Merge git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net 2025-03-20 21:38:01 +01:00
dsa dt-bindings: net: dsa: b53: add BCM53101 support 2025-02-19 18:41:43 -08:00
ieee802154 dt-bindings: ieee802154: ca8210: Update polarity of the reset pin 2025-03-06 21:55:18 +01:00
nfc dt-bindings: nfc: nxp,nci: Document PN553 compatible 2024-10-28 12:53:20 -07:00
pcs dt-bindings: net: Add Synopsys DW xPCS bindings 2024-07-05 09:35:50 +01:00
pse-pd dt-bindings: net: pse-pd: Fix unusual character in documentation 2025-01-08 19:34:56 -08:00
wireless ath.git patches for v6.15 2025-03-07 09:19:03 +01:00
actions,owl-emac.yaml
adi,adin.yaml
adi,adin1110.yaml
airoha,en7581-eth.yaml dt-bindings: net: airoha: Add airoha,npu phandle property 2025-03-04 13:22:09 +01:00
airoha,en7581-npu.yaml dt-bindings: net: airoha: Add the NPU node for EN7581 SoC 2025-03-04 13:22:09 +01:00
airoha,en8811h.yaml
allwinner,sun4i-a10-emac.yaml
allwinner,sun4i-a10-mdio.yaml
allwinner,sun7i-a20-gmac.yaml
allwinner,sun8i-a83t-emac.yaml
altr,tse.yaml
amd-xgbe.txt
amlogic,g12a-mdio-mux.yaml
amlogic,gxl-mdio-mux.yaml
amlogic,meson-dwmac.yaml dt-bindings: net: Define interrupt constraints for DWMAC vendor bindings 2025-03-13 12:00:18 +01:00
anarion-gmac.txt
apm-xgene-enet.txt
apm-xgene-mdio.txt
asix,ax88178.yaml dt-bindings: net: Correct indentation and style in DTS example 2025-01-09 13:13:52 +01:00
asix,ax88796c.yaml
aspeed,ast2600-mdio.yaml
brcm,amac.yaml
brcm,asp-v2.0.yaml
brcm,bcm4908-enet.yaml
brcm,bcm6368-mdio-mux.yaml
brcm,bcm7445-switch-v4.0.txt
brcm,bcmgenet.yaml dt-bindings: net: Correct indentation and style in DTS example 2025-01-09 13:13:52 +01:00
brcm,iproc-mdio.yaml
brcm,mdio-mux-iproc.yaml dt-bindings: net: Correct indentation and style in DTS example 2025-01-09 13:13:52 +01:00
brcm,systemport.yaml
brcm,unimac-mdio.yaml dt-bindings: net: brcm,unimac-mdio: Add bcm6846-mdio 2024-10-15 18:23:53 -07:00
broadcom-bcm87xx.txt
btusb.txt
calxeda-xgmac.yaml
cavium-mdio.txt
cavium-mix.txt
cavium-pip.txt
cdns,macb.yaml dt-bindings: xilinx: Deprecate header with firmware constants 2025-02-21 07:58:35 +01:00
cirrus,cs89x0.txt
cirrus,ep9301-eth.yaml dt-bindings: net: Add Cirrus EP93xx 2024-09-12 14:33:11 +00:00
cortina,gemini-ethernet.yaml
cortina.txt
cpsw-phy-sel.txt
cpsw.txt
davicom,dm9000.yaml
davicom,dm9051.yaml
davinci_emac.txt
engleder,tsnep.yaml
ethernet-controller.yaml dt-bindings: net: ethernet-controller: Add informative text about RGMII delays 2025-05-05 16:49:18 -07:00
ethernet-phy-package.yaml
ethernet-phy.yaml dt-bindings: net: ethernet-phy: add property tx-amplitude-100base-tx-percent 2025-02-17 16:40:42 -08:00
ethernet-switch-port.yaml
ethernet-switch.yaml
ethernet.txt
ezchip_enet.txt
faraday,ftgmac100.yaml dt-bindings: net: faraday,ftgmac100: Add phys mode 2025-02-04 14:01:58 -08:00
faraday,ftmac.txt
fixed-link.txt
fsl,cpm-enet.yaml dt-bindings: soc: fsl: cpm_qe: convert network.txt to yaml 2024-08-15 09:41:33 -06:00
fsl,cpm-mdio.yaml dt-bindings: soc: fsl: cpm_qe: convert network.txt to yaml 2024-08-15 09:41:33 -06:00
fsl,enetc-ierb.yaml dt-bindings: net: convert enetc to yaml 2024-07-10 19:05:46 -07:00
fsl,enetc-mdio.yaml dt-bindings: net: add compatible string for i.MX95 EMDIO 2024-11-04 10:03:50 +00:00
fsl,enetc.yaml dt-bindings: net: add i.MX95 ENETC support 2024-11-04 10:03:50 +00:00
fsl,fec.yaml dt-bindings: net: fec: add pps channel property 2024-10-08 12:29:34 +02:00
fsl,fman-dtsec.yaml
fsl,fman-mdio.yaml
fsl,fman-muram.yaml
fsl,fman-port.yaml
fsl,fman.yaml dt-bindings: net: fsl,fman: add ptimer-handle property 2024-07-09 11:33:39 -07:00
fsl,gianfar-mdio.yaml dt-bindings: net: fsl,gianfar-mdio: Update information about TBI 2025-03-04 17:02:16 -08:00
fsl,gianfar.yaml dt-bindings: net: Convert fsl,gianfar to YAML 2025-03-04 17:02:16 -08:00
fsl,qoriq-mc-dpmac.yaml Merge git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net 2024-08-15 17:18:52 -07:00
fsl-tsec-phy.txt dt-bindings: net: Convert fsl,gianfar to YAML 2025-03-04 17:02:16 -08:00
hisilicon-femac-mdio.txt
hisilicon-femac.txt
hisilicon-hip04-net.txt
hisilicon-hix5hd2-gmac.txt
hisilicon-hns-dsaf.txt
hisilicon-hns-mdio.txt
hisilicon-hns-nic.txt
ibm,emac.txt
icplus-ip101ag.txt
idt,3243x-emac.yaml
ingenic,mac.yaml
intel,dwmac-plat.yaml dt-bindings: net: Define interrupt constraints for DWMAC vendor bindings 2025-03-13 12:00:18 +01:00
intel,ixp4xx-ethernet.yaml
intel,ixp4xx-hss.yaml
intel,ixp46x-ptp-timer.yaml
ipq806x-dwmac.txt
keystone-netcp.txt
lantiq,etop-xway.yaml
lantiq,pef2256.yaml
lantiq,xrx200-net.yaml
litex,liteeth.yaml
loongson,ls1b-gmac.yaml
loongson,ls1c-emac.yaml
lpc-eth.txt
marvell,aquantia.yaml dt-bindings: net: marvell,aquantia: add property to override MDI_CFG 2024-10-08 17:16:35 -07:00
marvell,dfx-server.yaml
marvell,mvusb.yaml
marvell,orion-mdio.yaml
marvell,pp2.yaml
marvell,prestera.yaml
marvell-armada-370-neta.txt
marvell-bt-8xxx.txt
marvell-neta-bm.txt
marvell-orion-net.txt
marvell-pxa168.txt
maxim,ds26522.yaml dt-bindings: net: convert maxim,ds26522.txt to yaml format 2024-08-13 14:19:31 -06:00
maxlinear,gpy2xx.yaml
mctp-i2c-controller.yaml
mdio-gpio.yaml
mdio-mux-gpio.yaml dt-bindings: net: mdio-mux-gpio: Drop undocumented "marvell,reg-init" 2024-11-14 19:30:16 -08:00
mdio-mux-mmioreg.yaml
mdio-mux-multiplexer.yaml
mdio-mux.yaml
mdio.txt
mdio.yaml dt-bindings: net: mdio: change nodename match pattern 2024-08-16 14:28:53 -07:00
mediatek,net.yaml dt-bindings: net: mediatek,net: add top-level constraints 2024-08-20 15:28:41 -07:00
mediatek,star-emac.yaml
mediatek-dwmac.yaml dt-bindings: net: Define interrupt constraints for DWMAC vendor bindings 2025-03-13 12:00:18 +01:00
micrel,ks8851.yaml
micrel-ks8995.txt
micrel-ksz90x1.txt
micrel.txt
microchip,enc28j60.txt
microchip,lan78xx.txt
microchip,lan95xx.yaml
microchip,lan966x-switch.yaml
microchip,lan8650.yaml dt-bindings: net: add Microchip's LAN865X 10BASE-T1S MACPHY 2024-09-11 20:53:46 -07:00
microchip,sparx5-switch.yaml dt-bindings: net: sparx5: document RGMII delays 2024-12-23 10:57:56 -08:00
motorcomm,yt8xxx.yaml
mscc,miim.yaml
mscc,vsc7514-switch.yaml
mscc-phy-vsc8531.txt
nixge.txt
nvidia,tegra234-mgbe.yaml
nxp,dwmac-imx.yaml dt-bindings: net: Define interrupt constraints for DWMAC vendor bindings 2025-03-13 12:00:18 +01:00
nxp,lpc1850-dwmac.txt
nxp,netc-blk-ctrl.yaml dt-bindings: net: add bindings for NETC blocks control 2024-11-04 10:03:50 +00:00
nxp,s32-dwmac.yaml dt-bindings: net: Add DT bindings for DWMAC on NXP S32G/R SoCs 2024-12-09 18:36:03 -08:00
nxp,tja11xx.yaml dt-bindings: net: tja11xx: add "nxp,rmii-refclk-out" property 2024-10-15 10:44:52 +02:00
opencores-ethoc.txt
phy.txt
qca,ar71xx.yaml
qca,ar803x.yaml
qca,qca808x.yaml
qca,qca7000.txt
qcom,bam-dmux.yaml
qcom,ethqos.yaml First batch of fixes for 6.14. Nothing really stands out, 2025-01-30 12:24:20 -08:00
qcom,ipa.yaml dt-bindings: net: qcom,ipa: Correct indentation and style in DTS example 2025-03-25 08:49:21 -07:00
qcom,ipq4019-mdio.yaml
qcom,ipq8064-mdio.yaml
qcom,qca807x.yaml
qcom-emac.txt
realtek,rtl82xx.yaml dt-bindings: net: realtek,rtl82xx: Document RTL8211F LED support 2024-07-10 19:04:42 -07:00
realtek,rtl9301-mdio.yaml dt-bindings: net: Add Realtek MDIO controller 2025-02-21 15:07:15 -08:00
realtek,rtl9301-switch.yaml dt-bindings: net: Add Realtek MDIO controller 2025-02-21 15:07:15 -08:00
renesas,ether.yaml dt-bindings: net: renesas,ether: Drop undocumented "micrel,led-mode" 2024-11-18 16:17:41 -08:00
renesas,etheravb.yaml dt-bindings: net: renesas,etheravb: add top-level constraints 2024-08-20 15:28:41 -07:00
renesas,ethertsn.yaml
renesas,r8a779f0-ether-switch.yaml
renesas,rzn1-gmac.yaml
rfkill-gpio.yaml dt-bindings: net: rfkill-gpio: enable booting in blocked state 2025-02-11 11:55:55 +01:00
rockchip,emac.yaml
rockchip-dwmac.yaml dt-bindings: net: rockchip-dwmac: Add compatible string for RK3528 2025-03-25 08:00:55 -07:00
samsung-sxgbe.txt
sff,sfp.yaml dt-bindings: net: sff,sfp: Fix "interrupts" property typo 2024-11-14 19:31:35 -08:00
smsc,lan91c111.yaml
smsc,lan9115.yaml dt-bindings: net: smsc,lan9115: Ensure all properties are defined 2025-02-10 18:13:34 -06:00
smsc-lan87xx.txt
snps,dwc-qos-ethernet.txt
snps,dwmac.yaml dt-bindings: deprecate "snps,en-tx-lpi-clockgating" property 2025-03-19 18:06:33 +01:00
socfpga-dwmac.txt
socionext,synquacer-netsec.yaml
socionext,uniphier-ave4.yaml dt-bindings: net: socionext,uniphier-ave4: add top-level constraints 2024-08-20 15:28:42 -07:00
sophgo,sg2044-dwmac.yaml dt-bindings: net: Add support for Sophgo SG2044 dwmac 2025-03-07 19:06:36 -08:00
starfive,jh7110-dwmac.yaml
sti-dwmac.txt
stm32-dwmac.yaml dt-bindings: net: Define interrupt constraints for DWMAC vendor bindings 2025-03-13 12:00:18 +01:00
stmmac.txt
sunplus,sp7021-emac.yaml
tesla,fsd-ethqos.yaml dt-bindings: net: Add FSD EQoS device tree bindings 2025-03-06 15:30:32 -08:00
thead,th1520-gmac.yaml dt-bindings: net: Add T-HEAD dwmac support 2024-11-05 17:50:04 -08:00
ti,cc1352p7.yaml dt-bindings: net: ti,cc1352p7: Add bootloader-backdoor-gpios 2024-09-12 09:04:09 +02:00
ti,cpsw-switch.yaml
ti,davinci-mdio.yaml dt-bindings: net: Correct indentation and style in DTS example 2025-01-09 13:13:52 +01:00
ti,dp83822.yaml dt-bindings: net: dp83822: Add support for GPIO2 clock output 2024-12-15 21:12:37 +00:00
ti,dp83867.yaml
ti,dp83869.yaml
ti,icss-iep.yaml
ti,icssg-prueth.yaml
ti,k3-am654-cpsw-nuss.yaml dt-bindings: net: Correct indentation and style in DTS example 2025-01-09 13:13:52 +01:00
ti,k3-am654-cpts.yaml dt-bindings: net: Correct indentation and style in DTS example 2025-01-09 13:13:52 +01:00
toshiba,visconti-dwmac.yaml dt-bindings: net: Define interrupt constraints for DWMAC vendor bindings 2025-03-13 12:00:18 +01:00
vertexcom-mse102x.yaml
via-rhine.txt
via-velocity.txt
wiznet,w5x00.txt
xlnx,axi-ethernet.yaml dt-bindings: net: xlnx,axi-ethernet: Correct phy-mode property value 2024-11-01 19:02:50 -07:00
xlnx,emaclite.yaml dt-bindings: net: emaclite: Add clock support 2024-10-11 15:41:33 -07:00
xlnx,gmii-to-rgmii.yaml