[PATCH v2 2/2] dt-bindings: leds: Document Awinic AW2026 bindings

From: Vladimir Barinov
Date: Thu May 25 2023 - 06:15:01 EST


Add Awinic AW2026 binding documentation

Signed-off-by: Vladimir Barinov <v.barinov@xxxxxxxxx>
---
Changes in version 2:
- fixed typos in patch header 2016 -> 2026
- fixed typo in example section that break dt_binding_check

.../bindings/leds/awinic,aw2026.yaml | 92 +++++++++++++++++++
1 file changed, 92 insertions(+)
create mode 100644 Documentation/devicetree/bindings/leds/awinic,aw2026.yaml

diff --git a/Documentation/devicetree/bindings/leds/awinic,aw2026.yaml b/Documentation/devicetree/bindings/leds/awinic,aw2026.yaml
new file mode 100664
index 000000000000..abacf746677b
--- /dev/null
+++ b/Documentation/devicetree/bindings/leds/awinic,aw2026.yaml
@@ -0,0 +1,93 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/leds/awinic,aw2026.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Awinic AW2026 3-channel LED Driver
+
+maintainers:
+ - Vladimir Barinov <v.barinov@xxxxxxxxx>
+
+description: |
+ The AW2026 is a 3-channel LED driver with I2C interface. It can control
+ LED brightness with PWM output. It supports hardware blinking and
+ hardware patterns.
+
+properties:
+ compatible:
+ const: awinic,aw2026
+
+ reg:
+ maxItems: 1
+
+ "#address-cells":
+ const: 1
+
+ "#size-cells":
+ const: 0
+
+ awinic,led-max-microamp:
+ description:
+ Maximum current at LED output
+ enum:
+ [3000, 6375, 12750, 25500]
+
+ vcc-supply:
+ description: Regulator providing power to the "VBAT" pin.
+
+patternProperties:
+ "^led@[0-2]$":
+ type: object
+ $ref: common.yaml#
+
+ properties:
+ reg:
+ description: Index of the LED.
+ minimum: 0
+ maximum: 2
+
+required:
+ - compatible
+ - reg
+ - "#address-cells"
+ - "#size-cells"
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/leds/common.h>
+
+ i2c0 {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ led-controller@64 {
+ compatible = "awinic,aw2026";
+ reg = <0x64>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+ awinic,led-max-microamp = <6375>;
+ vcc-supply = <&vcc_3v3_s0>;
+
+ led@0 {
+ reg = <0>;
+ function = LED_FUNCTION_INDICATOR;
+ color = <LED_COLOR_ID_RED>;
+ };
+
+ led@1 {
+ reg = <1>;
+ function = LED_FUNCTION_INDICATOR;
+ color = <LED_COLOR_ID_BLUE>;
+ };
+
+ led@2 {
+ reg = <2>;
+ function = LED_FUNCTION_INDICATOR;
+ color = <LED_COLOR_ID_GREEN>;
+ };
+ };
+ };
+...
--
2.34.1