dt-bindings: leds: Convert gpio-leds to DT schema

LEDs connected to GPIO lines

Required properties:

- compatible : should be "gpio-leds".

Each LED is represented as a sub-node of the gpio-leds device.  Each

node's name represents the name of the corresponding LED.

LED sub-node properties:

- gpios :  Should specify the LED's GPIO, see "gpios property" in

  Documentation/devicetree/bindings/gpio/gpio.txt.  Active low LEDs should be

  indicated using flags in the GPIO specifier.

- function :  (optional)

  see Documentation/devicetree/bindings/leds/common.txt

- color :  (optional)

  see Documentation/devicetree/bindings/leds/common.txt

- label :  (optional)

  see Documentation/devicetree/bindings/leds/common.txt (deprecated)

- linux,default-trigger :  (optional)

  see Documentation/devicetree/bindings/leds/common.txt

- default-state:  (optional) The initial state of the LED.

  see Documentation/devicetree/bindings/leds/common.txt

- retain-state-suspended: (optional) The suspend state can be retained.Such

  as charge-led gpio.

- retain-state-shutdown: (optional) Retain the state of the LED on shutdown.

  Useful in BMC systems, for example when the BMC is rebooted while the host

  remains up.

- panic-indicator : (optional)

  see Documentation/devicetree/bindings/leds/common.txt

Examples:

#include <dt-bindings/gpio/gpio.h>

#include <dt-bindings/leds/common.h>

leds {

	compatible = "gpio-leds";

	led0 {

		gpios = <&mcu_pio 0 GPIO_ACTIVE_LOW>;

		linux,default-trigger = "disk-activity";

		function = LED_FUNCTION_DISK;

	};

	led1 {

		gpios = <&mcu_pio 1 GPIO_ACTIVE_HIGH>;

		/* Keep LED on if BIOS detected hardware fault */

		default-state = "keep";

		function = LED_FUNCTION_FAULT;

	};

};

run-control {

	compatible = "gpio-leds";

	led0 {

		gpios = <&mpc8572 6 GPIO_ACTIVE_HIGH>;

		color = <LED_COLOR_ID_RED>;

		default-state = "off";

	};

	led1 {

		gpios = <&mpc8572 7 GPIO_ACTIVE_HIGH>;

		color = <LED_COLOR_ID_GREEN>;

		default-state = "on";

	};

};

leds {

	compatible = "gpio-leds";

	led0 {

		gpios = <&gpio1 2 GPIO_ACTIVE_HIGH>;

		linux,default-trigger = "max8903-charger-charging";

		retain-state-suspended;

		function = LED_FUNCTION_CHARGE;

	};

};

# SPDX-License-Identifier: GPL-2.0-only

%YAML 1.2

---

$id: http://devicetree.org/schemas/leds/leds-gpio.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#

title: LEDs connected to GPIO lines

maintainers:

  - Jacek Anaszewski <jacek.anaszewski@gmail.com>

  - Pavel Machek <pavel@ucw.cz>

description:

  Each LED is represented as a sub-node of the gpio-leds device.  Each

  node's name represents the name of the corresponding LED.

properties:

  compatible:

    const: gpio-leds

patternProperties:

  # The first form is preferred, but fall back to just 'led' anywhere in the

  # node name to at least catch some child nodes.

  "(^led-[0-9a-f]$|led)":

    type: object

    allOf:

      - $ref: common.yaml#

    properties:

      gpios:

        maxItems: 1

      retain-state-suspended:

        description:

          The suspend state can be retained.Such as charge-led gpio.

        type: boolean

      retain-state-shutdown:

        description:

          Retain the state of the LED on shutdown. Useful in BMC systems, for

          example when the BMC is rebooted while the host remains up.

        type: boolean

    required:

      - gpios

additionalProperties: false

examples:

  - |

    #include <dt-bindings/gpio/gpio.h>

    #include <dt-bindings/leds/common.h>

    leds {

        compatible = "gpio-leds";

        led-0 {

            gpios = <&mcu_pio 0 GPIO_ACTIVE_LOW>;

            linux,default-trigger = "disk-activity";

            function = LED_FUNCTION_DISK;

        };

        led-1 {

            gpios = <&mcu_pio 1 GPIO_ACTIVE_HIGH>;

            /* Keep LED on if BIOS detected hardware fault */

            default-state = "keep";

            function = LED_FUNCTION_FAULT;

        };

    };

    run-control {

        compatible = "gpio-leds";

        led-0 {

            gpios = <&mpc8572 6 GPIO_ACTIVE_HIGH>;

            color = <LED_COLOR_ID_RED>;

            default-state = "off";

        };

        led-1 {

            gpios = <&mpc8572 7 GPIO_ACTIVE_HIGH>;

            color = <LED_COLOR_ID_GREEN>;

            default-state = "on";

        };

    };

...