mirror of
https://github.com/torvalds/linux.git
synced 2026-04-18 14:53:58 -04:00
3e782985cb
MDIO busses typically operate at 2.5MHz. However many devices can operate at faster speeds. This then allows more MDIO transactions per second, useful for Ethernet switch statistics, or Ethernet PHY TDR data. Allow the bus speed to be configured, using the standard "clock-frequency" property, which i2c busses use to indicate the bus speed. Before using this property, ensure all devices on the bus do actually support the requested clock speed. Suggested-by: Chris Healy <Chris.Healy@zii.aero> Signed-off-by: Andrew Lunn <andrew@lunn.ch> Reviewed-by: Florian Fainelli <f.fainelli@gmail.com> Signed-off-by: David S. Miller <davem@davemloft.net>
80 lines
1.9 KiB
YAML
80 lines
1.9 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/net/mdio.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: MDIO Bus Generic Binding
|
|
|
|
maintainers:
|
|
- Andrew Lunn <andrew@lunn.ch>
|
|
- Florian Fainelli <f.fainelli@gmail.com>
|
|
- Heiner Kallweit <hkallweit1@gmail.com>
|
|
|
|
description:
|
|
These are generic properties that can apply to any MDIO bus. Any
|
|
MDIO bus must have a list of child nodes, one per device on the
|
|
bus. These should follow the generic ethernet-phy.yaml document, or
|
|
a device specific binding document.
|
|
|
|
properties:
|
|
$nodename:
|
|
pattern: "^mdio(@.*)?"
|
|
|
|
"#address-cells":
|
|
const: 1
|
|
|
|
"#size-cells":
|
|
const: 0
|
|
|
|
reset-gpios:
|
|
maxItems: 1
|
|
description:
|
|
The phandle and specifier for the GPIO that controls the RESET
|
|
lines of all PHYs on that MDIO bus.
|
|
|
|
reset-delay-us:
|
|
description:
|
|
RESET pulse width in microseconds. It applies to all PHY devices
|
|
and must therefore be appropriately determined based on all PHY
|
|
requirements (maximum value of all per-PHY RESET pulse widths).
|
|
|
|
clock-frequency:
|
|
description:
|
|
Desired MDIO bus clock frequency in Hz. Values greater than IEEE 802.3
|
|
defined 2.5MHz should only be used when all devices on the bus support
|
|
the given clock speed.
|
|
|
|
patternProperties:
|
|
"^ethernet-phy@[0-9a-f]+$":
|
|
type: object
|
|
|
|
properties:
|
|
reg:
|
|
minimum: 0
|
|
maximum: 31
|
|
description:
|
|
The ID number for the PHY.
|
|
|
|
required:
|
|
- reg
|
|
|
|
examples:
|
|
- |
|
|
davinci_mdio: mdio@5c030000 {
|
|
reg = <0x5c030000 0x1000>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
reset-gpios = <&gpio2 5 1>;
|
|
reset-delay-us = <2>;
|
|
|
|
ethphy0: ethernet-phy@1 {
|
|
reg = <1>;
|
|
};
|
|
|
|
ethphy1: ethernet-phy@3 {
|
|
reg = <3>;
|
|
};
|
|
};
|