From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Cyrus-Session-Id: sloti22d1t05-212881-1517270821-2-1632580295638711714 X-Sieve: CMU Sieve 3.0 X-Spam-known-sender: no X-Spam-score: 0.0 X-Spam-hits: BAYES_00 -1.9, ME_NOAUTH 0.01, RCVD_IN_DNSWL_HI -5, T_RP_MATCHES_RCVD -0.01, 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: plain='us-ascii' 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=arctest; t=1517270820; b=JGQAPiV1QlOL08pMFPXwCH34Z/T5AEUBTO0OxHH80hdpftQ J2wlD29Hf+b0mugYyVc/xOb2WVkEBymPhoPl2WPX+l3zjD1ZNOrsMY4hTtxBZ6zz X9xdIhOrXAnrXOYDf4ZLq9AlyJ57d6WukMUSbRUOgCwnH6cJNeXjPjF2EuVhO400 gdnoDeIrpxWFvIGqSGjlmKLLjK17iNhTcfdPZp59WXYciW9R9Er+o9tJ+LD0xRUE SmzcZ7OPCInbRUutllFx7iQoO1+mZtaigGowS5seU2NgWciPxIbio98M1pgKAJNf azuCnTYwIJRtG5HXhjGNIz/icn291lapeNwvvIQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=date:from:to:cc:subject:message-id :references:mime-version:content-type:in-reply-to:sender :list-id; s=arctest; t=1517270820; bh=4R7CNrFWb4ISLircZW5lLDlTdn /hH0M6FAROBK/EiRg=; b=PU7KLBWstVBOw/k5DX8+8rP/NEtKkic/iHGLBFRg0q Qp5rJqRbeUfmsx40A0vhQ7/YuQ8e5ilfvlp0PZk8NaeYaliXq6FiYEXNSZDiEa55 MGpMJWgGchlYWEqg9UZquiTX2/BxoKzm1ITp2P1sVc7JRDIAC2zM4siGuoxmzT4E /3wnP/dYOXCNBHnlpiayk9EKYbzqX2XfnkSa2y/uXCmFQ6Ypuu8FV5xr2yS9XBH/ t6yL+4ypUP76z7G9I/RkLdxEDdnnJozi5KG9w8nBclqaXivJxukMA2vpSNqYaVpa Q9GcPcjklqfFWXE34DuIoBi0V2W7wbWiEClHN8MwGDzg== ARC-Authentication-Results: i=1; mx5.messagingengine.com; arc=none (no signatures found); dkim=none (no signatures found); dmarc=none (p=none,has-list-id=yes,d=none) header.from=kernel.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=orgdomain_pass; x-google-dkim=fail (body has been altered; 2048-bit rsa key) header.d=1e100.net header.i=@1e100.net header.b=cNS9Ieuw; 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=kernel.org header.result=pass header_is_org_domain=yes Authentication-Results: mx5.messagingengine.com; arc=none (no signatures found); dkim=none (no signatures found); dmarc=none (p=none,has-list-id=yes,d=none) header.from=kernel.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=orgdomain_pass; x-google-dkim=fail (body has been altered; 2048-bit rsa key) header.d=1e100.net header.i=@1e100.net header.b=cNS9Ieuw; 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=kernel.org header.result=pass header_is_org_domain=yes Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751439AbeA3AG4 (ORCPT ); Mon, 29 Jan 2018 19:06:56 -0500 Received: from mail-ot0-f196.google.com ([74.125.82.196]:39363 "EHLO mail-ot0-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751394AbeA3AGz (ORCPT ); Mon, 29 Jan 2018 19:06:55 -0500 X-Google-Smtp-Source: AH8x227pIpEC3NP8j4HKUNT7eIlksrnaib+1fy26+TbvrziWlfdCk4AAlXdi+nnIJ3hDKlUu0daykg== Date: Mon, 29 Jan 2018 18:06:53 -0600 From: Rob Herring To: Kunihiko Hayashi Cc: Felipe Balbi , linux-usb@vger.kernel.org, Greg Kroah-Hartman , Masahiro Yamada , Mark Rutland , devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Jassi Brar , Masami Hiramatsu Subject: Re: [PATCH 1/4] dt-bindings: dwc3: add binding documentation for UniPhier dwc3 glue driver Message-ID: <20180130000653.rvxqttpwz2mf2yrm@rob-hp-laptop> References: <1516712454-2915-1-git-send-email-hayashi.kunihiko@socionext.com> <1516712454-2915-2-git-send-email-hayashi.kunihiko@socionext.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1516712454-2915-2-git-send-email-hayashi.kunihiko@socionext.com> User-Agent: NeoMutt/20170609 (1.8.3) 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: On Tue, Jan 23, 2018 at 10:00:51PM +0900, Kunihiko Hayashi wrote: > Add devicetree binding documentation for dwc3 glue driver implemented > on Socionext UniPhier SoCs. > > Signed-off-by: Kunihiko Hayashi > --- > .../devicetree/bindings/usb/dwc3-uniphier.txt | 58 ++++++++++++++++++++++ > 1 file changed, 58 insertions(+) > create mode 100644 Documentation/devicetree/bindings/usb/dwc3-uniphier.txt > > diff --git a/Documentation/devicetree/bindings/usb/dwc3-uniphier.txt b/Documentation/devicetree/bindings/usb/dwc3-uniphier.txt > new file mode 100644 > index 0000000..677e072 > --- /dev/null > +++ b/Documentation/devicetree/bindings/usb/dwc3-uniphier.txt > @@ -0,0 +1,58 @@ > +UniPhier DWC3 glue layer > + > +This describes the devicetree bindings for dwc3-uniphier driver implemented on > +Socionext UniPhier SoCs. > + > +Required properties: > +- compatible: > + - "socionext,uniphier-pxs2-dwc3" : For UniPhier PXs2 SoC > + - "socionext,uniphier-ld20-dwc3" : For UniPhier LD20 SoC > +- reg: Address and range of the glue logic > +- clocks: List of phandles for the clocks, and the number of phandles depends > + on SoC platform. Number of clocks needs to be specific. It should be fixed per compatible. > + > +Optional properties: > +- resets: List of phandles for the resets, and the number of phandles depends > + on SoC platform. Same here. > +- nvmem-cells: Phandles to nvmem cell that contains the trimming data. > + Available only for LD20, and if unspecified, default value is used. > +- nvmem-cell-names: Should be the following names, which correspond to each > + nvmem-cells. N is the number indicating a port of phy. > + All of the 3 parameters associated with the following names are > + required for each port, if any one is omitted, the trimming data > + of the port will not be set at all. > + - "rtermN", "sel_tN", "hs_iN" : Each cell name for phy parameters > + > +Required child node: > +A child node must exist to represent the core DWC3 IP block. The name of > +the node is not important. The content of the node is defined in dwc3.txt. > + > +Example: > + > + usb: usb@65b00000 { > + compatible = "socionext,uniphier-ld20-dwc3"; > + reg = <0x65b00000 0x1000>; > + #address-cells = <1>; > + #size-cells = <1>; > + clocks = <&sys_clk 14>, <&sys_clk 16>, <&sys_clk 17>; > + resets = <&sys_rst 12>, <&sys_rst 16>, <&sys_rst 17>, > + <&sys_rst 18>, <&sys_rst 19>; > + nvmem-cells = <&usb_rterm0>, <&usb_rterm1>, > + <&usb_rterm2>, <&usb_rterm3>, > + <&usb_sel_t0>, <&usb_sel_t1>, > + <&usb_sel_t2>, <&usb_sel_t3>, > + <&usb_hs_i0>, <&usb_hs_i0>, > + <&usb_hs_i2>, <&usb_hs_i2>; > + nvmem-cell-names = "rterm0", "rterm1", "rterm2", "rterm3", > + "sel_t0", "sel_t1", "sel_t2", "sel_t3", > + "hs_i0", "hs_i1", "hs_i2", "hs_i3"; > + ranges; > + > + dwc3@65a00000 { > + compatible = "snps,dwc3"; > + reg = <0x65a00000 0xcd00>; > + interrupt-names = "host"; > + interrupts = <0 134 4>; > + dr_mode = "host"; > + }; > + }; > -- > 2.7.4 >