From patchwork Thu Apr 19 15:16:59 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Phil Elwell X-Patchwork-Id: 901313 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=raspberrypi.org Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; secure) header.d=raspberrypi.org header.i=@raspberrypi.org header.b="S9FhmjRC"; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=raspberrypi-org.20150623.gappssmtp.com header.i=@raspberrypi-org.20150623.gappssmtp.com header.b="kPzqKcY3"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 40RjLJ2LvWz9s27 for ; Fri, 20 Apr 2018 01:18:32 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752890AbeDSPS3 (ORCPT ); Thu, 19 Apr 2018 11:18:29 -0400 Received: from mx07-00252a01.pphosted.com ([62.209.51.214]:6578 "EHLO mx07-00252a01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752946AbeDSPSI (ORCPT ); Thu, 19 Apr 2018 11:18:08 -0400 Received: from pps.filterd (m0102628.ppops.net [127.0.0.1]) by mx07-00252a01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w3JFHMxY014500 for ; Thu, 19 Apr 2018 16:18:06 +0100 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=raspberrypi.org; h=from : to : subject : date : message-id : in-reply-to : references; s=pp; bh=xSSD9SvLCvUPLV3TsLO9yFBlCax29EsDDiA9e9toJmo=; b=S9FhmjRChTwyL2wOEa5Qhayr5UMf9e7SAD3BQxYq9dUFCmSRelgn4Y8lUQdENcpT5o1w ITm1Vq+QaeklBRw0WXcetAaZ31oGwwLpNMkYcDSuZW54Tm998zgGVYdQ3zEIsn3dWwYu 0iaqknrrcF74rupPIUWpBnw64J3rBQVPIr3g0b2onnA4eCfiTHQ/MLVzHuJMlp4mcKqt OLPYqvSq7yGQPaUPcPQQ9cMCuExsIOxIBTGYutYUEK29rWQe9cHXztbNFL1NFaWgnGNS NExg6VSouhfisRPWyomRdEHo4BJrTH9HP77Zof5wLjkpr7OxsGwUR2xl86stBduq55F6 Jw== Received: from mail-wr0-f200.google.com (mail-wr0-f200.google.com [209.85.128.200]) by mx07-00252a01.pphosted.com with ESMTP id 2hdrya8xn0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=OK) for ; Thu, 19 Apr 2018 16:18:06 +0100 Received: by mail-wr0-f200.google.com with SMTP id b10-v6so5603401wrf.3 for ; Thu, 19 Apr 2018 08:18:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=raspberrypi-org.20150623.gappssmtp.com; s=20150623; h=from:to:subject:date:message-id:in-reply-to:references; bh=xSSD9SvLCvUPLV3TsLO9yFBlCax29EsDDiA9e9toJmo=; b=kPzqKcY3cEOMeV6+nz1O0jqyK0NmBzpycg+cGQWFdc7/eAmm8Gt5snJ24QcxJo9anV qWoIySkV7VfLGouo4ybM7AtZUYmHWsYF9xoO0wiEoeeMncOpMdB0eJfNWtqny0ZvTg63 286ngYHfMz7PGCaaGEwS7f8v3sQR7HHLREj9pmu36W1TgeqGsMC2vdB7rcaUqMGwHvjH f5w2bTxtkdakmXvpE/2gzlLP2QrxolpMQjAKXXCzeUAMaih0faEffO9bh8C0N5bZBNxK hn5wx+dkaGAoS6uoWaZkZ1iSeuQ9W6KB8C1Xd3qF5DfDG4qK3wBKta+wrFl/KyRoPIx7 rL1A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references; bh=xSSD9SvLCvUPLV3TsLO9yFBlCax29EsDDiA9e9toJmo=; b=alOBVUlY4T2JFNmfTDSzqpD8zMQjfTkP4g5qCb86itxrU9KmlK6xN+zJ/4G8YbCiad xM2H0RuPW7wVSYbrdLWeczlnFiv4uGI4LwX3HlRBBA9G/jhOOJY+raavwtdYw0IrVLy4 2QKfe8Adf7ICore43y8FO8JjD06ntMQ7ZqFK44WshTmYWGijFhnAIWwXtKgGxKouB+Cd SOFmBl4JdtXnBTPx+PDHnBWu3gFN7sSRHlS3SHaRo5a0S1ovWiEOz46zEwkujdV9/1/J 8G54yLe/VqrFLYaHgXrzhysJJuFiOsUoVdeGleCRCJbkzn4UYRwksnKl6AMl+XPIFu9R 21Aw== X-Gm-Message-State: ALQs6tCWi3YNc02p44x8gKFWUBSEKWPD4LHoSRLBD9f1oVysPDKg+h/b M233b4ekuqHAjyNbGQiT6D3QHV+ew3JDrHGdxaGO2wSGJogWI8N4dVcxKnyMQwnhHgxCe+Emp7m Ep/Woo05+EugWY30tbBanow== X-Received: by 10.28.28.137 with SMTP id c131mr5081251wmc.45.1524151084853; Thu, 19 Apr 2018 08:18:04 -0700 (PDT) X-Google-Smtp-Source: AIpwx4/kuPQVF6+5dpoLHjU1MyOxAFNHesxCYv7i3mLMIRFjImdRmno/KziG9NsW9k92hz5YD0UFVQ== X-Received: by 10.28.28.137 with SMTP id c131mr5081227wmc.45.1524151084591; Thu, 19 Apr 2018 08:18:04 -0700 (PDT) Received: from buildbot.pitowers.org ([2a00:2381:fdf7:14:3509:880e:14cc:3c11]) by smtp.gmail.com with ESMTPSA id f15-v6sm4322342wrh.35.2018.04.19.08.18.03 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 19 Apr 2018 08:18:03 -0700 (PDT) From: Phil Elwell To: Woojung Huh , Microchip Linux Driver Support , Rob Herring , Mark Rutland , Andrew Lunn , Florian Fainelli , "David S. Miller" , Mauro Carvalho Chehab , Greg Kroah-Hartman , Linus Walleij , Andrew Morton , Randy Dunlap , Phil Elwell , netdev@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Subject: [PATCH resend v3 3/3] dt-bindings: Document the DT bindings for lan78xx Date: Thu, 19 Apr 2018 16:16:59 +0100 Message-Id: <1524151019-82823-4-git-send-email-phil@raspberrypi.org> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1524151019-82823-1-git-send-email-phil@raspberrypi.org> References: <1524151019-82823-1-git-send-email-phil@raspberrypi.org> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2018-04-19_05:, , signatures=0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org The Microchip LAN78XX family of devices are Ethernet controllers with a USB interface. Despite being discoverable devices it can be useful to be able to configure them from Device Tree, particularly in low-cost applications without an EEPROM or programmed OTP. Document the supported properties in a bindings file. Signed-off-by: Phil Elwell --- .../devicetree/bindings/net/microchip,lan78xx.txt | 54 ++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 55 insertions(+) create mode 100644 Documentation/devicetree/bindings/net/microchip,lan78xx.txt diff --git a/Documentation/devicetree/bindings/net/microchip,lan78xx.txt b/Documentation/devicetree/bindings/net/microchip,lan78xx.txt new file mode 100644 index 0000000..a5d701b --- /dev/null +++ b/Documentation/devicetree/bindings/net/microchip,lan78xx.txt @@ -0,0 +1,54 @@ +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". + +Optional properties: +- local-mac-address: see ethernet.txt +- mac-address: see 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 { + usb1@1 { + compatible = "usb424,2514"; + reg = <1>; + #address-cells = <1>; + #size-cells = <0>; + + usb1_1@1 { + compatible = "usb424,2514"; + reg = <1>; + #address-cells = <1>; + #size-cells = <0>; + + ethernet: usbether@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 + >; + }; + }; + }; + }; + }; +}; diff --git a/MAINTAINERS b/MAINTAINERS index 23735d9..91cb961 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -14572,6 +14572,7 @@ M: Woojung Huh M: Microchip Linux Driver Support L: netdev@vger.kernel.org S: Maintained +F: Documentation/devicetree/bindings/net/microchip,lan78xx.txt F: drivers/net/usb/lan78xx.* F: include/dt-bindings/net/microchip-lan78xx.h