dt-bindings: net: microchip,lan78xx: convert to DT schema

Convert the Microchip LAN78xx family (LAN7800, LAN7801, LAN7850) binding
documentation from plain text to DT schema.

Restoring a mistakenly deleted email in MAINTAINERS file and fixing
microchip,lan7800.yaml.

Signed-off-by: Mikhail Lukianchikov <avermoal@gmail.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com>
Link: https://patch.msgid.link/20260712113821.12543-1-avermoal@gmail.com
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
This commit is contained in:
Mikhail Lukianchikov
2026-07-12 17:38:21 +06:00
committed by Jakub Kicinski
parent f14a8561f3
commit c86cfc9829
3 changed files with 90 additions and 54 deletions

View File

@@ -0,0 +1,89 @@
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/net/microchip,lan7800.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Microchip LAN7800/LAN7801/LAN7850 Gigabit Ethernet controller
maintainers:
- Thangaraj Samynathan <Thangaraj.S@microchip.com>
- Rengarajan Sundararajan <Rengarajan.S@microchip.com>
description:
The LAN7800/LAN7801/LAN7850 devices are usually configured by
programming their OTP or with an external EEPROM, but some
platforms (e.g. Raspberry Pi 3 B+) have neither. The Device Tree
properties, if present, override the OTP and EEPROM.
allOf:
- $ref: /schemas/usb/usb-device.yaml#
- $ref: /schemas/net/ethernet-controller.yaml#
properties:
compatible:
enum:
- usb424,7800
- usb424,7801
- usb424,7850
reg:
maxItems: 1
description: USB port number
mdio:
$ref: /schemas/net/mdio.yaml#
unevaluatedProperties: false
patternProperties:
"^ethernet-phy(@[0-9a-f]+)?$":
$ref: /schemas/net/ethernet-phy.yaml#
unevaluatedProperties: false
type: object
properties:
microchip,led-modes:
$ref: /schemas/types.yaml#/definitions/uint32-array
minItems: 1
maxItems: 4
description:
Array of LED mode values for each of up to 4 LEDs.
Omitted LEDs are turned off. Allowed values are defined
in include/dt-bindings/net/microchip-lan78xx.h.
required:
- reg
required:
- compatible
- reg
unevaluatedProperties: false
examples:
- |
#include <dt-bindings/net/microchip-lan78xx.h>
usb {
#address-cells = <1>;
#size-cells = <0>;
ethernet@1 {
compatible = "usb424,7800";
reg = <1>;
local-mac-address = [00 11 22 33 44 55];
mdio {
#address-cells = <1>;
#size-cells = <0>;
ethernet-phy@1 {
reg = <1>;
microchip,led-modes = <
LAN78XX_LINK_1000_ACTIVITY
LAN78XX_LINK_10_100_ACTIVITY
>;
};
};
};
};
...

View File

@@ -1,53 +0,0 @@
Microchip LAN78xx Gigabit Ethernet controller
The LAN78XX devices are usually configured by programming their OTP or with
an external EEPROM, but some platforms (e.g. Raspberry Pi 3 B+) have neither.
The Device Tree properties, if present, override the OTP and EEPROM.
Required properties:
- compatible: Should be one of "usb424,7800", "usb424,7801" or "usb424,7850".
The MAC address will be determined using the optional properties
defined in ethernet.txt.
Optional properties of the embedded PHY:
- microchip,led-modes: a 0..4 element vector, with each element configuring
the operating mode of an LED. Omitted LEDs are turned off. Allowed values
are defined in "include/dt-bindings/net/microchip-lan78xx.h".
Example:
/* Based on the configuration for a Raspberry Pi 3 B+ */
&usb {
usb-port@1 {
compatible = "usb424,2514";
reg = <1>;
#address-cells = <1>;
#size-cells = <0>;
usb-port@1 {
compatible = "usb424,2514";
reg = <1>;
#address-cells = <1>;
#size-cells = <0>;
ethernet: ethernet@1 {
compatible = "usb424,7800";
reg = <1>;
local-mac-address = [ 00 11 22 33 44 55 ];
mdio {
#address-cells = <0x1>;
#size-cells = <0x0>;
eth_phy: ethernet-phy@1 {
reg = <1>;
microchip,led-modes = <
LAN78XX_LINK_1000_ACTIVITY
LAN78XX_LINK_10_100_ACTIVITY
>;
};
};
};
};
};
};

View File

@@ -27943,7 +27943,7 @@ M: Rengarajan Sundararajan <Rengarajan.S@microchip.com>
M: UNGLinuxDriver@microchip.com
L: netdev@vger.kernel.org
S: Maintained
F: Documentation/devicetree/bindings/net/microchip,lan78xx.txt
F: Documentation/devicetree/bindings/net/microchip,lan7800.yaml
F: drivers/net/usb/lan78xx.*
F: include/dt-bindings/net/microchip-lan78xx.h