From patchwork Thu Apr 12 13:55:36 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Phil Elwell X-Patchwork-Id: 897681 X-Patchwork-Delegate: davem@davemloft.net Return-Path: X-Original-To: patchwork-incoming-netdev@ozlabs.org Delivered-To: patchwork-incoming-netdev@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=netdev-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=raspberrypi.org Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; secure) header.d=raspberrypi.org header.i=@raspberrypi.org header.b="VZc2zjDE"; dkim=pass (2048-bit key; unprotected) header.d=raspberrypi-org.20150623.gappssmtp.com header.i=@raspberrypi-org.20150623.gappssmtp.com header.b="v0V/o4Cp"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 40MMrj6z5kz9s32 for ; Thu, 12 Apr 2018 23:56:21 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752877AbeDLNz5 (ORCPT ); Thu, 12 Apr 2018 09:55:57 -0400 Received: from mx08-00252a01.pphosted.com ([91.207.212.211]:40400 "EHLO mx08-00252a01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752810AbeDLNzy (ORCPT ); Thu, 12 Apr 2018 09:55:54 -0400 Received: from pps.filterd (m0102629.ppops.net [127.0.0.1]) by mx08-00252a01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w3CDrYcT012269 for ; Thu, 12 Apr 2018 14:55:53 +0100 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=raspberrypi.org; h=from : to : cc : subject : date : message-id : in-reply-to : references; s=pp; bh=jpP5AtDESC7sHwxSB19ZOw6n+7fgGp52qaCeJCjqZDk=; b=VZc2zjDE/QGgr6Ir4mYQzev/bxeGxeUIHyVZMKoFbn6p8nzk7UYn+ExNRXQw3ptvXgvk L3b1+PPKkq4CRli1iRNpWFDcqZ8hKHANj0lAeEyT6HYSdoFqURWkj8x1bFZHl8PcnFBv G/szepXw2qHnKnPgVc9C6mTrLwDgwZ0p6NjPOJvccWWfsz/WWSRMa/7UNSsJzxk7VUnC lMkmlBBry2Y28uQCBtDUbMDgCo0uxE+J1sDe9akJHHZ/eDK9/e9wJJNPA9Oa2+u8ZrDn qpDIhmX7DcA2mgJk9GXoGhA6WvCJguDx16x8oFEXF/iSf3X9uZvfoPXSZyu7Ogfl1YO6 LQ== Received: from mail-wr0-f199.google.com (mail-wr0-f199.google.com [209.85.128.199]) by mx08-00252a01.pphosted.com with ESMTP id 2h6trdtjsc-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=OK) for ; Thu, 12 Apr 2018 14:55:53 +0100 Received: by mail-wr0-f199.google.com with SMTP id h1so2568987wre.0 for ; Thu, 12 Apr 2018 06:55:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=raspberrypi-org.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=jpP5AtDESC7sHwxSB19ZOw6n+7fgGp52qaCeJCjqZDk=; b=v0V/o4CpJrRGlHxASyItCda07EcXucjL3qxjyhl2GvGFad64T5vHlhHwTYBB3em1Xi vCA85UgyDLXfJJgHeOQ5CrmVDWvLz/77PLSu/GLY7I16mf8LDNR3HvphDFrIk02G7L9v +woU2DkeIRw0KHKwJKqI+LsaKsyRbjLrL00mg3WNyiYcSk2WPfST9czgfyHOyRLVVyVP S9BOoS/mOVqC9Grv2STZjfAvOHWtmSHd6k68D2OZe29Ko8FQktdMLiU0Hlnwl7YvcopS 6g46NTUXRLQXVKUpNi9bbEdlfcivtOFL911YaqhjQhfgT67xDRZwiw3Ofet05Ox9Y8bj StTg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=jpP5AtDESC7sHwxSB19ZOw6n+7fgGp52qaCeJCjqZDk=; b=V67o9463ULoN1ZV7T3vm9HhZe8tqrD6AGQHkwcjx2paKH2RcyBLimT0Y+4JbhjqGTU 5pHkrBp11YQCpemWzAdXDUj+5rZGWvupL6Zfu1YeMaymxOBAabWoUdnsg2WfqLsiVlgw ziEGh0ti3cyhxPMh9GAMwIQvofYPQznFTY4GaSS4+hPmFc7cYvumnfjI4J8Okrz2UERU lh9dEsX8++TcVC+gTF8oSJnYM9cdBYmGBZ0uC+uKVkXtety4BssBh81aqndtq9mqssNO YhrUhck2FglGnhQrqUdLi7V8uUHrTiTI5KARGNyhIl3jiLywWiS6Pa+PdyyQWIhB1OWU ENSQ== X-Gm-Message-State: ALQs6tDUHyD4TKx7a56blNLswYNI1HClykHWvKAbos7Cr7iMb6LBjtcm 3M6BmxzaY9BeQpmxOchUdK9AArmwEUpxAOs1BtnLyiT/CET0KJ7sgycY+jJZmj3oPnVhP1Uil6a ttnyJbkDeCo9BNq+T X-Received: by 10.28.191.27 with SMTP id p27mr867480wmf.97.1523541352743; Thu, 12 Apr 2018 06:55:52 -0700 (PDT) X-Google-Smtp-Source: AIpwx48syZENwRqzgo09M7WUStD73Y3HrzDvyhCFRvoR5eGYRUOlPTkNWgPPuKhgP0iNja0IOeGZ0Q== X-Received: by 10.28.191.27 with SMTP id p27mr867459wmf.97.1523541352507; Thu, 12 Apr 2018 06:55:52 -0700 (PDT) Received: from buildbot.pitowers.org ([2a00:2381:fdf7:14:3403:8ea9:e6c1:e3f5]) by smtp.gmail.com with ESMTPSA id m83sm3491581wma.17.2018.04.12.06.55.51 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 12 Apr 2018 06:55:51 -0700 (PDT) From: Phil Elwell To: Woojung Huh , Microchip Linux Driver Support , Rob Herring , Mark Rutland , "David S. Miller" , Mauro Carvalho Chehab , Greg Kroah-Hartman , Linus Walleij , Andrew Morton , Randy Dunlap , netdev@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Cc: Phil Elwell Subject: [PATCH 4/4] dt-bindings: Document the DT bindings for lan78xx Date: Thu, 12 Apr 2018 14:55:36 +0100 Message-Id: <1523541336-145953-5-git-send-email-phil@raspberrypi.org> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1523541336-145953-1-git-send-email-phil@raspberrypi.org> References: <1523541336-145953-1-git-send-email-phil@raspberrypi.org> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2018-04-12_07:, , signatures=0 Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@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, adding it to MAINTAINERS at the same time. Signed-off-by: Phil Elwell --- .../devicetree/bindings/net/microchip,lan78xx.txt | 44 ++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 45 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..e7d7850 --- /dev/null +++ b/Documentation/devicetree/bindings/net/microchip,lan78xx.txt @@ -0,0 +1,44 @@ +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. + +Please refer to ethernet.txt for a description of common Ethernet bindings. + +Optional properties: +- microchip,eee-enabled: if present, enable Energy Efficient Ethernet support; +- microchip,led-modes: a two-element vector, with each element configuring + the operating mode of an LED. The values supported by the device are; + 0: Link/Activity + 1: Link1000/Activity + 2: Link100/Activity + 3: Link10/Activity + 4: Link100/1000/Activity + 5: Link10/1000/Activity + 6: Link10/100/Activity + 7: RESERVED + 8: Duplex/Collision + 9: Collision + 10: Activity + 11: RESERVED + 12: Auto-negotiation Fault + 13: RESERVED + 14: Off + 15: On +- microchip,tx-lpi-timer: the delay (in microseconds) between the TX fifo + becoming empty and invoking Low Power Idles (default 600). + +Example: + + /* Standard configuration for a Raspberry Pi 3 B+ */ + ethernet: usbether@1 { + compatible = "usb424,7800"; + reg = <1>; + microchip,eee-enabled; + microchip,tx-lpi-timer = <600>; + /* + * led0 = 1:link1000/activity + * led1 = 6:link10/100/activity + */ + microchip,led-modes = <1 6>; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 2328eed..b637aad 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -14482,6 +14482,7 @@ M: Microchip Linux Driver Support L: netdev@vger.kernel.org S: Maintained F: drivers/net/usb/lan78xx.* +F: Documentation/devicetree/bindings/net/microchip,lan78xx.txt USB MASS STORAGE DRIVER M: Alan Stern