[PATCH v5 1/2] dt-bindings: leds: backlight: Add Kinetic KTZ8866 backlight

Jianhua Lu
2023-01-17T15:47:00Z

Add Kinetic KTZ8866 backlight binding documentation.

Signed-off-by: Jianhua Lu <lujianhua000@gmail.com>
---
Changes in v2:
- Remove "items" between "compatible" and "const: kinetic,ktz8866"
- Change "additionalProperties" to "unevaluatedProperties"

Changes in v3:
- Add Krzysztof's R-b

Changes in v4:
- Drop Krzysztof's R-b
- Add some new properties

Changes in v5:
- Add missing enum under property description.
- Rename uncorrect properties.

.../leds/backlight/kinetic,ktz8866.yaml | 57 +++++++++++++++++++
1 file changed, 57 insertions(+)
create mode 100644 Documentation/devicetree/bindings/leds/backlight/kinetic,ktz8866.yaml

diff --git a/Documentation/devicetree/bindings/leds/backlight/kinetic,ktz8866.yaml b/Documentation/devicetree/bindings/leds/backlight/kinetic,ktz8866.yaml
new file mode 100644
index 000000000000..1efc29b0632f
--- /dev/null
+++ b/Documentation/devicetree/bindings/leds/backlight/kinetic,ktz8866.yaml
@@ -0,0 +1,57 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/leds/backlight/kinetic,ktz8866.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Kinetic Technologies KTZ8866 backlight
+
+maintainers:
+ - Jianhua Lu <lujianhua000@gmail.com>
+
+description: |
+ The Kinetic Technologies KTZ8866 is a high efficiency 6-sinks led backlight
+ with dual lcd bias power.
+ https://www.kinet-ic.com/ktz8866/
+
+allOf:
+ - $ref: common.yaml#
+
+properties:
+ compatible:
+ const: kinetic,ktz8866
+
+ current-num-sinks:
+ description: Number of LED current sinks.
+ enum: [1, 2, 3, 4, 5, 6]
+
+ current-ramping-time-us:
+ description: LED current ramping time in microseconds.
+ enum: [2, 4, 8, 16, 32, 64, 128, 192, 256, 320, 384, 448, 512, 576, 640]
+
+ led-ramping-time-us:
+ description: LED on/off ramping time in microseconds.
+ enum: [1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192, 16384]
+
+ enable-lcd-bias:
+ description: Set if we want to output bias power supply for LCD.
+ type: boolean
+
+required:
+ - compatible
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ backlight {
+ compatible = "kinetic,ktz8866";
+
+ pinctrl-names = "default";
+ pinctrl-0 = <&bl_en_default>;
+
+ current-num-sinks = <5>;
+ current-ramping-time-us = <128>;
+ led-ramping-time-us = <1>;
+ enable-lcd-bias;
+ };
--
2.38.2