xref: /linux/Documentation/devicetree/bindings/net/phy.txt (revision e5c86679d5e864947a52fb31e45a425dea3e7fa9) 
1PHY nodes
2
3Required properties:
4
5 - interrupts : <a b> where a is the interrupt number and b is a
6   field that represents an encoding of the sense and level
7   information for the interrupt.  This should be encoded based on
8   the information in section 2) depending on the type of interrupt
9   controller you have.
10 - interrupt-parent : the phandle for the interrupt controller that
11   services interrupts for this device.
12 - reg : The ID number for the phy, usually a small integer
13
14Optional Properties:
15
16- compatible: Compatible list, may contain
17  "ethernet-phy-ieee802.3-c22" or "ethernet-phy-ieee802.3-c45" for
18  PHYs that implement IEEE802.3 clause 22 or IEEE802.3 clause 45
19  specifications. If neither of these are specified, the default is to
20  assume clause 22.
21
22  If the PHY reports an incorrect ID (or none at all) then the
23  "compatible" list may contain an entry with the correct PHY ID in the
24  form: "ethernet-phy-idAAAA.BBBB" where
25     AAAA - The value of the 16 bit Phy Identifier 1 register as
26            4 hex digits. This is the chip vendor OUI bits 3:18
27     BBBB - The value of the 16 bit Phy Identifier 2 register as
28            4 hex digits. This is the chip vendor OUI bits 19:24,
29            followed by 10 bits of a vendor specific ID.
30
31  The compatible list should not contain other values than those
32  listed here.
33
34- max-speed: Maximum PHY supported speed (10, 100, 1000...)
35
36- broken-turn-around: If set, indicates the PHY device does not correctly
37  release the turn around line low at the end of a MDIO transaction.
38
39- enet-phy-lane-swap: If set, indicates the PHY will swap the TX/RX lanes to
40  compensate for the board being designed with the lanes swapped.
41
42- enet-phy-lane-no-swap: If set, indicates that PHY will disable swap of the
43  TX/RX lanes. This property allows the PHY to work correcly after e.g. wrong
44  bootstrap configuration caused by issues in PCB layout design.
45
46- eee-broken-100tx:
47- eee-broken-1000t:
48- eee-broken-10gt:
49- eee-broken-1000kx:
50- eee-broken-10gkx4:
51- eee-broken-10gkr:
52  Mark the corresponding energy efficient ethernet mode as broken and
53  request the ethernet to stop advertising it.
54
55Example:
56
57ethernet-phy@0 {
58	compatible = "ethernet-phy-id0141.0e90", "ethernet-phy-ieee802.3-c22";
59	interrupt-parent = <40000>;
60	interrupts = <35 1>;
61	reg = <0>;
62};
63