Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: net: move ptp-timer property to ethernet-controller.yaml

For some Ethernet controllers, the PTP timer function is not integrated.
Instead, the PTP timer is a separate device and provides PTP Hardware
Clock (PHC) to the Ethernet controller to use, such as NXP FMan MAC,
ENETC, etc. Therefore, a property is needed to indicate this hardware
relationship between the Ethernet controller and the PTP timer.

Since this use case is also very common, it is better to add a generic
property to ethernet-controller.yaml. According to the existing binding
docs, there are two good candidates, one is the "ptp-timer" defined in
fsl,fman-dtsec.yaml, and the other is the "ptimer-handle" defined in
fsl,fman.yaml. From the perspective of the name, the former is more
straightforward, so move the "ptp-timer" from fsl,fman-dtsec.yaml to
ethernet-controller.yaml.

Signed-off-by: Wei Fang <wei.fang@nxp.com>
Reviewed-by: Vladimir Oltean <vladimir.oltean@nxp.com>
Reviewed-by: Frank Li <Frank.Li@nxp.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/20250829050615.1247468-3-wei.fang@nxp.com
Signed-off-by: Paolo Abeni <pabeni@redhat.com>

authored by

Wei Fang and committed by
Paolo Abeni
db2d2de1 d6900b8b

+5 -4
+5
Documentation/devicetree/bindings/net/ethernet-controller.yaml
··· 108 108 $ref: "#/properties/phy-handle" 109 109 deprecated: true 110 110 111 + ptp-timer: 112 + $ref: /schemas/types.yaml#/definitions/phandle 113 + description: 114 + Specifies a reference to a node representing an IEEE 1588 PTP device. 115 + 111 116 rx-fifo-depth: 112 117 $ref: /schemas/types.yaml#/definitions/uint32 113 118 description:
-4
Documentation/devicetree/bindings/net/fsl,fman-dtsec.yaml
··· 81 81 An array of two references: the first is the FMan RX port and the second 82 82 is the TX port used by this MAC. 83 83 84 - ptp-timer: 85 - $ref: /schemas/types.yaml#/definitions/phandle 86 - description: A reference to the IEEE1588 timer 87 - 88 84 phys: 89 85 description: A reference to the SerDes lane(s) 90 86 maxItems: 1