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

title: Sitronix ST7586 Display Controller

maintainers:
  - David Lechner <david@lechnology.com>

description:
  Sitronix ST7586 is a driver and controller for 4-level gray
  scale and monochrome dot matrix LCD panels.
  https://topwaydisplay.com/sites/default/files/2020-04/ST7586S.pdf

$ref: panel/panel-common.yaml#

additionalProperties: false

properties:
  compatible:
    const: lego,ev3-lcd

  reg:
    maxItems: 1

  spi-max-frequency:
    maximum: 50000000

  a0-gpios:
    description:
      The A0 signal (for serial mode, this is the pin labeled D1 on the
      controller, not the pin labeled A0)
    maxItems: 1

  reset-gpios: true
  rotation: true

required:
  - compatible
  - reg
  - a0-gpios
  - reset-gpios

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

    spi {
        #address-cells = <1>;
        #size-cells = <0>;

        display@0 {
            compatible = "lego,ev3-lcd";
            reg = <0>;
            spi-max-frequency = <10000000>;
            a0-gpios = <&gpio 43 GPIO_ACTIVE_HIGH>;
            reset-gpios = <&gpio 80 GPIO_ACTIVE_HIGH>;
        };
    };
