bindings: power: supply: add QTI battery charger

Add DT bindings for QTI battery charger which gets and sets
power supply properties by communicating with charger firmware
running on the remote subsystem (e.g. DSP) over PMIC Glink.

This is a snapshot taken as of qcom-6.1
commit 7b5e13f9043d ("dt-bindings: power: supply:
qcom,battery-charger: Add display panel property")
which was then converted to yaml.

Change-Id: I8e3aedfb70c627807388db3c449c283f35ecfd59
Signed-off-by: David Collins <quic_collinsd@quicinc.com>
This commit is contained in:
David Collins
2023-06-15 16:39:02 -07:00
parent 798c342875
commit 8dd209e566

View File

@@ -0,0 +1,86 @@
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/power/supply/qcom,battery-charger.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Qualcomm Technologies, Inc. Battery Charger Glink Device
maintainers:
- Subbaraman Narayanamurthy <quic_subbaram@quicinc.com>
description: |
This binding describes the Qualcomm Technologies, Inc. battery charger device.
The QTI battery charger gets and sets power supply properties by communicating
with charger firmware running on a remote subsystem (e.g. DSP) over PMIC
Glink.
properties:
compatible:
const: qcom,battery-charger
qcom,thermal-mitigation:
description: |
Array of fast charge current limit values for different system thermal
mitigation levels. This should be a flat array that denotes the maximum
charging current (in uA) for each thermal level. Elements should be listed
in monotonically decreasing (non-increasing) order.
$ref: /schemas/types.yaml#/definitions/uint32-array
qcom,thermal-mitigation-step:
description: |
Fast charging current step (in uA) which if specified would be used to
calculate different system thermal mitigation levels based on the maximum
charging current provided by the charger firmware. This property can be
specified only if "qcom,thermal-mitigation" property is not specified.
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 500000
qcom,wireless-fw-name:
description: |
Firmware name that is used for updating wireless charger firmware.
$ref: /schemas/types.yaml#/definitions/string
qcom,shutdown-voltage:
description: |
Battery voltage (in mV) when shutdown needs to be initiated when battery
SOC reaches 0 and device is not charging.
$ref: /schemas/types.yaml#/definitions/uint32
qcom,display-panels:
description: |
Array of one or more phandles of the display panel(s) that sends the DRM
blank/unblank notifications.
$ref: /schemas/types.yaml#/definitions/phandle-array
minItems: 1
required:
- compatible
allOf:
- if:
required:
- qcom,thermal-mitigation
then:
properties:
qcom,thermal-mitigation-step: false
- if:
required:
- qcom,thermal-mitigation-step
then:
properties:
qcom,thermal-mitigation: false
additionalProperties: false
examples:
- |
pmic_glink {
battery_charger {
compatible = "qcom,battery-charger";
qcom,thermal-mitigation = <3000000 1500000 1000000 500000>;
qcom,wireless-fw-name = "idt9412.bin";
qcom,shutdown-voltage = <3100>;
};
};