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: [1/5] dt-bindings: Add Broadcom STB OHCI, EHCI and XHCI binding document From: Rob Herring Message-Id: <20181015182216.GA29537@bogus> Date: Mon, 15 Oct 2018 13:22:16 -0500 To: Al Cooper Cc: linux-kernel@vger.kernel.org, Greg Kroah-Hartman , Mark Rutland , Alan Stern , Mathias Nyman , Mauro Carvalho Chehab , "David S. Miller" , Andrew Morton , Arnd Bergmann , Dmitry Osipenko , Chunfeng Yun , Jianguo Sun , James Hogan , Alban Bedel , Lu Baolu , Avi Fishman , Alex Elder , Hans de Goede , linux-usb@vger.kernel.org, devicetree@vger.kernel.org, bcm-kernel-feedback-list@broadcom.com List-ID: T24gV2VkLCBTZXAgMjYsIDIwMTggYXQgMDY6MjA6MTBQTSAtMDQwMCwgQWwgQ29vcGVyIHdyb3Rl Ogo+IEFkZCBEVCBiaW5kaW5ncyBkb2N1bWVudCBmb3IgQnJvYWRjb20gU1RCIFVTQiBPSENJLCBF SENJIGFuZAo+IFhIQ0kgZHJpdmVycy4KPiAKPiBTaWduZWQtb2ZmLWJ5OiBBbCBDb29wZXIgPGFs Y29vcGVyeEBnbWFpbC5jb20+Cj4gLS0tCj4gIC4uLi9kZXZpY2V0cmVlL2JpbmRpbmdzL3VzYi9i cmNtLGVoY2ktYnJjbS50eHQgICAgIHwgMjIgKysrKysrKysrKysrKysrKysrKysrCj4gIC4uLi9k ZXZpY2V0cmVlL2JpbmRpbmdzL3VzYi9icmNtLG9oY2ktYnJjbS50eHQgICAgIHwgMjIgKysrKysr KysrKysrKysrKysrKysrCj4gIC4uLi9kZXZpY2V0cmVlL2JpbmRpbmdzL3VzYi9icmNtLHhoY2kt YnJjbS50eHQgICAgIHwgMjMgKysrKysrKysrKysrKysrKysrKysrKwo+ICAzIGZpbGVzIGNoYW5n ZWQsIDY3IGluc2VydGlvbnMoKykKPiAgY3JlYXRlIG1vZGUgMTAwNjQ0IERvY3VtZW50YXRpb24v ZGV2aWNldHJlZS9iaW5kaW5ncy91c2IvYnJjbSxlaGNpLWJyY20udHh0Cj4gIGNyZWF0ZSBtb2Rl IDEwMDY0NCBEb2N1bWVudGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3MvdXNiL2JyY20sb2hjaS1i cmNtLnR4dAo+ICBjcmVhdGUgbW9kZSAxMDA2NDQgRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2Jp bmRpbmdzL3VzYi9icmNtLHhoY2ktYnJjbS50eHQKPiAKPiBkaWZmIC0tZ2l0IGEvRG9jdW1lbnRh dGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL3VzYi9icmNtLGVoY2ktYnJjbS50eHQgYi9Eb2N1bWVu dGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3MvdXNiL2JyY20sZWhjaS1icmNtLnR4dAo+IG5ldyBm aWxlIG1vZGUgMTAwNjQ0Cj4gaW5kZXggMDAwMDAwMDAwMDAwLi4wMjBiNWVjNDBmNWIKPiAtLS0g L2Rldi9udWxsCj4gKysrIGIvRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL3VzYi9i cmNtLGVoY2ktYnJjbS50eHQKPiBAQCAtMCwwICsxLDIyIEBACj4gK0Jyb2FkY29tIFNUQiBVU0Ig RUhDSSBjb250cm9sbGVyCj4gKwo+ICtSZXF1aXJlZCBwcm9wZXJ0aWVzOgo+ICstIGNvbXBhdGli bGU6IHNob3VsZCBiZSAiYnJjbSxlaGNpLWJyY20tdjIiCgpOZWVkcyBhbiBTb0Mgc3BlY2lmaWMg Y29tcGF0aWJsZSBzdHJpbmcuCgo+ICstIHJlZzogc2hvdWxkIGNvbnRhaW4gb25lIHJlZ2lzdGVy IHJhbmdlIGkuZS4gc3RhcnQgYW5kIGxlbmd0aAo+ICstIGludGVycnVwdHM6IGRlc2NyaXB0aW9u IG9mIHRoZSBpbnRlcnJ1cHQgbGluZQo+ICstIHBoeXM6IHBoYW5kbGUgKyBwaHkgc3BlY2lmaWVy IHBhaXIKPiArICBUaGUgc3BlY2lmaWVyIHNob3VsZCBiZSAwIGZvciB0aGUgT0hDSS9FSENJIFBI WSBhbmQgMSBmb3IgdGhlIFhIQ0kgUEhZCgowIG9yIDEgZGVwZW5kcyBvbiB0aGUgcGh5IGJpbmRp bmcuIFRoaXMgYmluZGluZyBqdXN0IG5lZWRzIHRvIHNheSBob3cgCm1hbnkgcGh5IHNwZWNpZmll cnMgdGhlcmUgYXJlLgoKPiArCj4gK09wdGlvbmFsIHByb3BlcnRpZXM6Cj4gKy0gY2xvY2tzOiBB IGxpc3Qgb2YgcGhhbmRsZXMgZm9yIHRoZSBjbG9ja3MKCk5lZWQgdG8gc2F5IGhvdyBtYW55IGFu ZCB0aGUgb3JkZXIuCgo+ICsKPiArRXhhbXBsZToKPiArCj4gK2VoY2lAZjBiMDAzMDAgewo+ICsJ Y29tcGF0aWJsZSA9ICJicmNtLGVoY2ktYnJjbS12MiI7Cj4gKwlyZWcgPSA8MHhmMGIwMDMwMCAw eGE4PjsKPiArCWludGVycnVwdHMgPSA8MHgwIDB4NWEgMHgwPjsKPiArCWludGVycnVwdC1uYW1l cyA9ICJ1c2IwX2VoY2lfMCI7Cj4gKwlwaHlzID0gPCZ1c2JwaHlfMCAweDA+Owo+ICsJY2xvY2tz ID0gPCZ1c2IyMD4KPiArfTsKClNpbWlsYXIgY29tbWVudHMgaW4gdGhlIG90aGVyIDIgZmlsZXMu Cg== From mboxrd@z Thu Jan 1 00:00:00 1970 From: Rob Herring Subject: Re: [PATCH 1/5] dt-bindings: Add Broadcom STB OHCI, EHCI and XHCI binding document Date: Mon, 15 Oct 2018 13:22:16 -0500 Message-ID: <20181015182216.GA29537@bogus> References: <1538000414-24873-1-git-send-email-alcooperx@gmail.com> <1538000414-24873-2-git-send-email-alcooperx@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Content-Disposition: inline In-Reply-To: <1538000414-24873-2-git-send-email-alcooperx@gmail.com> Sender: linux-kernel-owner@vger.kernel.org To: Al Cooper Cc: linux-kernel@vger.kernel.org, Greg Kroah-Hartman , Mark Rutland , Alan Stern , Mathias Nyman , Mauro Carvalho Chehab , "David S. Miller" , Andrew Morton , Arnd Bergmann , Dmitry Osipenko , Chunfeng Yun , Jianguo Sun , James Hogan , Alban Bedel , Lu Baolu , Avi Fishman , Alex Elder , Hans de Goede , linux-usb@vger.kernel.org, devicetree@vger.kernel.org, bcm-kernel-f List-Id: devicetree@vger.kernel.org On Wed, Sep 26, 2018 at 06:20:10PM -0400, Al Cooper wrote: > Add DT bindings document for Broadcom STB USB OHCI, EHCI and > XHCI drivers. > > Signed-off-by: Al Cooper > --- > .../devicetree/bindings/usb/brcm,ehci-brcm.txt | 22 +++++++++++++++++++++ > .../devicetree/bindings/usb/brcm,ohci-brcm.txt | 22 +++++++++++++++++++++ > .../devicetree/bindings/usb/brcm,xhci-brcm.txt | 23 ++++++++++++++++++++++ > 3 files changed, 67 insertions(+) > create mode 100644 Documentation/devicetree/bindings/usb/brcm,ehci-brcm.txt > create mode 100644 Documentation/devicetree/bindings/usb/brcm,ohci-brcm.txt > create mode 100644 Documentation/devicetree/bindings/usb/brcm,xhci-brcm.txt > > diff --git a/Documentation/devicetree/bindings/usb/brcm,ehci-brcm.txt b/Documentation/devicetree/bindings/usb/brcm,ehci-brcm.txt > new file mode 100644 > index 000000000000..020b5ec40f5b > --- /dev/null > +++ b/Documentation/devicetree/bindings/usb/brcm,ehci-brcm.txt > @@ -0,0 +1,22 @@ > +Broadcom STB USB EHCI controller > + > +Required properties: > +- compatible: should be "brcm,ehci-brcm-v2" Needs an SoC specific compatible string. > +- reg: should contain one register range i.e. start and length > +- interrupts: description of the interrupt line > +- phys: phandle + phy specifier pair > + The specifier should be 0 for the OHCI/EHCI PHY and 1 for the XHCI PHY 0 or 1 depends on the phy binding. This binding just needs to say how many phy specifiers there are. > + > +Optional properties: > +- clocks: A list of phandles for the clocks Need to say how many and the order. > + > +Example: > + > +ehci@f0b00300 { > + compatible = "brcm,ehci-brcm-v2"; > + reg = <0xf0b00300 0xa8>; > + interrupts = <0x0 0x5a 0x0>; > + interrupt-names = "usb0_ehci_0"; > + phys = <&usbphy_0 0x0>; > + clocks = <&usb20> > +}; Similar comments in the other 2 files. From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.5 required=3.0 tests=INCLUDES_PATCH, MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_PASS,USER_AGENT_MUTT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 746CFC71133 for ; Mon, 15 Oct 2018 18:22:21 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 48FDD208D9 for ; Mon, 15 Oct 2018 18:22:21 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 48FDD208D9 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727034AbeJPCIl (ORCPT ); Mon, 15 Oct 2018 22:08:41 -0400 Received: from mail-oi1-f194.google.com ([209.85.167.194]:44609 "EHLO mail-oi1-f194.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726849AbeJPCIl (ORCPT ); Mon, 15 Oct 2018 22:08:41 -0400 Received: by mail-oi1-f194.google.com with SMTP id u74-v6so15851661oia.11; Mon, 15 Oct 2018 11:22:18 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=TXc+d0Rc6EuGQDJAiIKA+Xam+Mv/SY6agLLhvE1qLTo=; b=ZX1BrZD2dS9mKX/tLbCNEXAHJ9YbP8Tszg1JNHNkwPrxe9tpBNmnfyNSO+G/JKJIY3 hH1gKEm1vKAc0zzQbSuS9H5GpxNPd12lZTkTVKtUBAlC1gclUZB9GKseF9cijt+xMiaZ /YnDdltsbs5hjK1PD6R4hzvtO9sf5SCZqfTOc++Ubd85zG80C89P7+6ZoJkYSMkZXX+5 YBI6+dIza4VRy+fE0yBH8nD0SIDt2cby2xYniVxvEXF5djiXbSJzkFcY8Yvma9uaYFou quo38xUy5cdBqA0hTnBCxVgzTLPyq09/6CdVsXhUsUsMuM6kQXHFsZvszl7pcGlX9u+r Ogkw== X-Gm-Message-State: ABuFfogNxacx5WMPKwsaXeiULnG1xN22zGHxaEHviC52p/u9kZPS9Rq7 XllM8yw3Fx+8dzB+xvTFig== X-Google-Smtp-Source: ACcGV61ZNC/zjhJOkGMTKfvsnjbS/hMmaLneC2p8y2fhWlVvoEtuXOBnM5lgv7XvTTRiXZysOygMOg== X-Received: by 2002:aca:c0c1:: with SMTP id q184-v6mr10165346oif.353.1539627738080; Mon, 15 Oct 2018 11:22:18 -0700 (PDT) Received: from localhost (24-155-109-49.dyn.grandenetworks.net. [24.155.109.49]) by smtp.gmail.com with ESMTPSA id h70-v6sm4228397oic.17.2018.10.15.11.22.17 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 15 Oct 2018 11:22:17 -0700 (PDT) Date: Mon, 15 Oct 2018 13:22:16 -0500 From: Rob Herring To: Al Cooper Cc: linux-kernel@vger.kernel.org, Greg Kroah-Hartman , Mark Rutland , Alan Stern , Mathias Nyman , Mauro Carvalho Chehab , "David S. Miller" , Andrew Morton , Arnd Bergmann , Dmitry Osipenko , Chunfeng Yun , Jianguo Sun , James Hogan , Alban Bedel , Lu Baolu , Avi Fishman , Alex Elder , Hans de Goede , linux-usb@vger.kernel.org, devicetree@vger.kernel.org, bcm-kernel-feedback-list@broadcom.com Subject: Re: [PATCH 1/5] dt-bindings: Add Broadcom STB OHCI, EHCI and XHCI binding document Message-ID: <20181015182216.GA29537@bogus> References: <1538000414-24873-1-git-send-email-alcooperx@gmail.com> <1538000414-24873-2-git-send-email-alcooperx@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1538000414-24873-2-git-send-email-alcooperx@gmail.com> User-Agent: Mutt/1.9.4 (2018-02-28) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Wed, Sep 26, 2018 at 06:20:10PM -0400, Al Cooper wrote: > Add DT bindings document for Broadcom STB USB OHCI, EHCI and > XHCI drivers. > > Signed-off-by: Al Cooper > --- > .../devicetree/bindings/usb/brcm,ehci-brcm.txt | 22 +++++++++++++++++++++ > .../devicetree/bindings/usb/brcm,ohci-brcm.txt | 22 +++++++++++++++++++++ > .../devicetree/bindings/usb/brcm,xhci-brcm.txt | 23 ++++++++++++++++++++++ > 3 files changed, 67 insertions(+) > create mode 100644 Documentation/devicetree/bindings/usb/brcm,ehci-brcm.txt > create mode 100644 Documentation/devicetree/bindings/usb/brcm,ohci-brcm.txt > create mode 100644 Documentation/devicetree/bindings/usb/brcm,xhci-brcm.txt > > diff --git a/Documentation/devicetree/bindings/usb/brcm,ehci-brcm.txt b/Documentation/devicetree/bindings/usb/brcm,ehci-brcm.txt > new file mode 100644 > index 000000000000..020b5ec40f5b > --- /dev/null > +++ b/Documentation/devicetree/bindings/usb/brcm,ehci-brcm.txt > @@ -0,0 +1,22 @@ > +Broadcom STB USB EHCI controller > + > +Required properties: > +- compatible: should be "brcm,ehci-brcm-v2" Needs an SoC specific compatible string. > +- reg: should contain one register range i.e. start and length > +- interrupts: description of the interrupt line > +- phys: phandle + phy specifier pair > + The specifier should be 0 for the OHCI/EHCI PHY and 1 for the XHCI PHY 0 or 1 depends on the phy binding. This binding just needs to say how many phy specifiers there are. > + > +Optional properties: > +- clocks: A list of phandles for the clocks Need to say how many and the order. > + > +Example: > + > +ehci@f0b00300 { > + compatible = "brcm,ehci-brcm-v2"; > + reg = <0xf0b00300 0xa8>; > + interrupts = <0x0 0x5a 0x0>; > + interrupt-names = "usb0_ehci_0"; > + phys = <&usbphy_0 0x0>; > + clocks = <&usb20> > +}; Similar comments in the other 2 files.