1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/power/suppl 4 $id: http://devicetree.org/schemas/power/supply/sbs,sbs-battery.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: SBS compliant battery 7 title: SBS compliant battery
8 8
9 maintainers: 9 maintainers:
10 - Sebastian Reichel <sre@kernel.org> 10 - Sebastian Reichel <sre@kernel.org>
11 11
12 description: | 12 description: |
13 Battery compatible with the smart battery sy 13 Battery compatible with the smart battery system specifications
14 14
15 allOf: 15 allOf:
16 - $ref: power-supply.yaml# 16 - $ref: power-supply.yaml#
17 17
18 properties: 18 properties:
19 compatible: 19 compatible:
20 oneOf: 20 oneOf:
21 - items: 21 - items:
22 - enum: 22 - enum:
23 - ti,bq20z45 23 - ti,bq20z45
24 - ti,bq20z65 24 - ti,bq20z65
25 - ti,bq20z75 25 - ti,bq20z75
26 - enum: 26 - enum:
27 - sbs,sbs-battery 27 - sbs,sbs-battery
28 - items: 28 - items:
29 - const: sbs,sbs-battery 29 - const: sbs,sbs-battery
30 30
31 reg: 31 reg:
32 maxItems: 1 32 maxItems: 1
33 33
34 sbs,i2c-retry-count: 34 sbs,i2c-retry-count:
35 description: 35 description:
36 The number of times to retry I2C transac 36 The number of times to retry I2C transactions on I2C IO failure.
37 default: 0 37 default: 0
38 $ref: /schemas/types.yaml#/definitions/uin 38 $ref: /schemas/types.yaml#/definitions/uint32
39 39
40 sbs,poll-retry-count: 40 sbs,poll-retry-count:
41 description: 41 description:
42 The number of times to try looking for n 42 The number of times to try looking for new status after an external
43 change notification. 43 change notification.
44 default: 0 44 default: 0
45 $ref: /schemas/types.yaml#/definitions/uin 45 $ref: /schemas/types.yaml#/definitions/uint32
46 46
47 sbs,battery-detect-gpios: 47 sbs,battery-detect-gpios:
48 description: 48 description:
49 GPIO which signals battery detection. If 49 GPIO which signals battery detection. If this is not supplied, the bus
50 needs to be polled to detect the battery 50 needs to be polled to detect the battery.
51 maxItems: 1 51 maxItems: 1
52 52
53 sbs,disable-charger-broadcasts: 53 sbs,disable-charger-broadcasts:
54 description: 54 description:
55 SBS batteries by default send broadcast 55 SBS batteries by default send broadcast messages to SBS compliant chargers to
56 configure max. charge current/voltage. I 56 configure max. charge current/voltage. If your hardware does not have an SBS
57 compliant charger it should be disabled 57 compliant charger it should be disabled via this property to avoid blocking
58 the bus. Also some SBS battery fuel gaug 58 the bus. Also some SBS battery fuel gauges are known to have a buggy multi-
59 master implementation. 59 master implementation.
60 type: boolean 60 type: boolean
61 61
62 required: 62 required:
63 - compatible 63 - compatible
64 - reg 64 - reg
65 65
66 unevaluatedProperties: false 66 unevaluatedProperties: false
67 67
68 examples: 68 examples:
69 - | 69 - |
70 #include <dt-bindings/gpio/gpio.h> 70 #include <dt-bindings/gpio/gpio.h>
71 71
72 i2c { 72 i2c {
73 #address-cells = <1>; 73 #address-cells = <1>;
74 #size-cells = <0>; 74 #size-cells = <0>;
75 75
76 battery@b { 76 battery@b {
77 compatible = "ti,bq20z75", "sbs,sb 77 compatible = "ti,bq20z75", "sbs,sbs-battery";
78 reg = <0xb>; 78 reg = <0xb>;
79 sbs,i2c-retry-count = <2>; 79 sbs,i2c-retry-count = <2>;
80 sbs,poll-retry-count = <10>; 80 sbs,poll-retry-count = <10>;
81 sbs,battery-detect-gpios = <&gpio 81 sbs,battery-detect-gpios = <&gpio 122 GPIO_ACTIVE_HIGH>;
82 sbs,disable-charger-broadcasts; 82 sbs,disable-charger-broadcasts;
83 }; 83 };
84 }; 84 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.