[PATCH 1/5] dt-bindings: power: supply: add Qualcomm QGauge fuel gauge
From: Val Packett
Date: Thu Nov 12 2026 - 13:27:08 EST
From: Marc Lainez <marc.lainez@xxxxxxxxx>
Document the QGauge fuel-gauge block handled by the qcom_qg driver, with
compatibles for the PMI632 and PM6150 PMICs.
Signed-off-by: Marc Lainez <marc.lainez@xxxxxxxxx>
Signed-off-by: Val Packett <val@xxxxxxxxxxxx>
---
.../bindings/power/supply/qcom,qg.yaml | 105 ++++++++++++++++++
MAINTAINERS | 6 +
2 files changed, 111 insertions(+)
create mode 100644 Documentation/devicetree/bindings/power/supply/qcom,qg.yaml
diff --git a/Documentation/devicetree/bindings/power/supply/qcom,qg.yaml b/Documentation/devicetree/bindings/power/supply/qcom,qg.yaml
new file mode 100644
index 000000000000..79dd18d87879
--- /dev/null
+++ b/Documentation/devicetree/bindings/power/supply/qcom,qg.yaml
@@ -0,0 +1,105 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/power/supply/qcom,qg.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Qualcomm QGauge Fuel Gauge
+
+maintainers:
+ - Val Packett <val@xxxxxxxxxxxx>
+
+description:
+ The QGauge (QG) block found in some Qualcomm PMICs (PM6150, PMI632)
+ provides battery fuel gauging through hardware voltage and current
+ FIFO sampling, open circuit voltage (OCV) measurement, and coulomb
+ counting. The hardware has a multi-state FSM (S1-S7) that automatically
+ transitions between active sampling and low-power sleep states.
+
+allOf:
+ - $ref: /schemas/power/supply/power-supply.yaml#
+ - $ref: /schemas/nvmem/nvmem-consumer.yaml#
+
+properties:
+ compatible:
+ enum:
+ - qcom,pm6150-qg
+ - qcom,pmi632-qg
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ items:
+ - description: Battery missing interrupt
+ - description: Battery voltage low interrupt
+ - description: Battery voltage empty interrupt
+ - description: FIFO data update done interrupt
+ - description: Good OCV measured interrupt
+ - description: FSM state change interrupt
+ - description: QG event interrupt
+
+ interrupt-names:
+ items:
+ - const: batt-missing
+ - const: vbat-low
+ - const: vbat-empty
+ - const: fifo-done
+ - const: good-ocv
+ - const: fsm-state-chg
+ - const: event
+
+ io-channels:
+ items:
+ - description: ADC channel for battery thermistor temperature
+
+ io-channel-names:
+ items:
+ - const: batt-therm
+
+ monitored-battery: true
+
+ nvmem: true
+
+ power-supplies: true
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - interrupt-names
+ - monitored-battery
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/irq.h>
+ pmic {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ fuel-gauge@4800 {
+ compatible = "qcom,pmi632-qg";
+ reg = <0x4800>;
+
+ interrupts = <0x2 0x48 0x0 IRQ_TYPE_EDGE_BOTH>,
+ <0x2 0x48 0x1 IRQ_TYPE_EDGE_BOTH>,
+ <0x2 0x48 0x2 IRQ_TYPE_EDGE_RISING>,
+ <0x2 0x48 0x3 IRQ_TYPE_EDGE_RISING>,
+ <0x2 0x48 0x4 IRQ_TYPE_EDGE_RISING>,
+ <0x2 0x48 0x5 IRQ_TYPE_EDGE_RISING>,
+ <0x2 0x48 0x6 IRQ_TYPE_EDGE_RISING>;
+ interrupt-names = "batt-missing",
+ "vbat-low",
+ "vbat-empty",
+ "fifo-done",
+ "good-ocv",
+ "fsm-state-chg",
+ "event";
+
+ nvmem = <&pmi632_sdam_2>;
+
+ monitored-battery = <&battery>;
+ };
+ };
diff --git a/MAINTAINERS b/MAINTAINERS
index b253b10dd436..7b76b07ed66f 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -23328,6 +23328,12 @@ F: drivers/firmware/qcom/qcom_pas.h
F: drivers/firmware/qcom/qcom_pas_tee.c
F: include/linux/firmware/qcom/qcom_pas.h
+QUALCOMM QGAUGE FUEL GAUGE DRIVER
+M: Val Packett <val@xxxxxxxxxxxx>
+L: linux-arm-msm@xxxxxxxxxxxxxxx
+S: Maintained
+F: Documentation/devicetree/bindings/power/supply/qcom,qg.yaml
+
QUALCOMM SMB CHARGER DRIVER
M: Casey Connolly <casey.connolly@xxxxxxxxxx>
L: linux-arm-msm@xxxxxxxxxxxxxxx
--
2.56.0