[05/38] dt-bindings: power: supply: bq24257: Convert to DT schema format

Message ID	20210312154357.1561730-6-sebastian.reichel@collabora.com
State	Superseded
Headers	show Return-Path: <linux-pm-owner@kernel.org> sender: sre) with ESMTPSA id 82E301F46E7A 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: [PATCH 05/38] dt-bindings: power: supply: bq24257: Convert to DT schema format Date: Fri, 12 Mar 2021 16:43:24 +0100 Message-Id: <20210312154357.1561730-6-sebastian.reichel@collabora.com> In-Reply-To: <20210312154357.1561730-1-sebastian.reichel@collabora.com> References: <20210312154357.1561730-1-sebastian.reichel@collabora.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk
Series	Convert power-supply DT bindings to YAML \| expand [00/38] Convert power-supply DT bindings to YAML [01/38] ARM: dts: motorola-cpcap-mapphone: Prepare for dtbs_check parsing [02/38] dt-bindings: power: supply: cpcap-battery: Convert to DT schema format [03/38] dt-bindings: power: supply: cpcap-charger: Convert to DT schema format [04/38] dt-bindings: power: supply: bq25890: Convert to DT schema format [05/38] dt-bindings: power: supply: bq24257: Convert to DT schema format [06/38] dt-bindings: power: supply: bq24190: Convert to DT schema format [07/38] dt-bindings: power: supply: bq2415x: Convert to DT schema format [08/38] dt-bindings: power: supply: bq24735: Convert to DT schema format [09/38] dt-bindings: power: supply: isp1704: Convert to DT schema format [10/38] dt-bindings: power: supply: sbs-charger: Convert to DT schema format [11/38] dt-bindings: power: supply: sbs-manager: Convert to DT schema format [12/38] dt-bindings: power: supply: ds2760: Convert to DT schema format [13/38] dt-bindings: power: supply: sc27xx-fg: Convert to DT schema format [14/38] dt-bindings: power: supply: sc2731-charger: Convert to DT schema format [15/38] dt-bindings: power: supply: tps65090: Convert to DT schema format [16/38] dt-bindings: power: supply: tps65217: Convert to DT schema format [17/38] dt-bindings: power: supply: twl4030: Convert to DT schema format [18/38] dt-bindings: power: supply: n900-battery: Convert to DT schema format [19/38] dt-bindings: power: supply: lego-ev3-battery: Convert to DT schema format [20/38] dt-bindings: power: supply: max17040: Convert to DT schema format [21/38] dt-bindings: power: supply: max14656: Convert to DT schema format [22/38] dt-bindings: power: supply: max17042: Convert to DT schema format [23/38] dt-bindings: power: supply: max8903: Convert to DT schema format [24/38] dt-bindings: power: supply: ucs1002: Convert to DT schema format [25/38] dt-bindings: power: supply: pm8941-charger: Convert to DT schema format [26/38] dt-bindings: power: supply: pm8941-coincell: Convert to DT schema format [27/38] dt-bindings: power: supply: act8945a: Convert to DT schema format [28/38] dt-bindings: power: supply: axp20x: Convert to DT schema format [29/38] dt-bindings: power: supply: da9150: Convert to DT schema format [30/38] dt-bindings: power: supply: lp8727: Convert to DT schema format [31/38] dt-bindings: power: supply: lt3651: Convert to DT schema format [32/38] dt-bindings: power: supply: ltc294x: Convert to DT schema format [33/38] dt-bindings: power: supply: rt9455: Convert to DT schema format [34/38] dt-bindings: power: supply: olpc-battery: Convert to DT schema format [35/38] dt-bindings: power: supply: ab8500: Convert to DT schema format [36/38] dt-bindings: power: supply: sbs-battery: Fix dtbs_check [37/38] dt-bindings: power: supply: Fix remaining battery.txt links [38/38] dt-bindings: power: supply: Drop power_supply.txt

diff --git a/Documentation/devicetree/bindings/power/supply/bq24257.txt b/Documentation/devicetree/bindings/power/supply/bq24257.txt deleted file mode 100644 index f8f5a1685bb9..000000000000 --- a/Documentation/devicetree/bindings/power/supply/bq24257.txt +++ /dev/null @@ -1,62 +0,0 @@ -Binding for TI bq24250/bq24251/bq24257 Li-Ion Charger - -Required properties: -- compatible: Should contain one of the following: - * "ti,bq24250" - * "ti,bq24251" - * "ti,bq24257" -- reg: integer, i2c address of the device. -- interrupts: Interrupt mapping for GPIO IRQ (configure for both edges). Use in - conjunction with "interrupt-parent". -- ti,battery-regulation-voltage: integer, maximum charging voltage in uV. -- ti,charge-current: integer, maximum charging current in uA. -- ti,termination-current: integer, charge will be terminated when current in - constant-voltage phase drops below this value (in uA). - -Optional properties: -- pg-gpios: GPIO used for connecting the bq2425x device PG (Power Good) pin. - This pin is not available on all devices however it should be used if - possible as this is the recommended way to obtain the charger's input PG - state. If this pin is not specified a software-based approach for PG - detection is used. -- ti,current-limit: The maximum current to be drawn from the charger's input - (in uA). If this property is not specified, the input limit current is - set automatically using USB D+/D- signal based charger type detection. - If the hardware does not support the D+/D- based detection, a default - of 500,000 is used (=500mA) instead. -- ti,ovp-voltage: Configures the over voltage protection voltage (in uV). If - not specified a default of 6,5000,000 (=6.5V) is used. -- ti,in-dpm-voltage: Configures the threshold input voltage for the dynamic - power path management (in uV). If not specified a default of 4,360,000 - (=4.36V) is used. - -Example: - -bq24257 { - compatible = "ti,bq24257"; - reg = <0x6a>; - interrupt-parent = <&gpio1>; - interrupts = <16 IRQ_TYPE_EDGE_BOTH>; - - pg-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>; - - ti,battery-regulation-voltage = <4200000>; - ti,charge-current = <1000000>; - ti,termination-current = <50000>; -}; - -Example: - -bq24250 { - compatible = "ti,bq24250"; - reg = <0x6a>; - interrupt-parent = <&gpio1>; - interrupts = <16 IRQ_TYPE_EDGE_BOTH>; - - ti,battery-regulation-voltage = <4200000>; - ti,charge-current = <500000>; - ti,termination-current = <50000>; - ti,current-limit = <900000>; - ti,ovp-voltage = <9500000>; - ti,in-dpm-voltage = <4440000>; -}; diff --git a/Documentation/devicetree/bindings/power/supply/bq24257.yaml b/Documentation/devicetree/bindings/power/supply/bq24257.yaml new file mode 100644 index 000000000000..3a0f6cd9015a --- /dev/null +++ b/Documentation/devicetree/bindings/power/supply/bq24257.yaml @@ -0,0 +1,124 @@ +# SPDX-License-Identifier: GPL-2.0 +# Copyright (C) 2021 Sebastian Reichel +%YAML 1.2 +--- +$id: "http://devicetree.org/schemas/power/supply/bq24257.yaml#" +$schema: "http://devicetree.org/meta-schemas/core.yaml#" + +title: Binding for bq24250, bq24251 and bq24257 Li-Ion Charger + +maintainers: + - Sebastian Reichel <sre@kernel.org> + +allOf: + - $ref: power-supply.yaml# + +properties: + compatible: + enum: + - ti,bq24250 + - ti,bq24251 + - ti,bq24257 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + ti,battery-regulation-voltage: + $ref: /schemas/types.yaml#/definitions/uint32 + description: maximum charging voltage in uV + + ti,charge-current: + $ref: /schemas/types.yaml#/definitions/uint32 + description: maximum charging current in uA + + ti,termination-current: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + charge will be terminated when current in constant-voltage phase + drops below this value (in uA) + + pg-gpios: + description: | + GPIO used for connecting the bq2425x device PG (Power Good) pin. + This pin is not available on all devices however it should be used if + possible as this is the recommended way to obtain the charger's input PG + state. If this pin is not specified a software-based approach for PG + detection is used. + maxItems: 1 + + ti,current-limit: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + The maximum current to be drawn from the charger's input (in uA). + If this property is not specified, the input limit current is set + automatically using USB D+/D- signal based charger type detection. + If the hardware does not support the D+/D- based detection, a default + of 500,000 is used (=500mA) instead. + + ti,ovp-voltage: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + Configures the over voltage protection voltage (in uV). + If not specified a default of 6,5000,000 (=6.5V) is used. + + ti,in-dpm-voltage: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + Configures the threshold input voltage for the dynamic power path management (in uV). + If not specified a default of 4,360,000 (=4.36V) is used. + +required: + - compatible + - reg + - interrupts + - ti,battery-regulation-voltage + - ti,charge-current + - ti,termination-current + +additionalProperties: false + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + #include <dt-bindings/interrupt-controller/irq.h> + i2c0 { + #address-cells = <1>; + #size-cells = <0>; + + charger@6a { + compatible = "ti,bq24257"; + reg = <0x6a>; + interrupt-parent = <&gpio1>; + interrupts = <16 IRQ_TYPE_EDGE_BOTH>; + + pg-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>; + + ti,battery-regulation-voltage = <4200000>; + ti,charge-current = <1000000>; + ti,termination-current = <50000>; + }; + }; + - | + #include <dt-bindings/gpio/gpio.h> + #include <dt-bindings/interrupt-controller/irq.h> + i2c0 { + #address-cells = <1>; + #size-cells = <0>; + + charger@6a { + compatible = "ti,bq24250"; + reg = <0x6a>; + interrupt-parent = <&gpio1>; + interrupts = <16 IRQ_TYPE_EDGE_BOTH>; + + ti,battery-regulation-voltage = <4200000>; + ti,charge-current = <500000>; + ti,termination-current = <50000>; + ti,current-limit = <900000>; + ti,ovp-voltage = <9500000>; + ti,in-dpm-voltage = <4440000>; + }; + };

[05/38] dt-bindings: power: supply: bq24257: Convert to DT schema format

Commit Message

Patch