From patchwork Thu Aug 29 11:33:25 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sachin Kamat X-Patchwork-Id: 19612 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-qe0-f70.google.com (mail-qe0-f70.google.com [209.85.128.70]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id DE07E246C2 for ; Thu, 29 Aug 2013 11:51:05 +0000 (UTC) Received: by mail-qe0-f70.google.com with SMTP id a11sf326559qen.9 for ; Thu, 29 Aug 2013 04:51:05 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=mime-version:x-gm-message-state:delivered-to:from:to:cc:subject :date:message-id:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-unsubscribe; bh=Cy+vqn0Pw4fq8fj1NL7Y7q2iH8g6IFLhOhFfV1L7Ntk=; b=bJ8ShMfHYqCvX2DRS5bdvIka03B6gbzETw50v0sC8Lgrdyj6KkJ9ZC/TS6hXNvl/AQ 0CpvXkB2+O20PWAFHA6l30F4amg4tr+ZeO0knZ6muNuNWVIXgTEpTI6qILRHL3WRjXyz hMV89t/xhARYJjaOXhXgttsk7Wncb/vWfr3tVpsieQ6aL5wZqoHJB17Ukjz9jYYcfLeD bxunFb3nrSj76RjSN6SHBHbnSzmU0ehdFqpaAEbx96O4nVKxJ+6QrB2aC8tgMnnJ3onz bu8MyhAd3s1LA3n1UpJjYMl1g5rQectga6e0u1DFPPUUdocupBtXdQFKSv4XV0+hWRw1 8/0g== X-Received: by 10.236.111.73 with SMTP id v49mr1046456yhg.46.1377777065419; Thu, 29 Aug 2013 04:51:05 -0700 (PDT) MIME-Version: 1.0 X-BeenThere: patchwork-forward@linaro.org Received: by 10.49.71.194 with SMTP id x2ls828902qeu.51.gmail; Thu, 29 Aug 2013 04:51:05 -0700 (PDT) X-Received: by 10.52.34.40 with SMTP id w8mr1695361vdi.7.1377777065319; Thu, 29 Aug 2013 04:51:05 -0700 (PDT) Received: from mail-vc0-f175.google.com (mail-vc0-f175.google.com [209.85.220.175]) by mx.google.com with ESMTPS id k20si922433vco.61.1969.12.31.16.00.00 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 29 Aug 2013 04:51:05 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.220.175 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) client-ip=209.85.220.175; Received: by mail-vc0-f175.google.com with SMTP id ia10so203409vcb.20 for ; Thu, 29 Aug 2013 04:51:05 -0700 (PDT) X-Gm-Message-State: ALoCoQlYpbRwAr9SR/qyX4/5qHxTGSDYu/dYNft50zMKR5q0RG1UUEgbTmXXfHV0ScQFGUQqexZa X-Received: by 10.52.92.15 with SMTP id ci15mr399352vdb.34.1377777065213; Thu, 29 Aug 2013 04:51:05 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patches@linaro.org Received: by 10.220.174.196 with SMTP id u4csp17342vcz; Thu, 29 Aug 2013 04:51:04 -0700 (PDT) X-Received: by 10.68.202.201 with SMTP id kk9mr3148041pbc.166.1377777064020; Thu, 29 Aug 2013 04:51:04 -0700 (PDT) Received: from mail-pd0-f179.google.com (mail-pd0-f179.google.com [209.85.192.179]) by mx.google.com with ESMTPS id ds3si24201990pbb.319.1969.12.31.16.00.00 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 29 Aug 2013 04:51:04 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.192.179 is neither permitted nor denied by best guess record for domain of sachin.kamat@linaro.org) client-ip=209.85.192.179; Received: by mail-pd0-f179.google.com with SMTP id v10so356585pde.10 for ; Thu, 29 Aug 2013 04:51:03 -0700 (PDT) X-Received: by 10.66.255.104 with SMTP id ap8mr3999442pad.53.1377777063442; Thu, 29 Aug 2013 04:51:03 -0700 (PDT) Received: from linaro.sisodomain.com ([115.113.119.130]) by mx.google.com with ESMTPSA id xl3sm37546899pbb.17.1969.12.31.16.00.00 (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 29 Aug 2013 04:51:02 -0700 (PDT) From: Sachin Kamat To: devicetree@vger.kernel.org Cc: rob.herring@calxeda.com, swarren@wwwdotorg.org, pawel.moll@arm.com, mark.rutland@arm.com, ian.campbell@citrix.com, sachin.kamat@linaro.org, kgene.kim@samsung.com, patches@linaro.org Subject: [PATCH v2 1/2] usb: samsung: Update Exynos EHCI/OHCI bindings documentation Date: Thu, 29 Aug 2013 17:03:25 +0530 Message-Id: <1377776006-22972-1-git-send-email-sachin.kamat@linaro.org> X-Mailer: git-send-email 1.7.9.5 X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: sachin.kamat@linaro.org X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 209.85.220.175 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Precedence: list Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org List-ID: X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Updated the document as per the latest implementation. While at it also fixed some trivial typos. Signed-off-by: Sachin Kamat --- Changes since v1: * Updated review comments from Stephen Warren regarding the wording and some styling. --- .../devicetree/bindings/usb/exynos-usb.txt | 29 ++++++++++---------- 1 file changed, 15 insertions(+), 14 deletions(-) diff --git a/Documentation/devicetree/bindings/usb/exynos-usb.txt b/Documentation/devicetree/bindings/usb/exynos-usb.txt index d967ba1..56468f7 100644 --- a/Documentation/devicetree/bindings/usb/exynos-usb.txt +++ b/Documentation/devicetree/bindings/usb/exynos-usb.txt @@ -5,13 +5,14 @@ The device node has following properties. EHCI Required properties: - - compatible: should be "samsung,exynos4210-ehci" for USB 2.0 - EHCI controller in host mode. + - compatible: should be one of the following for USB 2.0 EHCI controller: + (a) "samsung,exynos5440-ehci" for Exynos5440 SoC + (b) "samsung,exynos4210-ehci" for all other Exynos4 and 5 SoCs - reg: physical base address of the controller and length of memory mapped region. - - interrupts: interrupt number to the cpu. - - clocks: from common clock binding: handle to usb clock. - - clock-names: from common clock binding: Shall be "usbhost". + - interrupts: interrupt number to the CPU. + - clocks: from common clock binding: handle to USB clock. + - clock-names: shall be "usbhost". Optional properties: - samsung,vbus-gpio: if present, specifies the GPIO that @@ -23,7 +24,7 @@ Example: compatible = "samsung,exynos4210-ehci"; reg = <0x12110000 0x100>; interrupts = <0 71 0>; - samsung,vbus-gpio = <&gpx2 6 1 3 3>; + samsung,vbus-gpio = <&gpx2 6 0>; clocks = <&clock 285>; clock-names = "usbhost"; @@ -31,13 +32,14 @@ Example: OHCI Required properties: - - compatible: should be "samsung,exynos4210-ohci" for USB 2.0 - OHCI companion controller in host mode. + - compatible: should be one of the following for USB 2.0 OHCI controller: + (a) "samsung,exynos5440-ohci" for Exynos5440 SoC + (b) "samsung,exynos4210-ohci" for all other Exynos4 and 5 SoCs - reg: physical base address of the controller and length of memory mapped region. - - interrupts: interrupt number to the cpu. - - clocks: from common clock binding: handle to usb clock. - - clock-names: from common clock binding: Shall be "usbhost". + - interrupts: interrupt number to the CPU. + - clocks: from common clock binding: handle to USB clock. + - clock-names: shall be "usbhost". Example: usb@12120000 { @@ -53,12 +55,11 @@ DWC3 Required properties: - compatible: should be "samsung,exynos5250-dwusb3" for USB 3.0 DWC3 controller. - - #address-cells, #size-cells : should be '1' if the device has sub-nodes - with 'reg' property. + - #address-cells, #size-cells: should be '1'. - ranges: allows valid 1:1 translation between child's address space and parent's address space - clocks: Clock IDs array as required by the controller. - - clock-names: names of clocks correseponding to IDs in the clock property + - clock-names: shall be "usbdrd30". Sub-nodes: The dwc3 core should be added as subnode to Exynos dwc3 glue.