1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
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/cw2015_battery.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Battery driver for CW2015 shuntless fue 7 title: Battery driver for CW2015 shuntless fuel gauge by CellWise.
8 8
9 maintainers: 9 maintainers:
10 - Tobias Schramm <t.schramm@manjaro.org> 10 - Tobias Schramm <t.schramm@manjaro.org>
11 11
12 description: | 12 description: |
13 The driver can utilize information from a si 13 The driver can utilize information from a simple-battery linked via a
14 phandle in monitored-battery. If specified t 14 phandle in monitored-battery. If specified the driver uses the
15 charge-full-design-microamp-hours property o 15 charge-full-design-microamp-hours property of the battery.
16 16
17 allOf: 17 allOf:
18 - $ref: power-supply.yaml# 18 - $ref: power-supply.yaml#
19 19
20 properties: 20 properties:
21 compatible: 21 compatible:
22 const: cellwise,cw2015 22 const: cellwise,cw2015
23 23
24 reg: 24 reg:
25 maxItems: 1 25 maxItems: 1
26 26
27 cellwise,battery-profile: 27 cellwise,battery-profile:
28 description: | 28 description: |
29 This property specifies characteristics 29 This property specifies characteristics of the battery used. The format
30 of this binary blob is kept secret by Ce 30 of this binary blob is kept secret by CellWise. The only way to obtain
31 it is to mail two batteries to a test fa 31 it is to mail two batteries to a test facility of CellWise and receive
32 back a test report with the binary blob. 32 back a test report with the binary blob.
33 $ref: /schemas/types.yaml#/definitions/uin 33 $ref: /schemas/types.yaml#/definitions/uint8-array
34 minItems: 64 34 minItems: 64
35 maxItems: 64 35 maxItems: 64
36 36
37 cellwise,monitor-interval-ms: 37 cellwise,monitor-interval-ms:
38 description: 38 description:
39 Specifies the interval in milliseconds g 39 Specifies the interval in milliseconds gauge values are polled at
40 minimum: 250 40 minimum: 250
41 41
42 power-supplies: 42 power-supplies:
43 minItems: 1 43 minItems: 1
44 maxItems: 8 # Should be enough 44 maxItems: 8 # Should be enough
45 45
46 monitored-battery: 46 monitored-battery:
47 description: 47 description:
48 Specifies the phandle of a simple-batter 48 Specifies the phandle of a simple-battery connected to this gauge
49 $ref: /schemas/types.yaml#/definitions/pha 49 $ref: /schemas/types.yaml#/definitions/phandle
50 50
51 required: 51 required:
52 - compatible 52 - compatible
53 - reg 53 - reg
54 54
55 additionalProperties: false 55 additionalProperties: false
56 56
57 examples: 57 examples:
58 - | 58 - |
59 i2c { 59 i2c {
60 #address-cells = <1>; 60 #address-cells = <1>;
61 #size-cells = <0>; 61 #size-cells = <0>;
62 62
63 cw2015@62 { 63 cw2015@62 {
64 compatible = "cellwise,cw2015"; 64 compatible = "cellwise,cw2015";
65 reg = <0x62>; 65 reg = <0x62>;
66 cellwise,battery-profile = /bits/ 66 cellwise,battery-profile = /bits/ 8 <
67 0x17 0x67 0x80 0x73 0x6E 0x6C 67 0x17 0x67 0x80 0x73 0x6E 0x6C 0x6B 0x63
68 0x77 0x51 0x5C 0x58 0x50 0x4C 68 0x77 0x51 0x5C 0x58 0x50 0x4C 0x48 0x36
69 0x15 0x0C 0x0C 0x19 0x5B 0x7D 69 0x15 0x0C 0x0C 0x19 0x5B 0x7D 0x6F 0x69
70 0x69 0x5B 0x0C 0x29 0x20 0x40 70 0x69 0x5B 0x0C 0x29 0x20 0x40 0x52 0x59
71 0x57 0x56 0x54 0x4F 0x3B 0x1F 71 0x57 0x56 0x54 0x4F 0x3B 0x1F 0x7F 0x17
72 0x06 0x1A 0x30 0x5A 0x85 0x93 72 0x06 0x1A 0x30 0x5A 0x85 0x93 0x96 0x2D
73 0x48 0x77 0x9C 0xB3 0x80 0x52 73 0x48 0x77 0x9C 0xB3 0x80 0x52 0x94 0xCB
74 0x2F 0x00 0x64 0xA5 0xB5 0x11 74 0x2F 0x00 0x64 0xA5 0xB5 0x11 0xF0 0x11
75 >; 75 >;
76 cellwise,monitor-interval-ms = <500 76 cellwise,monitor-interval-ms = <5000>;
77 monitored-battery = <&bat>; 77 monitored-battery = <&bat>;
78 power-supplies = <&mains_charger>, 78 power-supplies = <&mains_charger>, <&usb_charger>;
79 }; 79 };
80 }; 80 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.