From patchwork Mon Dec 7 14:27:55 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Klein X-Patchwork-Id: 11956135 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-16.8 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 00ED3C433FE for ; Mon, 7 Dec 2020 14:29:39 +0000 (UTC) Received: from merlin.infradead.org (merlin.infradead.org [205.233.59.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id B5038235FF for ; Mon, 7 Dec 2020 14:29:38 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org B5038235FF Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=fossekall.de Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=merlin.20170209; h=Sender:Content-Transfer-Encoding: Content-Type:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=Qzw1uhoFFGgk2RKzDgUbU86FgUc1i1pSL1GGSmLUy64=; b=tjSdDyrZrfT72Mbmb94I06ezU ngd6sua+55LzAcdJHIWEbgGpMaLkKmytA2PJl7O4tGROLaI7d7gEjmU1trOL3IShEdJc9f7fpPPMA lSrvFsagKB9anZRb+3NojcVdBIxLlgf9wwDisdBzEKLILJ6uAQlDe0v3VpZYLp9RoOXEcTG3lpD/9 WVBo9kDQcTiGdArER/lMQ1FAnV4LRI89DEfXudw2F7E2goAt3EmR+R08o05VRWfUBRMPFRWDJLV5k dAUp93ZMwAwFy/hP993LZyo088k+1i86q2lhC4NSgAVZmGnR0RGQ6yxC2oHRTr7mSi+NPUckn/ouh 2NdodBwpg==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1kmHV8-00088B-0F; Mon, 07 Dec 2020 14:28:30 +0000 Received: from mo4-p01-ob.smtp.rzone.de ([81.169.146.165]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1kmHUq-00081I-0o for linux-arm-kernel@lists.infradead.org; Mon, 07 Dec 2020 14:28:15 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1607351290; s=strato-dkim-0002; d=fossekall.de; h=References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From: X-RZG-CLASS-ID:X-RZG-AUTH:From:Subject:Sender; bh=9SYLzlFgBXzuvKKzJL8JRRj5vw51OfuroQA/clOun08=; b=ba5sLuE9hslnkpYghx2QIVcsYwN5de2CKQbUgV+yu1ofTqlGoA+1xSphBCBID28HX7 ZapTF7HkULvRJdq5OdajWUAWoBdlxNilEb9I890l8RxSbjVsSMxr51GcfpUX+wub/7c1 +pZz0Pfz7VyenK1acu2Z5TfK1CnF7gXeAnpV3rHIRxK8yS5C2JY0wTIDoTJV6ct39zih k2cRoes8Qy28tIczJ8Roz3WFHxKyXXuMCanqBJCzqF8keyGrsDR2PKBiuVQL9F9FYBq6 AZcvDywOz+pPMW2Rbrama4PJJee0Yub8hGm+knR7oYbYu6Fn9y8BjiiMQef0Aq8tQDYS EciA== X-RZG-AUTH: ":O2kGeEG7b/pS1EzgE2y7nF0STYsSLflpbjNKxx7cGrBOdI6BL9pkS3QW19mO7I+/JwRspuzJFZuRzQ==" X-RZG-CLASS-ID: mo00 Received: from aerfugl by smtp.strato.de (RZmta 47.3.4 AUTH) with ESMTPSA id g02087wB7ES9OVc (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (curve X9_62_prime256v1 with 256 ECDH bits, eq. 3072 bits RSA)) (Client did not present a certificate); Mon, 7 Dec 2020 15:28:09 +0100 (CET) Received: from koltrast.a98shuttle.de ([192.168.1.27] helo=a98shuttle.de) by aerfugl with smtp (Exim 4.89) (envelope-from ) id 1kmHUh-0001TH-CZ; Mon, 07 Dec 2020 15:28:03 +0100 Received: (nullmailer pid 17908 invoked by uid 502); Mon, 07 Dec 2020 14:28:03 -0000 From: Michael Klein To: Sebastian Reichel , Rob Herring , Maxime Ripard , Chen-Yu Tsai , Jernej Skrabec , Michael Klein Subject: [PATCH v3 2/3] Documentation: DT: binding documentation for regulator-poweroff Date: Mon, 7 Dec 2020 15:27:55 +0100 Message-Id: <20201207142756.17819-3-michael@fossekall.de> X-Mailer: git-send-email 2.29.2 In-Reply-To: <20201207142756.17819-1-michael@fossekall.de> References: <20201128103958.q6glewhhch7vtczr@gilmour> <20201207142756.17819-1-michael@fossekall.de> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20201207_092812_220561_2C376C03 X-CRM114-Status: GOOD ( 15.92 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-pm@vger.kernel.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Add devicetree binding documentation for regulator-poweroff driver. Signed-off-by: Michael Klein --- .../power/reset/regulator-poweroff.yaml | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 Documentation/devicetree/bindings/power/reset/regulator-poweroff.yaml diff --git a/Documentation/devicetree/bindings/power/reset/regulator-poweroff.yaml b/Documentation/devicetree/bindings/power/reset/regulator-poweroff.yaml new file mode 100644 index 000000000000..8c8ce6bb031a --- /dev/null +++ b/Documentation/devicetree/bindings/power/reset/regulator-poweroff.yaml @@ -0,0 +1,53 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/power/reset/regulator-poweroff.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Force-disable power regulators to turn the power off. + +maintainers: + - Michael Klein + +description: | + When the power-off handler is called, one more regulators are disabled + by calling regulator_force_disable(). If the power is still on and the + CPU still running after a 3000ms delay, a WARN_ON(1) is emitted. + +properties: + compatible: + const: "regulator-poweroff" + + regulator-names: + description: + Array of regulator names + $ref: /schemas/types.yaml#/definitions/string-array + + REGULATOR-supply: + description: + For any REGULATOR listed in regulator-names, a phandle + to the corresponding regulator node + $ref: /schemas/types.yaml#/definitions/phandle + + timeout-ms: + description: + Time to wait before asserting a WARN_ON(1). If nothing is + specified, 3000 ms is used. + $ref: /schemas/types.yaml#/definitions/uint32 + +required: + - compatible + - regulator-names + - REGULATOR-supply + +additionalProperties: false + +examples: + - | + regulator-poweroff { + compatible = "regulator-poweroff"; + regulator-names = "vcc1v2", "vcc-dram"; + vcc1v2-supply = <®_vcc1v2>; + vcc-dram-supply = <®_vcc_dram>; + }; +...