From patchwork Thu Jan 4 22:40:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Andr=C3=A9_Apitzsch?= X-Patchwork-Id: 185167 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:6f82:b0:100:9c79:88ff with SMTP id tb2csp5909331dyb; Thu, 4 Jan 2024 14:44:17 -0800 (PST) X-Google-Smtp-Source: AGHT+IHE5TTWwyLWzbmf5KWSVaDZXrJef1sgLcb6uLcllZFgMqAmrZPVD64BN82dlHWKQ/CJFWC1 X-Received: by 2002:a19:761a:0:b0:50e:b349:1448 with SMTP id c26-20020a19761a000000b0050eb3491448mr16270lff.36.1704408257662; Thu, 04 Jan 2024 14:44:17 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1704408257; cv=none; d=google.com; s=arc-20160816; b=x70H7KJz/rzcaJjzYeXSWQq2ysqT1luNN2tciPX7XpWQTzXZ4MOvASwTh2rlMG4qVL po72dj0CrTCc56sNKsqOA/I2N3ZZxHOOr/wZE7OOX77D930vWqdIqou14ddVwU0VLxUp gzGeoseKOKxiTOwcFe5r3sGTU0Ncbx+RI8u2yjNCSKr+WNDkpFvq1m8G44YbhLXVOUzK Sb2yGTHC4S9AOC3WUbAUBFGe2MNCOW+h1RMppSValzF/eXi7QOnN50LRkMxQfYi76G07 Dn7rBe/oQeacD+nCCxO1BMhWPYEmY3PvDNDpPT9wGLRw+dqE8dAgL5OnBDHruDXJR/Oy fYpg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=cc:to:message-id:content-transfer-encoding:mime-version :list-unsubscribe:list-subscribe:list-id:precedence:subject:date :from; bh=Df8hBkj8vyXgRmIJlDqks0MFCbWpdCnZt15mEfBHqxw=; fh=kvavLOGCFLu/HM2v7S0Id7m9SB6lrOuVomLCkHnwYuA=; b=fSp5a+aSthya7zhHThbknqoB43Uys1PrXQ5cd84iAAKG+uTUeTxnw9vKeyf+aClgZa UxhMDWwF5CgeimL7N6fpcM+Q3zMb5hL9iYiONvkzyUXM4hX0KnihScjXQbzdrciSwpPA JE5Lxl02nIzRGHQZX45SczvSUwDIV6W777WzCb3pA0I1NXlBLIyMjUa5eecnkZVUFQiQ M4Ne1p9+a+6XmoU+xe1amFHABHmLxE+OHjo6SPr9jW+3elWSLSRm8MbHcA7X7x7e3006 wcpzVdSdR++EHOWDNVJQoZswnVAaRjyr4xKXo3iFlO0M72K8B9Ovk+wUTgi60cbVYp1W HdYw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel+bounces-17301-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-17301-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id c22-20020a50f616000000b0055639c87d69si144580edn.465.2024.01.04.14.44.17 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 04 Jan 2024 14:44:17 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-17301-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel+bounces-17301-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-17301-ouuuleilei=gmail.com@vger.kernel.org" Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id 1E0031F236E3 for ; Thu, 4 Jan 2024 22:44:17 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 2D6DE2D043; Thu, 4 Jan 2024 22:44:00 +0000 (UTC) X-Original-To: linux-kernel@vger.kernel.org Received: from smtprelay07.ispgateway.de (smtprelay07.ispgateway.de [134.119.228.105]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 89D0A2CCB4; Thu, 4 Jan 2024 22:43:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=apitzsch.eu Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=apitzsch.eu Received: from [92.206.191.209] (helo=note-book.lan) by smtprelay07.ispgateway.de with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96.1) (envelope-from ) id 1rLWOi-0005BY-2u; Thu, 04 Jan 2024 23:41:09 +0100 From: =?utf-8?q?Andr=C3=A9_Apitzsch?= Date: Thu, 04 Jan 2024 23:40:40 +0100 Subject: [PATCH v2] dt-bindings: regulator: Convert ti,tps65132 to YAML Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240104-tps65132-v2-1-6c77fe2f4787@apitzsch.eu> X-B4-Tracking: v=1; b=H4sIAOczl2UC/23MQQ7CIBCF4as0sxZTpikUV97DdEGAymxaApSoD XcXu3b5v7x8ByQXySW4dQdEVyjRtrbASwfG6/XpGNnWgD0OHLlkOSQx8gGZXCZEZY22o4J2D9E t9Dqpx9zaU8pbfJ9y4b/1D1I440wORiitRG9xuutA+ZOMv7od5lrrF9S8kHaiAAAA To: Liam Girdwood , Mark Brown , Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, =?utf-8?q?Andr?= =?utf-8?q?=C3=A9_Apitzsch?= X-Mailer: b4 0.12.4 X-Df-Sender: YW5kcmVAYXBpdHpzY2guZXU= X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1787201593228013906 X-GMAIL-MSGID: 1787201593228013906 Convert TI TPS65132 bindings from .txt to .yaml format. Signed-off-by: André Apitzsch Reviewed-by: Krzysztof Kozlowski --- Changes in v2: - Fix typo in commit message header (65133 -> 65132) - Add missing 'maintainers' property and put list in as fallback as it was done for Documentation/devicetree/bindings/serial/8250.yaml - Link to v1: https://lore.kernel.org/r/20231217-tps65132-v1-1-73c69a960d28@apitzsch.eu --- .../devicetree/bindings/regulator/ti,tps65132.yaml | 84 ++++++++++++++++++++++ .../bindings/regulator/tps65132-regulator.txt | 46 ------------ 2 files changed, 84 insertions(+), 46 deletions(-) --- base-commit: d0b3c8aa5e37775cd7c3ac07b256218df0fd6678 change-id: 20231217-tps65132-7f8229dcad59 Best regards, diff --git a/Documentation/devicetree/bindings/regulator/ti,tps65132.yaml b/Documentation/devicetree/bindings/regulator/ti,tps65132.yaml new file mode 100644 index 000000000000..6a6d1a3d6fa7 --- /dev/null +++ b/Documentation/devicetree/bindings/regulator/ti,tps65132.yaml @@ -0,0 +1,84 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/regulator/ti,tps65132.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: TI TPS65132 Dual Output Power Regulators + +maintainers: + - devicetree@vger.kernel.org + +description: | + The TPS65132 is designed to supply positive/negative driven applications. + + Datasheet is available at: + https://www.ti.com/lit/gpn/tps65132 + +properties: + compatible: + enum: + - ti,tps65132 + + reg: + maxItems: 1 + +patternProperties: + "^out[pn]$": + type: object + $ref: regulator.yaml# + unevaluatedProperties: false + description: + Properties for single regulator. + + properties: + enable-gpios: + maxItems: 1 + description: + GPIO specifier to enable the GPIO control (on/off) for regulator. + + active-discharge-gpios: + maxItems: 1 + description: + GPIO specifier to actively discharge the delay mechanism. + + ti,active-discharge-time-us: + description: Regulator active discharge time in microseconds. + + dependencies: + active-discharge-gpios: [ 'ti,active-discharge-time-us' ] + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + #include + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + regulator@3e { + compatible = "ti,tps65132"; + reg = <0x3e>; + + outp { + regulator-name = "outp"; + regulator-boot-on; + regulator-always-on; + enable-gpios = <&gpio 23 GPIO_ACTIVE_HIGH>; + }; + + outn { + regulator-name = "outn"; + regulator-boot-on; + regulator-always-on; + regulator-active-discharge = <0>; + enable-gpios = <&gpio 40 GPIO_ACTIVE_HIGH>; + }; + }; + }; diff --git a/Documentation/devicetree/bindings/regulator/tps65132-regulator.txt b/Documentation/devicetree/bindings/regulator/tps65132-regulator.txt deleted file mode 100644 index 3a3505520c69..000000000000 --- a/Documentation/devicetree/bindings/regulator/tps65132-regulator.txt +++ /dev/null @@ -1,46 +0,0 @@ -TPS65132 regulators - -Required properties: -- compatible: "ti,tps65132" -- reg: I2C slave address - -Optional Subnode: -Device supports two regulators OUTP and OUTN. A sub node within the - device node describe the properties of these regulators. The sub-node - names must be as follows: - -For regulator outp, the sub node name should be "outp". - -For regulator outn, the sub node name should be "outn". - --enable-gpios:(active high, output) Regulators are controlled by the input pins. - If it is connected to GPIO through host system then provide the - gpio number as per gpio.txt. --active-discharge-gpios: (active high, output) Some configurations use delay mechanisms - on the enable pin, to keep the regulator enabled for some time after - the enable signal goes low. This GPIO is used to actively discharge - the delay mechanism. Requires specification of ti,active-discharge-time-us --ti,active-discharge-time-us: how long the active discharge gpio should be - asserted for during active discharge, in microseconds. - -Each regulator is defined using the standard binding for regulators. - -Example: - - tps65132@3e { - compatible = "ti,tps65132"; - reg = <0x3e>; - - outp { - regulator-name = "outp"; - regulator-boot-on; - regulator-always-on; - enable-gpios = <&gpio 23 0>; - }; - - outn { - regulator-name = "outn"; - regulator-boot-on; - regulator-always-on; - regulator-active-discharge = <0>; - enable-gpios = <&gpio 40 0>; - }; - };