1 # SPDX-License-Identifier: GPL-2.0-only OR BSD 1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/leds/nxp,pc 4 $id: http://devicetree.org/schemas/leds/nxp,pca963x.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: NXP PCA963x LED controllers 7 title: NXP PCA963x LED controllers
8 8
9 maintainers: 9 maintainers:
10 - Laurent Pinchart <laurent.pinchart@ideasonb 10 - Laurent Pinchart <laurent.pinchart@ideasonboard.com>
11 11
12 description: | 12 description: |
13 The NXP PCA963x are I2C-controlled LED drive 13 The NXP PCA963x are I2C-controlled LED drivers optimized for
14 Red/Green/Blue/Amber (RGBA) color mixing app 14 Red/Green/Blue/Amber (RGBA) color mixing applications. Each LED is
15 individually controllable and has its own PW 15 individually controllable and has its own PWM controller.
16 16
17 Datasheets are available at 17 Datasheets are available at
18 18
19 - https://www.nxp.com/docs/en/data-sheet/PCA 19 - https://www.nxp.com/docs/en/data-sheet/PCA9632.pdf
20 - https://www.nxp.com/docs/en/data-sheet/PCA 20 - https://www.nxp.com/docs/en/data-sheet/PCA9633.pdf
21 - https://www.nxp.com/docs/en/data-sheet/PCA 21 - https://www.nxp.com/docs/en/data-sheet/PCA9634.pdf
22 - https://www.nxp.com/docs/en/data-sheet/PCA 22 - https://www.nxp.com/docs/en/data-sheet/PCA9635.pdf
23 23
24 properties: 24 properties:
25 compatible: 25 compatible:
26 enum: 26 enum:
27 - nxp,pca9632 27 - nxp,pca9632
28 - nxp,pca9633 28 - nxp,pca9633
29 - nxp,pca9634 29 - nxp,pca9634
30 - nxp,pca9635 30 - nxp,pca9635
31 31
32 reg: 32 reg:
33 maxItems: 1 33 maxItems: 1
34 34
35 "#address-cells": 35 "#address-cells":
36 const: 1 36 const: 1
37 37
38 "#size-cells": 38 "#size-cells":
39 const: 0 39 const: 0
40 40
41 nxp,hw-blink: 41 nxp,hw-blink:
42 type: boolean 42 type: boolean
43 description: 43 description:
44 Use hardware blinking instead of softwar 44 Use hardware blinking instead of software blinking
45 45
46 nxp,inverted-out: 46 nxp,inverted-out:
47 type: boolean 47 type: boolean
48 description: 48 description:
49 Invert the polarity of the generated PWM 49 Invert the polarity of the generated PWM.
50 50
51 nxp,period-scale: 51 nxp,period-scale:
52 $ref: /schemas/types.yaml#/definitions/uin 52 $ref: /schemas/types.yaml#/definitions/uint32
53 description: 53 description:
54 In some configurations, the chip blinks 54 In some configurations, the chip blinks faster than expected. This
55 parameter provides a scaling ratio (fixe 55 parameter provides a scaling ratio (fixed point, decimal divided by 1000)
56 to compensate, e.g. 1300=1.3x and 750=0. 56 to compensate, e.g. 1300=1.3x and 750=0.75x.
57 57
58 nxp,totem-pole: 58 nxp,totem-pole:
59 type: boolean 59 type: boolean
60 description: 60 description:
61 Use totem pole (push-pull) instead of op 61 Use totem pole (push-pull) instead of open-drain (pca9632 defaults to
62 open-drain, newer chips to totem pole). 62 open-drain, newer chips to totem pole).
63 63
64 patternProperties: 64 patternProperties:
65 "^led@[0-9a-f]+$": 65 "^led@[0-9a-f]+$":
66 type: object 66 type: object
67 $ref: common.yaml# 67 $ref: common.yaml#
68 unevaluatedProperties: false 68 unevaluatedProperties: false
69 69
70 properties: 70 properties:
71 reg: 71 reg:
72 minimum: 0 72 minimum: 0
73 73
74 required: 74 required:
75 - reg 75 - reg
76 76
77 allOf: 77 allOf:
78 - if: 78 - if:
79 properties: 79 properties:
80 compatible: 80 compatible:
81 contains: 81 contains:
82 enum: 82 enum:
83 - nxp,pca9632 83 - nxp,pca9632
84 - nxp,pca9633 84 - nxp,pca9633
85 then: 85 then:
86 patternProperties: 86 patternProperties:
87 "^led@[0-9a-f]+$": 87 "^led@[0-9a-f]+$":
88 properties: 88 properties:
89 reg: 89 reg:
90 maximum: 3 90 maximum: 3
91 else: 91 else:
92 patternProperties: 92 patternProperties:
93 "^led@[0-9a-f]+$": 93 "^led@[0-9a-f]+$":
94 properties: 94 properties:
95 reg: 95 reg:
96 maximum: 7 96 maximum: 7
97 97
98 additionalProperties: false 98 additionalProperties: false
99 99
100 examples: 100 examples:
101 - | 101 - |
102 #include <dt-bindings/leds/common.h> 102 #include <dt-bindings/leds/common.h>
103 103
104 i2c { 104 i2c {
105 #address-cells = <1>; 105 #address-cells = <1>;
106 #size-cells = <0>; 106 #size-cells = <0>;
107 107
108 led-controller@62 { 108 led-controller@62 {
109 compatible = "nxp,pca9632"; 109 compatible = "nxp,pca9632";
110 reg = <0x62>; 110 reg = <0x62>;
111 #address-cells = <1>; 111 #address-cells = <1>;
112 #size-cells = <0>; 112 #size-cells = <0>;
113 113
114 led@0 { 114 led@0 {
115 reg = <0>; 115 reg = <0>;
116 color = <LED_COLOR_ID_RED> 116 color = <LED_COLOR_ID_RED>;
117 function = LED_FUNCTION_ST 117 function = LED_FUNCTION_STATUS;
118 }; 118 };
119 119
120 led@1 { 120 led@1 {
121 reg = <1>; 121 reg = <1>;
122 color = <LED_COLOR_ID_GREE 122 color = <LED_COLOR_ID_GREEN>;
123 function = LED_FUNCTION_ST 123 function = LED_FUNCTION_STATUS;
124 }; 124 };
125 125
126 led@2 { 126 led@2 {
127 reg = <2>; 127 reg = <2>;
128 color = <LED_COLOR_ID_BLUE 128 color = <LED_COLOR_ID_BLUE>;
129 function = LED_FUNCTION_ST 129 function = LED_FUNCTION_STATUS;
130 }; 130 };
131 131
132 led@3 { 132 led@3 {
133 reg = <3>; 133 reg = <3>;
134 color = <LED_COLOR_ID_WHIT 134 color = <LED_COLOR_ID_WHITE>;
135 function = LED_FUNCTION_ST 135 function = LED_FUNCTION_STATUS;
136 }; 136 };
137 }; 137 };
138 }; 138 };
139 139
140 ... 140 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.