# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/leds/lacie,netxbig-leds.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: LaCie/Seagate netxbig CPLD LEDs

maintainers:
  - Simon Guinot <simon.guinot@sequanux.org>

description: |
  Binding for the CPLD LEDs (GPIO extension bus) found on some LaCie/Seagate
  boards (Example: 2Big/5Big Network v2, 2Big NAS).

properties:
  compatible:
    const: lacie,netxbig-leds

  gpio-ext:
    description: Phandle for the gpio-ext bus.
    $ref: /schemas/types.yaml#/definitions/phandle

  timers:
    description:
      Timer array. Each timer entry is represented by three integers -
      Mode (gpio-ext bus), delay_on and delay_off.
    $ref: /schemas/types.yaml#/definitions/uint32-array

patternProperties:
  "^led-[a-z0-9]+$":
    type: object
    $ref: common.yaml#
    unevaluatedProperties: false

    properties:
      mode-addr:
        description: Mode register address on gpio-ext bus.
        $ref: /schemas/types.yaml#/definitions/uint32

      mode-val:
        description:
          Mode to value mapping. Each entry is represented by two integers -
          a mode and the corresponding value on the gpio-ext bus.
        $ref: /schemas/types.yaml#/definitions/uint32-array

      bright-addr:
        description: Brightness register address on gpio-ext bus.
        $ref: /schemas/types.yaml#/definitions/uint32

      max-brightness:
        description: Maximum brightness value.
        $ref: /schemas/types.yaml#/definitions/uint32

    required:
      - mode-addr
      - mode-val
      - bright-addr
      - max-brightness

required:
  - compatible
  - gpio-ext

additionalProperties: false

examples:
  - |
    #include <dt-bindings/leds/leds-netxbig.h>

    leds {
        compatible = "lacie,netxbig-leds";

        gpio-ext = <&netxbig_gpio_ext>;

        timers = <NETXBIG_LED_TIMER1 500 500
                  NETXBIG_LED_TIMER2 500 1000>;

        led-0 {
            label = "netxbig:blue:power";
            mode-addr = <0>;
            mode-val = <NETXBIG_LED_OFF 0
                        NETXBIG_LED_ON 1
                        NETXBIG_LED_TIMER1 3
                        NETXBIG_LED_TIMER2 7>;
            bright-addr = <1>;
            max-brightness = <7>;
        };
        led-1 {
            label = "netxbig:red:power";
            mode-addr = <0>;
            mode-val = <NETXBIG_LED_OFF 0
                        NETXBIG_LED_ON 2
                        NETXBIG_LED_TIMER1 4>;
            bright-addr = <1>;
            max-brightness = <7>;
        };
        led-2 {
            label = "netxbig:blue:sata0";
            mode-addr = <3>;
            mode-val = <NETXBIG_LED_OFF 0
                        NETXBIG_LED_ON 7
                        NETXBIG_LED_SATA 1
                        NETXBIG_LED_TIMER1 3>;
            bright-addr = <2>;
            max-brightness = <7>;
        };
        led-3 {
            label = "netxbig:red:sata0";
            mode-addr = <3>;
            mode-val = <NETXBIG_LED_OFF 0
                        NETXBIG_LED_ON 2
                        NETXBIG_LED_TIMER1 4>;
            bright-addr = <2>;
            max-brightness = <7>;
        };
        led-4 {
            label = "netxbig:blue:sata1";
            mode-addr = <4>;
            mode-val = <NETXBIG_LED_OFF 0
                        NETXBIG_LED_ON 7
                        NETXBIG_LED_SATA 1
                        NETXBIG_LED_TIMER1 3>;
            bright-addr = <2>;
            max-brightness = <7>;
        };
        led-5 {
            label = "netxbig:red:sata1";
            mode-addr = <4>;
            mode-val = <NETXBIG_LED_OFF 0
                        NETXBIG_LED_ON 2
                        NETXBIG_LED_TIMER1 4>;
            bright-addr = <2>;
            max-brightness = <7>;
        };
    };