From patchwork Thu Aug 1 09:24:35 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sachin Kamat X-Patchwork-Id: 18721 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-ve0-f197.google.com (mail-ve0-f197.google.com [209.85.128.197]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id B32E5238F9 for ; Thu, 1 Aug 2013 09:41:13 +0000 (UTC) Received: by mail-ve0-f197.google.com with SMTP id ox1sf2328963veb.8 for ; Thu, 01 Aug 2013 02:41:13 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:x-beenthere:x-forwarded-to:x-forwarded-for :delivered-to:from:to:cc:subject:date:message-id:x-mailer :x-gm-message-state:x-removed-original-auth:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-google-group-id:list-post:list-help:list-archive:list-unsubscribe; bh=C0oEunQ7McS4nquRxpedyhWuqdfDF6pdDMH4wG9CgG8=; b=ipd/nD+bhHQEX0C+g/p+NIu3mysu1z+1q8EBmDWsW5iyQcwPN6txNP2Xum27k0WbbW qTM81V0oviM52mjgMx8ZY3B0FonvoqOIfb13YMm4EwQoBR5vyskDqYXepC1ihojJOHFg UUFFxblpnktyjs54og/WPt30GAAZ1cInG+S5DvTL34ANs0mJAy/B3rBbQfQ/kgcz38/w J/7ZlLHA1ARX5uTbygvaSYAAdBK1MdufyixCFd1bffQB0l/Yusu0UGQAy5uod4B8IkPp LYMhyVIAmNFLzz5kRWbBGJKdAcHi8iWQRN4IG/4LlALH79mvbZcRk6Ieoske3l60j9ZC b36Q== X-Received: by 10.236.62.132 with SMTP id y4mr300644yhc.13.1375350073444; Thu, 01 Aug 2013 02:41:13 -0700 (PDT) MIME-Version: 1.0 X-BeenThere: patchwork-forward@linaro.org Received: by 10.49.27.195 with SMTP id v3ls1055322qeg.6.gmail; Thu, 01 Aug 2013 02:41:13 -0700 (PDT) X-Received: by 10.220.191.5 with SMTP id dk5mr198292vcb.47.1375350073312; Thu, 01 Aug 2013 02:41:13 -0700 (PDT) Received: from mail-vb0-f43.google.com (mail-vb0-f43.google.com [209.85.212.43]) by mx.google.com with ESMTPS id pa20si439827veb.90.2013.08.01.02.41.13 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 01 Aug 2013 02:41:13 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.212.43 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) client-ip=209.85.212.43; Received: by mail-vb0-f43.google.com with SMTP id h11so1860728vbh.16 for ; Thu, 01 Aug 2013 02:41:13 -0700 (PDT) X-Received: by 10.58.187.4 with SMTP id fo4mr198656vec.55.1375350073190; Thu, 01 Aug 2013 02:41:13 -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.221.11.8 with SMTP id pc8csp287295vcb; Thu, 1 Aug 2013 02:41:12 -0700 (PDT) X-Received: by 10.66.164.71 with SMTP id yo7mr2952784pab.92.1375350072090; Thu, 01 Aug 2013 02:41:12 -0700 (PDT) Received: from mail-pd0-f181.google.com (mail-pd0-f181.google.com [209.85.192.181]) by mx.google.com with ESMTPS id or6si1924662pac.160.2013.08.01.02.41.11 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 01 Aug 2013 02:41:12 -0700 (PDT) Received-SPF: neutral (google.com: 209.85.192.181 is neither permitted nor denied by best guess record for domain of sachin.kamat@linaro.org) client-ip=209.85.192.181; Received: by mail-pd0-f181.google.com with SMTP id g10so1832186pdj.12 for ; Thu, 01 Aug 2013 02:41:11 -0700 (PDT) X-Received: by 10.68.223.34 with SMTP id qr2mr823734pbc.75.1375350071504; Thu, 01 Aug 2013 02:41:11 -0700 (PDT) Received: from linaro.sisodomain.com ([115.113.119.130]) by mx.google.com with ESMTPSA id sz3sm1469986pbc.5.2013.08.01.02.41.05 for (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 01 Aug 2013 02:41:10 -0700 (PDT) From: Sachin Kamat To: linux-usb@vger.kernel.org, devicetree@vger.kernel.org, linux-doc@vger.kernel.org Cc: gregkh@linuxfoundation.org, balbi@ti.com, gautam.vivek@samsung.com, kgene.kim@samsung.com, swarren@wwwdotorg.org, rob@landley.net, sachin.kamat@linaro.org, patches@linaro.org Subject: [PATCH 1/1] usb: phy: samsung: Update usbphy documentation Date: Thu, 1 Aug 2013 14:54:35 +0530 Message-Id: <1375349075-15833-1-git-send-email-sachin.kamat@linaro.org> X-Mailer: git-send-email 1.7.9.5 X-Gm-Message-State: ALoCoQkzGifd0yyoJBmAGld/zJREJ0zx19T7q9O09hcyOzHOpSefJfxcXTZD87liOauAFw64HPnD 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.212.43 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 documentation as per the latest driver implementation. While at it also fixed some trivial typos. Signed-off-by: Sachin Kamat Acked-by: Felipe Balbi --- .../devicetree/bindings/usb/samsung-usbphy.txt | 48 ++++++++++---------- 1 file changed, 23 insertions(+), 25 deletions(-) diff --git a/Documentation/devicetree/bindings/usb/samsung-usbphy.txt b/Documentation/devicetree/bindings/usb/samsung-usbphy.txt index 33fd354..62e6f17 100644 --- a/Documentation/devicetree/bindings/usb/samsung-usbphy.txt +++ b/Documentation/devicetree/bindings/usb/samsung-usbphy.txt @@ -1,34 +1,32 @@ SAMSUNG USB-PHY controllers -** Samsung's usb 2.0 phy transceiver +** Samsung's USB 2.0 phy transceiver -The Samsung's usb 2.0 phy transceiver is used for controlling -usb 2.0 phy for s3c-hsotg as well as ehci-s5p and ohci-exynos -usb controllers across Samsung SOCs. +The Samsung's USB 2.0 phy transceiver is used for controlling +USB 2.0 phy for s3c-hsotg as well as ehci-s5p and ohci-exynos +USB controllers across Samsung SOCs. TODO: Adding the PHY binding with controller(s) according to the under development generic PHY driver. Required properties: -Exynos4210: -- compatible : should be "samsung,exynos4210-usb2phy" -- reg : base physical address of the phy registers and length of memory mapped - region. -- clocks: Clock IDs array as required by the controller. -- clock-names: names of clock correseponding IDs clock property as requested - by the controller driver. - -Exynos5250: -- compatible : should be "samsung,exynos5250-usb2phy" +- compatible : value should be one among the following: + (a) "samsung,s3c64xx-usb2phy" for S3C64xx SoCs + (b) "samsung,exynos4210-usb2phy" for Exynos4210 SoC + (c) "samsung,exynos4x12-usb2phy" for Exynos4x12 SoCs + (d) "samsung,exynos5250-usb2phy" for Exynos5250 SoC - reg : base physical address of the phy registers and length of memory mapped region. +- clocks : Clock IDs array as required by the controller. +- clock-names : names of clocks listed in clocks property in the same order + as requested by the controller driver. Optional properties: -- #address-cells: should be '1' when usbphy node has a child node with 'reg' +- #address-cellsi : should be '1' when usbphy node has a child node with 'reg' property. -- #size-cells: should be '1' when usbphy node has a child node with 'reg' +- #size-cells : should be '1' when usbphy node has a child node with 'reg' property. -- ranges: allows valid translation between child's address space and parent's +- ranges : allows valid translation between child's address space and parent's address space. - The child node 'usbphy-sys' to the node 'usbphy' is for the system controller @@ -63,10 +61,10 @@ Example: }; -** Samsung's usb 3.0 phy transceiver +** Samsung's USB 3.0 phy transceiver -Starting exynso5250, Samsung's SoC have usb 3.0 phy transceiver -which is used for controlling usb 3.0 phy for dwc3-exynos usb 3.0 +Starting Exynos5250, Samsung's SoC have USB 3.0 phy transceiver +which is used for controlling USB 3.0 phy for dwc3-exynos USB 3.0 controllers across Samsung SOCs. Required properties: @@ -75,16 +73,16 @@ Exynos5250: - compatible : should be "samsung,exynos5250-usb3phy" - reg : base physical address of the phy registers and length of memory mapped region. -- clocks: Clock IDs array as required by the controller. -- clock-names: names of clocks correseponding to IDs in the clock property +- clocks : Clock IDs array as required by the controller. +- clock-names : names of clocks correseponding to IDs in the clock property as requested by the controller driver. Optional properties: -- #address-cells: should be '1' when usbphy node has a child node with 'reg' +- #address-cells : should be '1' when usbphy node has a child node with 'reg' property. -- #size-cells: should be '1' when usbphy node has a child node with 'reg' +- #size-cells : should be '1' when usbphy node has a child node with 'reg' property. -- ranges: allows valid translation between child's address space and parent's +- ranges : allows valid translation between child's address space and parent's address space. - The child node 'usbphy-sys' to the node 'usbphy' is for the system controller