xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/ingenic,battery.yaml (revision a64729f5077d77e13b9497cb33ecb3c82e606ee8) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2# Copyright 2019-2020 Artur Rojek
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/power/supply/ingenic,battery.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Ingenic JZ47xx battery
9
10maintainers:
11  - Artur Rojek <contact@artur-rojek.eu>
12
13$ref: power-supply.yaml#
14
15properties:
16  compatible:
17    oneOf:
18      - const: ingenic,jz4740-battery
19      - items:
20          - enum:
21              - ingenic,jz4725b-battery
22              - ingenic,jz4770-battery
23          - const: ingenic,jz4740-battery
24
25  io-channels:
26    maxItems: 1
27
28  io-channel-names:
29    const: battery
30
31  monitored-battery:
32    description: >
33      This property must be a phandle to a node using the format described
34      in battery.yaml, with the following properties being required:
35      - voltage-min-design-microvolt: drained battery voltage,
36      - voltage-max-design-microvolt: fully charged battery voltage.
37
38required:
39  - compatible
40  - io-channels
41  - io-channel-names
42  - monitored-battery
43
44additionalProperties: false
45
46examples:
47  - |
48    #include <dt-bindings/iio/adc/ingenic,adc.h>
49
50    simple_battery: battery {
51            compatible = "simple-battery";
52            voltage-min-design-microvolt = <3600000>;
53            voltage-max-design-microvolt = <4200000>;
54    };
55
56    ingenic-battery {
57            compatible = "ingenic,jz4740-battery";
58            io-channels = <&adc INGENIC_ADC_BATTERY>;
59            io-channel-names = "battery";
60            monitored-battery = <&simple_battery>;
61    };
62