From patchwork Mon Feb 6 09:13:34 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9557263 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 16E8560242 for ; Mon, 6 Feb 2017 09:14:59 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id F066A205F7 for ; Mon, 6 Feb 2017 09:14:58 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id E36A827CF3; Mon, 6 Feb 2017 09:14:58 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=2.0 tests=BAD_ENC_HEADER,BAYES_00 autolearn=unavailable version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [65.50.211.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id BD022205F7 for ; Mon, 6 Feb 2017 09:14:57 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1cafNv-00058R-5P; Mon, 06 Feb 2017 09:14:55 +0000 Received: from mail-cys01nam02on0063.outbound.protection.outlook.com ([104.47.37.63] helo=NAM02-CY1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1cafNk-0004Ya-NT for linux-arm-kernel@lists.infradead.org; Mon, 06 Feb 2017 09:14:52 +0000 Received: from BN6PR03CA0021.namprd03.prod.outlook.com (10.168.230.159) by DM2PR0301MB0735.namprd03.prod.outlook.com (10.160.97.143) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.888.16; Mon, 6 Feb 2017 09:14:22 +0000 Received: from BL2FFO11FD049.protection.gbl (2a01:111:f400:7c09::165) by BN6PR03CA0021.outlook.office365.com (2603:10b6:404:23::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.888.16 via Frontend Transport; Mon, 6 Feb 2017 09:14:21 +0000 Authentication-Results: spf=fail (sender IP is 192.88.168.50) smtp.mailfrom=nxp.com; nxp.com; dkim=none (message not signed) header.d=none; nxp.com; dmarc=fail action=none header.from=nxp.com; nxp.com; dkim=none (message not signed) header.d=none; Received-SPF: Fail (protection.outlook.com: domain of nxp.com does not designate 192.88.168.50 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.168.50; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (192.88.168.50) by BL2FFO11FD049.mail.protection.outlook.com (10.173.161.211) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.888.7 via Frontend Transport; Mon, 6 Feb 2017 09:14:21 +0000 Received: from b29397-desktop.ap.freescale.net (b29397-desktop.ap.freescale.net [10.192.242.114]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id v169Dq2N005959; Mon, 6 Feb 2017 02:14:13 -0700 From: Peter Chen To: , , , , , , , , Subject: [PATCH v12 2/9] power: add power sequence library Date: Mon, 6 Feb 2017 17:13:34 +0800 Message-ID: <1486372421-29073-3-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1486372421-29073-1-git-send-email-peter.chen@nxp.com> References: <1486372421-29073-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131308460619496582; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.168.50; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(7916002)(336005)(39380400002)(39860400002)(39840400002)(39450400003)(39410400002)(39850400002)(39400400002)(2980300002)(1109001)(1110001)(339900001)(199003)(189002)(81156014)(2950100002)(5660300001)(6666003)(92566002)(81166006)(50226002)(106466001)(189998001)(8936002)(105606002)(5001770100001)(97736004)(8676002)(104016004)(33646002)(2171002)(47776003)(305945005)(356003)(77096006)(68736007)(38730400001)(53936002)(54906002)(7406005)(2201001)(86362001)(5003940100001)(2906002)(39060400001)(4326007)(7416002)(8656002)(76176999)(626004)(50466002)(48376002)(85426001)(50986999)(36756003)(2004002); DIR:OUT; SFP:1101; SCL:1; SRVR:DM2PR0301MB0735; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD049; 1:S9LpwwM1KBhPVnv+5XTB2g7IFtuVcFgvNOn+GEy0LAsVimcIoT8mhpUJX3vCVT3qr5oNROoBToq+aHlzQiZNwYJTZx5YUbEQDCFHcNHQ8+AVjhFGU7MzrcsK+KMIwmxN+E4VQm3ARSomC2WiAKTXiSOXquDE0Gb9Bc7B6i7gwcW3WkWGluZ0XCe08JdSLZHiQRNrHQ2HzEFrt0DicrVBVCMtntEqibSMMK/lbg9ttpoobJWPsYMiVIY05rN5YnlVDAH/At3xnjor7pPuzPi1MAw0SlqnJJXtPYdAKMI0vn7/R+EduWJiys0wKRcL2Ha7mmvbLWQn6WGbR/mjdZmvqRZtWwVJCB4+Jc33HtDEuK2+Krm6YRGBhtFEyV4Ymckf1NCHjsQpeZnOGUB/+77vLQnmEgLinjNq17W5TSV4I3F10iG6Jd6+3mS4CBiU/n3QPj3+bNLtM3WKMqFEk9covxAVzfCPLXwHa5zpqSEcRnD5QK0S1iRh9R+WrS3nEIFHy+OrjZWU3f5QRKfTNBHCgpBNwQZ7Z9YxtJpT6hPoVKhoQWr2g0FDBOlkwszA/3hRee+MHScovSbZmoFhw8vo0E5GmjWhpu5T4BZbW1i6jqZ0HqTrbNH86B8D7K4Rb69jj4xRZvO0O8gBy+apPyoyNVIsbjwXvF+tYCfyh14KQBWWtiIfL2td2l4XdLGc4kOJRGXkjti5EmaU9kCm2qvePXCqtgLhJJ9gP1r0KTCr2Vi/7OYLY66k5VWtJgIWQNztjaqXsH6A6AlX75vhb32Eng== MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: f7aa8fe5-650f-4494-1041-08d44e70899c X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:DM2PR0301MB0735; X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 3:/sVKZvAFs85MFsvLaTV3fo1gFrSwIlNTfsjkqTdRAPjSvsM9eajFcxgeeTmG84KohHSpV0Pl2k84y+PIbA9e+T6fBigIwDk1gzRuf2WsdGTJdJZaMfFXXw7YPQWLR2+4/NKNNE/9h06waR8+9jM3udq3kFFhoBUUHXBrVNX2W+FsyNN0DcVOJoTHCXlMrn4mWpX/rCtSFjmDK9hjFKsVLaSZ2h+rZvjy3oagWPh7DWdahNnlFKZuWLJXuMT1dxQeVu1rpbfwLWguSUr9op88PYSSoB/qBABsBuIMtml+B3AWc8Ocb1bpo7Sl7U7hZx5f2jpPbCtyO4yKk7+vgMaeWxVDQMvy899DKrV+wB/TXutauij5Sgqe6CdGlBIUtt/M; 25:MfHFLQRO8ILwm7V/20K3h62wHrqisANC/edub2nLbv1d3wuzALPQHqEfTXWIUFXNn7nuYR2+pD/Nxu4LfjxiNqWg/lZ4vZ8mHiCqPzjHXFzQvIcYWqihG8OB3h+XlBilCEqKMksVNQ3O5nlh/gltWSAsymxmrFP27DcCxHB0UNAGEe99xxU958z5iV3ZGvYdvIe42SIFrTxz6BcnDpWbYOvnquZrPV6IGkHHt2tdNLht/CUS/hdj3jpYjoWKx6j7mjLOo+mDAf3FbhJvAvxGZH9HvjiR0QfmH1obCrooyI7rPzgftTj7qJcyi+aAj3KGwvOzwczvia89uCpd9lsR2veWeZ0MYEcIZPAGJeKoAYqH010L2hSFFYQAuMqNV981eph1/gtKuvG/eRyo50ZwX3ybAack0gmxVu4o7huNwGXOzvfSiwlmMr3/qEEo5MeLO6T1pjMXWsiPrkgSQciifQ== X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 31:ogX39gvXcFIUQAJ+LCUJMyLJNy9qwkyYOsrJZdFkx5b5U1TsNncDdxK7//PJppkuawB0F43yfaUs1MTKv7h1cvHQGgQau9BuWjpn+a8/YummGlLm1r2Lzdtc15C2ofk4PUkBdry4/XqVHkYVS5ZZlic7Ghrrw0w+4lBMeoC1cBHqeaOu2F7bKvAodyGAzCmkI6Hlyav9cdvicxS9KQ9PvnkgRqaG0mbst9aIUcBlqWkcF2Pl1YIwBmLd6GCblOitm6NrUNRVAvFWyEQ18ek9GA== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(9452136761055)(185117386973197)(84791874153150); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6095060)(601004)(2401047)(13018025)(13024025)(13017025)(5005006)(13015025)(20170203043)(8121501046)(13023025)(10201501046)(3002001)(6055026)(6096035)(20161123563025)(20161123565025)(20161123556025)(20161123559025)(20161123561025); SRVR:DM2PR0301MB0735; BCL:0; PCL:0; RULEID:(400006); SRVR:DM2PR0301MB0735; X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 4:I/C0pgZ1JzqWcDVFKCmQg2sVPVdDhHDRlQqDktYPxpEVlzwCy08Z2zYcDNvkQgUuvI2tr66kvalmPvYLiLj0OmegUpRk+g06l4hx+31LKf6OUah2LZ0snqZ9zGCgEsBvNbDZkuOqiSbWYY6B3nEd++CBUX2AOqnYQCv/RB+O1868ddoKcN/3XGDGvT+NDnzlhPdbtnnrlNu7NfDCnJKcwseYUtRKr/aj97iZdRvpOQK0k+nVwXF/2+nroFlVjj28EMlFubRTmVptl/b0drB+/hY/TZys2MRpVKaINHJsoWoECvXsy6VfdDEVOvKq+4dzHDzBDRektY+XKcSqVnpcg07f7NpAXmiMyt/10eeeBtZQ4Y6ddCvxPdFYB5TA/ZhNgEz9QZmeGI/3ha1mzZnG3EzQevvyY4HdAGSDY83jQns4KHup3Po8qyYF0kygzPLib9K3eVZeHMNmVix6Uuc2Cqy6BkDc6fqOdiVRE7rVzfVpfGMEUvATHUhjh/idhkXsjZ/Kl9Fa/gtCoyUjt5bRCd3yFqG+6OANowWJMAIhDGYXIDa8GugZWVF52WX3NL+P4yal2DIhhd3V1NflvG52pQeyDFT6Y/ZrfUlE7pcvyEz+YKIaWNCHXdmENS7a7jRBovY6hBP4O1bw5CRVYxxClm7+RWL+HBIkUoJg5lxOTsPLFxgJfjJLhG7DOdTBnS3kVTQr0p5yW1RfhIcof5vnrxx843p9rTUvk3RDpudHaSOL/x4q8ijCOyLsvpz4ZhnvYW3mX4CGQg5ia5e1IS8iLmFUmshLfnU6fjwTnGdEOTPFsd2AaoLKZfePYKOslYOQzh4D5gEyHIJz9WSQNNEU5g== X-Forefront-PRVS: 0210479ED8 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM2PR0301MB0735; 23:w01rWdwt+dFLjhlwwSHy2DOwKk6K4dGBeryOeQV?= =?us-ascii?Q?Kh43vcZnHobORWdMURAbn6DpVLziUQB/Q0iLacrmX8fMaCb55IRzzphbuO4D?= =?us-ascii?Q?vorDETzPB9aWiopgv9200o+KS1fkWIUA2OwX6tc6wGkRrIhmqv6vZUUkT4J0?= =?us-ascii?Q?y67/jnWhSGBdubT6m+gLmAP3Z8ealiG9mMDPOXEBTEmwDXZEe5orWK609zJJ?= =?us-ascii?Q?U5WvwbrjqKM0w4Bt8H0hSwzZxe4M+vjebOTQgCtLUFvEheO/q5ZlXsRzKR6p?= =?us-ascii?Q?v/KrI7FmDur7p5BjZCZFwlAqODQMOQk2uDPgIa3UZvXdrm2ZufnVazYPrPYd?= =?us-ascii?Q?5P0ea3mpoYIm/DOv7GsRcDTKrIyEUzzQ/W1K03Bi+GcXVdn/MPrHAbwzQabM?= =?us-ascii?Q?t23tSaRTezb50BzIyh4ZU+u8qtBZnJyz/eapVYW7LJDfJGkRbMd28x2QUouK?= =?us-ascii?Q?4psjZc3Gt6PhXaOyzVMP9T9ks2NodFTB2dQItXCgMmcTNLVIzv+c0d9AeEVT?= =?us-ascii?Q?Qj9acuqARJpg7A/vd55MVG1lxvpcfXb/j4wzmHl2F396SV7m11uLTYJ6ZazR?= =?us-ascii?Q?jN6hY/mvhlHFCQa5zS1MJDekLmK3tRpfXbcu+EYrhkT6SYNbaXOUQqiEmN27?= =?us-ascii?Q?omPSxm2QYkxxMcQESNhdEVTtf7GTQiwkOHrUbvqlc4JUs8EH2eECDzo9/0Y4?= =?us-ascii?Q?7C7STpLCtbGfCfOCy5yMh/qSeLJOLqFD6Kk+Md4Z993OBvO4VXWjL0a4hiNt?= =?us-ascii?Q?77hCnUhKJSY95/Q+VSBVfFeiF7Z68NHVsgzfBLJZJMIyIMUViKTQ+bBWL7QG?= =?us-ascii?Q?w83LkJaX7WXiNZ+Hgb1T6tWJ2U61KnM64qrFq+cf2NN0aHjVgXmm0eRFNlPa?= =?us-ascii?Q?dcyKvlP0ENcaCbPTf0BulJP3N1nBewnbWEBjciAWrp4y7q5h4fcpm4Zxv9/3?= =?us-ascii?Q?/EMVurzURRsi1vnrM8GR/pJF+5mwRxnk6bYOmXgEIThOf9GXjHB8vgopxsBi?= =?us-ascii?Q?C+/s9dPg33jgTkYE3UB4+or/LYyEUj+P3yb/aJJma8U6ZJtP9QXutPZ55vcM?= =?us-ascii?Q?0pItvgx9eXuunQw1T8vzRgHyxOnbUc4ueFxGI78wFFzHf7ZV7NZt8BneJVqE?= =?us-ascii?Q?HA6eBZHDAgzKVrPoQjza4tb1Laz9mbOwqXN3sveFAt1Atty9p7JEibtInrTS?= =?us-ascii?Q?6zJg6LXPaX1XB0GOlflVeEtmSIhMbc2sHBrWVoThm1zJSiEHbEnkFn3P42zD?= =?us-ascii?Q?Pv8SWMKjhmXVWGkBwMnr2/QwVJXD5I6xvys93+UhqxapWLJ5gIx27HVFclOx?= =?us-ascii?Q?GzjOrdt3OwKUt7JJlRiMu7h3bNUN2o6p/piiPI+aJnbg52+Pk3zgRyMiJ0Rs?= =?us-ascii?Q?yFSPYG11TEvFH6QwnjVUIV2mI8NRAJwda90g2s44FoBmjM8mK?= X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 6:6yCjNzvXbqUw4cSk3/++Ui6puxMSv7d/vpNkLXO4gmTZiioRR4YXzXsmEo5sIWKtWJcLKaO68JT1Z+SAz3opYgOsPly/IrwrVSHS7/dtIbYO7uUm1RXAZD4x8q6szJ7wF43HoGvCl/uvh0stqbEaWTeXe0i7cnGbTip3utArymXEPM3udPcbP7d0mJ5l3xWmE31lDGpMMjvzNxd5E78ZfcqdIzrG7UpOBa/7QxEzxDVDAt47c3ZIPO9t0bJt2jB5CNX92KwnIdJ3mtmtS6m7UcM5AQIytK2ixLPHUlaRFoxO/njpuBxWlhzlDKtjdTa+jwFn1i4J6FRU4g0tzgtwLI0XYWMfPBNw4GC1KajgtNB9tSyJ06T3FIrg0WCjspZ+hHE1s4utZ/hWjtQGk4eUMhYldXv5JQm2VTi4R4zQgX8=; 5:g8c+idCzXFuTTs+fuGc4z9LwOU8cISZfMoY0FFOBbGK8Tb4Dy4xSDP9RgQhRwqeKgXO6siD0ZcrOM/uv5bkxlB/1bTT70/ExEB1V4FOYsUbEw893avmboxwhOEzw9qkmjKlQO0Jhg2wZvCQPu4KInD5u1QC0PkTFpfm7BnmxnPYxUMCIBBLA+EjWRCLCDwu1; 24:jGQ4usl65FWRpPjsmaUs+K01ZY77i/P8sw5CpQnT3ABXkNCjQEZ/+Q7P2HaNK5AbIpj/dDkzXhCaCnkJ8gRQ8qs9g+VlrL4MSXQ1MrQkwMs= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 7:3wxQFz24jPEiteW9rC9SUOypVGw5TOtlf/9m4ZXj6apR/OIdl2CHVbp5zbKKNWS7lcZqEy1hntJkjQkcs1AlepujQ+l9NtI2sp9if5RvebIaAVjibPeAp5kjNnYx979+MBZ70DZGTFemD1uFlvzH5Uq7V7Q2q60zLHBsjNyZH8z2O+zFVm3dL7ZEmLN56j+6ze6oO8yuZMn6sjjjeTuUsDjlwVoNB5coGKUzqQoUsva7Et+aToOMeQ3AmvGFbayS9e3ILfwWYhqMZ4HMRn3jdCHUaTHgJq+ow6pjmpE4cyoyQnnewYsGBEIcTYdsy1WAvX3W6We4FFjvY7TF35Xz0ZNbqBh5WFh6OJ2/F2JSSiBBf7LdLJlrlSUXfslXK/Pck6/ars1vEbZsMHXchf4R49Bs3Q/KUdaRickg4CNXviOSrHgQcq6foQw6CU+UNHygnl4xSLSKi3oCeAR3EhkLONcVEeqxHrgKGVRt0tcAlLS95hKpBZzd07hyWYRX2+T2e3r1BLZO6tN4lyepsE9Y+w== X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Feb 2017 09:14:21.4348 (UTC) X-MS-Exchange-CrossTenant-Id: 5afe0b00-7697-4969-b663-5eab37d5f47e X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5afe0b00-7697-4969-b663-5eab37d5f47e; Ip=[192.88.168.50]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM2PR0301MB0735 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170206_011445_311971_D7258ED9 X-CRM114-Status: GOOD ( 19.24 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: mark.rutland@arm.com, Peter Chen , heiko@sntech.de, stephen.boyd@linaro.org, gary.bisson@boundarydevices.com, festevam@gmail.com, stillcompiling@gmail.com, arnd@arndb.de, vaibhav.hiremath@linaro.org, krzk@kernel.org, mka@chromium.org, devicetree@vger.kernel.org, mail@maciej.szmigiero.name, pawel.moll@arm.com, linux-pm@vger.kernel.org, s.hauer@pengutronix.de, troy.kisky@boundarydevices.com, linux-arm-kernel@lists.infradead.org, hverkuil@xs4all.nl, oscar@naiandei.net, linux-usb@vger.kernel.org, linux-kernel@vger.kernel.org, p.zabel@pengutronix.de Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP We have an well-known problem that the device needs to do some power sequence before it can be recognized by related host, the typical example like hard-wired mmc devices and usb devices. This power sequence is hard to be described at device tree and handled by related host driver, so we have created a common power sequence library to cover this requirement. The core code has supplied some common helpers for host driver, and individual power sequence libraries handle kinds of power sequence for devices. The pwrseq librares always need to allocate extra instance for compatible string match. pwrseq_generic is intended for general purpose of power sequence, which handles gpios and clocks currently, and can cover other controls in future. The host driver just needs to call of_pwrseq_on/of_pwrseq_off if only one power sequence is needed, else call of_pwrseq_on_list /of_pwrseq_off_list instead (eg, USB hub driver). For new power sequence library, it can add its compatible string to pwrseq_of_match_table, then the pwrseq core will match it with DT's, and choose this library at runtime. Signed-off-by: Peter Chen Tested-by: Maciej S. Szmigiero Tested-by Joshua Clayton Reviewed-by: Matthias Kaehlcke Tested-by: Matthias Kaehlcke --- Documentation/power/power-sequence/design.rst | 38 +++ MAINTAINERS | 9 + drivers/power/Kconfig | 1 + drivers/power/Makefile | 1 + drivers/power/pwrseq/Kconfig | 20 ++ drivers/power/pwrseq/Makefile | 2 + drivers/power/pwrseq/core.c | 335 ++++++++++++++++++++++++++ drivers/power/pwrseq/pwrseq_generic.c | 234 ++++++++++++++++++ include/linux/power/pwrseq.h | 81 +++++++ 9 files changed, 721 insertions(+) create mode 100644 Documentation/power/power-sequence/design.rst create mode 100644 drivers/power/pwrseq/Kconfig create mode 100644 drivers/power/pwrseq/Makefile create mode 100644 drivers/power/pwrseq/core.c create mode 100644 drivers/power/pwrseq/pwrseq_generic.c create mode 100644 include/linux/power/pwrseq.h diff --git a/Documentation/power/power-sequence/design.rst b/Documentation/power/power-sequence/design.rst new file mode 100644 index 0000000..8d57e4e --- /dev/null +++ b/Documentation/power/power-sequence/design.rst @@ -0,0 +1,38 @@ +==================================== +Power Sequence Library +==================================== + +:Date: Feb, 2017 +:Author: Peter Chen + + +Introduction +============ + +We have an well-known problem that the device needs to do a power +sequence before it can be recognized by related host, the typical +examples are hard-wired mmc devices and usb devices. The host controller +can't know what kinds of this device in its bus if the power sequence has +not done, since the related devices driver's probe is runtime and +according to eunumeration results. Besides, the devices may have custom +power sequence, so the power sequence library which is independent with +the devices is needed. + +Design +============ + +The power sequence library includes the exported interfaces are called by +host controller driver and individual sequence source files to register +its power sequence instance to global power sequence list, and individual +sequence files create power sequence instance and implement custom power +sequence. + +The exported interfaces +.. kernel-doc:: drivers/power/pwrseq/core.c + :export: + +Since the power sequence describes hardware design, the description is +located at board description file, eg, device tree dts file. And +a specific power sequence belongs to device, so its description +is under the device node, please refer to: +Documentation/devicetree/bindings/power/pwrseq/pwrseq-generic.txt diff --git a/MAINTAINERS b/MAINTAINERS index 26edd83..a186193 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -9845,6 +9845,15 @@ F: include/linux/pm_* F: include/linux/powercap.h F: drivers/powercap/ +POWER SEQUENCE LIBRARY +M: Peter Chen +T: git git://git.kernel.org/pub/scm/linux/kernel/git/peter.chen/usb.git +L: linux-pm@vger.kernel.org +S: Maintained +F: Documentation/devicetree/bindings/power/pwrseq/ +F: drivers/power/pwrseq/ +F: include/linux/power/pwrseq.h + POWER SUPPLY CLASS/SUBSYSTEM and DRIVERS M: Sebastian Reichel L: linux-pm@vger.kernel.org diff --git a/drivers/power/Kconfig b/drivers/power/Kconfig index 63454b5..c1bb046 100644 --- a/drivers/power/Kconfig +++ b/drivers/power/Kconfig @@ -1,3 +1,4 @@ source "drivers/power/avs/Kconfig" source "drivers/power/reset/Kconfig" source "drivers/power/supply/Kconfig" +source "drivers/power/pwrseq/Kconfig" diff --git a/drivers/power/Makefile b/drivers/power/Makefile index ff35c71..7db8035 100644 --- a/drivers/power/Makefile +++ b/drivers/power/Makefile @@ -1,3 +1,4 @@ obj-$(CONFIG_POWER_AVS) += avs/ obj-$(CONFIG_POWER_RESET) += reset/ obj-$(CONFIG_POWER_SUPPLY) += supply/ +obj-$(CONFIG_POWER_SEQUENCE) += pwrseq/ diff --git a/drivers/power/pwrseq/Kconfig b/drivers/power/pwrseq/Kconfig new file mode 100644 index 0000000..c6b3569 --- /dev/null +++ b/drivers/power/pwrseq/Kconfig @@ -0,0 +1,20 @@ +# +# Power Sequence library +# + +menuconfig POWER_SEQUENCE + bool "Power sequence control" + help + It is used for drivers which needs to do power sequence + (eg, turn on clock, toggle reset gpio) before the related + devices can be found by hardware, eg, USB bus. + +if POWER_SEQUENCE + +config PWRSEQ_GENERIC + bool "Generic power sequence control" + depends on OF + help + This is the generic power sequence control library, and is + supposed to support common power sequence usage. +endif diff --git a/drivers/power/pwrseq/Makefile b/drivers/power/pwrseq/Makefile new file mode 100644 index 0000000..ad82389 --- /dev/null +++ b/drivers/power/pwrseq/Makefile @@ -0,0 +1,2 @@ +obj-$(CONFIG_POWER_SEQUENCE) += core.o +obj-$(CONFIG_PWRSEQ_GENERIC) += pwrseq_generic.o diff --git a/drivers/power/pwrseq/core.c b/drivers/power/pwrseq/core.c new file mode 100644 index 0000000..3d19e62 --- /dev/null +++ b/drivers/power/pwrseq/core.c @@ -0,0 +1,335 @@ +/* + * core.c power sequence core file + * + * Copyright (C) 2016 Freescale Semiconductor, Inc. + * Author: Peter Chen + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License version 2 of + * the License as published by the Free Software Foundation. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. + */ + +#include +#include +#include +#include +#include + +static DEFINE_MUTEX(pwrseq_list_mutex); +static LIST_HEAD(pwrseq_list); + +static int pwrseq_get(struct device_node *np, struct pwrseq *p) +{ + if (p && p->get) + return p->get(np, p); + + return -ENOTSUPP; +} + +static int pwrseq_on(struct pwrseq *p) +{ + if (p && p->on) + return p->on(p); + + return -ENOTSUPP; +} + +static void pwrseq_off(struct pwrseq *p) +{ + if (p && p->off) + p->off(p); +} + +static void pwrseq_put(struct pwrseq *p) +{ + if (p && p->put) + p->put(p); +} + +/** + * pwrseq_register - Add pwrseq instance to global pwrseq list + * + * @pwrseq: the pwrseq instance + */ +void pwrseq_register(struct pwrseq *pwrseq) +{ + mutex_lock(&pwrseq_list_mutex); + list_add(&pwrseq->node, &pwrseq_list); + mutex_unlock(&pwrseq_list_mutex); +} +EXPORT_SYMBOL_GPL(pwrseq_register); + +/** + * pwrseq_unregister - Remove pwrseq instance from global pwrseq list + * + * @pwrseq: the pwrseq instance + */ +void pwrseq_unregister(struct pwrseq *pwrseq) +{ + mutex_lock(&pwrseq_list_mutex); + list_del(&pwrseq->node); + mutex_unlock(&pwrseq_list_mutex); +} +EXPORT_SYMBOL_GPL(pwrseq_unregister); + +static struct pwrseq *pwrseq_find_available_instance(struct device_node *np) +{ + struct pwrseq *pwrseq; + + mutex_lock(&pwrseq_list_mutex); + list_for_each_entry(pwrseq, &pwrseq_list, node) { + if (pwrseq->used) + continue; + + /* compare compatible string for pwrseq node */ + if (of_match_node(pwrseq->pwrseq_of_match_table, np)) { + pwrseq->used = true; + mutex_unlock(&pwrseq_list_mutex); + return pwrseq; + } + + /* return generic pwrseq instance */ + if (!strcmp(pwrseq->pwrseq_of_match_table->compatible, + "generic")) { + pr_debug("using generic pwrseq instance for %s\n", + np->full_name); + pwrseq->used = true; + mutex_unlock(&pwrseq_list_mutex); + return pwrseq; + } + } + mutex_unlock(&pwrseq_list_mutex); + pr_debug("Can't find any pwrseq instances for %s\n", np->full_name); + + return NULL; +} + +/** + * of_pwrseq_on - Carry out power sequence on for device node + * + * @np: the device node would like to power on + * + * Carry out a single device power on. If multiple devices + * need to be handled, use of_pwrseq_on_list() instead. + * + * Return a pointer to the power sequence instance on success, + * or an error code otherwise. + */ +struct pwrseq *of_pwrseq_on(struct device_node *np) +{ + struct pwrseq *pwrseq; + int ret; + + pwrseq = pwrseq_find_available_instance(np); + if (!pwrseq) + return ERR_PTR(-ENOENT); + + ret = pwrseq_get(np, pwrseq); + if (ret) { + /* Mark current pwrseq as unused */ + pwrseq->used = false; + return ERR_PTR(ret); + } + + ret = pwrseq_on(pwrseq); + if (ret) + goto pwr_put; + + return pwrseq; + +pwr_put: + pwrseq_put(pwrseq); + return ERR_PTR(ret); +} +EXPORT_SYMBOL_GPL(of_pwrseq_on); + +/** + * of_pwrseq_off - Carry out power sequence off for this pwrseq instance + * + * @pwrseq: the pwrseq instance which related device would like to be off + * + * This API is used to power off single device, it is the opposite + * operation for of_pwrseq_on. + */ +void of_pwrseq_off(struct pwrseq *pwrseq) +{ + pwrseq_off(pwrseq); + pwrseq_put(pwrseq); +} +EXPORT_SYMBOL_GPL(of_pwrseq_off); + +/** + * of_pwrseq_on_list - Carry out power sequence on for list + * + * @np: the device node would like to power on + * @head: the list head for pwrseq list on this bus + * + * This API is used to power on multiple devices at single bus. + * If there are several devices on bus (eg, USB bus), uses this + * this API. Otherwise, use of_pwrseq_on instead. After the device + * is powered on successfully, it will be added to pwrseq list for + * this bus. The caller needs to use mutex_lock for concurrent. + * + * Return 0 on success, or an error value otherwise. + */ +int of_pwrseq_on_list(struct device_node *np, struct list_head *head) +{ + struct pwrseq *pwrseq; + struct pwrseq_list_per_dev *pwrseq_list_node; + + pwrseq_list_node = kzalloc(sizeof(*pwrseq_list_node), GFP_KERNEL); + if (!pwrseq_list_node) + return -ENOMEM; + + pwrseq = of_pwrseq_on(np); + if (IS_ERR(pwrseq)) { + kfree(pwrseq_list_node); + return PTR_ERR(pwrseq); + } + + pwrseq_list_node->pwrseq = pwrseq; + list_add(&pwrseq_list_node->list, head); + + return 0; +} +EXPORT_SYMBOL_GPL(of_pwrseq_on_list); + +/** + * of_pwrseq_off_list - Carry out power sequence off for the list + * + * @head: the list head for pwrseq instance list on this bus + * + * This API is used to power off all devices on this bus, it is + * the opposite operation for of_pwrseq_on_list. + * The caller needs to use mutex_lock for concurrent. + */ +void of_pwrseq_off_list(struct list_head *head) +{ + struct pwrseq *pwrseq; + struct pwrseq_list_per_dev *pwrseq_list_node, *tmp_node; + + list_for_each_entry_safe(pwrseq_list_node, tmp_node, head, list) { + pwrseq = pwrseq_list_node->pwrseq; + of_pwrseq_off(pwrseq); + list_del(&pwrseq_list_node->list); + kfree(pwrseq_list_node); + } +} +EXPORT_SYMBOL_GPL(of_pwrseq_off_list); + +/** + * pwrseq_suspend - Carry out power sequence suspend for this pwrseq instance + * + * @pwrseq: the pwrseq instance + * + * This API is used to do suspend operation on pwrseq instance. + * + * Return 0 on success, or an error value otherwise. + */ +int pwrseq_suspend(struct pwrseq *p) +{ + int ret = 0; + + if (p && p->suspend) + ret = p->suspend(p); + else + return ret; + + if (!ret) + p->suspended = true; + else + pr_err("%s failed\n", __func__); + + return ret; +} +EXPORT_SYMBOL_GPL(pwrseq_suspend); + +/** + * pwrseq_resume - Carry out power sequence resume for this pwrseq instance + * + * @pwrseq: the pwrseq instance + * + * This API is used to do resume operation on pwrseq instance. + * + * Return 0 on success, or an error value otherwise. + */ +int pwrseq_resume(struct pwrseq *p) +{ + int ret = 0; + + if (p && p->resume) + ret = p->resume(p); + else + return ret; + + if (!ret) + p->suspended = false; + else + pr_err("%s failed\n", __func__); + + return ret; +} +EXPORT_SYMBOL_GPL(pwrseq_resume); + +/** + * pwrseq_suspend_list - Carry out power sequence suspend for list + * + * @head: the list head for pwrseq instance list on this bus + * + * This API is used to do suspend on all power sequence instances on this bus. + * The caller needs to use mutex_lock for concurrent. + */ +int pwrseq_suspend_list(struct list_head *head) +{ + struct pwrseq *pwrseq; + struct pwrseq_list_per_dev *pwrseq_list_node; + int ret = 0; + + list_for_each_entry(pwrseq_list_node, head, list) { + ret = pwrseq_suspend(pwrseq_list_node->pwrseq); + if (ret) + break; + } + + if (ret) { + list_for_each_entry(pwrseq_list_node, head, list) { + pwrseq = pwrseq_list_node->pwrseq; + if (pwrseq->suspended) + pwrseq_resume(pwrseq); + } + } + + return ret; +} +EXPORT_SYMBOL_GPL(pwrseq_suspend_list); + +/** + * pwrseq_resume_list - Carry out power sequence resume for the list + * + * @head: the list head for pwrseq instance list on this bus + * + * This API is used to do resume on all power sequence instances on this bus. + * The caller needs to use mutex_lock for concurrent. + */ +int pwrseq_resume_list(struct list_head *head) +{ + struct pwrseq_list_per_dev *pwrseq_list_node; + int ret = 0; + + list_for_each_entry(pwrseq_list_node, head, list) { + ret = pwrseq_resume(pwrseq_list_node->pwrseq); + if (ret) + break; + } + + return ret; +} +EXPORT_SYMBOL_GPL(pwrseq_resume_list); diff --git a/drivers/power/pwrseq/pwrseq_generic.c b/drivers/power/pwrseq/pwrseq_generic.c new file mode 100644 index 0000000..4e7c090 --- /dev/null +++ b/drivers/power/pwrseq/pwrseq_generic.c @@ -0,0 +1,234 @@ +/* + * pwrseq_generic.c Generic power sequence handling + * + * Copyright (C) 2016 Freescale Semiconductor, Inc. + * Author: Peter Chen + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License version 2 of + * the License as published by the Free Software Foundation. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. + */ + +#include +#include +#include +#include +#include +#include +#include + +#include + +struct pwrseq_generic { + struct pwrseq pwrseq; + struct gpio_desc *gpiod_reset; + struct clk *clks[PWRSEQ_MAX_CLKS]; + u32 duration_us; + bool suspended; +}; + +#define to_generic_pwrseq(p) container_of(p, struct pwrseq_generic, pwrseq) + +static int pwrseq_generic_alloc_instance(void); +static const struct of_device_id generic_id_table[] = { + { .compatible = "generic",}, + { /* sentinel */ } +}; + +static int pwrseq_generic_suspend(struct pwrseq *pwrseq) +{ + struct pwrseq_generic *pwrseq_gen = to_generic_pwrseq(pwrseq); + int clk; + + for (clk = PWRSEQ_MAX_CLKS - 1; clk >= 0; clk--) + clk_disable_unprepare(pwrseq_gen->clks[clk]); + + pwrseq_gen->suspended = true; + return 0; +} + +static int pwrseq_generic_resume(struct pwrseq *pwrseq) +{ + struct pwrseq_generic *pwrseq_gen = to_generic_pwrseq(pwrseq); + int clk, ret = 0; + + for (clk = 0; clk < PWRSEQ_MAX_CLKS && pwrseq_gen->clks[clk]; clk++) { + ret = clk_prepare_enable(pwrseq_gen->clks[clk]); + if (ret) { + pr_err("Can't enable clock, ret=%d\n", ret); + goto err_disable_clks; + } + } + + pwrseq_gen->suspended = false; + return ret; + +err_disable_clks: + while (--clk >= 0) + clk_disable_unprepare(pwrseq_gen->clks[clk]); + + return ret; +} + +static void pwrseq_generic_put(struct pwrseq *pwrseq) +{ + struct pwrseq_generic *pwrseq_gen = to_generic_pwrseq(pwrseq); + int clk; + + if (pwrseq_gen->gpiod_reset) + gpiod_put(pwrseq_gen->gpiod_reset); + + for (clk = 0; clk < PWRSEQ_MAX_CLKS; clk++) + clk_put(pwrseq_gen->clks[clk]); + + pwrseq_unregister(&pwrseq_gen->pwrseq); + kfree(pwrseq_gen); +} + +static void pwrseq_generic_off(struct pwrseq *pwrseq) +{ + struct pwrseq_generic *pwrseq_gen = to_generic_pwrseq(pwrseq); + int clk; + + if (pwrseq_gen->suspended) + return; + + for (clk = PWRSEQ_MAX_CLKS - 1; clk >= 0; clk--) + clk_disable_unprepare(pwrseq_gen->clks[clk]); +} + +static int pwrseq_generic_on(struct pwrseq *pwrseq) +{ + struct pwrseq_generic *pwrseq_gen = to_generic_pwrseq(pwrseq); + int clk, ret = 0; + struct gpio_desc *gpiod_reset = pwrseq_gen->gpiod_reset; + + for (clk = 0; clk < PWRSEQ_MAX_CLKS && pwrseq_gen->clks[clk]; clk++) { + ret = clk_prepare_enable(pwrseq_gen->clks[clk]); + if (ret) { + pr_err("Can't enable clock, ret=%d\n", ret); + goto err_disable_clks; + } + } + + if (gpiod_reset) { + u32 duration_us = pwrseq_gen->duration_us; + + if (duration_us <= 10) + udelay(10); + else + usleep_range(duration_us, duration_us + 100); + gpiod_set_value(gpiod_reset, 0); + } + + return ret; + +err_disable_clks: + while (--clk >= 0) + clk_disable_unprepare(pwrseq_gen->clks[clk]); + + return ret; +} + +static int pwrseq_generic_get(struct device_node *np, struct pwrseq *pwrseq) +{ + struct pwrseq_generic *pwrseq_gen = to_generic_pwrseq(pwrseq); + enum of_gpio_flags flags; + int reset_gpio, clk, ret = 0; + + for (clk = 0; clk < PWRSEQ_MAX_CLKS; clk++) { + pwrseq_gen->clks[clk] = of_clk_get(np, clk); + if (IS_ERR(pwrseq_gen->clks[clk])) { + ret = PTR_ERR(pwrseq_gen->clks[clk]); + if (ret != -ENOENT) + goto err_put_clks; + pwrseq_gen->clks[clk] = NULL; + break; + } + } + + reset_gpio = of_get_named_gpio_flags(np, "reset-gpios", 0, &flags); + if (gpio_is_valid(reset_gpio)) { + unsigned long gpio_flags; + + if (flags & OF_GPIO_ACTIVE_LOW) + gpio_flags = GPIOF_ACTIVE_LOW | GPIOF_OUT_INIT_LOW; + else + gpio_flags = GPIOF_OUT_INIT_HIGH; + + ret = gpio_request_one(reset_gpio, gpio_flags, + "pwrseq-reset-gpios"); + if (ret) + goto err_put_clks; + + pwrseq_gen->gpiod_reset = gpio_to_desc(reset_gpio); + of_property_read_u32(np, "reset-duration-us", + &pwrseq_gen->duration_us); + } else if (reset_gpio == -ENOENT) { + ; /* no such gpio */ + } else { + ret = reset_gpio; + pr_err("Failed to get reset gpio on %s, err = %d\n", + np->full_name, reset_gpio); + goto err_put_clks; + } + + /* allocate new one for later pwrseq instance request */ + ret = pwrseq_generic_alloc_instance(); + if (ret) + goto err_put_gpio; + + return 0; + +err_put_gpio: + if (pwrseq_gen->gpiod_reset) + gpiod_put(pwrseq_gen->gpiod_reset); +err_put_clks: + while (--clk >= 0) + clk_put(pwrseq_gen->clks[clk]); + return ret; +} + +/** + * pwrseq_generic_alloc_instance - power sequence instance allocation + * + * This function is used to allocate one generic power sequence instance, + * it is called when the system boots up and after one power sequence + * instance is got successfully. + * + * Return zero on success or an error code otherwise. + */ +static int pwrseq_generic_alloc_instance(void) +{ + struct pwrseq_generic *pwrseq_gen; + + pwrseq_gen = kzalloc(sizeof(*pwrseq_gen), GFP_KERNEL); + if (!pwrseq_gen) + return -ENOMEM; + + pwrseq_gen->pwrseq.pwrseq_of_match_table = generic_id_table; + pwrseq_gen->pwrseq.get = pwrseq_generic_get; + pwrseq_gen->pwrseq.on = pwrseq_generic_on; + pwrseq_gen->pwrseq.off = pwrseq_generic_off; + pwrseq_gen->pwrseq.put = pwrseq_generic_put; + pwrseq_gen->pwrseq.suspend = pwrseq_generic_suspend; + pwrseq_gen->pwrseq.resume = pwrseq_generic_resume; + + pwrseq_register(&pwrseq_gen->pwrseq); + return 0; +} + +/* Allocate one pwrseq instance during boots up */ +static int __init pwrseq_generic_register(void) +{ + return pwrseq_generic_alloc_instance(); +} +postcore_initcall(pwrseq_generic_register) diff --git a/include/linux/power/pwrseq.h b/include/linux/power/pwrseq.h new file mode 100644 index 0000000..9256133 --- /dev/null +++ b/include/linux/power/pwrseq.h @@ -0,0 +1,81 @@ +#ifndef __LINUX_PWRSEQ_H +#define __LINUX_PWRSEQ_H + +#include + +#define PWRSEQ_MAX_CLKS 3 + +/** + * struct pwrseq - the power sequence structure + * @pwrseq_of_match_table: the OF device id table this pwrseq library supports + * @node: the list pointer to be added to pwrseq list + * @get: the API is used to get pwrseq instance from the device node + * @on: do power on for this pwrseq instance + * @off: do power off for this pwrseq instance + * @put: release the resources on this pwrseq instance + * @suspend: do suspend operation on this pwrseq instance + * @resume: do resume operation on this pwrseq instance + * @used: this pwrseq instance is used by device + */ +struct pwrseq { + const struct of_device_id *pwrseq_of_match_table; + struct list_head node; + int (*get)(struct device_node *np, struct pwrseq *p); + int (*on)(struct pwrseq *p); + void (*off)(struct pwrseq *p); + void (*put)(struct pwrseq *p); + int (*suspend)(struct pwrseq *p); + int (*resume)(struct pwrseq *p); + bool used; + bool suspended; +}; + +/* used for power sequence instance list in one driver */ +struct pwrseq_list_per_dev { + struct pwrseq *pwrseq; + struct list_head list; +}; + +#if IS_ENABLED(CONFIG_POWER_SEQUENCE) && IS_ENABLED(CONFIG_OF) +void pwrseq_register(struct pwrseq *pwrseq); +void pwrseq_unregister(struct pwrseq *pwrseq); +struct pwrseq *of_pwrseq_on(struct device_node *np); +void of_pwrseq_off(struct pwrseq *pwrseq); +int of_pwrseq_on_list(struct device_node *np, struct list_head *head); +void of_pwrseq_off_list(struct list_head *head); +int pwrseq_suspend(struct pwrseq *p); +int pwrseq_resume(struct pwrseq *p); +int pwrseq_suspend_list(struct list_head *head); +int pwrseq_resume_list(struct list_head *head); +#else +static inline void pwrseq_register(struct pwrseq *pwrseq) {} +static inline void pwrseq_unregister(struct pwrseq *pwrseq) {} +static inline struct pwrseq *of_pwrseq_on(struct device_node *np) +{ + return NULL; +} +static void of_pwrseq_off(struct pwrseq *pwrseq) {} +static int of_pwrseq_on_list(struct device_node *np, struct list_head *head) +{ + return 0; +} +static void of_pwrseq_off_list(struct list_head *head) {} +static int pwrseq_suspend(struct pwrseq *p) +{ + return 0; +} +static int pwrseq_resume(struct pwrseq *p) +{ + return 0; +} +static int pwrseq_suspend_list(struct list_head *head) +{ + return 0; +} +static int pwrseq_resume_list(struct list_head *head) +{ + return 0; +} +#endif /* CONFIG_POWER_SEQUENCE */ + +#endif /* __LINUX_PWRSEQ_H */