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

From: Adam Azuddin

Date: Thu Sep 24 2026 - 10:58:19 EST


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

Assisted-by: LLM
Signed-off-by: Adam Azuddin <azuddinadam@xxxxxxxxx>
---
.../bindings/display/panel/raio,ra8875.yaml | 78 +++++++++++++++++++
.../devicetree/bindings/vendor-prefixes.yaml | 2 +
2 files changed, 80 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..b50fd95c5753
--- /dev/null
+++ b/Documentation/devicetree/bindings/display/panel/raio,ra8875.yaml
@@ -0,0 +1,78 @@
+# 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@xxxxxxxxx>
+
+description:
+ The RA8875 is a TFT LCD controller for panels up to 800x480 pixels.
+ It can be connected to the controller via 8080/6800 parallel interface,
+ SPI or I2C. This binding describes the SPI-connected device.
+
+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
+
+ vdd-supply:
+ description:
+ 3.3 V supply for the IO pins, the oscillator IO pins, the ADC pins
+ and the internal LDO. The 1.8 V core rail is generated internally.
+
+ reset-gpios:
+ description:
+ GPIO connected to the active-low RST# pin. Optional, since the board
+ may instead use an RC reset circuit.
+ maxItems: 1
+
+required:
+ - compatible
+ - reg
+ - display-timings
+ - vdd-supply
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ spi {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ panel: display@0 {
+ compatible = "raio,ra8875";
+ reg = <0>;
+ spi-max-frequency = <16000000>;
+ vdd-supply = <&vcc_3v3>;
+ 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 ba2002969373..99d5113fb035 100644
--- a/Documentation/devicetree/bindings/vendor-prefixes.yaml
+++ b/Documentation/devicetree/bindings/vendor-prefixes.yaml
@@ -1395,6 +1395,8 @@ patternProperties:
description: Radxa
"^raidsonic,.*":
description: RaidSonic Technology GmbH
+ "^raio,.*":
+ description: RAiO Technology Inc.
"^ralink,.*":
description: Mediatek/Ralink Technology Corp.
"^ramtron,.*":
--
2.55.0