# \[PATCH v4 0/6\] dt-bindings: max77650: convert the device-tree bindings to yaml

- Subsystems: INPUT (KEYBOARD, MOUSE, JOYSTICK, TOUCHSCREEN) DRIVERS, LED SUBSYSTEM, MAXIM MAX77650 PMIC MFD DRIVER, MULTIFUNCTION DEVICES (MFD), OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS, POWER SUPPLY CLASS/SUBSYSTEM and DRIVERS, THE REST, VOLTAGE AND CURRENT REGULATOR FRAMEWORK
- Maintainers: Dmitry Torokhov, Lee Jones, Pavel Machek, Bartosz Golaszewski, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Sebastian Reichel, Linus Torvalds, Liam Girdwood, Mark Brown
- Series: 6 patches touching 11 files, +302/-200
- Status: PENDING · 2 of 6 reviewed
- Pending, 2 of 6 reviewed.
- Revision v4 (4 revisions archived).
- List: linux-input
- 19 messages, 6 authors
- Page: https://ratatoskr.run/linux-input/2019/10/5751321/t

## \[PATCH v4 0/6\] dt-bindings: max77650: convert the device-tree bindings to yaml

- From: Bartosz Golaszewski \<hidden\>
- Date: 2019-10-21 12:44:39 
- Message: https://ratatoskr.run/linux-input/2019/10/5751321.md

```text
From: Bartosz Golaszewski <redacted>

This series converts all DT binding documents for MAX77650 PMIC to YAML.

v1 -> v2:
- use upper case for abbreviations in commit messages

v2 -> v3:
- pull all example fragments into the binding document for the core MFD module
- fix all dt_binding_check errors
- add references to submodules to the main binding document
- drop the type for gpio-line-names
- drop the description for the interrupts property
- completely delete the previous txt files

v3 -> v4:
- remove unnecessary parts of descriptions, added details on the chip
- correct file references (.txt -> .yaml)
- fix mixing scalar and array constraints
- dropped type refs for globally defined properties

Bartosz Golaszewski (6):
  dt-bindings: input: max77650: convert the binding document to yaml
  dt-bindings: regulator: max77650: convert the binding document to yaml
  dt-bindings: power: max77650: convert the binding document to yaml
  dt-bindings: leds: max77650: convert the binding document to yaml
  dt-bindings: mfd: max77650: convert the binding document to yaml
  MAINTAINERS: update the list of maintained files for max77650

 .../bindings/input/max77650-onkey.txt         |  26 ---
 .../bindings/input/max77650-onkey.yaml        |  35 ++++
 .../bindings/leds/leds-max77650.txt           |  57 -------
 .../bindings/leds/leds-max77650.yaml          |  51 ++++++
 .../devicetree/bindings/mfd/max77650.txt      |  46 ------
 .../devicetree/bindings/mfd/max77650.yaml     | 149 ++++++++++++++++++
 .../power/supply/max77650-charger.txt         |  28 ----
 .../power/supply/max77650-charger.yaml        |  34 ++++
 .../bindings/regulator/max77650-regulator.txt |  41 -----
 .../regulator/max77650-regulator.yaml         |  31 ++++
 MAINTAINERS                                   |   4 +-
 11 files changed, 302 insertions(+), 200 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/input/max77650-onkey.txt
 create mode 100644 Documentation/devicetree/bindings/input/max77650-onkey.yaml
 delete mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.txt
 create mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.yaml
 delete mode 100644 Documentation/devicetree/bindings/mfd/max77650.txt
 create mode 100644 Documentation/devicetree/bindings/mfd/max77650.yaml
 delete mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.txt
 create mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.yaml
 delete mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.txt
 create mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.yaml

-- 
2.23.0

```

## \[PATCH v4 1/6\] dt-bindings: input: max77650: convert the binding document to yaml

- From: Bartosz Golaszewski \<hidden\>
- Date: 2019-10-21 12:44:41 
- Message: https://ratatoskr.run/linux-input/2019/10/5751322.md

```text
From: Bartosz Golaszewski <redacted>

Convert the binding document for MAX77650 onkey module to YAML.

Signed-off-by: Bartosz Golaszewski <redacted>
Reviewed-by: Rob Herring <robh@kernel.org>
---
 .../bindings/input/max77650-onkey.txt         | 26 --------------
 .../bindings/input/max77650-onkey.yaml        | 35 +++++++++++++++++++
 2 files changed, 35 insertions(+), 26 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/input/max77650-onkey.txt
 create mode 100644 Documentation/devicetree/bindings/input/max77650-onkey.yaml

diff --git a/Documentation/devicetree/bindings/input/max77650-onkey.txt b/Documentation/devicetree/bindings/input/max77650-onkey.txt
deleted file mode 100644
index 477dc74f452a..000000000000
--- a/Documentation/devicetree/bindings/input/max77650-onkey.txt
+++ /dev/null
@@ -1,26 +0,0 @@
-Onkey driver for MAX77650 PMIC from Maxim Integrated.
-
-This module is part of the MAX77650 MFD device. For more details
-see Documentation/devicetree/bindings/mfd/max77650.txt.
-
-The onkey controller is represented as a sub-node of the PMIC node on
-the device tree.
-
-Required properties:
---------------------
-- compatible:		Must be "maxim,max77650-onkey".
-
-Optional properties:
-- linux,code:		The key-code to be reported when the key is pressed.
-			Defaults to KEY_POWER.
-- maxim,onkey-slide:	The system's button is a slide switch, not the default
-			push button.
-
-Example:
---------
-
-	onkey {
-		compatible = "maxim,max77650-onkey";
-		linux,code = <KEY_END>;
-		maxim,onkey-slide;
-	};
diff --git a/Documentation/devicetree/bindings/input/max77650-onkey.yaml b/Documentation/devicetree/bindings/input/max77650-onkey.yaml
new file mode 100644
index 000000000000..2f2e0b6ebbbd
--- /dev/null
+++ b/Documentation/devicetree/bindings/input/max77650-onkey.yaml
@@ -0,0 +1,35 @@
+# SPDX-License-Identifier: GPL-2.0
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/input/max77650-onkey.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Onkey driver for MAX77650 PMIC from Maxim Integrated.
+
+maintainers:
+  - Bartosz Golaszewski <bgolaszewski@baylibre.com>
+
+description: |
+  This module is part of the MAX77650 MFD device. For more details
+  see Documentation/devicetree/bindings/mfd/max77650.yaml.
+
+  The onkey controller is represented as a sub-node of the PMIC node on
+  the device tree.
+
+properties:
+  compatible:
+    const: maxim,max77650-onkey
+
+  linux,code:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description:
+      The key-code to be reported when the key is pressed. Defaults
+      to KEY_POWER.
+
+  maxim,onkey-slide:
+    $ref: /schemas/types.yaml#/definitions/flag
+    description:
+      The system's button is a slide switch, not the default push button.
+
+required:
+  - compatible
-- 
2.23.0

```

## \[PATCH v4 4/6\] dt-bindings: leds: max77650: convert the binding document to yaml

- From: Bartosz Golaszewski \<hidden\>
- Date: 2019-10-21 12:44:46 
- Message: https://ratatoskr.run/linux-input/2019/10/5751323.md

```text
From: Bartosz Golaszewski <redacted>

Convert the binding document for MAX77650 LED module to YAML.

Signed-off-by: Bartosz Golaszewski <redacted>
---
 .../bindings/leds/leds-max77650.txt           | 57 -------------------
 .../bindings/leds/leds-max77650.yaml          | 51 +++++++++++++++++
 2 files changed, 51 insertions(+), 57 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.txt
 create mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.yaml

diff --git a/Documentation/devicetree/bindings/leds/leds-max77650.txt b/Documentation/devicetree/bindings/leds/leds-max77650.txt
deleted file mode 100644
index 3a67115cc1da..000000000000
--- a/Documentation/devicetree/bindings/leds/leds-max77650.txt
+++ /dev/null
@@ -1,57 +0,0 @@
-LED driver for MAX77650 PMIC from Maxim Integrated.
-
-This module is part of the MAX77650 MFD device. For more details
-see Documentation/devicetree/bindings/mfd/max77650.txt.
-
-The LED controller is represented as a sub-node of the PMIC node on
-the device tree.
-
-This device has three current sinks.
-
-Required properties:
---------------------
-- compatible:		Must be "maxim,max77650-led"
-- #address-cells:	Must be <1>.
-- #size-cells:		Must be <0>.
-
-Each LED is represented as a sub-node of the LED-controller node. Up to
-three sub-nodes can be defined.
-
-Required properties of the sub-node:
-------------------------------------
-
-- reg:			Must be <0>, <1> or <2>.
-
-Optional properties of the sub-node:
-------------------------------------
-
-- label:		See Documentation/devicetree/bindings/leds/common.txt
-- linux,default-trigger: See Documentation/devicetree/bindings/leds/common.txt
-
-For more details, please refer to the generic GPIO DT binding document
-<devicetree/bindings/gpio/gpio.txt>.
-
-Example:
---------
-
-	leds {
-		compatible = "maxim,max77650-led";
-		#address-cells = <1>;
-		#size-cells = <0>;
-
-		led@0 {
-			reg = <0>;
-			label = "blue:usr0";
-		};
-
-		led@1 {
-			reg = <1>;
-			label = "red:usr1";
-			linux,default-trigger = "heartbeat";
-		};
-
-		led@2 {
-			reg = <2>;
-			label = "green:usr2";
-		};
-	};
diff --git a/Documentation/devicetree/bindings/leds/leds-max77650.yaml b/Documentation/devicetree/bindings/leds/leds-max77650.yaml
new file mode 100644
index 000000000000..8c43f1e1bf7d
--- /dev/null
+++ b/Documentation/devicetree/bindings/leds/leds-max77650.yaml
@@ -0,0 +1,51 @@
+# SPDX-License-Identifier: GPL-2.0
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/leds/leds-max77650.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: LED driver for MAX77650 PMIC from Maxim Integrated.
+
+maintainers:
+  - Bartosz Golaszewski <bgolaszewski@baylibre.com>
+
+description: |
+  This module is part of the MAX77650 MFD device. For more details
+  see Documentation/devicetree/bindings/mfd/max77650.yaml.
+
+  The LED controller is represented as a sub-node of the PMIC node on
+  the device tree.
+
+  This device has three current sinks.
+
+properties:
+  compatible:
+    const: maxim,max77650-led
+
+  "#address-cells":
+    const: 1
+
+  "#size-cells":
+    const: 0
+
+patternProperties:
+  "^led@[0-2]$":
+    type: object
+    description: |
+      Properties for a single LED.
+
+    properties:
+      reg:
+        description:
+          Index of the LED.
+        minimum: 0
+        maximum: 2
+
+      label: true
+
+      linux,default-trigger: true
+
+required:
+  - compatible
+  - "#address-cells"
+  - "#size-cells"
-- 
2.23.0

```

## \[PATCH v4 6/6\] MAINTAINERS: update the list of maintained files for max77650

- From: Bartosz Golaszewski \<hidden\>
- Date: 2019-10-21 12:44:47 
- Message: https://ratatoskr.run/linux-input/2019/10/5751324.md

```text
From: Bartosz Golaszewski <redacted>

The DT bindings for MAX77650 MFD have now been converted to YAML.
Update the MAINTAINERS entry for this set of drivers.

Signed-off-by: Bartosz Golaszewski <redacted>
---
 MAINTAINERS | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/MAINTAINERS b/MAINTAINERS
index e51a68bf8ca8..aba7de45a7ca 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -9903,8 +9903,8 @@ MAXIM MAX77650 PMIC MFD DRIVER
 M:	Bartosz Golaszewski <bgolaszewski@baylibre.com>
 L:	linux-kernel@vger.kernel.org
 S:	Maintained
-F:	Documentation/devicetree/bindings/*/*max77650.txt
-F:	Documentation/devicetree/bindings/*/max77650*.txt
+F:	Documentation/devicetree/bindings/*/*max77650.yaml
+F:	Documentation/devicetree/bindings/*/max77650*.yaml
 F:	include/linux/mfd/max77650.h
 F:	drivers/mfd/max77650.c
 F:	drivers/regulator/max77650-regulator.c
-- 
2.23.0

```

## \[PATCH v4 5/6\] dt-bindings: mfd: max77650: convert the binding document to yaml

- From: Bartosz Golaszewski \<hidden\>
- Date: 2019-10-21 12:44:56 
- Message: https://ratatoskr.run/linux-input/2019/10/5751325.md

```text
From: Bartosz Golaszewski <redacted>

Convert the binding document for MAX77650 core MFD module to YAML.

Signed-off-by: Bartosz Golaszewski <redacted>
---
 .../devicetree/bindings/mfd/max77650.txt      |  46 ------
 .../devicetree/bindings/mfd/max77650.yaml     | 149 ++++++++++++++++++
 2 files changed, 149 insertions(+), 46 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/mfd/max77650.txt
 create mode 100644 Documentation/devicetree/bindings/mfd/max77650.yaml

diff --git a/Documentation/devicetree/bindings/mfd/max77650.txt b/Documentation/devicetree/bindings/mfd/max77650.txt
deleted file mode 100644
index b529d8d19335..000000000000
--- a/Documentation/devicetree/bindings/mfd/max77650.txt
+++ /dev/null
@@ -1,46 +0,0 @@
-MAX77650 ultra low-power PMIC from Maxim Integrated.
-
-Required properties:
--------------------
-- compatible:		Must be "maxim,max77650"
-- reg:			I2C device address.
-- interrupts:		The interrupt on the parent the controller is
-			connected to.
-- interrupt-controller: Marks the device node as an interrupt controller.
-- #interrupt-cells:	Must be <2>.
-
-- gpio-controller:	Marks the device node as a gpio controller.
-- #gpio-cells:		Must be <2>. The first cell is the pin number and
-			the second cell is used to specify the gpio active
-			state.
-
-Optional properties:
---------------------
-gpio-line-names:	Single string containing the name of the GPIO line.
-
-The GPIO-controller module is represented as part of the top-level PMIC
-node. The device exposes a single GPIO line.
-
-For device-tree bindings of other sub-modules (regulator, power supply,
-LEDs and onkey) refer to the binding documents under the respective
-sub-system directories.
-
-For more details on GPIO bindings, please refer to the generic GPIO DT
-binding document <devicetree/bindings/gpio/gpio.txt>.
-
-Example:
---------
-
-	pmic@48 {
-		compatible = "maxim,max77650";
-		reg = <0x48>;
-
-		interrupt-controller;
-		interrupt-parent = <&gpio2>;
-		#interrupt-cells = <2>;
-		interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
-
-		gpio-controller;
-		#gpio-cells = <2>;
-		gpio-line-names = "max77650-charger";
-	};
diff --git a/Documentation/devicetree/bindings/mfd/max77650.yaml b/Documentation/devicetree/bindings/mfd/max77650.yaml
new file mode 100644
index 000000000000..4a70f875a6eb
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/max77650.yaml
@@ -0,0 +1,149 @@
+# SPDX-License-Identifier: GPL-2.0
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/mfd/max77650.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: MAX77650 ultra low-power PMIC from Maxim Integrated.
+
+maintainers:
+  - Bartosz Golaszewski <bgolaszewski@baylibre.com>
+
+description: |
+  MAX77650 is an ultra-low power PMIC providing battery charging and power
+  supply for low-power IoT and wearable applications.
+
+  The GPIO-controller module is represented as part of the top-level PMIC
+  node. The device exposes a single GPIO line.
+
+  For device-tree bindings of other sub-modules (regulator, power supply,
+  LEDs and onkey) refer to the binding documents under the respective
+  sub-system directories.
+
+properties:
+  compatible:
+    const: maxim,max77650
+
+  reg:
+    description:
+      I2C device address.
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+  interrupt-controller: true
+
+  "#interrupt-cells":
+    const: 2
+    description:
+      The first cell is the IRQ number, the second cell is the trigger type.
+
+  gpio-controller: true
+
+  "#gpio-cells":
+    const: 2
+    description:
+      The first cell is the pin number and the second cell is used to specify
+      the gpio active state.
+
+  gpio-line-names:
+    maxItems: 1
+    description:
+      Single string containing the name of the GPIO line.
+
+  regulators:
+    $ref: ../regulator/max77650-regulator.yaml
+
+  charger:
+    $ref: ../power/supply/max77650-charger.yaml
+
+  leds:
+    $ref: ../leds/leds-max77650.yaml
+
+  onkey:
+    $ref: ../input/max77650-onkey.yaml
+
+required:
+  - compatible
+  - reg
+  - interrupts
+  - interrupt-controller
+  - "#interrupt-cells"
+  - gpio-controller
+  - "#gpio-cells"
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/irq.h>
+    #include <dt-bindings/input/linux-event-codes.h>
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        pmic@48 {
+            compatible = "maxim,max77650";
+            reg = <0x48>;
+
+            interrupt-controller;
+            interrupt-parent = <&gpio2>;
+            #interrupt-cells = <2>;
+            interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
+
+            gpio-controller;
+            #gpio-cells = <2>;
+            gpio-line-names = "max77650-charger";
+
+            regulators {
+                compatible = "maxim,max77650-regulator";
+
+                max77650_ldo: regulator@0 {
+                    regulator-compatible = "ldo";
+                    regulator-name = "max77650-ldo";
+                    regulator-min-microvolt = <1350000>;
+                    regulator-max-microvolt = <2937500>;
+                };
+
+                max77650_sbb0: regulator@1 {
+                    regulator-compatible = "sbb0";
+                    regulator-name = "max77650-sbb0";
+                    regulator-min-microvolt = <800000>;
+                    regulator-max-microvolt = <1587500>;
+                };
+            };
+
+            charger {
+                compatible = "maxim,max77650-charger";
+                input-voltage-min-microvolt = <4200000>;
+                input-current-limit-microamp = <285000>;
+            };
+
+            leds {
+                compatible = "maxim,max77650-led";
+                #address-cells = <1>;
+                #size-cells = <0>;
+
+                led@0 {
+                    reg = <0>;
+                    label = "blue:usr0";
+                };
+
+                led@1 {
+                    reg = <1>;
+                    label = "red:usr1";
+                    linux,default-trigger = "heartbeat";
+                };
+
+                led@2 {
+                    reg = <2>;
+                    label = "green:usr2";
+                };
+            };
+
+            onkey {
+                compatible = "maxim,max77650-onkey";
+                linux,code = <KEY_END>;
+                maxim,onkey-slide;
+            };
+        };
+    };
-- 
2.23.0

```

## \[PATCH v4 3/6\] dt-bindings: power: max77650: convert the binding document to yaml

- From: Bartosz Golaszewski \<hidden\>
- Date: 2019-10-21 12:45:03 
- Message: https://ratatoskr.run/linux-input/2019/10/5751327.md

```text
From: Bartosz Golaszewski <redacted>

Convert the binding document for MAX77650 charger module to YAML.

Signed-off-by: Bartosz Golaszewski <redacted>
Acked-by: Sebastian Reichel <sre@kernel.org>
---
 .../power/supply/max77650-charger.txt         | 28 ---------------
 .../power/supply/max77650-charger.yaml        | 34 +++++++++++++++++++
 2 files changed, 34 insertions(+), 28 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.txt
 create mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.yaml

diff --git a/Documentation/devicetree/bindings/power/supply/max77650-charger.txt b/Documentation/devicetree/bindings/power/supply/max77650-charger.txt
deleted file mode 100644
index e6d0fb6ff94e..000000000000
--- a/Documentation/devicetree/bindings/power/supply/max77650-charger.txt
+++ /dev/null
@@ -1,28 +0,0 @@
-Battery charger driver for MAX77650 PMIC from Maxim Integrated.
-
-This module is part of the MAX77650 MFD device. For more details
-see Documentation/devicetree/bindings/mfd/max77650.txt.
-
-The charger is represented as a sub-node of the PMIC node on the device tree.
-
-Required properties:
---------------------
-- compatible:		Must be "maxim,max77650-charger"
-
-Optional properties:
---------------------
-- input-voltage-min-microvolt:	Minimum CHGIN regulation voltage. Must be one
-				of: 4000000, 4100000, 4200000, 4300000,
-				4400000, 4500000, 4600000, 4700000.
-- input-current-limit-microamp:	CHGIN input current limit (in microamps). Must
-				be one of: 95000, 190000, 285000, 380000,
-				475000.
-
-Example:
---------
-
-	charger {
-		compatible = "maxim,max77650-charger";
-		input-voltage-min-microvolt = <4200000>;
-		input-current-limit-microamp = <285000>;
-	};
diff --git a/Documentation/devicetree/bindings/power/supply/max77650-charger.yaml b/Documentation/devicetree/bindings/power/supply/max77650-charger.yaml
new file mode 100644
index 000000000000..deef010ec535
--- /dev/null
+++ b/Documentation/devicetree/bindings/power/supply/max77650-charger.yaml
@@ -0,0 +1,34 @@
+# SPDX-License-Identifier: GPL-2.0
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/power/supply/max77650-charger.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Battery charger driver for MAX77650 PMIC from Maxim Integrated.
+
+maintainers:
+  - Bartosz Golaszewski <bgolaszewski@baylibre.com>
+
+description: |
+  This module is part of the MAX77650 MFD device. For more details
+  see Documentation/devicetree/bindings/mfd/max77650.yaml.
+
+  The charger is represented as a sub-node of the PMIC node on the device tree.
+
+properties:
+  compatible:
+    const: maxim,max77650-charger
+
+  input-voltage-min-microvolt:
+    description:
+      Minimum CHGIN regulation voltage.
+    enum: [ 4000000, 4100000, 4200000, 4300000,
+            4400000, 4500000, 4600000, 4700000 ]
+
+  input-current-limit-microamp:
+    description:
+      CHGIN input current limit (in microamps).
+    enum: [ 95000, 190000, 285000, 380000, 475000 ]
+
+required:
+  - compatible
-- 
2.23.0

```

## \[PATCH v4 2/6\] dt-bindings: regulator: max77650: convert the binding document to yaml

- From: Bartosz Golaszewski \<hidden\>
- Date: 2019-10-21 12:45:08 
- Message: https://ratatoskr.run/linux-input/2019/10/5751328.md

```text
From: Bartosz Golaszewski <redacted>

Convert the binding document for MAX77650 regulator module to YAML.

Signed-off-by: Bartosz Golaszewski <redacted>
---
 .../bindings/regulator/max77650-regulator.txt | 41 -------------------
 .../regulator/max77650-regulator.yaml         | 31 ++++++++++++++
 2 files changed, 31 insertions(+), 41 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.txt
 create mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.yaml

diff --git a/Documentation/devicetree/bindings/regulator/max77650-regulator.txt b/Documentation/devicetree/bindings/regulator/max77650-regulator.txt
deleted file mode 100644
index f1cbe813c30f..000000000000
--- a/Documentation/devicetree/bindings/regulator/max77650-regulator.txt
+++ /dev/null
@@ -1,41 +0,0 @@
-Regulator driver for MAX77650 PMIC from Maxim Integrated.
-
-This module is part of the MAX77650 MFD device. For more details
-see Documentation/devicetree/bindings/mfd/max77650.txt.
-
-The regulator controller is represented as a sub-node of the PMIC node
-on the device tree.
-
-The device has a single LDO regulator and a SIMO buck-boost regulator with
-three independent power rails.
-
-Required properties:
---------------------
-- compatible:		Must be "maxim,max77650-regulator"
-
-Each rail must be instantiated under the regulators subnode of the top PMIC
-node. Up to four regulators can be defined. For standard regulator properties
-refer to Documentation/devicetree/bindings/regulator/regulator.txt.
-
-Available regulator compatible strings are: "ldo", "sbb0", "sbb1", "sbb2".
-
-Example:
---------
-
-	regulators {
-		compatible = "maxim,max77650-regulator";
-
-		max77650_ldo: regulator@0 {
-			regulator-compatible = "ldo";
-			regulator-name = "max77650-ldo";
-			regulator-min-microvolt = <1350000>;
-			regulator-max-microvolt = <2937500>;
-		};
-
-		max77650_sbb0: regulator@1 {
-			regulator-compatible = "sbb0";
-			regulator-name = "max77650-sbb0";
-			regulator-min-microvolt = <800000>;
-			regulator-max-microvolt = <1587500>;
-		};
-	};
diff --git a/Documentation/devicetree/bindings/regulator/max77650-regulator.yaml b/Documentation/devicetree/bindings/regulator/max77650-regulator.yaml
new file mode 100644
index 000000000000..7d724159f890
--- /dev/null
+++ b/Documentation/devicetree/bindings/regulator/max77650-regulator.yaml
@@ -0,0 +1,31 @@
+# SPDX-License-Identifier: GPL-2.0
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/regulator/max77650-regulator.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Regulator driver for MAX77650 PMIC from Maxim Integrated.
+
+maintainers:
+  - Bartosz Golaszewski <bgolaszewski@baylibre.com>
+
+description: |
+  This module is part of the MAX77650 MFD device. For more details
+  see Documentation/devicetree/bindings/mfd/max77650.yaml.
+
+  The regulator controller is represented as a sub-node of the PMIC node
+  on the device tree.
+
+  The device has a single LDO regulator and a SIMO buck-boost regulator with
+  three independent power rails.
+
+properties:
+  compatible:
+    const: maxim,max77650-regulator
+
+patternProperties:
+  "^regulator@[0-3]$":
+    $ref: "regulator.yaml#"
+
+required:
+  - compatible
-- 
2.23.0

```

## Re: \[PATCH v4 2/6\] dt-bindings: regulator: max77650: convert the binding document to yaml

- From: Mark Brown \<broonie@kernel.org\>
- Date: 2019-10-22 10:27:46 
- Message: https://ratatoskr.run/linux-input/2019/10/5752506.md

```text
On Mon, Oct 21, 2019 at 02:44:24PM +0200, Bartosz Golaszewski wrote:
> From: Bartosz Golaszewski <redacted>
> 
> Convert the binding document for MAX77650 regulator module to YAML.

Acked-by: Mark Brown <broonie@kernel.org>
```

## Re: \[PATCH v4 2/6\] dt-bindings: regulator: max77650: convert the binding document to yaml

- From: Rob Herring \<robh@kernel.org\>
- Date: 2019-10-25 16:56:41 
- Message: https://ratatoskr.run/linux-input/2019/10/5756373.md

```text
On Mon, 21 Oct 2019 14:44:24 +0200, Bartosz Golaszewski wrote:
> From: Bartosz Golaszewski <redacted>
> 
> Convert the binding document for MAX77650 regulator module to YAML.
> 
> Signed-off-by: Bartosz Golaszewski <redacted>
> ---
>  .../bindings/regulator/max77650-regulator.txt | 41 -------------------
>  .../regulator/max77650-regulator.yaml         | 31 ++++++++++++++
>  2 files changed, 31 insertions(+), 41 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.txt
>  create mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.yaml
> 

Reviewed-by: Rob Herring <robh@kernel.org>
```

## Re: \[PATCH v4 3/6\] dt-bindings: power: max77650: convert the binding document to yaml

- From: Rob Herring \<robh@kernel.org\>
- Date: 2019-10-25 16:57:57 
- Message: https://ratatoskr.run/linux-input/2019/10/5756376.md

```text
On Mon, 21 Oct 2019 14:44:25 +0200, Bartosz Golaszewski wrote:
> From: Bartosz Golaszewski <redacted>
> 
> Convert the binding document for MAX77650 charger module to YAML.
> 
> Signed-off-by: Bartosz Golaszewski <redacted>
> Acked-by: Sebastian Reichel <sre@kernel.org>
> ---
>  .../power/supply/max77650-charger.txt         | 28 ---------------
>  .../power/supply/max77650-charger.yaml        | 34 +++++++++++++++++++
>  2 files changed, 34 insertions(+), 28 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.txt
>  create mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.yaml
> 

Reviewed-by: Rob Herring <robh@kernel.org>
```

## Re: \[PATCH v4 4/6\] dt-bindings: leds: max77650: convert the binding document to yaml

- From: Rob Herring \<robh@kernel.org\>
- Date: 2019-10-25 16:58:29 
- Message: https://ratatoskr.run/linux-input/2019/10/5756377.md

```text
On Mon, 21 Oct 2019 14:44:26 +0200, Bartosz Golaszewski wrote:
> From: Bartosz Golaszewski <redacted>
> 
> Convert the binding document for MAX77650 LED module to YAML.
> 
> Signed-off-by: Bartosz Golaszewski <redacted>
> ---
>  .../bindings/leds/leds-max77650.txt           | 57 -------------------
>  .../bindings/leds/leds-max77650.yaml          | 51 +++++++++++++++++
>  2 files changed, 51 insertions(+), 57 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.txt
>  create mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.yaml
> 

Reviewed-by: Rob Herring <robh@kernel.org>
```

## Re: \[PATCH v4 5/6\] dt-bindings: mfd: max77650: convert the binding document to yaml

- From: Rob Herring \<robh@kernel.org\>
- Date: 2019-10-25 17:02:44 
- Message: https://ratatoskr.run/linux-input/2019/10/5756380.md

```text
On Mon, 21 Oct 2019 14:44:27 +0200, Bartosz Golaszewski wrote:
> From: Bartosz Golaszewski <redacted>
> 
> Convert the binding document for MAX77650 core MFD module to YAML.
> 
> Signed-off-by: Bartosz Golaszewski <redacted>
> ---
>  .../devicetree/bindings/mfd/max77650.txt      |  46 ------
>  .../devicetree/bindings/mfd/max77650.yaml     | 149 ++++++++++++++++++
>  2 files changed, 149 insertions(+), 46 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/mfd/max77650.txt
>  create mode 100644 Documentation/devicetree/bindings/mfd/max77650.yaml
> 

Reviewed-by: Rob Herring <robh@kernel.org>
```

## Re: \[PATCH v4 0/6\] dt-bindings: max77650: convert the device-tree bindings to yaml

- From: Bartosz Golaszewski \<hidden\>
- Date: 2019-10-26 11:54:40 
- Message: https://ratatoskr.run/linux-input/2019/10/5756776.md

```text
pon., 21 paź 2019 o 14:44 Bartosz Golaszewski [ref] napisał(a):
>
> From: Bartosz Golaszewski <redacted>
>
> This series converts all DT binding documents for MAX77650 PMIC to YAML.
>
> v1 -> v2:
> - use upper case for abbreviations in commit messages
>
> v2 -> v3:
> - pull all example fragments into the binding document for the core MFD module
> - fix all dt_binding_check errors
> - add references to submodules to the main binding document
> - drop the type for gpio-line-names
> - drop the description for the interrupts property
> - completely delete the previous txt files
>
> v3 -> v4:
> - remove unnecessary parts of descriptions, added details on the chip
> - correct file references (.txt -> .yaml)
> - fix mixing scalar and array constraints
> - dropped type refs for globally defined properties
>
> Bartosz Golaszewski (6):
>   dt-bindings: input: max77650: convert the binding document to yaml
>   dt-bindings: regulator: max77650: convert the binding document to yaml
>   dt-bindings: power: max77650: convert the binding document to yaml
>   dt-bindings: leds: max77650: convert the binding document to yaml
>   dt-bindings: mfd: max77650: convert the binding document to yaml
>   MAINTAINERS: update the list of maintained files for max77650
>
>  .../bindings/input/max77650-onkey.txt         |  26 ---
>  .../bindings/input/max77650-onkey.yaml        |  35 ++++
>  .../bindings/leds/leds-max77650.txt           |  57 -------
>  .../bindings/leds/leds-max77650.yaml          |  51 ++++++
>  .../devicetree/bindings/mfd/max77650.txt      |  46 ------
>  .../devicetree/bindings/mfd/max77650.yaml     | 149 ++++++++++++++++++
>  .../power/supply/max77650-charger.txt         |  28 ----
>  .../power/supply/max77650-charger.yaml        |  34 ++++
>  .../bindings/regulator/max77650-regulator.txt |  41 -----
>  .../regulator/max77650-regulator.yaml         |  31 ++++
>  MAINTAINERS                                   |   4 +-
>  11 files changed, 302 insertions(+), 200 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/input/max77650-onkey.txt
>  create mode 100644 Documentation/devicetree/bindings/input/max77650-onkey.yaml
>  delete mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.txt
>  create mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.yaml
>  delete mode 100644 Documentation/devicetree/bindings/mfd/max77650.txt
>  create mode 100644 Documentation/devicetree/bindings/mfd/max77650.yaml
>  delete mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.txt
>  create mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.yaml
>  delete mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.txt
>  create mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.yaml
>
> --
> 2.23.0
>

Hi Rob,

thanks for reviewing the series. Can you please take it through your
tree for v5.5? I think it'll be easier than bothering all the
respective maintainers and it only touches on bindings anyway.

Thanks,
Bartosz
```

## Re: \[PATCH v4 0/6\] dt-bindings: max77650: convert the device-tree bindings to yaml

- From: Rob Herring \<robh+dt@kernel.org\>
- Date: 2019-10-27 21:38:11 
- Message: https://ratatoskr.run/linux-input/2019/10/5757817.md

```text
On Sat, Oct 26, 2019 at 6:54 AM Bartosz Golaszewski [ref] wrote:
>
> pon., 21 paź 2019 o 14:44 Bartosz Golaszewski [ref] napisał(a):
> >
> > From: Bartosz Golaszewski <redacted>
> >
> > This series converts all DT binding documents for MAX77650 PMIC to YAML.
> >
> > v1 -> v2:
> > - use upper case for abbreviations in commit messages
> >
> > v2 -> v3:
> > - pull all example fragments into the binding document for the core MFD module
> > - fix all dt_binding_check errors
> > - add references to submodules to the main binding document
> > - drop the type for gpio-line-names
> > - drop the description for the interrupts property
> > - completely delete the previous txt files
> >
> > v3 -> v4:
> > - remove unnecessary parts of descriptions, added details on the chip
> > - correct file references (.txt -> .yaml)
> > - fix mixing scalar and array constraints
> > - dropped type refs for globally defined properties
> >
> > Bartosz Golaszewski (6):
> >   dt-bindings: input: max77650: convert the binding document to yaml
> >   dt-bindings: regulator: max77650: convert the binding document to yaml
> >   dt-bindings: power: max77650: convert the binding document to yaml
> >   dt-bindings: leds: max77650: convert the binding document to yaml
> >   dt-bindings: mfd: max77650: convert the binding document to yaml
> >   MAINTAINERS: update the list of maintained files for max77650
> >
> >  .../bindings/input/max77650-onkey.txt         |  26 ---
> >  .../bindings/input/max77650-onkey.yaml        |  35 ++++
> >  .../bindings/leds/leds-max77650.txt           |  57 -------
> >  .../bindings/leds/leds-max77650.yaml          |  51 ++++++
> >  .../devicetree/bindings/mfd/max77650.txt      |  46 ------
> >  .../devicetree/bindings/mfd/max77650.yaml     | 149 ++++++++++++++++++
> >  .../power/supply/max77650-charger.txt         |  28 ----
> >  .../power/supply/max77650-charger.yaml        |  34 ++++
> >  .../bindings/regulator/max77650-regulator.txt |  41 -----
> >  .../regulator/max77650-regulator.yaml         |  31 ++++
> >  MAINTAINERS                                   |   4 +-
> >  11 files changed, 302 insertions(+), 200 deletions(-)
> >  delete mode 100644 Documentation/devicetree/bindings/input/max77650-onkey.txt
> >  create mode 100644 Documentation/devicetree/bindings/input/max77650-onkey.yaml
> >  delete mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.txt
> >  create mode 100644 Documentation/devicetree/bindings/leds/leds-max77650.yaml
> >  delete mode 100644 Documentation/devicetree/bindings/mfd/max77650.txt
> >  create mode 100644 Documentation/devicetree/bindings/mfd/max77650.yaml
> >  delete mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.txt
> >  create mode 100644 Documentation/devicetree/bindings/power/supply/max77650-charger.yaml
> >  delete mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.txt
> >  create mode 100644 Documentation/devicetree/bindings/regulator/max77650-regulator.yaml
> >
> > --
> > 2.23.0
> >
>
> Hi Rob,
>
> thanks for reviewing the series. Can you please take it through your
> tree for v5.5? I think it'll be easier than bothering all the
> respective maintainers and it only touches on bindings anyway.

Okay, series applied.

Rob
```

## Re: \[PATCH v4 5/6\] dt-bindings: mfd: max77650: convert the binding document to yaml

- From: Lee Jones \<hidden\>
- Date: 2019-11-11 08:08:49 
- Message: https://ratatoskr.run/linux-input/2019/11/5771906.md

```text
On Mon, 21 Oct 2019, Bartosz Golaszewski wrote:

> From: Bartosz Golaszewski <redacted>
> 
> Convert the binding document for MAX77650 core MFD module to YAML.
> 
> Signed-off-by: Bartosz Golaszewski <redacted>
> ---
>  .../devicetree/bindings/mfd/max77650.txt      |  46 ------
>  .../devicetree/bindings/mfd/max77650.yaml     | 149 ++++++++++++++++++
>  2 files changed, 149 insertions(+), 46 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/mfd/max77650.txt
>  create mode 100644 Documentation/devicetree/bindings/mfd/max77650.yaml

Applied, thanks.

-- 
Lee Jones [李琼斯]
Linaro Services Technical Lead
Linaro.org │ Open source software for ARM SoCs
Follow Linaro: Facebook | Twitter | Blog
```

## Re: \[PATCH v4 5/6\] dt-bindings: mfd: max77650: convert the binding document to yaml

- From: Bartosz Golaszewski \<hidden\>
- Date: 2019-11-11 19:11:39 
- Message: https://ratatoskr.run/linux-input/2019/11/5773033.md

```text
pon., 11 lis 2019 o 09:08 Lee Jones [ref] napisał(a):
>
> On Mon, 21 Oct 2019, Bartosz Golaszewski wrote:
>
> > From: Bartosz Golaszewski <redacted>
> >
> > Convert the binding document for MAX77650 core MFD module to YAML.
> >
> > Signed-off-by: Bartosz Golaszewski <redacted>
> > ---
> >  .../devicetree/bindings/mfd/max77650.txt      |  46 ------
> >  .../devicetree/bindings/mfd/max77650.yaml     | 149 ++++++++++++++++++
> >  2 files changed, 149 insertions(+), 46 deletions(-)
> >  delete mode 100644 Documentation/devicetree/bindings/mfd/max77650.txt
> >  create mode 100644 Documentation/devicetree/bindings/mfd/max77650.yaml
>
> Applied, thanks.
>

Hi Lee,

FYI this series is already in next through Rob's DT tree.

Bart

> --
> Lee Jones [李琼斯]
> Linaro Services Technical Lead
> Linaro.org │ Open source software for ARM SoCs
> Follow Linaro: Facebook | Twitter | Blog
```

## Re: \[PATCH v4 5/6\] dt-bindings: mfd: max77650: convert the binding document to yaml

- From: Lee Jones \<hidden\>
- Date: 2019-11-12 10:50:50 
- Message: https://ratatoskr.run/linux-input/2019/11/5773712.md

```text
On Mon, 11 Nov 2019, Bartosz Golaszewski wrote:

> pon., 11 lis 2019 o 09:08 Lee Jones [ref] napisał(a):
> >
> > On Mon, 21 Oct 2019, Bartosz Golaszewski wrote:
> >
> > > From: Bartosz Golaszewski <redacted>
> > >
> > > Convert the binding document for MAX77650 core MFD module to YAML.
> > >
> > > Signed-off-by: Bartosz Golaszewski <redacted>
> > > ---
> > >  .../devicetree/bindings/mfd/max77650.txt      |  46 ------
> > >  .../devicetree/bindings/mfd/max77650.yaml     | 149 ++++++++++++++++++
> > >  2 files changed, 149 insertions(+), 46 deletions(-)
> > >  delete mode 100644 Documentation/devicetree/bindings/mfd/max77650.txt
> > >  create mode 100644 Documentation/devicetree/bindings/mfd/max77650.yaml
> >
> > Applied, thanks.
> >
> 
> Hi Lee,
> 
> FYI this series is already in next through Rob's DT tree.

Why don't I see an 'applied' email?

-- 
Lee Jones [李琼斯]
Linaro Services Technical Lead
Linaro.org │ Open source software for ARM SoCs
Follow Linaro: Facebook | Twitter | Blog
```

## Re: \[PATCH v4 4/6\] dt-bindings: leds: max77650: convert the binding document to yaml

- From: Pavel Machek \<hidden\>
- Date: 2019-11-25 13:06:18 
- Message: https://ratatoskr.run/linux-input/2019/11/5787683.md

```text
On Mon 2019-10-21 14:44:26, Bartosz Golaszewski wrote:
> From: Bartosz Golaszewski <redacted>
> 
> Convert the binding document for MAX77650 LED module to YAML.
> 
> Signed-off-by: Bartosz Golaszewski <redacted>

Acked-by: Pavel Machek <redacted>

-- 
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html
```

## Re: \[PATCH v4 5/6\] dt-bindings: mfd: max77650: convert the binding document to yaml

- From: Rob Herring \<robh+dt@kernel.org\>
- Date: 2019-12-02 17:09:55 
- Message: https://ratatoskr.run/linux-input/2019/12/5792685.md

```text
On Tue, Nov 12, 2019 at 4:50 AM Lee Jones [ref] wrote:
>
> On Mon, 11 Nov 2019, Bartosz Golaszewski wrote:
>
> > pon., 11 lis 2019 o 09:08 Lee Jones [ref] napisał(a):
> > >
> > > On Mon, 21 Oct 2019, Bartosz Golaszewski wrote:
> > >
> > > > From: Bartosz Golaszewski <redacted>
> > > >
> > > > Convert the binding document for MAX77650 core MFD module to YAML.
> > > >
> > > > Signed-off-by: Bartosz Golaszewski <redacted>
> > > > ---
> > > >  .../devicetree/bindings/mfd/max77650.txt      |  46 ------
> > > >  .../devicetree/bindings/mfd/max77650.yaml     | 149 ++++++++++++++++++
> > > >  2 files changed, 149 insertions(+), 46 deletions(-)
> > > >  delete mode 100644 Documentation/devicetree/bindings/mfd/max77650.txt
> > > >  create mode 100644 Documentation/devicetree/bindings/mfd/max77650.yaml
> > >
> > > Applied, thanks.
> > >
> >
> > Hi Lee,
> >
> > FYI this series is already in next through Rob's DT tree.
>
> Why don't I see an 'applied' email?

There was discussion about it in the cover letter.

With the schema for MFDs, we need to merge all the schema thru one
tree because the main schema references the child node schemas.
Otherwise, 'make dt_binding_check' will start failing (as Linus' tree
is now). Perhaps we should encourage they be a single patche because
1) child devices alone don't make sense and 2) it will be clear not to
apply each separately.

Rob
```
