lkml.org 
[lkml]   [2021]   [Mar]   [12]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCH 32/38] dt-bindings: power: supply: ltc294x: Convert to DT schema format
    Date
    Convert the binding to DT schema format.

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

    diff --git a/Documentation/devicetree/bindings/power/supply/lltc,ltc294x.yaml b/Documentation/devicetree/bindings/power/supply/lltc,ltc294x.yaml
    new file mode 100644
    index 000000000000..043bf378040f
    --- /dev/null
    +++ b/Documentation/devicetree/bindings/power/supply/lltc,ltc294x.yaml
    @@ -0,0 +1,66 @@
    +# SPDX-License-Identifier: GPL-2.0
    +%YAML 1.2
    +---
    +$id: "http://devicetree.org/schemas/power/supply/lltc,ltc294x.yaml#"
    +$schema: "http://devicetree.org/meta-schemas/core.yaml#"
    +
    +title: Binding for LTC2941, LTC2942, LTC2943 and LTC2944 battery fuel gauges
    +
    +description: |
    + All chips measure battery capacity.
    + The LTC2942 is pin compatible with the LTC2941, it adds voltage and
    + temperature monitoring, and is runtime detected. LTC2943 and LTC2944
    + are software compatible, uses a slightly different conversion formula
    + for the charge counter and adds voltage, current and temperature monitoring.
    +
    +maintainers:
    + - Sebastian Reichel <sre@kernel.org>
    +
    +allOf:
    + - $ref: power-supply.yaml#
    +
    +properties:
    + compatible:
    + enum:
    + - lltc,ltc2941
    + - lltc,ltc2942
    + - lltc,ltc2943
    + - lltc,ltc2944
    +
    + reg:
    + maxItems: 1
    +
    + lltc,resistor-sense:
    + $ref: /schemas/types.yaml#/definitions/int32
    + description: |
    + Sense resistor value in milli-ohms.
    + Can be negative value when the battery has been connected to the wrong end of the resistor.
    +
    + lltc,prescaler-exponent:
    + $ref: /schemas/types.yaml#/definitions/uint32
    + description: |
    + The prescaler exponent as explained in the datasheet.
    + This determines the range and accuracy of the gauge.
    + The value is programmed into the chip only if it differs from the current setting.
    + The setting is lost when the battery is disconnected.
    +
    +required:
    + - compatible
    + - reg
    + - lltc,resistor-sense
    + - lltc,prescaler-exponent
    +
    +additionalProperties: false
    +
    +examples:
    + - |
    + i2c0 {
    + #address-cells = <1>;
    + #size-cells = <0>;
    + battery@64 {
    + compatible = "lltc,ltc2943";
    + reg = <0x64>;
    + lltc,resistor-sense = <15>;
    + lltc,prescaler-exponent = <5>; /* 2^(2*5) = 1024 */
    + };
    + };
    diff --git a/Documentation/devicetree/bindings/power/supply/ltc2941.txt b/Documentation/devicetree/bindings/power/supply/ltc2941.txt
    deleted file mode 100644
    index 3b9ba147b041..000000000000
    --- a/Documentation/devicetree/bindings/power/supply/ltc2941.txt
    +++ /dev/null
    @@ -1,28 +0,0 @@
    -binding for LTC2941, LTC2942, LTC2943 and LTC2944 battery gauges
    -
    -All chips measure battery capacity.
    -The LTC2942 is pin compatible with the LTC2941, it adds voltage and
    -temperature monitoring, and is runtime detected. LTC2943 and LTC2944
    -is software compatible, uses a slightly different conversion formula
    -for the charge counter and adds voltage, current and temperature monitoring.
    -
    -Required properties:
    -- compatible: Should contain "lltc,ltc2941", "lltc,ltc2942", "lltc,ltc2943"
    - or "lltc,ltc2944" which also indicates the type of I2C chip attached.
    -- reg: The 7-bit I2C address.
    -- lltc,resistor-sense: The sense resistor value in milli-ohms. Can be a 32-bit
    - negative value when the battery has been connected to the wrong end of the
    - resistor.
    -- lltc,prescaler-exponent: The prescaler exponent as explained in the datasheet.
    - This determines the range and accuracy of the gauge. The value is programmed
    - into the chip only if it differs from the current setting. The setting is
    - lost when the battery is disconnected.
    -
    -Example from the Topic Miami Florida board:
    -
    - fuelgauge: ltc2943@64 {
    - compatible = "lltc,ltc2943";
    - reg = <0x64>;
    - lltc,resistor-sense = <15>;
    - lltc,prescaler-exponent = <5>; /* 2^(2*5) = 1024 */
    - };
    --
    2.30.1
    \
     
     \ /
      Last update: 2021-03-12 16:53    [W:4.157 / U:0.288 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site