bindings/leds/leds-bcm6328.yaml

1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
3 ---
4 $id: http://devicetree.org/schemas/leds/leds-bcm6328.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10   - Álvaro Fernández Rojas <noltari@gmail.com>
14   In these SoCs it's possible to control LEDs both as GPIOs or by hardware.
16   controller), which can either be controlled by software (exporting the 74x164
17   as spi-gpio. See
18   Documentation/devicetree/bindings/gpio/fairchild,74hc595.yaml), or by hardware
20   Some of these Serial LEDs are hardware controlled (e.g. ethernet LEDs) and
21   exporting the 74x164 as spi-gpio prevents those LEDs to be hardware
22   controlled, so the only chance to keep them working is by using this driver.
25   should be controlled by a hardware signal instead of the MODE register value,
26   with 0 meaning hardware control enabled and 1 hardware control disabled. This
27   is usually 1:1 for hardware to LED signals, but through the activity/link
29   explained later in brcm,link-signal-sources). Even if a LED is hardware
30   controlled you are still able to make it blink or light it up if it isn't,
31   but you can't turn it off if the hardware decides to light it up. For this
32   reason, hardware controlled LEDs aren't registered as LED class devices.
34   Each LED is represented as a sub-node of the brcm,bcm6328-leds device.
38     const: brcm,bcm6328-leds
43   brcm,serial-leds:
47   brcm,serial-mux:
51   brcm,serial-clk-low:
55   brcm,serial-dat-low:
59   brcm,serial-shift-inv:
63   "#address-cells":
66   "#size-cells":
70   "@[a-f0-9]+$":
78           - maximum: 23
81       brcm,hardware-controlled:
83         description: Makes this LED hardware controlled.
85       brcm,link-signal-sources:
86         $ref: /schemas/types.yaml#/definitions/uint32-array
90           An array of hardware link signal sources. Up to four link hardware
96       brcm,activity-signal-sources:
97         $ref: /schemas/types.yaml#/definitions/uint32-array
101           An array of hardware activity signal sources. Up to four activity
102           hardware signals can get muxed into these LEDs. Only valid for LEDs 0
108       - reg
113   - reg
114   - "#address-cells"
115   - "#size-cells"
120   - |
122     led-controller@10000800 {
123         compatible = "brcm,bcm6328-leds";
124         #address-cells = <1>;
125         #size-cells = <0>;
130             active-low;
136             active-low;
142             active-low;
144             default-state = "on";
149             brcm,hardware-controlled;
154             brcm,hardware-controlled;
159             brcm,hardware-controlled;
164             brcm,hardware-controlled;
167   - |
169     led-controller@10001900 {
170         compatible = "brcm,bcm6328-leds";
171         #address-cells = <1>;
172         #size-cells = <0>;
174         brcm,serial-leds;
175         brcm,serial-dat-low;
176         brcm,serial-shift-inv;
180             brcm,hardware-controlled;
181             brcm,link-signal-sources = <0>;
186             brcm,hardware-controlled;
187             brcm,link-signal-sources = <1>;
192             active-low;
198             active-low;
204             active-low;
210             active-low;
216             active-low;
222             brcm,hardware-controlled;
227             brcm,hardware-controlled;
232             brcm,hardware-controlled;
237             brcm,hardware-controlled;
242             brcm,hardware-controlled;
247             brcm,hardware-controlled;
252             brcm,hardware-controlled;
257             active-low;
259             default-state = "on";
262   - |
264     led-controller@10001900 {
265         compatible = "brcm,bcm6328-leds";
266         #address-cells = <1>;
267         #size-cells = <0>;
272             brcm,hardware-controlled;
273             brcm,link-signal-sources = <0>;
274             brcm,activity-signal-sources = <0>;
280             brcm,hardware-controlled;
281             brcm,activity-signal-sources = <1>;
287             brcm,hardware-controlled;
288             brcm,link-signal-sources = <4>;
294             brcm,hardware-controlled;
295             brcm,link-signal-sources = <5>;
301             brcm,hardware-controlled;
302             brcm,link-signal-sources = <6>;
308             brcm,hardware-controlled;
309             brcm,link-signal-sources = <7>;
315             active-low;
317             default-state = "on";
320   - |
322     led-controller@10001900 {
323         compatible = "brcm,bcm6328-leds";
324         #address-cells = <1>;
325         #size-cells = <0>;
330             brcm,hardware-controlled;
331             brcm,link-signal-sources = <0 1>;
332             brcm,activity-signal-sources = <0 1>;
338             brcm,hardware-controlled;
339             brcm,link-signal-sources = <4 5 6 7>;
345             active-low;
347             default-state = "on";
350   - |
352     led-controller@10001900 {
353         compatible = "brcm,bcm6328-leds";
354         #address-cells = <1>;
355         #size-cells = <0>;
360             brcm,hardware-controlled;
361             brcm,link-signal-sources = <0>;
362             brcm,activity-signal-sources = <0 1>;
368             brcm,hardware-controlled;
369             brcm,link-signal-sources = <7>;
375             brcm,hardware-controlled;
376             brcm,link-signal-sources = <6>;
382             brcm,hardware-controlled;
383             brcm,link-signal-sources = <5>;
389             brcm,hardware-controlled;
390             brcm,link-signal-sources = <4>;
396             active-low;
398             default-state = "on";