Merge tag 'v5.15.57' into rpi-5.15.y
[platform/kernel/linux-rpi.git] / Documentation / devicetree / bindings / net / microchip,lan78xx.txt
1 Microchip LAN78xx Gigabit Ethernet controller
2
3 The LAN78XX devices are usually configured by programming their OTP or with
4 an external EEPROM, but some platforms (e.g. Raspberry Pi 3 B+) have neither.
5 The Device Tree properties, if present, override the OTP and EEPROM.
6
7 Required properties:
8 - compatible: Should be one of "usb424,7800", "usb424,7801" or "usb424,7850".
9
10 The MAC address will be determined using the optional properties
11 defined in ethernet.txt.
12
13 Optional properties of the embedded PHY:
14 - microchip,led-modes: a 0..4 element vector, with each element configuring
15   the operating mode of an LED. Omitted LEDs are turned off. Allowed values
16   are defined in "include/dt-bindings/net/microchip-lan78xx.h".
17 - microchip,downshift-after: sets the number of failed auto-negotiation
18   attempts after which the link is downgraded from 1000BASE-T. Should be one of
19   2, 3, 4, 5 or 0, where 0 means never downshift.
20
21 Example:
22
23 /* Based on the configuration for a Raspberry Pi 3 B+ */
24 &usb {
25         usb-port@1 {
26                 compatible = "usb424,2514";
27                 reg = <1>;
28                 #address-cells = <1>;
29                 #size-cells = <0>;
30
31                 usb-port@1 {
32                         compatible = "usb424,2514";
33                         reg = <1>;
34                         #address-cells = <1>;
35                         #size-cells = <0>;
36
37                         ethernet: ethernet@1 {
38                                 compatible = "usb424,7800";
39                                 reg = <1>;
40                                 local-mac-address = [ 00 11 22 33 44 55 ];
41
42                                 mdio {
43                                         #address-cells = <0x1>;
44                                         #size-cells = <0x0>;
45                                         eth_phy: ethernet-phy@1 {
46                                                 reg = <1>;
47                                                 microchip,led-modes = <
48                                                         LAN78XX_LINK_1000_ACTIVITY
49                                                         LAN78XX_LINK_10_100_ACTIVITY
50                                                 >;
51                                         };
52                                 };
53                         };
54                 };
55         };
56 };