[2/2] dt-bindings: Migrate DA9063 text bindings to YAML

Message ID	20211027052323.1788476-2-alexandre.ghiti@canonical.com (mailing list archive)
State	Superseded
Headers	show Return-Path: <linux-input-owner@kernel.org> From: Alexandre Ghiti <alexandre.ghiti@canonical.com> To: Dmitry Torokhov <dmitry.torokhov@gmail.com>, Rob Herring <robh+dt@kernel.org>, Adam Thomson <Adam.Thomson.Opensource@diasemi.com>, Support Opensource <support.opensource@diasemi.com>, Lee Jones <lee.jones@linaro.org>, Liam Girdwood <lgirdwood@gmail.com>, Mark Brown <broonie@kernel.org>, Alessandro Zummo <a.zummo@towertech.it>, Alexandre Belloni <alexandre.belloni@bootlin.com>, Wim Van Sebroeck <wim@linux-watchdog.org>, Guenter Roeck <linux@roeck-us.net>, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-rtc@vger.kernel.org, linux-watchdog@vger.kernel.org Cc: Alexandre Ghiti <alexandre.ghiti@canonical.com> Subject: [PATCH 2/2] dt-bindings: Migrate DA9063 text bindings to YAML Date: Wed, 27 Oct 2021 07:23:23 +0200 Message-Id: <20211027052323.1788476-2-alexandre.ghiti@canonical.com> In-Reply-To: <20211027052323.1788476-1-alexandre.ghiti@canonical.com> References: <20211027052323.1788476-1-alexandre.ghiti@canonical.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk
Series	[1/2] dt-bindings: mfd: Fix typo "DA9093" -> "DA9063" \| expand [1/2] dt-bindings: mfd: Fix typo "DA9093" -> "DA9063" [2/2] dt-bindings: Migrate DA9063 text bindings to YAML

diff --git a/Documentation/devicetree/bindings/input/da9063-onkey.yaml b/Documentation/devicetree/bindings/input/da9063-onkey.yaml new file mode 100644 index 000000000000..e49f69f7aaac --- /dev/null +++ b/Documentation/devicetree/bindings/input/da9063-onkey.yaml @@ -0,0 +1,39 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/input/da9063-onkey.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: OnKey driver for Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC) + +maintainers: + - Support Opensource <support.opensource@diasemi.com> + +description: | + This module is part of the DA9063 MFD device. For more details, see + Documentation/devicetree/bindings/mfd/da9063.yaml. + + The OnKey controller is represented as a sub-node of the PMIC node + on the device tree. + + This node defines the OnKey settings for controlling the key + functionality of the device. The node should contain the compatible property + with the value "dlg,da9063-onkey". + +properties: + compatible: + const: dlg,da9063-onkey + + dlg,disable-key-power: + description: | + Disable power-down using a long key-press. If this + entry exists the OnKey driver will remove support for the KEY_POWER key + press. If this entry does not exist then by default the key-press + triggered power down is enabled and the OnKey will support both KEY_POWER + and KEY_SLEEP. + type: boolean + +required: + - compatible + +additionalProperties: false diff --git a/Documentation/devicetree/bindings/mfd/da9063.txt b/Documentation/devicetree/bindings/mfd/da9063.txt deleted file mode 100644 index 91b79a21d403..000000000000 --- a/Documentation/devicetree/bindings/mfd/da9063.txt +++ /dev/null @@ -1,111 +0,0 @@ -* Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC) - -DA9063 consists of a large and varied group of sub-devices (I2C Only): - -Device Supply Names Description ------- ------------ ----------- -da9063-regulator : : LDOs & BUCKs -da9063-onkey : : On Key -da9063-rtc : : Real-Time Clock (DA9063 only) -da9063-watchdog : : Watchdog - -====== - -Required properties: - -- compatible : Should be "dlg,da9063" or "dlg,da9063l" -- reg : Specifies the I2C slave address (this defaults to 0x58 but it can be - modified to match the chip's OTP settings). -- interrupts : IRQ line information. -- interrupt-controller - -Sub-nodes: - -- regulators : This node defines the settings for the LDOs and BUCKs. - The DA9063(L) regulators are bound using their names listed below: - - bcore1 : BUCK CORE1 - bcore2 : BUCK CORE2 - bpro : BUCK PRO - bmem : BUCK MEM - bio : BUCK IO - bperi : BUCK PERI - ldo1 : LDO_1 (DA9063 only) - ldo2 : LDO_2 (DA9063 only) - ldo3 : LDO_3 - ldo4 : LDO_4 (DA9063 only) - ldo5 : LDO_5 (DA9063 only) - ldo6 : LDO_6 (DA9063 only) - ldo7 : LDO_7 - ldo8 : LDO_8 - ldo9 : LDO_9 - ldo10 : LDO_10 (DA9063 only) - ldo11 : LDO_11 - - The component follows the standard regulator framework and the bindings - details of individual regulator device can be found in: - Documentation/devicetree/bindings/regulator/regulator.txt - -- rtc : This node defines settings for the Real-Time Clock associated with - the DA9063 only. The RTC is not present in DA9063L. There are currently - no entries in this binding, however compatible = "dlg,da9063-rtc" should - be added if a node is created. - -- onkey : This node defines the OnKey settings for controlling the key - functionality of the device. The node should contain the compatible property - with the value "dlg,da9063-onkey". - - Optional onkey properties: - - - dlg,disable-key-power : Disable power-down using a long key-press. If this - entry exists the OnKey driver will remove support for the KEY_POWER key - press. If this entry does not exist then by default the key-press - triggered power down is enabled and the OnKey will support both KEY_POWER - and KEY_SLEEP. - -- watchdog : This node defines settings for the Watchdog timer associated - with the DA9063 and DA9063L. There are currently no entries in this - binding, however compatible = "dlg,da9063-watchdog" should be added - if a node is created. - - -Example: - - pmic0: da9063@58 { - compatible = "dlg,da9063" - reg = <0x58>; - interrupt-parent = <&gpio6>; - interrupts = <11 IRQ_TYPE_LEVEL_LOW>; - interrupt-controller; - - rtc { - compatible = "dlg,da9063-rtc"; - }; - - wdt { - compatible = "dlg,da9063-watchdog"; - }; - - onkey { - compatible = "dlg,da9063-onkey"; - dlg,disable-key-power; - }; - - regulators { - DA9063_BCORE1: bcore1 { - regulator-name = "BCORE1"; - regulator-min-microvolt = <300000>; - regulator-max-microvolt = <1570000>; - regulator-min-microamp = <500000>; - regulator-max-microamp = <2000000>; - regulator-boot-on; - }; - DA9063_LDO11: ldo11 { - regulator-name = "LDO_11"; - regulator-min-microvolt = <900000>; - regulator-max-microvolt = <3600000>; - regulator-boot-on; - }; - }; - }; - diff --git a/Documentation/devicetree/bindings/mfd/da9063.yaml b/Documentation/devicetree/bindings/mfd/da9063.yaml new file mode 100644 index 000000000000..f3eedf766d29 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/da9063.yaml @@ -0,0 +1,98 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mfd/da9063.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC) + +maintainers: + - Support Opensource <support.opensource@diasemi.com> + +description: | + DA9063 consists of a large and varied group of sub-devices (I2C Only): + + Device Supply Names Description + ------ ------------ ----------- + da9063-regulator : : LDOs & BUCKs + da9063-onkey : : On Key + da9063-rtc : : Real-Time Clock (DA9063 only) + da9063-watchdog : : Watchdog + +properties: + compatible: + oneOf: + - items: + - enum: + - dlg,da9063 + - dlg,da9063l + + reg: + description: + I2C device address. + maxItems: 1 + + interrupts: + maxItems: 1 + + interrupt-controller: true + + regulators: + $ref: ../regulator/da9063-regulator.yaml + + onkey: + $ref: ../input/da9063-onkey.yaml + + rtc: + $ref: ../rtc/da9063-rtc.yaml + + watchdog: + $ref: ../watchdog/da9063-watchdog.yaml + +required: + - compatible + - reg + - interrupts + - interrupt-controller + +additionalProperties: false + +examples: + - | + pmic0: da9063@58 { + compatible = "dlg,da9063" + reg = <0x58>; + interrupt-parent = <&gpio6>; + interrupts = <11 IRQ_TYPE_LEVEL_LOW>; + interrupt-controller; + + rtc { + compatible = "dlg,da9063-rtc"; + }; + + wdt { + compatible = "dlg,da9063-watchdog"; + }; + + onkey { + compatible = "dlg,da9063-onkey"; + dlg,disable-key-power; + }; + + regulators { + DA9063_BCORE1: bcore1 { + regulator-name = "BCORE1"; + regulator-min-microvolt = <300000>; + regulator-max-microvolt = <1570000>; + regulator-min-microamp = <500000>; + regulator-max-microamp = <2000000>; + regulator-boot-on; + }; + DA9063_LDO11: ldo11 { + regulator-name = "LDO_11"; + regulator-min-microvolt = <900000>; + regulator-max-microvolt = <3600000>; + regulator-boot-on; + }; + }; + }; diff --git a/Documentation/devicetree/bindings/regulator/da9063-regulator.yaml b/Documentation/devicetree/bindings/regulator/da9063-regulator.yaml new file mode 100644 index 000000000000..49128cf7369e --- /dev/null +++ b/Documentation/devicetree/bindings/regulator/da9063-regulator.yaml @@ -0,0 +1,51 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/regulator/da9063-regulator.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Regulator driver for Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC) + +maintainers: + - Support Opensource <support.opensource@diasemi.com> + +description: | + This module is part of the DA9063 MFD device. For more details, see + Documentation/devicetree/bindings/mfd/da9063.yaml. + + The regulator controller is represented as a sub-node of the PMIC node + on the device tree. + + This node defines the settings for the LDOs and BUCKs. + The DA9063(L) regulators are bound using their names listed below: + + bcore1 : BUCK CORE1 + bcore2 : BUCK CORE2 + bpro : BUCK PRO + bmem : BUCK MEM + bio : BUCK IO + bperi : BUCK PERI + ldo1 : LDO_1 (DA9063 only) + ldo2 : LDO_2 (DA9063 only) + ldo3 : LDO_3 + ldo4 : LDO_4 (DA9063 only) + ldo5 : LDO_5 (DA9063 only) + ldo6 : LDO_6 (DA9063 only) + ldo7 : LDO_7 + ldo8 : LDO_8 + ldo9 : LDO_9 + ldo10 : LDO_10 (DA9063 only) + ldo11 : LDO_11 + + The component follows the standard regulator framework and the bindings + details of individual regulator device can be found in: + Documentation/devicetree/bindings/regulator/regulator.txt + +properties: + compatible: + const: dlg,da9063-regulator + +required: + - compatible + +additionalProperties: false diff --git a/Documentation/devicetree/bindings/rtc/da9063-rtc.yaml b/Documentation/devicetree/bindings/rtc/da9063-rtc.yaml new file mode 100644 index 000000000000..3db1a9e5b572 --- /dev/null +++ b/Documentation/devicetree/bindings/rtc/da9063-rtc.yaml @@ -0,0 +1,31 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/rtc/da9063-rtc.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: RTC driver for Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC) + +maintainers: + - Support Opensource <support.opensource@diasemi.com> + +description: + This module is part of the DA9063 MFD device. For more details, see + Documentation/devicetree/bindings/mfd/da9063.yaml. + + The RTC controller is represented as a sub-node of the PMIC node + on the device tree. + + This node defines settings for the Real-Time Clock associated with + the DA9063 only. The RTC is not present in DA9063L. There are currently + no entries in this binding, however compatible = "dlg,da9063-rtc" should + be added if a node is created. + +properties: + compatible: + const: dlg,da9063-rtc + +required: + - compatible + +additionalProperties: false diff --git a/Documentation/devicetree/bindings/watchdog/da9063-watchdog.yaml b/Documentation/devicetree/bindings/watchdog/da9063-watchdog.yaml new file mode 100644 index 000000000000..d3286f4c04d2 --- /dev/null +++ b/Documentation/devicetree/bindings/watchdog/da9063-watchdog.yaml @@ -0,0 +1,31 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/watchdog/da9063-watchdog.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Watchdog driver for Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC) + +maintainers: + - Support Opensource <support.opensource@diasemi.com> + +description: | + This module is part of the DA9063 MFD device. For more details, see + Documentation/devicetree/bindings/mfd/da9063.yaml. + + The watchdog controller is represented as a sub-node of the PMIC node + on the device tree. + + This node defines settings for the Watchdog timer associated + with the DA9063 and DA9063L. There are currently no entries in this + binding, however compatible = "dlg,da9063-watchdog" should be added + if a node is created. + +properties: + compatible: + const: dlg,da9063-watchdog + +required: + - compatible + +additionalProperties: false

[2/2] dt-bindings: Migrate DA9063 text bindings to YAML

Commit Message

Comments

Patch