85 lines · yaml
1# SPDX-License-Identifier: GPL-2.02%YAML 1.23---4$id: http://devicetree.org/schemas/power/supply/sbs,sbs-battery.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: SBS compliant battery8 9maintainers:10 - Sebastian Reichel <sre@kernel.org>11 12description: |13 Battery compatible with the smart battery system specifications14 15allOf:16 - $ref: power-supply.yaml#17 18properties:19 compatible:20 oneOf:21 - items:22 - enum:23 - ti,bq20z4524 - ti,bq20z6525 - ti,bq20z7526 - enum:27 - sbs,sbs-battery28 - items:29 - const: sbs,sbs-battery30 31 reg:32 maxItems: 133 34 sbs,i2c-retry-count:35 description:36 The number of times to retry I2C transactions on I2C IO failure.37 default: 038 $ref: /schemas/types.yaml#/definitions/uint3239 40 sbs,poll-retry-count:41 description:42 The number of times to try looking for new status after an external43 change notification.44 default: 045 $ref: /schemas/types.yaml#/definitions/uint3246 47 sbs,battery-detect-gpios:48 description:49 GPIO which signals battery detection. If this is not supplied, the bus50 needs to be polled to detect the battery.51 maxItems: 152 53 sbs,disable-charger-broadcasts:54 description:55 SBS batteries by default send broadcast messages to SBS compliant chargers to56 configure max. charge current/voltage. If your hardware does not have an SBS57 compliant charger it should be disabled via this property to avoid blocking58 the bus. Also some SBS battery fuel gauges are known to have a buggy multi-59 master implementation.60 type: boolean61 62required:63 - compatible64 - reg65 66unevaluatedProperties: false67 68examples:69 - |70 #include <dt-bindings/gpio/gpio.h>71 72 i2c {73 #address-cells = <1>;74 #size-cells = <0>;75 76 battery@b {77 compatible = "ti,bq20z75", "sbs,sbs-battery";78 reg = <0xb>;79 sbs,i2c-retry-count = <2>;80 sbs,poll-retry-count = <10>;81 sbs,battery-detect-gpios = <&gpio 122 GPIO_ACTIVE_HIGH>;82 sbs,disable-charger-broadcasts;83 };84 };85