From patchwork Mon Jun 17 12:57:06 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Leela Krishna Amudala X-Patchwork-Id: 2733171 Return-Path: X-Original-To: patchwork-linux-samsung-soc@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork2.web.kernel.org (Postfix) with ESMTP id D3DD8C0AB1 for ; Mon, 17 Jun 2013 12:33:49 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 2FBE5202B4 for ; Mon, 17 Jun 2013 12:33:45 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id E395F202B1 for ; Mon, 17 Jun 2013 12:33:43 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752397Ab3FQMdn (ORCPT ); Mon, 17 Jun 2013 08:33:43 -0400 Received: from mailout1.samsung.com ([203.254.224.24]:29257 "EHLO mailout1.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751096Ab3FQMdm (ORCPT ); Mon, 17 Jun 2013 08:33:42 -0400 Received: from epcpsbgr1.samsung.com (u141.gpu120.samsung.co.kr [203.254.230.141]) by mailout1.samsung.com (Oracle Communications Messaging Server 7u4-24.01 (7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTP id <0MOJ00JUXEW5SS00@mailout1.samsung.com> for linux-samsung-soc@vger.kernel.org; Mon, 17 Jun 2013 21:33:41 +0900 (KST) Received: from epcpsbgm2.samsung.com ( [172.20.52.125]) by epcpsbgr1.samsung.com (EPCPMTA) with SMTP id A9.F7.17404.5220FB15; Mon, 17 Jun 2013 21:33:41 +0900 (KST) X-AuditID: cbfee68d-b7f096d0000043fc-a9-51bf02250adf Received: from epmmp2 ( [203.254.227.17]) by epcpsbgm2.samsung.com (EPCPMTA) with SMTP id 21.69.21068.4220FB15; Mon, 17 Jun 2013 21:33:41 +0900 (KST) Received: from chromeserver-PowerEdge-T410.sisodomain.com ([107.108.73.106]) by mmp2.samsung.com (Oracle Communications Messaging Server 7u4-24.01(7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTPA id <0MOJ00895EVFB660@mmp2.samsung.com>; Mon, 17 Jun 2013 21:33:40 +0900 (KST) From: Leela Krishna Amudala To: linux-samsung-soc@vger.kernel.org Cc: devicetree-discuss@lists.ozlabs.org, kgene.kim@samsung.com, dianders@chromium.org, t.figa@samsung.com, linus.walleij@linaro.org Subject: [PATCH V2] Documentation: Add examples to samsung-pinctrl device tree bindings documentation Date: Mon, 17 Jun 2013 18:27:06 +0530 Message-id: <1371473826-2595-1-git-send-email-l.krishna@samsung.com> X-Mailer: git-send-email 1.7.10.4 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFrrNLMWRmVeSWpSXmKPExsWyRsSkVleVaX+gwdlefosDsx+yWpxddpDN onfBVTaLKX+WM1nMOL+PyWL9jNcsDmwesxsusnjcubaHzeP8jIWMHn1bVjF6fN4kF8AaxWWT kpqTWZZapG+XwJXRfmAbc8EC4YqJD3cxNzDu5+9i5OSQEDCRmLXsDBOELSZx4d56ti5GLg4h gaWMEodftjHCFE36Op0ZIjGdUeLm/VdMEM5sJolzn/+yg1SxCRhL3J+7GWyUiICqxOe2Bewg RcwCrYwSx268AxslLJAu8Xv5BhYQmwWo6FnrT7A4r4CLxNRFs6DuUJTofjYB7A4Jgd9sEpu3 nmaDaBCQ+Db5EFAzB1BCVmLTAWaIekmJgytusExgFFzAyLCKUTS1ILmgOCm9yFCvODG3uDQv XS85P3cTIzBgT/971ruD8fYB60OMyUDjJjJLiSbnAwM+ryTe0NjMyMLUxNTYyNzSjDRhJXFe tRbrQCGB9MSS1OzU1ILUovii0pzU4kOMTBycUg2M4gc3LD+6ec57Pqmc+s/dXQazU5NcTY9Y VirWMDcy6v2KKvy3Wkrgmfsxf4HwG5I3T2nMiltU33fNOJy54GGgPlfUaQWhnhc9K/bE733f W/Fs/gTjdaWSb5ZPtjfpO/iHn+35eYV4Xcec5EqpWZ2lr3M9vXRXP+E6efr6BEvtzM9uew/W yhgqsRRnJBpqMRcVJwIAVNKmyW4CAAA= X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFtrBIsWRmVeSWpSXmKPExsVy+t9jQV1Vpv2BBs3b2SwOzH7IanF22UE2 i94FV9kspvxZzmQx4/w+Jov1M16zOLB5zG64yOJx59oeNo/zMxYyevRtWcXo8XmTXABrVAOj TUZqYkpqkUJqXnJ+SmZeuq2Sd3C8c7ypmYGhrqGlhbmSQl5ibqqtkotPgK5bZg7QCUoKZYk5 pUChgMTiYiV9O0wTQkPcdC1gGiN0fUOC4HqMDNBAwhrGjPYD25gLFghXTHy4i7mBcT9/FyMn h4SAicSkr9OZIWwxiQv31rN1MXJxCAlMZ5S4ef8VE4Qzm0ni3Oe/7CBVbALGEvfnbmYCsUUE VCU+ty1gByliFmhllDh24x0jSEJYIF3i9/INLCA2C1DRs9afYHFeAReJqYtmMUGsU5TofjaB bQIj9wJGhlWMoqkFyQXFSem5RnrFibnFpXnpesn5uZsYwfHwTHoH46oGi0OMAhyMSjy8HHX7 AoVYE8uKK3MPMUpwMCuJ8MZOBArxpiRWVqUW5ccXleakFh9iTAbaPpFZSjQ5HxireSXxhsYm 5qbGppYmFiZmlqQJK4nzHmy1DhQSSE8sSc1OTS1ILYLZwsTBKdXAqPN29u9FzrJJ+2o6Zv1Z 8q3i7AX+L+e22y3Mv8C40MrUwMnz+FWhjL7eP+t/6MrKsotEyuqFX3tit8d628bem9+rlM/N 7N7heyXDKdbpv0Kx53n7iJvK7y6XiV+XWS+txFLrbPL6rJyp58s8q4zrISEGrIzSe0441KxK 4g08wMlkusdnxpJLSizFGYmGWsxFxYkAETAa9ssCAAA= DLP-Filter: Pass X-MTR: 20000000000000000@CPGS X-CFilter-Loop: Reflected Sender: linux-samsung-soc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-samsung-soc@vger.kernel.org X-Spam-Status: No, score=-8.0 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_HI, RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP This patch adds examples to samsung-pinctrl.txt documentaion file on how to make gpio binding and gpio request Signed-off-by: Leela Krishna Amudala Reviewed-by: Doug Anderson Reviewed-by: Tomasz Figa Acked-by: Linus Walleij --- .../bindings/pinctrl/samsung-pinctrl.txt | 44 +++++++++++++++++++- 1 file changed, 42 insertions(+), 2 deletions(-) diff --git a/Documentation/devicetree/bindings/pinctrl/samsung-pinctrl.txt b/Documentation/devicetree/bindings/pinctrl/samsung-pinctrl.txt index b2bc219..72e9cd1 100644 --- a/Documentation/devicetree/bindings/pinctrl/samsung-pinctrl.txt +++ b/Documentation/devicetree/bindings/pinctrl/samsung-pinctrl.txt @@ -25,8 +25,18 @@ Required Properties: - gpio-controller: identifies the node as a gpio controller and pin bank. - #gpio-cells: number of cells in GPIO specifier. Since the generic GPIO - binding is used, the amount of cells must be specified as 2. See generic - GPIO binding documentation for description of particular cells. + binding is used, the amount of cells must be specified as 2. See the below + mentioned gpio binding representation for description of particular cells. + + Eg: <&gpx2 6 0> + <[phandle of the gpio controller node] + [pin number within the gpio controller] + [flags]> + + Values for gpio specifier: + - Pin number: is a value between 0 to 7. + - Flags: 0 - Active High + 1 - Active Low - Pin mux/config groups as child nodes: The pin mux (selecting pin function mode) and pin config (pull up/down, driver strength) settings are represented @@ -274,3 +284,33 @@ Example 4: Set up the default pin state for uart controller. pinctrl = devm_pinctrl_get_select_default(&pdev->dev); } + +Example 5: A display port client node that supports 'default' pinctrl state + and gpio binding. + + display-port-controller { + /* ... */ + + samsung,hpd-gpio = <&gpx2 6 0>; + pinctrl-names = "default"; + pinctrl-0 = <&dp_hpd>; + }; + +Example 6: Request the gpio for display port controller + + static int exynos_dp_probe(struct platform_device *pdev) + { + int hpd_gpio, ret; + struct device *dev = &pdev->dev; + struct device_node *dp_node = dev->of_node; + + /* ... */ + + hpd_gpio = of_get_named_gpio(dp_node, "samsung,hpd-gpio", 0); + + /* ... */ + + ret = devm_gpio_request_one(&pdev->dev, hpd_gpio, GPIOF_IN, + "hpd_gpio"); + /* ... */ + }