On Wed, Jul 05, 2023 at 02:04:06AM +0200, Marek Vasut wrote: > The PCA995x chips are I2C controlled LED drivers. Each chip has > up to 16 outputs, each one with an individual 8-bit resolution > PWM for brightness control. Add binding document. > > Signed-off-by: Marek Vasut <marex@xxxxxxx> > --- > Cc: Conor Dooley <conor+dt@xxxxxxxxxx> > Cc: Isai Gaspar <isaiezequiel.gaspar@xxxxxxx> > Cc: Krzysztof Kozlowski <krzysztof.kozlowski+dt@xxxxxxxxxx> > Cc: Lee Jones <lee@xxxxxxxxxx> > Cc: Marek Vasut <marex@xxxxxxx> > Cc: Pavel Machek <pavel@xxxxxx> > Cc: Rob Herring <robh+dt@xxxxxxxxxx> > Cc: devicetree@xxxxxxxxxxxxxxx > Cc: linux-leds@xxxxxxxxxxxxxxx > --- > V2: Fix the led@[0-9]+ match > --- > .../devicetree/bindings/leds/nxp,pca995x.yaml | 81 +++++++++++++++++++ > 1 file changed, 81 insertions(+) > create mode 100644 Documentation/devicetree/bindings/leds/nxp,pca995x.yaml > > diff --git a/Documentation/devicetree/bindings/leds/nxp,pca995x.yaml b/Documentation/devicetree/bindings/leds/nxp,pca995x.yaml > new file mode 100644 > index 0000000000000..562199d3ad820 > --- /dev/null > +++ b/Documentation/devicetree/bindings/leds/nxp,pca995x.yaml > @@ -0,0 +1,81 @@ > +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/leds/nxp,pca995x.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: NXP PCA995x LED controllers > + > +maintainers: > + - Isai Gaspar <isaiezequiel.gaspar@xxxxxxx> > + - Marek Vasut <marex@xxxxxxx> > + > +description: > + The NXP PCA9952/PCA9955B are programmable LED controllers connected via I2C > + that can drive 16 separate lines. Each of them can be individually switched > + on and off, and brightness can be controlled via individual PWM. > + > + Datasheets are available at > + https://www.nxp.com/docs/en/data-sheet/PCA9952_PCA9955.pdf > + https://www.nxp.com/docs/en/data-sheet/PCA9955B.pdf > + > +properties: > + compatible: > + enum: > + - nxp,pca9952 > + - nxp,pca9955b > + > + reg: > + maxItems: 1 > + > + "#address-cells": > + const: 1 > + > + "#size-cells": > + const: 0 > + > +patternProperties: > + "^led@[0-9]+$": Unit-addresses are hex. > + type: object > + $ref: common.yaml# > + unevaluatedProperties: false > + > + properties: > + reg: > + minimum: 0 > + maximum: 15 > + > + required: > + - reg > + > +additionalProperties: false > + > +examples: > + - | > + #include <dt-bindings/leds/common.h> > + > + i2c { > + #address-cells = <1>; > + #size-cells = <0>; > + > + led-controller@1 { > + compatible = "nxp,pca9955b"; > + reg = <0x01>; > + #address-cells = <1>; > + #size-cells = <0>; > + > + led@0 { > + reg = <0x0>; > + color = <LED_COLOR_ID_RED>; > + function = LED_FUNCTION_POWER; > + }; > + > + led@2 { > + reg = <0x2>; > + color = <LED_COLOR_ID_WHITE>; > + function = LED_FUNCTION_STATUS; > + }; > + }; > + }; > + > +... > -- > 2.40.1 >
