[RFC PATCH v1 1/2] dt-bindings: display: panel: Add RAiO RA8875 display controller

Adam Azuddin
2026-05-04T02:14:17Z

The RA8875 is an SPI-connected TFT display controller by RAiO
Technology Inc. It supports display resolutions of up to 800x480.

Add YAML binding schema for the RA8875 controller, along with
the raio vendor prefix for RAiO Technology Inc.

Signed-off-by: Adam Azuddin <azuddinadam@gmail.com>
---
.../bindings/display/panel/raio,ra8875.yaml | 76 +++++++++++++++++++
.../devicetree/bindings/vendor-prefixes.yaml | 2 +
2 files changed, 78 insertions(+)
create mode 100644 Documentation/devicetree/bindings/display/panel/raio,ra8875.yaml

diff --git a/Documentation/devicetree/bindings/display/panel/raio,ra8875.yaml b/Documentation/devicetree/bindings/display/panel/raio,ra8875.yaml
new file mode 100644
index 000000000000..a49521242763
--- /dev/null
+++ b/Documentation/devicetree/bindings/display/panel/raio,ra8875.yaml
@@ -0,0 +1,76 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/display/panel/raio,ra8875.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: RAiO RA8875 Display Controller
+
+maintainers:
+ - Adam Azuddin <azuddinadam@gmail.com>
+
+description: |
+ This binding is for display panels using an RAiO RA8875 controller
+ connected via SPI.
+
+allOf:
+ - $ref: panel-common.yaml#
+ - $ref: /schemas/spi/spi-peripheral-props.yaml#
+
+properties:
+ compatible:
+ const: raio,ra8875
+
+ reg:
+ maxItems: 1
+
+ spi-max-frequency:
+ maximum: 25000000
+
+ reset-gpios:
+ maxItems: 1
+ description: GPIO used to reset the controller, optional
+
+ vcc-supply:
+ description: Regulator that provides the VCC voltage, optional
+
+ display-timings:
+ $ref: /schemas/display/panel/display-timings.yaml#
+
+required:
+ - compatible
+ - reg
+ - display-timings
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/gpio/gpio.h>
+
+ spi {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ ra8875: ra8875@0 {
+ compatible = "raio,ra8875";
+ reg = <0>;
+ spi-max-frequency = <16000000>;
+ reset-gpios = <&gpio 25 GPIO_ACTIVE_LOW>;
+
+ display-timings {
+ native-mode = <&timing0>;
+ timing0: timing0 {
+ clock-frequency = <25000000>;
+ hactive = <800>;
+ vactive = <480>;
+ hfront-porch = <40>;
+ hsync-len = <40>;
+ hback-porch = <40>;
+ vfront-porch = <10>;
+ vsync-len = <10>;
+ vback-porch = <20>;
+ };
+ };
+ };
+ };
diff --git a/Documentation/devicetree/bindings/vendor-prefixes.yaml b/Documentation/devicetree/bindings/vendor-prefixes.yaml
index 28784d66ae7b..ca453042f6a2 100644
--- a/Documentation/devicetree/bindings/vendor-prefixes.yaml
+++ b/Documentation/devicetree/bindings/vendor-prefixes.yaml
@@ -1361,6 +1361,8 @@ patternProperties:
description: Radxa
"^raidsonic,.*":
description: RaidSonic Technology GmbH
+ "^raio,.*":
+ description: RAiO Technology Inc.
"^ralink,.*":
description: Mediatek/Ralink Technology Corp.
"^ramtron,.*":
--
2.54.0