From patchwork Thu Dec 27 12:35:22 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lars Povlsen X-Patchwork-Id: 1018859 X-Patchwork-Delegate: daniel.schwierzeck@googlemail.com Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=lists.denx.de (client-ip=81.169.180.215; helo=lists.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=microchip.com Received: from lists.denx.de (dione.denx.de [81.169.180.215]) by ozlabs.org (Postfix) with ESMTP id 43QVWh2W40z9s8r for ; Fri, 28 Dec 2018 00:08:16 +1100 (AEDT) Received: by lists.denx.de (Postfix, from userid 105) id 09147C21DCA; Thu, 27 Dec 2018 13:08:04 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on lists.denx.de X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=BAD_ENC_HEADER, SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=3.4.0 Received: from lists.denx.de (localhost [IPv6:::1]) by lists.denx.de (Postfix) with ESMTP id E79B0C21C3F; Thu, 27 Dec 2018 13:08:01 +0000 (UTC) Received: by lists.denx.de (Postfix, from userid 105) id 5CE4DC21C3F; Thu, 27 Dec 2018 13:08:00 +0000 (UTC) Received: from NAM05-DM3-obe.outbound.protection.outlook.com (mail-eopbgr730074.outbound.protection.outlook.com [40.107.73.74]) by lists.denx.de (Postfix) with ESMTPS id 5A076C21BE5 for ; Thu, 27 Dec 2018 13:07:59 +0000 (UTC) Received: from BN6PR19CA0085.namprd19.prod.outlook.com (2603:10b6:404:133::23) by BL2PR19MB0723.namprd19.prod.outlook.com (2603:10b6:201:1e::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1471.20; Thu, 27 Dec 2018 13:07:57 +0000 Received: from BY2FFO11FD019.protection.gbl (2a01:111:f400:7c0c::174) by BN6PR19CA0085.outlook.office365.com (2603:10b6:404:133::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1471.20 via Frontend Transport; Thu, 27 Dec 2018 13:07:57 +0000 Authentication-Results: spf=softfail (sender IP is 208.19.99.221) smtp.mailfrom=microchip.com; lists.denx.de; dkim=none (message not signed) header.d=none;lists.denx.de; dmarc=none action=none header.from=microchip.com; Received-SPF: SoftFail (protection.outlook.com: domain of transitioning microchip.com discourages use of 208.19.99.221 as permitted sender) Received: from AUSMBX1.microsemi.net (208.19.99.221) by BY2FFO11FD019.mail.protection.outlook.com (10.1.14.107) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.20.1471.13 via Frontend Transport; Thu, 27 Dec 2018 13:07:56 +0000 Received: from AUSMBX3.microsemi.net (10.201.34.33) by AUSMBX1.microsemi.net (10.201.34.31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1531.3; Thu, 27 Dec 2018 06:37:18 -0600 Received: from xrelay.vitesse.com (10.9.45.188) by ausmbx3.microsemi.net (10.201.34.33) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.1531.3 via Frontend Transport; Thu, 27 Dec 2018 06:37:18 -0600 Received: from soft-dev15.microsemi.net (soft-dev15.microsemi.net [10.205.27.48]) by xrelay.vitesse.com (8.13.8/8.13.8) with ESMTP id wBRCZRB8000380; Thu, 27 Dec 2018 04:37:02 -0800 From: Lars Povlsen To: , , , Date: Thu, 27 Dec 2018 13:35:22 +0100 Message-ID: <20181227123526.16109-3-lars.povlsen@microchip.com> X-Mailer: git-send-email 2.19.2 In-Reply-To: <20181227123526.16109-1-lars.povlsen@microchip.com> References: <20181227123526.16109-1-lars.povlsen@microchip.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-Matching-Connectors: 131903896762897906; (5a93feec-e11d-4f7b-166a-08d09f1f276b); () X-Forefront-Antispam-Report: CIP:208.19.99.221; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(376002)(39850400004)(396003)(136003)(346002)(2980300002)(189003)(199004)(37524003)(69596002)(68736007)(316002)(498600001)(47776003)(336012)(76176011)(6636002)(26005)(77096007)(305945005)(446003)(48376002)(2906002)(97736004)(2870700001)(50466002)(126002)(2616005)(11346002)(476003)(81166006)(50226002)(81156014)(8676002)(8936002)(110136005)(5660300001)(105596002)(44832011)(356004)(6666004)(5024004)(53936002)(86362001)(36756003)(106466001)(2201001)(486006)(1076003)(51416003)(53416004); DIR:OUT; SFP:1101; SCL:1; SRVR:BL2PR19MB0723; H:AUSMBX1.microsemi.net; FPR:; SPF:SoftFail; LANG:en; PTR:InfoDomainNonexistent; MX:1; A:1; X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD019; 1:9BQlBegdlC257i/O/BeUhA4PEWUyhdv3C90oKJtnZaqVmViSp/YVURpqVtTK0r1d71CpF6AGFhfkiqCBiJbcmBDoQ9ZcdkNcnJigJ6EhZMzpic3AznV3uLmehahk7Cpq X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 03103a2e-b197-4e4d-ea19-08d66bfc5175 X-Microsoft-Antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(5600074)(711020)(2017052603328); SRVR:BL2PR19MB0723; X-Microsoft-Exchange-Diagnostics: 1; BL2PR19MB0723; 3:V+pBrl0TNzCO3gPenf8J64KOmWL4Bn3rKtKWTE01AspU3sQH4l5Tfj3eNHBgOfH6f5zGx+B5BY/Y2Mi+X+aHEDltTb4AhF2NpNymGRGt16eJfv9pAcgMWws/EGLbKJNwWRsG8Qem9E0+icLEHlBgcWDrUATS1orqm70+IeIEgDXNYodItNJwSAZikqq72TuJD5uIYiiJIfbwth9z64in+QcrxaZlEkuVGoRrAAWqkjFNaDJWvGY6z38MVpR/P4FZI4Vk6C6pvYDTWsb5j6eiC4TqzWQh6wZQbGGacj7Etxhn3dSHHhVjOrIK/QYZmC8OhKwSDLrZTtsh4WX8HMDXbSoxdp7/7RTxb1BBOsjm33s=; 25:e7ADJ1L1cWbRVLJNK/BY1AjJA128uMzMFR00/7GzDZEQIWVWSc9leFdO070XiuVlvH+UZe1DIgbwR0dZ56D3U6mN9ar9LvBN4Trp83YOkis+WOlb0yBcaTD1lPYusSVyCuU5gvFiq69X2Ic9/vx+ShmoXDuPEwutNyMKajwS3/So6wrBEkoo03XDRkmwyOG3iqP1PIXt/BF9l8dipuyxkFsM58y+bd8fWFJ7ERptKJ8i7YY8y2sfDcm0Xp08rjR+YaDrNl9bfv1P8iNqgqH3JuUky/nOwm+Kp9ui8MHzxuCp8zVLkrTUt3Xnj33EynSV68apj5WTczEs2Pe31LkURA== X-MS-TrafficTypeDiagnostic: BL2PR19MB0723: X-Microsoft-Exchange-Diagnostics: 1; BL2PR19MB0723; 31:T2wbiz36LUbRH4ZuLMzuJyjZgrIDBkKPTsL4iF7JLiciAw6Dh61AUEUii4Nb2p08CQsZMDr6Cb28RmbgKKZImE2E40h1cNZ9TLCnBdMZsGi5QaFhjU+fLbuRlj+mfv5KmND/6GitEG/9qxU54rUadvK7q90lIRPR4XaVe9sXOrT8NVTy4s+LfKm5wx4YFkabl1dbAn303uZ22Zmw3pOEIeC7dmZjP5Gaq6lgfQk3oeg=; 4:T7K8KNHyVvJtSwrlla86/hwVthqaoRAEHBG7dIUW+dqAtZ/osB98EVcRj2uzKbR+zy2IzH+joMtJ8iOrmQ4GIyZOkbKojKVpHFqkeWGd4Fszi4oSl9VKBmth6JTJtxjH11hfS1xjuWBbAhNWo4QtFAgbBqWxBmiKTs0siN+w/7dSxQGxVsnsZkgbqlzI8d5uGbiZNimsXdmtNNoeKaEkEFy1SQLdePhH7ENUpC33DF/B75ja24BynSpmEND1nJJd5a84d579v2ly6y0f7Ij+SA== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(3230021)(908002)(999002)(5005026)(6095135)(2401047)(8121501046)(93006095)(93001095)(3231475)(944501520)(52105112)(3002001)(10201501046)(6055026)(6096035)(20161123565025)(201703131430075)(201703131433075)(201703131448075)(201703151042153)(20161123559100)(20161123556025)(20161123561025)(20161123563025)(201708071742011)(7699051)(76991095); SRVR:BL2PR19MB0723; BCL:0; PCL:0; RULEID:(400006); SRVR:BL2PR19MB0723; X-Forefront-PRVS: 0899B47777 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BL2PR19MB0723; 23:o6BQQwJH6JR0RpVsGCncCvSuuOFUJVMaLt/rQT3mJ?= MRrl+cgDJi6ms1KrFZsAJ/BAzDg3ox/66mYnJoL6NSb4pFr0fPV0UbnTsZbg9Wv1CwK1Fvebw2eseC8jlMCCTON5liVUBG8rKU3EKPag2Y8Zm8JHHENiyB7sLaGIOdUQxuzED/GW4Rnd2BQewzkIVDQdrUq+Mjio1KclCHpxOHEY9zgw1RzkLh97eXjada+Ng8xDgrn00C+1AT8AdSUXOmWKOjjgVr1Ymw/4g5cGQ5AUv4CAcsxV/5XofJ3BThL0uQaEiybdIQARcpezjpKCH/ux13C84B4NQjdrQJrAfakYsJ0O/mi4ziLQYNX78yz3oip1vAVg/mkFBeuLaYj0WVn6aiDhgzEnLn2oC1Bh/7+Oc+2gRFtmX7vis5g1pepOzXSYtrisndC/xS3h9LF1F/eISQxsKM6zrUwSjKSgijv6N2OdlSfMD6bnc7hfs5bNi2dnQ4LMN4Gmji8j/v3K8Yq7vtXgRh6Zi73AtxP9dBuCy9q4tyD2/3k++9TwZL+s2nqFFz3YpGsF94m6OTG3fA+YLsCxcOq/o2aCuYvKKQzwSx+EJFE+az5QaaEtzXxgEvCy3d0m9Vlpu/gAD+pL+nbS0r/pDXYztY0dwkepGXtljydqM82xCxReunlNU4hWJgJ7dOV9StqzJQp+i7QmpTcswfEfQNfGLMPbRsI5tycw2cEg4UwA4cHqSIG47bCsZdVIPPRxYMOFdnsOGnQhKjjcVhBBL1UfO3tOjtS1+Sjp4zAbNRgTES67bgxAw4y/36QIcRvwzM9U75OfHBkAYpFoaLp27mpd95hCKuueTxmWMEZwm++EMvh8x9btOvBJbuwD6V+poKwge7neZhUUaV6yKLCA3PQMwGg+i2mE2JR2ZAFTeJBtLJiPRl47JT1Liyo3kbd5SlvdejFxKb3XYgcnjCkjCCiFLSM9Uu8cw4UpEDIAquywk/HMgfqjNM98swJXh15GZfh7lzmviPWBhxgfLXgg6+ucNJkszFw0O6sZTvQACwNU9vv9HaHQO7rpK+spLwEVGX/Z3eyPQpDdPn78WPhuGMAkFt8/8eCe1nxltHM1Exh0avjY6JNT3uQFOlIPwUGDWob8g5DQDOYQNyaahzsMfCd/cjLOaiLPPI81w== X-Microsoft-Antispam-Message-Info: Q1WvfUNHMVHXphtPt02aJjjs3uKjSKgnsrATxDTGrFbUUProWC7vAqbi7gbEMZh8cYh9SygAJy1XXAUXYgzsioAzuJX7JIi+uvivbxVb5iw7nDQpyskPXVatX6iT/72FjVf+ZEqM16v2kQ5ERBJESdIj0qoGUC2TvRUAIDw1G2FeQnNLJBMIJvln/CefHmt37I8pkBamCz0S+PNY38aPeV5hLM4xFbVRXxHjSunug7YZeSUQ6chWLyXtP8zG+ND7H3TXuDWm29rdSdC9i33JYzgwtWwe+GnFlRjSKWBxkK60TQdquD9uJeAAjXqMprCw X-Microsoft-Exchange-Diagnostics: 1; BL2PR19MB0723; 6:nUHXnQ5zkr3KMH3UIGPAIrQ/XzWctrzSvohPHPfb+le/r0hGuhKMxp5zeePyPCDboR2NSIXGdLCcZmmjVoN2iJmDVzLRbgghvjK/mv9kU0h2CcMYBZRN58Fxg0h2yrSKBbUdm1sVr7ahASYZc9J6+CqVmCDfyt61EQ04tg7UhTfsXpL6Qw4SyYTKkjLaOKXEka2yop2FtclIxIwF3v+lj4bfaR2yuqmXxTa6qfcJ0v6CdUW7wEH39owa7pEhy8S93yAkoT8L8U5shiUg2kAxvMbb8dLWIzP1uSTj4erI5yiFZp3SM7fRUlqqrhQH5CnlRj8umEE5x7gHITj25GtumguwR4VyUx8bHJTjTC5SoK1qL2ueuYtjwYI9R5t+mFGwVk300tG6j0Pv5oeYxvEcml5wRmpZoy79kt3fZtFqWbMzUSuVrGdP4KW1VR03uoJfJr24Q+9VGFBilCM9wEQwoQ==; 5:5Y0xub+BsvPcHcLIgxjHgzCWJ37vDdoDdtL7aek7YVOgNYq/me7tm0/NMtr1ov2fwC0gr7KRWulVKdcsJWOZ65dQw/BL+Qbj8KBtPEjRbfVRRoPUkgmX745hWaB+czt3tvy80nt3ijk1TGcF8411yBdm0xwFnI31Aba0Q4TCHtc=; 7:8aw8G5a2zHX5M5OlhlxRdevWOXSy7ExFGQFXaFUCHbXl6qfDqEAxsoIoYIYEkZN2MYJGJgzK+JsBe2Kb5F1sY4jqTeNI80BTWpIvp2dInxYV+RDSdFjB9svx+u0TkkiszsDn8X2uA11GxUUoONqbAw== SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Dec 2018 13:07:56.0554 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 03103a2e-b197-4e4d-ea19-08d66bfc5175 X-MS-Exchange-CrossTenant-Id: 5afe0b00-7697-4969-b663-5eab37d5f47e X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5afe0b00-7697-4969-b663-5eab37d5f47e; Ip=[208.19.99.221]; Helo=[AUSMBX1.microsemi.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL2PR19MB0723 Subject: [U-Boot] [PATCH v2 2/6] mips: mscc_sgpio: Add DT bindings documentation X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.18 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" From: Lars Povlsen This add device tree binding documentation for the MSCC serial GPIO driver. Signed-off-by: Lars Povlsen --- doc/device-tree-bindings/gpio/mscc_sgpio.txt | 45 ++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 doc/device-tree-bindings/gpio/mscc_sgpio.txt diff --git a/doc/device-tree-bindings/gpio/mscc_sgpio.txt b/doc/device-tree-bindings/gpio/mscc_sgpio.txt new file mode 100644 index 0000000000..2db2d277a5 --- /dev/null +++ b/doc/device-tree-bindings/gpio/mscc_sgpio.txt @@ -0,0 +1,45 @@ +Microsemi Corporation (MSCC) Serial GPIO driver + +The MSCC serial GPIO extends the number or GPIO's on the system by +means of 4 dedicated pins: one input, one output, one clock and one +strobe pin. By attaching a number of (external) shift registers, the +effective GPIO count can be extended by up to 128 GPIO's per +controller. + +Required properties: +- compatible : "mscc,luton-sgpio" or "mscc,ocelot-sgpio" +- clock: Reference clock used to generate clock divider setting. See + mscc,sgpio-frequency property. +- reg : Physical base address and length of the controller's registers. +- #gpio-cells : Should be two. The first cell is the pin number and the + second cell is used to specify optional parameters: + - bit 0 specifies polarity (0 for normal, 1 for inverted) +- gpio-controller : Marks the device node as a GPIO controller. +- gpio-ranges: Standard gpio range(s): phandle, gpio base, pinctrl base + and count. + +Optional properties: +- ngpios: Set the number of GPIO's actually used. +- mscc,sgpio-frequency: The frequency at which the serial bitstream is + generated and sampled. Default: 12500000 (Hz). +- mscc,sgpio-ports: A bitmask (32 bits) of which ports are enabled in + the serialized gpio stream. One 'port' will transport from 1 to 4 + gpio bits. Default: 0xFFFFFFFF. + +Typically the pinctrl-0 and pinctrl-names properties will also be +present to enable the use of the SIO CLK, LD, DI and DO for some +regular GPIO pins. + +Example: + +sgpio: gpio@10700f8 { + compatible = "mscc,ocelot-sgpio"; + pinctrl-0 = <&sgpio_pins>; + pinctrl-names = "default"; + reg = <0x10700f8 0x100>; + gpio-controller; + #gpio-cells = <2>; + gpio-ranges = <&sgpio 0 0 64>; + mscc,sgpio-frequency = <12500>; + mscc,sgpio-ports = <0x000FFFFF>; +};