Commit 9a01fb40 authored by Hironori KIKUCHI's avatar Hironori KIKUCHI Committed by Neil Armstrong
Browse files

dt-bindings: display: st7701: Add Anbernic RG28XX panel 



The RG28XX panel is a display panel of the Anbernic RG28XX, a handheld
gaming device from Anbernic. It is 2.8 inches in size (diagonally) with
a resolution of 480x640.

This panel is driven by a variant of the ST7701 driver IC internally,
confirmed by dumping and analyzing its BSP initialization sequence
by using a logic analyzer. It is very similar to the existing
densitron,dmt028vghmcmi-1a panel, but differs in some unknown
register values, so add a new entry for the panel to distinguish them.

Additionally, the panel only has an SPI instead of MIPI DSI.
So add and modify for SPI as well.

Although a panel connected via SPI with a D/CX pin theoretically exists,
no such panels have been found for this driver yet. Therefore, disable
the use of the dc-gpios property for all currently known devices.

Signed-off-by: default avatarHironori KIKUCHI <kikuchan98@gmail.com>
Reviewed-by: default avatarConor Dooley <conor.dooley@microchip.com>
Reviewed-by: default avatarNeil Armstrong <neil.armstrong@linaro.org>
Reviewed-by: default avatarJessica Zhang <quic_jesszhan@quicinc.com>
Link: https://lore.kernel.org/r/20240804061503.881283-4-kikuchan98@gmail.com


Signed-off-by: default avatarNeil Armstrong <neil.armstrong@linaro.org>
Link: https://patchwork.freedesktop.org/patch/msgid/20240804061503.881283-4-kikuchan98@gmail.com
parent a055c91a

Documentation/devicetree/bindings/display/panel/sitronix,st7701.yaml

+64 −5
Original line number Diff line number Diff line
@@ -20,21 +20,19 @@ description: | 
  Densitron DMT028VGHMCMI-1A is 480x640, 2-lane MIPI DSI LCD panel

  which has built-in ST7701 chip.



allOf:

  - $ref: panel-common.yaml#



properties:

  compatible:

    items:

      - enum:

          - anbernic,rg-arc-panel

          - anbernic,rg28xx-panel

          - densitron,dmt028vghmcmi-1a

          - elida,kd50t048a

          - techstar,ts8550b

      - const: sitronix,st7701



  reg:

    description: DSI virtual channel used by that screen

    description: DSI / SPI channel used by that screen

    maxItems: 1



  VCC-supply:
@@ -43,6 +41,13 @@ properties: 
  IOVCC-supply:

    description: I/O system regulator



  dc-gpios:

    maxItems: 1

    description:

      Controller data/command selection (D/CX) in 4-line SPI mode.

      If not set, the controller is in 3-line SPI mode.

      Disallowed for DSI.



  port: true

  reset-gpios: true

  rotation: true
@@ -57,7 +62,38 @@ required: 
  - port

  - reset-gpios



additionalProperties: false

allOf:

  - $ref: panel-common.yaml#

  - if:

      properties:

        compatible:

          contains:

            # SPI connected panels

            enum:

              - anbernic,rg28xx-panel

    then:

      $ref: /schemas/spi/spi-peripheral-props.yaml#



  - if:

      properties:

        compatible:

          not:

            contains:

              # DSI or SPI without D/CX pin

              enum:

                - anbernic,rg-arc-panel

                - anbernic,rg28xx-panel

                - densitron,dmt028vghmcmi-1a

                - elida,kd50t048a

                - techstar,ts8550b

    then:

      required:

        - dc-gpios

    else:

      properties:

        dc-gpios: false



unevaluatedProperties: false



examples:

  - |
@@ -82,3 +118,26 @@ examples: 
            };

        };

    };

  - |

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



    spi {

        #address-cells = <1>;

        #size-cells = <0>;



        panel@0 {

            compatible = "anbernic,rg28xx-panel", "sitronix,st7701";

            reg = <0>;

            spi-max-frequency = <3125000>;

            VCC-supply = <&reg_lcd>;

            IOVCC-supply = <&reg_lcd>;

            reset-gpios = <&pio 8 14 GPIO_ACTIVE_HIGH>; /* LCD-RST: PI14 */

            backlight = <&backlight>;



            port {

                panel_in_rgb: endpoint {

                    remote-endpoint = <&tcon_lcd0_out_lcd>;

                };

            };

        };

    };