[mirror_ubuntu-jammy-kernel.git] / Documentation / devicetree / bindings / net / mdio.txt

Common MDIO bus properties.

These are generic properties that can apply to any MDIO bus.

Optional properties:
- reset-gpios: One GPIO that control the RESET lines of all PHYs on that MDIO
  bus.
- reset-delay-us: RESET pulse width in microseconds.

A list of child nodes, one per device on the bus is expected. These
should follow the generic phy.txt, or a device specific binding document.

The 'reset-delay-us' indicates the RESET signal pulse width in microseconds and
applies to all PHY devices. It must therefore be appropriately determined based
on all PHY requirements (maximum value of all per-PHY RESET pulse widths).

Example :
This example shows these optional properties, plus other properties
required for the TI Davinci MDIO driver.

	davinci_mdio: ethernet@5c030000 {
		compatible = "ti,davinci_mdio";
		reg = <0x5c030000 0x1000>;
		#address-cells = <1>;
		#size-cells = <0>;

		reset-gpios = <&gpio2 5 GPIO_ACTIVE_LOW>;
		reset-delay-us = <2>;

		ethphy0: ethernet-phy@1 {
			reg = <1>;
		};

		ethphy1: ethernet-phy@3 {
			reg = <3>;
		};
	};
Commit	Line	Data
69226896 RQ	1	Common MDIO bus properties.
	2
	3	These are generic properties that can apply to any MDIO bus.
	4
	5	Optional properties:
4c5e7a2c FF	6	- reset-gpios: One GPIO that control the RESET lines of all PHYs on that MDIO
	7	bus.
	8	- reset-delay-us: RESET pulse width in microseconds.
69226896 RQ	9
	10	A list of child nodes, one per device on the bus is expected. These
	11	should follow the generic phy.txt, or a device specific binding document.
	12
4c5e7a2c FF	13	The 'reset-delay-us' indicates the RESET signal pulse width in microseconds and
	14	applies to all PHY devices. It must therefore be appropriately determined based
	15	on all PHY requirements (maximum value of all per-PHY RESET pulse widths).
	16
69226896 RQ	17	Example :
	18	This example shows these optional properties, plus other properties
	19	required for the TI Davinci MDIO driver.
	20
4c9847b7	21	davinci_mdio: ethernet@5c030000 {
69226896 RQ	22	compatible = "ti,davinci_mdio";
	23	reg = <0x5c030000 0x1000>;
	24	#address-cells = <1>;
	25	#size-cells = <0>;
	26
	27	reset-gpios = <&gpio2 5 GPIO_ACTIVE_LOW>;
4c5e7a2c	28	reset-delay-us = <2>;
69226896 RQ	29
	30	ethphy0: ethernet-phy@1 {
	31	reg = <1>;
	32	};
	33
	34	ethphy1: ethernet-phy@3 {
	35	reg = <3>;
	36	};
	37	};