All of lore.kernel.org
 help / color / mirror / Atom feed
From: Sebastian Reichel <sebastian.reichel@collabora.com>
To: Sebastian Reichel <sre@kernel.org>, Rob Herring <robh+dt@kernel.org>
Cc: linux-pm@vger.kernel.org, devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	Sebastian Reichel <sebastian.reichel@collabora.com>,
	kernel@collabora.com
Subject: [PATCHv2 08/38] dt-bindings: power: supply: bq24735: Convert to DT schema format
Date: Wed, 17 Mar 2021 14:48:34 +0100	[thread overview]
Message-ID: <20210317134904.80737-9-sebastian.reichel@collabora.com> (raw)
In-Reply-To: <20210317134904.80737-1-sebastian.reichel@collabora.com>

Convert the binding to DT schema format.

Signed-off-by: Sebastian Reichel <sebastian.reichel@collabora.com>
---
 .../bindings/power/supply/bq24735.yaml        | 89 +++++++++++++++++++
 .../bindings/power/supply/ti,bq24735.txt      | 39 --------
 2 files changed, 89 insertions(+), 39 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/power/supply/bq24735.yaml
 delete mode 100644 Documentation/devicetree/bindings/power/supply/ti,bq24735.txt

diff --git a/Documentation/devicetree/bindings/power/supply/bq24735.yaml b/Documentation/devicetree/bindings/power/supply/bq24735.yaml
new file mode 100644
index 000000000000..131be6782c4b
--- /dev/null
+++ b/Documentation/devicetree/bindings/power/supply/bq24735.yaml
@@ -0,0 +1,89 @@
+# SPDX-License-Identifier: GPL-2.0
+# Copyright (C) 2021 Sebastian Reichel
+%YAML 1.2
+---
+$id: "http://devicetree.org/schemas/power/supply/bq24735.yaml#"
+$schema: "http://devicetree.org/meta-schemas/core.yaml#"
+
+title: Binding for TI BQ24735 Li-Ion Battery Charger
+
+maintainers:
+  - Sebastian Reichel <sre@kernel.org>
+
+allOf:
+  - $ref: power-supply.yaml#
+
+properties:
+  compatible:
+    const: ti,bq24735
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    description: AC adapter plug event interrupt
+    maxItems: 1
+
+  ti,ac-detect-gpios:
+    maxItems: 1
+    description: |
+      This GPIO is optionally used to read the AC adapter status. This is a Host GPIO
+      that is configured as an input and connected to the ACOK pin on the bq24735.
+      Note: for backwards compatibility reasons, the GPIO must be active on AC adapter
+      absence despite ACOK being active (high) on AC adapter presence.
+
+  ti,charge-current:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description: |
+      Used to control and set the charging current.
+      This value must be between 128mA and 8.128A with a 64mA step resolution.
+      The POR value is 0x0000h. This number is in mA (e.g. 8192).
+      See spec for more information about the ChargeCurrent (0x14h) register.
+
+  ti,charge-voltage:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description: |
+      Used to control and set the charging voltage.
+      This value must be between 1.024V and 19.2V with a 16mV step resolution.
+      The POR value is 0x0000h. This number is in mV (e.g. 19200).
+      See spec for more information about the ChargeVoltage (0x15h) register.
+
+  ti,input-current:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description: |
+      Used to control and set the charger input current.
+      This value must be between 128mA and 8.064A with a 128mA step resolution.
+      The POR value is 0x1000h. This number is in mA (e.g. 8064).
+      See the spec for more information about the InputCurrent (0x3fh) register.
+
+  ti,external-control:
+    type: boolean
+    description: |
+      Indicates that the charger is configured externally and that the host should not
+      attempt to enable/disable charging or set the charge voltage/current.
+
+  poll-interval:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description: |
+      If 'interrupts' is not specified, poll AC adapter presence with this interval (milliseconds).
+
+required:
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/gpio/gpio.h>
+
+    i2c0 {
+      #address-cells = <1>;
+      #size-cells = <0>;
+
+      charger@9 {
+        compatible = "ti,bq24735";
+        reg = <0x9>;
+        ti,ac-detect-gpios = <&gpio 72 0x1>;
+      };
+    };
diff --git a/Documentation/devicetree/bindings/power/supply/ti,bq24735.txt b/Documentation/devicetree/bindings/power/supply/ti,bq24735.txt
deleted file mode 100644
index de45e1a2a4d9..000000000000
--- a/Documentation/devicetree/bindings/power/supply/ti,bq24735.txt
+++ /dev/null
@@ -1,39 +0,0 @@
-TI BQ24735 Charge Controller
-~~~~~~~~~~
-
-Required properties :
- - compatible : "ti,bq24735"
-
-Optional properties :
- - interrupts : Specify the interrupt to be used to trigger when the AC
-   adapter is either plugged in or removed.
- - ti,ac-detect-gpios : This GPIO is optionally used to read the AC adapter
-   status. This is a Host GPIO that is configured as an input and connected
-   to the ACOK pin on the bq24735. Note: for backwards compatibility reasons,
-   the GPIO must be active on AC adapter absence despite ACOK being active
-   (high) on AC adapter presence.
- - ti,charge-current : Used to control and set the charging current. This value
-   must be between 128mA and 8.128A with a 64mA step resolution. The POR value
-   is 0x0000h. This number is in mA (e.g. 8192), see spec for more information
-   about the ChargeCurrent (0x14h) register.
- - ti,charge-voltage : Used to control and set the charging voltage. This value
-   must be between 1.024V and 19.2V with a 16mV step resolution. The POR value
-   is 0x0000h. This number is in mV (e.g. 19200), see spec for more information
-   about the ChargeVoltage (0x15h) register.
- - ti,input-current : Used to control and set the charger input current. This
-   value must be between 128mA and 8.064A with a 128mA step resolution. The
-   POR value is 0x1000h. This number is in mA (e.g. 8064), see the spec for
-   more information about the InputCurrent (0x3fh) register.
- - ti,external-control : Indicates that the charger is configured externally
-   and that the host should not attempt to enable/disable charging or set the
-   charge voltage/current.
- - poll-interval : In case 'interrupts' is not specified, poll AC adapter
-   presence with this interval (milliseconds).
-
-Example:
-
-	bq24735@9 {
-		compatible = "ti,bq24735";
-		reg = <0x9>;
-		ti,ac-detect-gpios = <&gpio 72 0x1>;
-	}
-- 
2.30.2


  parent reply	other threads:[~2021-03-17 13:50 UTC|newest]

Thread overview: 51+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-03-17 13:48 [PATCHv2 00/38] Convert power-supply DT bindings to YAML Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 01/38] ARM: dts: motorola-cpcap-mapphone: Prepare for dtbs_check parsing Sebastian Reichel
2021-03-17 14:29   ` Tony Lindgren
2021-03-23 12:51     ` Sebastian Reichel
2021-03-23 12:56       ` Tony Lindgren
2021-03-17 13:48 ` [PATCHv2 02/38] dt-bindings: power: supply: cpcap-battery: Convert to DT schema format Sebastian Reichel
2021-03-19 10:18   ` Tony Lindgren
2021-03-17 13:48 ` [PATCHv2 03/38] dt-bindings: power: supply: cpcap-charger: " Sebastian Reichel
2021-03-19 10:18   ` Tony Lindgren
2021-03-17 13:48 ` [PATCHv2 04/38] dt-bindings: power: supply: bq25890: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 05/38] dt-bindings: power: supply: bq24257: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 06/38] dt-bindings: power: supply: bq24190: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 07/38] dt-bindings: power: supply: bq2415x: " Sebastian Reichel
2021-03-17 13:48 ` Sebastian Reichel [this message]
2021-03-17 13:48 ` [PATCHv2 09/38] dt-bindings: power: supply: isp1704: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 10/38] dt-bindings: power: supply: sbs-charger: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 11/38] dt-bindings: power: supply: sbs-manager: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 12/38] dt-bindings: power: supply: ds2760: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 13/38] dt-bindings: power: supply: sc27xx-fg: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 14/38] dt-bindings: power: supply: sc2731-charger: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 15/38] dt-bindings: power: supply: tps65090: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 16/38] dt-bindings: power: supply: tps65217: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 17/38] dt-bindings: power: supply: twl4030: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 18/38] dt-bindings: power: supply: n900-battery: " Sebastian Reichel
2021-03-17 17:01   ` Pali Rohár
2021-03-17 13:48 ` [PATCHv2 19/38] dt-bindings: power: supply: lego-ev3-battery: " Sebastian Reichel
2021-03-23 16:57   ` David Lechner
2021-03-17 13:48 ` [PATCHv2 20/38] dt-bindings: power: supply: max17040: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 21/38] dt-bindings: power: supply: max14656: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 22/38] dt-bindings: power: supply: max17042: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 23/38] dt-bindings: power: supply: max8903: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 24/38] dt-bindings: power: supply: ucs1002: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 25/38] dt-bindings: power: supply: pm8941-charger: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 26/38] dt-bindings: power: supply: pm8941-coincell: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 27/38] dt-bindings: power: supply: act8945a: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 28/38] dt-bindings: power: supply: axp20x: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 29/38] dt-bindings: power: supply: da9150: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 30/38] dt-bindings: power: supply: lp8727: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 31/38] dt-bindings: power: supply: lt3651: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 32/38] dt-bindings: power: supply: ltc294x: " Sebastian Reichel
2021-03-17 13:48 ` [PATCHv2 33/38] dt-bindings: power: supply: rt9455: " Sebastian Reichel
2021-03-17 13:49 ` [PATCHv2 34/38] dt-bindings: power: supply: olpc-battery: " Sebastian Reichel
2021-03-17 13:49 ` [PATCHv2 35/38] dt-bindings: power: supply: ab8500: " Sebastian Reichel
2021-04-08 23:28   ` Linus Walleij
2021-04-09 13:43     ` Sebastian Reichel
2021-03-17 13:49 ` [PATCHv2 36/38] dt-bindings: power: supply: sbs-battery: Fix dtbs_check Sebastian Reichel
2021-03-17 13:49 ` [PATCHv2 37/38] dt-bindings: power: supply: Fix remaining battery.txt links Sebastian Reichel
2021-03-17 13:49 ` [PATCHv2 38/38] dt-bindings: power: supply: Drop power_supply.txt Sebastian Reichel
2021-03-22 16:25 ` [PATCHv2 00/38] Convert power-supply DT bindings to YAML Rob Herring
2021-03-22 21:42   ` Sebastian Reichel
2021-03-23  1:05     ` Rob Herring

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210317134904.80737-9-sebastian.reichel@collabora.com \
    --to=sebastian.reichel@collabora.com \
    --cc=devicetree@vger.kernel.org \
    --cc=kernel@collabora.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-pm@vger.kernel.org \
    --cc=robh+dt@kernel.org \
    --cc=sre@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.