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