mirror of
git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-09-18 22:14:16 +00:00
76fa2a1eff
Bjorn is no longer at Linaro. Update his email address to @kernel to match the .mailmap entry. The servers for @codeaurora are long retired and messages sent there will bounce. Update Kiran's email address to match the .mailmap entry. This will help anyone that is looking to reach out about this binding and is not using .mailmap to pre-process their message. Signed-off-by: Jeffrey Hugo <quic_jhugo@quicinc.com> Reviewed-by: Daniel Thompson <daniel.thompson@linaro.org> Acked-by: Rob Herring <robh@kernel.org> Link: https://lore.kernel.org/r/20240202180151.4116329-1-quic_jhugo@quicinc.com Signed-off-by: Lee Jones <lee@kernel.org>
263 lines
6 KiB
YAML
263 lines
6 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/leds/backlight/qcom-wled.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Qualcomm Technologies, Inc. WLED driver
|
|
|
|
maintainers:
|
|
- Bjorn Andersson <andersson@kernel.org>
|
|
- Kiran Gunda <quic_kgunda@quicinc.com>
|
|
|
|
description: |
|
|
WLED (White Light Emitting Diode) driver is used for controlling display
|
|
backlight that is part of PMIC on Qualcomm Technologies, Inc. reference
|
|
platforms. The PMIC is connected to the host processor via SPMI bus.
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- qcom,pm8941-wled
|
|
- qcom,pmi8950-wled
|
|
- qcom,pmi8994-wled
|
|
- qcom,pmi8998-wled
|
|
- qcom,pm660l-wled
|
|
- qcom,pm6150l-wled
|
|
- qcom,pm8150l-wled
|
|
|
|
reg:
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
default-brightness:
|
|
description: |
|
|
brightness value on boot.
|
|
|
|
label: true
|
|
|
|
max-brightness:
|
|
description: |
|
|
Maximum brightness level.
|
|
|
|
qcom,cs-out:
|
|
description: |
|
|
enable current sink output.
|
|
This property is supported only for WLED3.
|
|
type: boolean
|
|
|
|
qcom,cabc:
|
|
description: |
|
|
enable content adaptive backlight control.
|
|
type: boolean
|
|
|
|
qcom,ext-gen:
|
|
description: |
|
|
use externally generated modulator signal to dim.
|
|
This property is supported only for WLED3.
|
|
type: boolean
|
|
|
|
qcom,current-limit:
|
|
description: |
|
|
mA; per-string current limit.
|
|
This property is supported only for WLED3.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
default: 20
|
|
minimum: 0
|
|
maximum: 25
|
|
|
|
qcom,current-limit-microamp:
|
|
description: |
|
|
uA; per-string current limit.
|
|
default: 25
|
|
minimum: 0
|
|
maximum: 30000
|
|
multipleOf: 25
|
|
|
|
qcom,current-boost-limit:
|
|
description: |
|
|
mA; boost current limit.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
qcom,switching-freq:
|
|
description: |
|
|
kHz; switching frequency.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [ 600, 640, 685, 738, 800, 872, 960, 1066, 1200, 1371, 1600, 1920,
|
|
2400, 3200, 4800, 9600 ]
|
|
|
|
qcom,ovp:
|
|
description: |
|
|
V; Over-voltage protection limit.
|
|
This property is supported only for WLED3.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [ 27, 29, 32, 35 ]
|
|
default: 29
|
|
|
|
qcom,ovp-millivolt:
|
|
description: |
|
|
Over-voltage protection limit. This property is for WLED4 only.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [ 18100, 19600, 29600, 31100 ]
|
|
default: 29600
|
|
|
|
qcom,num-strings:
|
|
description: |
|
|
number of led strings attached.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
qcom,enabled-strings:
|
|
description: |
|
|
Array of the WLED strings numbered from 0 to 3. Each
|
|
string of leds are operated individually. Specify the
|
|
list of strings used by the device. Any combination of
|
|
led strings can be used.
|
|
$ref: /schemas/types.yaml#/definitions/uint32-array
|
|
minItems: 1
|
|
maxItems: 4
|
|
|
|
qcom,external-pfet:
|
|
description: |
|
|
Specify if external PFET control for short circuit
|
|
protection is used. This property is supported only
|
|
for WLED4.
|
|
type: boolean
|
|
|
|
qcom,auto-string-detection:
|
|
description: |
|
|
Enables auto-detection of the WLED string configuration.
|
|
This feature is not supported for WLED3.
|
|
type: boolean
|
|
|
|
interrupts:
|
|
minItems: 1
|
|
items:
|
|
- description: over voltage protection interrupt.
|
|
- description: short circuit interrupt.
|
|
|
|
interrupt-names:
|
|
minItems: 1
|
|
items:
|
|
- const: ovp
|
|
- const: short
|
|
|
|
qcom,modulator-sel:
|
|
description: |
|
|
Selects the modulator used for brightness modulation.
|
|
Allowed values are,
|
|
0 - Modulator A
|
|
1 - Modulator B
|
|
This property is applicable only to WLED5 peripheral.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [ 0, 1 ]
|
|
default: 0
|
|
|
|
qcom,cabc-sel:
|
|
description: |
|
|
Selects the CABC pin signal used for brightness modulation.
|
|
Allowed values are,
|
|
0 - CABC disabled
|
|
1 - CABC 1
|
|
2 - CABC 2
|
|
3 - External signal (e.g. LPG) is used for dimming
|
|
This property is applicable only to WLED5 peripheral.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [ 0, 1, 2, 3 ]
|
|
|
|
allOf:
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: qcom,pm8941-wled
|
|
|
|
then:
|
|
properties:
|
|
reg:
|
|
maxItems: 1
|
|
|
|
qcom,current-boost-limit:
|
|
enum: [ 105, 385, 525, 805, 980, 1260, 1400, 1680 ]
|
|
default: 805
|
|
|
|
qcom,switching-freq:
|
|
default: 1600
|
|
|
|
qcom,num-strings:
|
|
enum: [ 1, 2, 3 ]
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
interrupt-names:
|
|
maxItems: 1
|
|
|
|
else:
|
|
properties:
|
|
reg:
|
|
minItems: 2
|
|
|
|
qcom,current-boost-limit:
|
|
enum: [ 105, 280, 450, 620, 970, 1150, 1300, 1500 ]
|
|
default: 970
|
|
|
|
qcom,switching-freq:
|
|
default: 800
|
|
|
|
qcom,num-strings:
|
|
enum: [ 1, 2, 3, 4 ]
|
|
|
|
interrupts:
|
|
minItems: 2
|
|
|
|
interrupt-names:
|
|
minItems: 2
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- qcom,pm8150l-wled
|
|
|
|
then:
|
|
properties:
|
|
default-brightness:
|
|
minimum: 0
|
|
maximum: 32767
|
|
|
|
max-brightness:
|
|
minimum: 0
|
|
maximum: 32767
|
|
|
|
else:
|
|
properties:
|
|
default-brightness:
|
|
minimum: 0
|
|
maximum: 4095
|
|
|
|
max-brightness:
|
|
minimum: 0
|
|
maximum: 4095
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- label
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
backlight@d800 {
|
|
compatible = "qcom,pm8941-wled";
|
|
reg = <0xd800 0x100>;
|
|
label = "backlight";
|
|
|
|
qcom,cs-out;
|
|
qcom,current-limit = <20>;
|
|
qcom,current-boost-limit = <805>;
|
|
qcom,switching-freq = <1600>;
|
|
qcom,ovp = <29>;
|
|
qcom,num-strings = <2>;
|
|
qcom,enabled-strings = <0 1>;
|
|
};
|