405 lines
10 KiB
YAML
405 lines
10 KiB
YAML
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/leds/leds-bcm6328.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: LEDs connected to Broadcom BCM6328 controller
|
|
|
|
maintainers:
|
|
- Álvaro Fernández Rojas <noltari@gmail.com>
|
|
|
|
description: |
|
|
This controller is present on BCM6318, BCM6328, BCM6362 and BCM63268.
|
|
In these SoCs it's possible to control LEDs both as GPIOs or by hardware.
|
|
However, on some devices there are Serial LEDs (LEDs connected to a 74x164
|
|
controller), which can either be controlled by software (exporting the 74x164
|
|
as spi-gpio. See
|
|
Documentation/devicetree/bindings/gpio/fairchild,74hc595.yaml), or by hardware
|
|
using this driver.
|
|
Some of these Serial LEDs are hardware controlled (e.g. ethernet LEDs) and
|
|
exporting the 74x164 as spi-gpio prevents those LEDs to be hardware
|
|
controlled, so the only chance to keep them working is by using this driver.
|
|
|
|
BCM6328 LED controller has a HWDIS register, which controls whether a LED
|
|
should be controlled by a hardware signal instead of the MODE register value,
|
|
with 0 meaning hardware control enabled and 1 hardware control disabled. This
|
|
is usually 1:1 for hardware to LED signals, but through the activity/link
|
|
registers you have some limited control over rerouting the LEDs (as
|
|
explained later in brcm,link-signal-sources). Even if a LED is hardware
|
|
controlled you are still able to make it blink or light it up if it isn't,
|
|
but you can't turn it off if the hardware decides to light it up. For this
|
|
reason, hardware controlled LEDs aren't registered as LED class devices.
|
|
|
|
Each LED is represented as a sub-node of the brcm,bcm6328-leds device.
|
|
|
|
properties:
|
|
compatible:
|
|
const: brcm,bcm6328-leds
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
brcm,serial-leds:
|
|
type: boolean
|
|
description: Enables Serial LEDs.
|
|
|
|
brcm,serial-mux:
|
|
type: boolean
|
|
description: Enables Serial LEDs multiplexing.
|
|
|
|
brcm,serial-clk-low:
|
|
type: boolean
|
|
description: Makes clock signal active low.
|
|
|
|
brcm,serial-dat-low:
|
|
type: boolean
|
|
description: Makes data signal active low.
|
|
|
|
brcm,serial-shift-inv:
|
|
type: boolean
|
|
description: Inverts Serial LEDs shift direction.
|
|
|
|
"#address-cells":
|
|
const: 1
|
|
|
|
"#size-cells":
|
|
const: 0
|
|
|
|
patternProperties:
|
|
"@[a-f0-9]+$":
|
|
type: object
|
|
|
|
$ref: common.yaml#
|
|
|
|
properties:
|
|
reg:
|
|
items:
|
|
- maximum: 23
|
|
description: LED pin number (only LEDs 0 to 23 are valid).
|
|
|
|
active-low:
|
|
type: boolean
|
|
description: Makes LED active low.
|
|
|
|
brcm,hardware-controlled:
|
|
type: boolean
|
|
description: Makes this LED hardware controlled.
|
|
|
|
brcm,link-signal-sources:
|
|
$ref: /schemas/types.yaml#/definitions/uint32-array
|
|
minItems: 1
|
|
maxItems: 4
|
|
description: >
|
|
An array of hardware link signal sources. Up to four link hardware
|
|
signals can get muxed into these LEDs. Only valid for LEDs 0 to 7,
|
|
where LED signals 0 to 3 may be muxed to LEDs 0 to 3, and signals 4 to
|
|
7 may be muxed to LEDs 4 to 7. A signal can be muxed to more than one
|
|
LED, and one LED can have more than one source signal.
|
|
|
|
brcm,activity-signal-sources:
|
|
$ref: /schemas/types.yaml#/definitions/uint32-array
|
|
minItems: 1
|
|
maxItems: 4
|
|
description: >
|
|
An array of hardware activity signal sources. Up to four activity
|
|
hardware signals can get muxed into these LEDs. Only valid for LEDs 0
|
|
to 7, where LED signals 0 to 3 may be muxed to LEDs 0 to 3, and
|
|
signals 4 to 7 may be muxed to LEDs 4 to 7. A signal can be muxed to
|
|
more than one LED, and one LED can have more than one source signal.
|
|
|
|
required:
|
|
- reg
|
|
|
|
unevaluatedProperties: false
|
|
|
|
required:
|
|
- reg
|
|
- "#address-cells"
|
|
- "#size-cells"
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
/* BCM6328 with 4 EPHY LEDs */
|
|
led-controller@10000800 {
|
|
compatible = "brcm,bcm6328-leds";
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
reg = <0x10000800 0x24>;
|
|
|
|
alarm_red@2 {
|
|
reg = <2>;
|
|
active-low;
|
|
label = "red:alarm";
|
|
};
|
|
|
|
inet_green@3 {
|
|
reg = <3>;
|
|
active-low;
|
|
label = "green:inet";
|
|
};
|
|
|
|
power_green@4 {
|
|
reg = <4>;
|
|
active-low;
|
|
label = "green:power";
|
|
default-state = "on";
|
|
};
|
|
|
|
ephy0_spd@17 {
|
|
reg = <17>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
ephy1_spd@18 {
|
|
reg = <18>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
ephy2_spd@19 {
|
|
reg = <19>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
ephy3_spd@20 {
|
|
reg = <20>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
};
|
|
- |
|
|
/* BCM63268 with Serial/GPHY0 LEDs */
|
|
led-controller@10001900 {
|
|
compatible = "brcm,bcm6328-leds";
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
reg = <0x10001900 0x24>;
|
|
brcm,serial-leds;
|
|
brcm,serial-dat-low;
|
|
brcm,serial-shift-inv;
|
|
|
|
gphy0_spd0@0 {
|
|
reg = <0>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <0>;
|
|
};
|
|
|
|
gphy0_spd1@1 {
|
|
reg = <1>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <1>;
|
|
};
|
|
|
|
inet_red@2 {
|
|
reg = <2>;
|
|
active-low;
|
|
label = "red:inet";
|
|
};
|
|
|
|
dsl_green@3 {
|
|
reg = <3>;
|
|
active-low;
|
|
label = "green:dsl";
|
|
};
|
|
|
|
usb_green@4 {
|
|
reg = <4>;
|
|
active-low;
|
|
label = "green:usb";
|
|
};
|
|
|
|
wps_green@7 {
|
|
reg = <7>;
|
|
active-low;
|
|
label = "green:wps";
|
|
};
|
|
|
|
inet_green@8 {
|
|
reg = <8>;
|
|
active-low;
|
|
label = "green:inet";
|
|
};
|
|
|
|
ephy0_act@9 {
|
|
reg = <9>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
ephy1_act@10 {
|
|
reg = <10>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
ephy2_act@11 {
|
|
reg = <11>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
gphy0_act@12 {
|
|
reg = <12>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
ephy0_spd@13 {
|
|
reg = <13>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
ephy1_spd@14 {
|
|
reg = <14>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
ephy2_spd@15 {
|
|
reg = <15>;
|
|
brcm,hardware-controlled;
|
|
};
|
|
|
|
power_green@20 {
|
|
reg = <20>;
|
|
active-low;
|
|
label = "green:power";
|
|
default-state = "on";
|
|
};
|
|
};
|
|
- |
|
|
/* BCM6362 with 1 LED for each EPHY */
|
|
led-controller@10001900 {
|
|
compatible = "brcm,bcm6328-leds";
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
reg = <0x10001900 0x24>;
|
|
|
|
usb@0 {
|
|
reg = <0>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <0>;
|
|
brcm,activity-signal-sources = <0>;
|
|
/* USB link/activity routed to USB LED */
|
|
};
|
|
|
|
inet@1 {
|
|
reg = <1>;
|
|
brcm,hardware-controlled;
|
|
brcm,activity-signal-sources = <1>;
|
|
/* INET activity routed to INET LED */
|
|
};
|
|
|
|
ephy0@4 {
|
|
reg = <4>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <4>;
|
|
/* EPHY0 link routed to EPHY0 LED */
|
|
};
|
|
|
|
ephy1@5 {
|
|
reg = <5>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <5>;
|
|
/* EPHY1 link routed to EPHY1 LED */
|
|
};
|
|
|
|
ephy2@6 {
|
|
reg = <6>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <6>;
|
|
/* EPHY2 link routed to EPHY2 LED */
|
|
};
|
|
|
|
ephy3@7 {
|
|
reg = <7>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <7>;
|
|
/* EPHY3 link routed to EPHY3 LED */
|
|
};
|
|
|
|
power_green@20 {
|
|
reg = <20>;
|
|
active-low;
|
|
label = "green:power";
|
|
default-state = "on";
|
|
};
|
|
};
|
|
- |
|
|
/* BCM6362 with 1 LED for all EPHYs */
|
|
led-controller@10001900 {
|
|
compatible = "brcm,bcm6328-leds";
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
reg = <0x10001900 0x24>;
|
|
|
|
usb@0 {
|
|
reg = <0>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <0 1>;
|
|
brcm,activity-signal-sources = <0 1>;
|
|
/* USB/INET link/activity routed to USB LED */
|
|
};
|
|
|
|
ephy@4 {
|
|
reg = <4>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <4 5 6 7>;
|
|
/* EPHY0/1/2/3 link routed to EPHY0 LED */
|
|
};
|
|
|
|
power_green@20 {
|
|
reg = <20>;
|
|
active-low;
|
|
label = "green:power";
|
|
default-state = "on";
|
|
};
|
|
};
|
|
- |
|
|
/* BCM6362 with EPHY LEDs swapped */
|
|
led-controller@10001900 {
|
|
compatible = "brcm,bcm6328-leds";
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
reg = <0x10001900 0x24>;
|
|
|
|
usb@0 {
|
|
reg = <0>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <0>;
|
|
brcm,activity-signal-sources = <0 1>;
|
|
/* USB link/act and INET act routed to USB LED */
|
|
};
|
|
|
|
ephy0@4 {
|
|
reg = <4>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <7>;
|
|
/* EPHY3 link routed to EPHY0 LED */
|
|
};
|
|
|
|
ephy1@5 {
|
|
reg = <5>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <6>;
|
|
/* EPHY2 link routed to EPHY1 LED */
|
|
};
|
|
|
|
ephy2@6 {
|
|
reg = <6>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <5>;
|
|
/* EPHY1 link routed to EPHY2 LED */
|
|
};
|
|
|
|
ephy3@7 {
|
|
reg = <7>;
|
|
brcm,hardware-controlled;
|
|
brcm,link-signal-sources = <4>;
|
|
/* EPHY0 link routed to EPHY3 LED */
|
|
};
|
|
|
|
power_green@20 {
|
|
reg = <20>;
|
|
active-low;
|
|
label = "green:power";
|
|
default-state = "on";
|
|
};
|
|
};
|