forked from Minki/linux
e5f3a4a56c
RGMII requires special RX and/or TX delays depending on the actual hardware circuit/wiring. These delays can be added by the MAC, the PHY or the designer of the circuit (the latter means that no delay has to be added by PHY or MAC). There are 4 RGMII phy-modes used describe where a delay should be applied: - rgmii: the RX and TX delays are either added by the MAC (where the exact delay is typically configurable, and can be turned off when no extra delay is needed) or not needed at all (because the hardware wiring adds the delay already). The PHY should neither add the RX nor TX delay in this case. - rgmii-rxid: configures the PHY to enable the RX delay. The MAC should not add the RX delay in this case. - rgmii-txid: configures the PHY to enable the TX delay. The MAC should not add the TX delay in this case. - rgmii-id: combines rgmii-rxid and rgmii-txid and thus configures the PHY to enable the RX and TX delays. The MAC should neither add the RX nor TX delay in this case. Document these cases in the ethernet.txt documentation to make it clear when to use each mode. If applied incorrectly one might end up with MAC and PHY both enabling for example the TX delay, which breaks ethernet TX traffic on 1000Mbit/s links. Signed-off-by: Martin Blumenstingl <martin.blumenstingl@googlemail.com> Reviewed-by: Florian Fainelli <f.fainelli@gmail.com> Signed-off-by: David S. Miller <davem@davemloft.net>
52 lines
2.5 KiB
Plaintext
52 lines
2.5 KiB
Plaintext
The following properties are common to the Ethernet controllers:
|
|
|
|
- local-mac-address: array of 6 bytes, specifies the MAC address that was
|
|
assigned to the network device;
|
|
- mac-address: array of 6 bytes, specifies the MAC address that was last used by
|
|
the boot program; should be used in cases where the MAC address assigned to
|
|
the device by the boot program is different from the "local-mac-address"
|
|
property;
|
|
- max-speed: number, specifies maximum speed in Mbit/s supported by the device;
|
|
- max-frame-size: number, maximum transfer unit (IEEE defined MTU), rather than
|
|
the maximum frame size (there's contradiction in ePAPR).
|
|
- phy-mode: string, operation mode of the PHY interface. This is now a de-facto
|
|
standard property; supported values are:
|
|
* "mii"
|
|
* "gmii"
|
|
* "sgmii"
|
|
* "qsgmii"
|
|
* "tbi"
|
|
* "rev-mii"
|
|
* "rmii"
|
|
* "rgmii" (RX and TX delays are added by the MAC when required)
|
|
* "rgmii-id" (RGMII with internal RX and TX delays provided by the PHY, the
|
|
MAC should not add the RX or TX delays in this case)
|
|
* "rgmii-rxid" (RGMII with internal RX delay provided by the PHY, the MAC
|
|
should not add an RX delay in this case)
|
|
* "rgmii-txid" (RGMII with internal TX delay provided by the PHY, the MAC
|
|
should not add an TX delay in this case)
|
|
* "rtbi"
|
|
* "smii"
|
|
* "xgmii"
|
|
* "trgmii"
|
|
- phy-connection-type: the same as "phy-mode" property but described in ePAPR;
|
|
- phy-handle: phandle, specifies a reference to a node representing a PHY
|
|
device; this property is described in ePAPR and so preferred;
|
|
- phy: the same as "phy-handle" property, not recommended for new bindings.
|
|
- phy-device: the same as "phy-handle" property, not recommended for new
|
|
bindings.
|
|
- rx-fifo-depth: the size of the controller's receive fifo in bytes. This
|
|
is used for components that can have configurable receive fifo sizes,
|
|
and is useful for determining certain configuration settings such as
|
|
flow control thresholds.
|
|
- tx-fifo-depth: the size of the controller's transmit fifo in bytes. This
|
|
is used for components that can have configurable fifo sizes.
|
|
- managed: string, specifies the PHY management type. Supported values are:
|
|
"auto", "in-band-status". "auto" is the default, it usess MDIO for
|
|
management if fixed-link is not specified.
|
|
|
|
Child nodes of the Ethernet controller are typically the individual PHY devices
|
|
connected via the MDIO bus (sometimes the MDIO bus controller is separate).
|
|
They are described in the phy.txt file in this same directory.
|
|
For non-MDIO PHY management see fixed-link.txt.
|