From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Cyrus-Session-Id: sloti22d1t05-3414120-1524151132-2-4942270835456446943 X-Sieve: CMU Sieve 3.0 X-Spam-known-sender: no X-Spam-score: 0.0 X-Spam-hits: BAYES_00 -1.9, HEADER_FROM_DIFFERENT_DOMAINS 0.25, MAILING_LIST_MULTI -1, RCVD_IN_DNSWL_HI -5, LANGUAGES en, BAYES_USED global, SA_VERSION 3.4.0 X-Spam-source: IP='209.132.180.67', Host='vger.kernel.org', Country='US', FromHeader='org', MailFrom='org' X-Spam-charsets: X-Resolved-to: greg@kroah.com X-Delivered-to: greg@kroah.com X-Mail-from: linux-usb-owner@vger.kernel.org ARC-Seal: i=1; a=rsa-sha256; cv=none; d=messagingengine.com; s=fm2; t= 1524151131; b=mlyBKqJ4FAyOv8fqym2zsZvVWrr1KisksZ/taKtcAZQATiz7P5 pFJuZhaGnyjQL8h44j/Fiy5cDmhDF9d+iQBwiDejmhEXDklMyaPdezZF9wFlE1pg A3aPTsSrnyPKSroHaSEcQjIrIkAUi7rrNplInWqoReKKZm10O8hS71Mz45sGEskg Y8mqJNpKIW7BOVg8NsLxVyiS/PHD8LGoqbNGSVJRzgoSQ2K+V19/A9fUGEcVBlrh DInCgrhw+mi/FZNEWpPKOgFLGvzavIMVph2wH6/VaAZJxG78CFX3wfUmGqYjcGYi xNwk0NLpWmK3ZhN9+6ylA/GqZFiJi/ds55dg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=from:to:subject:date:message-id :in-reply-to:references:sender:list-id; s=fm2; t=1524151131; bh= 7pOe2kl85zuVbcN5/9ZHo+sqWDigCXbd4AZ3PhDY1R8=; b=A8w5Lp7cQMCTEu6A h1sQq0UtLZyZeSXLMf7nkMvR/pJj+Wnh3n0ziThKDoTeKK0u1ZgmfZ+ryVuLoexW eZkCVXwwh7oy/UH7dm6eStItCzkCLJF+GDn8wF0GegoYqQ8BEFiYrD9soScAvFZP EcPReDghv+fIdl8gzafXdVGfxXf3i1o7s4qFIsimtWgcgL7aoUEYxBXloYkWzCTB wjFy1BqUiIPP8xUpsOd8NiQqoqMgFDPJPA9RybHdoQqMDqv3BLzBtPUjcNoMVNjL Z4/xRBupW4xeNTbTNzHb3cGhN8DzZzY/Z3XV41OnLLbqcW8TA6MNJAHPfdCDLaai anoLFA== ARC-Authentication-Results: i=1; mx2.messagingengine.com; arc=none (no signatures found); dkim=fail (body has been altered, 2048-bit rsa key sha256) header.d=raspberrypi-org.20150623.gappssmtp.com header.i=@raspberrypi-org.20150623.gappssmtp.com header.b=kPzqKcY3 x-bits=2048 x-keytype=rsa x-algorithm=sha256 x-selector=20150623; dkim=invalid (public key: invalid data, 0-bit key sha256) header.d=raspberrypi.org header.i=@raspberrypi.org header.b=S9FhmjRC x-bits=0 x-keytype="" x-algorithm=sha256 x-selector=pp; dmarc=none (p=none,has-list-id=yes,d=none) header.from=raspberrypi.org; iprev=pass policy.iprev=209.132.180.67 (vger.kernel.org); spf=none smtp.mailfrom=linux-usb-owner@vger.kernel.org smtp.helo=vger.kernel.org; x-aligned-from=fail; x-cm=none score=0; x-google-dkim=fail (body has been altered, 2048-bit rsa key) header.d=1e100.net header.i=@1e100.net header.b=mMZ2KEhW; x-ptr=pass x-ptr-helo=vger.kernel.org x-ptr-lookup=vger.kernel.org; x-return-mx=pass smtp.domain=vger.kernel.org smtp.result=pass smtp_org.domain=kernel.org smtp_org.result=pass smtp_is_org_domain=no header.domain=raspberrypi.org header.result=pass header_is_org_domain=yes; x-vs=clean score=-100 state=0 Authentication-Results: mx2.messagingengine.com; arc=none (no signatures found); dkim=fail (body has been altered, 2048-bit rsa key sha256) header.d=raspberrypi-org.20150623.gappssmtp.com header.i=@raspberrypi-org.20150623.gappssmtp.com header.b=kPzqKcY3 x-bits=2048 x-keytype=rsa x-algorithm=sha256 x-selector=20150623; dkim=invalid (public key: invalid data, 0-bit key sha256) header.d=raspberrypi.org header.i=@raspberrypi.org header.b=S9FhmjRC x-bits=0 x-keytype="" x-algorithm=sha256 x-selector=pp; dmarc=none (p=none,has-list-id=yes,d=none) header.from=raspberrypi.org; iprev=pass policy.iprev=209.132.180.67 (vger.kernel.org); spf=none smtp.mailfrom=linux-usb-owner@vger.kernel.org smtp.helo=vger.kernel.org; x-aligned-from=fail; x-cm=none score=0; x-google-dkim=fail (body has been altered, 2048-bit rsa key) header.d=1e100.net header.i=@1e100.net header.b=mMZ2KEhW; x-ptr=pass x-ptr-helo=vger.kernel.org x-ptr-lookup=vger.kernel.org; x-return-mx=pass smtp.domain=vger.kernel.org smtp.result=pass smtp_org.domain=kernel.org smtp_org.result=pass smtp_is_org_domain=no header.domain=raspberrypi.org header.result=pass header_is_org_domain=yes; x-vs=clean score=-100 state=0 X-ME-VSCategory: clean X-CM-Envelope: MS4wfATZJxp2O2qwxliO8hQIxZrq58xRMyRfZTVxxHDORT6i+iaNBvTQrhabCUbRyW2UtW2ietWCGDjTqAP68aEGk6M8nIYi6FVrRiL9DrDf7HIqnTDDNl5g /UB33fcFdubwy0HA7GeQAypZZQYG4dsZcBDNDn/yNs4zytWz7tgyxRmSnKCkEaoF/2ZTitX0R2vJByOzdoK/8LVbAtLsUtBtyaSgpGcOdh6huihJPxMYaUH1 X-CM-Analysis: v=2.3 cv=E8HjW5Vl c=1 sm=1 tr=0 a=UK1r566ZdBxH71SXbqIOeA==:117 a=UK1r566ZdBxH71SXbqIOeA==:17 a=xqWC_Br6kY4A:10 a=Kd1tUaAdevIA:10 a=WFZIRff2AAAA:8 a=XYAwZIGsAAAA:8 a=VwQbUJbxAAAA:8 a=rR3N6wF2ypCZ4i_Y_DoA:9 a=GBO4_o2OZE_o7MNm:21 a=6cc50G5iDQA5SUGw:21 a=x8gzFH9gYPwA:10 a=E8ToXWR_bxluHZ7gmE-Z:22 a=AjGcO6oz07-iQ99wixmX:22 X-ME-CMScore: 0 X-ME-CMCategory: none Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753157AbeDSPSe (ORCPT ); Thu, 19 Apr 2018 11:18:34 -0400 Received: from mx08-00252a01.pphosted.com ([91.207.212.211]:56702 "EHLO mx08-00252a01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752892AbeDSPSH (ORCPT ); Thu, 19 Apr 2018 11:18:07 -0400 X-Google-Smtp-Source: AIpwx4/kuPQVF6+5dpoLHjU1MyOxAFNHesxCYv7i3mLMIRFjImdRmno/KziG9NsW9k92hz5YD0UFVQ== 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: linux-usb-owner@vger.kernel.org X-Mailing-List: linux-usb@vger.kernel.org X-getmail-retrieved-from-mailbox: INBOX X-Mailing-List: linux-kernel@vger.kernel.org List-ID: 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 -- 2.7.4 From mboxrd@z Thu Jan 1 00:00:00 1970 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: [resend,v3,3/3] dt-bindings: Document the DT bindings for lan78xx From: Phil Elwell Message-Id: <1524151019-82823-4-git-send-email-phil@raspberrypi.org> Date: Thu, 19 Apr 2018 16:16:59 +0100 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 List-ID: VGhlIE1pY3JvY2hpcCBMQU43OFhYIGZhbWlseSBvZiBkZXZpY2VzIGFyZSBFdGhlcm5ldCBjb250 cm9sbGVycyB3aXRoCmEgVVNCIGludGVyZmFjZS4gRGVzcGl0ZSBiZWluZyBkaXNjb3ZlcmFibGUg ZGV2aWNlcyBpdCBjYW4gYmUgdXNlZnVsIHRvCmJlIGFibGUgdG8gY29uZmlndXJlIHRoZW0gZnJv bSBEZXZpY2UgVHJlZSwgcGFydGljdWxhcmx5IGluIGxvdy1jb3N0CmFwcGxpY2F0aW9ucyB3aXRo b3V0IGFuIEVFUFJPTSBvciBwcm9ncmFtbWVkIE9UUC4KCkRvY3VtZW50IHRoZSBzdXBwb3J0ZWQg cHJvcGVydGllcyBpbiBhIGJpbmRpbmdzIGZpbGUuCgpTaWduZWQtb2ZmLWJ5OiBQaGlsIEVsd2Vs bCA8cGhpbEByYXNwYmVycnlwaS5vcmc+Ci0tLQogLi4uL2RldmljZXRyZWUvYmluZGluZ3MvbmV0 L21pY3JvY2hpcCxsYW43OHh4LnR4dCAgfCA1NCArKysrKysrKysrKysrKysrKysrKysrCiBNQUlO VEFJTkVSUyAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB8ICAxICsKIDIg ZmlsZXMgY2hhbmdlZCwgNTUgaW5zZXJ0aW9ucygrKQogY3JlYXRlIG1vZGUgMTAwNjQ0IERvY3Vt ZW50YXRpb24vZGV2aWNldHJlZS9iaW5kaW5ncy9uZXQvbWljcm9jaGlwLGxhbjc4eHgudHh0Cgpk aWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL25ldC9taWNyb2No aXAsbGFuNzh4eC50eHQgYi9Eb2N1bWVudGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3MvbmV0L21p Y3JvY2hpcCxsYW43OHh4LnR4dApuZXcgZmlsZSBtb2RlIDEwMDY0NAppbmRleCAwMDAwMDAwLi5h NWQ3MDFiCi0tLSAvZGV2L251bGwKKysrIGIvRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRp bmdzL25ldC9taWNyb2NoaXAsbGFuNzh4eC50eHQKQEAgLTAsMCArMSw1NCBAQAorTWljcm9jaGlw IExBTjc4eHggR2lnYWJpdCBFdGhlcm5ldCBjb250cm9sbGVyCisKK1RoZSBMQU43OFhYIGRldmlj ZXMgYXJlIHVzdWFsbHkgY29uZmlndXJlZCBieSBwcm9ncmFtbWluZyB0aGVpciBPVFAgb3Igd2l0 aAorYW4gZXh0ZXJuYWwgRUVQUk9NLCBidXQgc29tZSBwbGF0Zm9ybXMgKGUuZy4gUmFzcGJlcnJ5 IFBpIDMgQispIGhhdmUgbmVpdGhlci4KK1RoZSBEZXZpY2UgVHJlZSBwcm9wZXJ0aWVzLCBpZiBw cmVzZW50LCBvdmVycmlkZSB0aGUgT1RQIGFuZCBFRVBST00uCisKK1JlcXVpcmVkIHByb3BlcnRp ZXM6CistIGNvbXBhdGlibGU6IFNob3VsZCBiZSBvbmUgb2YgInVzYjQyNCw3ODAwIiwgInVzYjQy NCw3ODAxIiBvciAidXNiNDI0LDc4NTAiLgorCitPcHRpb25hbCBwcm9wZXJ0aWVzOgorLSBsb2Nh bC1tYWMtYWRkcmVzczogICBzZWUgZXRoZXJuZXQudHh0CistIG1hYy1hZGRyZXNzOiAgICAgICAg IHNlZSBldGhlcm5ldC50eHQKKworT3B0aW9uYWwgcHJvcGVydGllcyBvZiB0aGUgZW1iZWRkZWQg UEhZOgorLSBtaWNyb2NoaXAsbGVkLW1vZGVzOiBhIDAuLjQgZWxlbWVudCB2ZWN0b3IsIHdpdGgg ZWFjaCBlbGVtZW50IGNvbmZpZ3VyaW5nCisgIHRoZSBvcGVyYXRpbmcgbW9kZSBvZiBhbiBMRUQu IE9taXR0ZWQgTEVEcyBhcmUgdHVybmVkIG9mZi4gQWxsb3dlZCB2YWx1ZXMKKyAgYXJlIGRlZmlu ZWQgaW4gImluY2x1ZGUvZHQtYmluZGluZ3MvbmV0L21pY3JvY2hpcC1sYW43OHh4LmgiLgorCitF eGFtcGxlOgorCisvKiBCYXNlZCBvbiB0aGUgY29uZmlndXJhdGlvbiBmb3IgYSBSYXNwYmVycnkg UGkgMyBCKyAqLworJnVzYiB7CisJdXNiMUAxIHsKKwkJY29tcGF0aWJsZSA9ICJ1c2I0MjQsMjUx NCI7CisJCXJlZyA9IDwxPjsKKwkJI2FkZHJlc3MtY2VsbHMgPSA8MT47CisJCSNzaXplLWNlbGxz ID0gPDA+OworCisJCXVzYjFfMUAxIHsKKwkJCWNvbXBhdGlibGUgPSAidXNiNDI0LDI1MTQiOwor CQkJcmVnID0gPDE+OworCQkJI2FkZHJlc3MtY2VsbHMgPSA8MT47CisJCQkjc2l6ZS1jZWxscyA9 IDwwPjsKKworCQkJZXRoZXJuZXQ6IHVzYmV0aGVyQDEgeworCQkJCWNvbXBhdGlibGUgPSAidXNi NDI0LDc4MDAiOworCQkJCXJlZyA9IDwxPjsKKwkJCQlsb2NhbC1tYWMtYWRkcmVzcyA9IFsgMDAg MTEgMjIgMzMgNDQgNTUgXTsKKworCQkJCW1kaW8geworCQkJCQkjYWRkcmVzcy1jZWxscyA9IDww eDE+OworCQkJCQkjc2l6ZS1jZWxscyA9IDwweDA+OworCQkJCQlldGhfcGh5OiBldGhlcm5ldC1w aHlAMSB7CisJCQkJCQlyZWcgPSA8MT47CisJCQkJCQltaWNyb2NoaXAsbGVkLW1vZGVzID0gPAor CQkJCQkJIAlMQU43OFhYX0xJTktfMTAwMF9BQ1RJVklUWQorCQkJCQkJCUxBTjc4WFhfTElOS18x MF8xMDBfQUNUSVZJVFkKKwkJCQkJCT47CisJCQkJCX07CisJCQkJfTsKKwkJCX07CisJCX07CisJ fTsKK307CmRpZmYgLS1naXQgYS9NQUlOVEFJTkVSUyBiL01BSU5UQUlORVJTCmluZGV4IDIzNzM1 ZDkuLjkxY2I5NjEgMTAwNjQ0Ci0tLSBhL01BSU5UQUlORVJTCisrKyBiL01BSU5UQUlORVJTCkBA IC0xNDU3Miw2ICsxNDU3Miw3IEBAIE06CVdvb2p1bmcgSHVoIDx3b29qdW5nLmh1aEBtaWNyb2No aXAuY29tPgogTToJTWljcm9jaGlwIExpbnV4IERyaXZlciBTdXBwb3J0IDxVTkdMaW51eERyaXZl ckBtaWNyb2NoaXAuY29tPgogTDoJbmV0ZGV2QHZnZXIua2VybmVsLm9yZwogUzoJTWFpbnRhaW5l ZAorRjoJRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL25ldC9taWNyb2NoaXAsbGFu Nzh4eC50eHQKIEY6CWRyaXZlcnMvbmV0L3VzYi9sYW43OHh4LioKIEY6CWluY2x1ZGUvZHQtYmlu ZGluZ3MvbmV0L21pY3JvY2hpcC1sYW43OHh4LmgKIAo=