[PATCH v2 1/2] dt-bindings: spi: qcom-geni: Document ready-gpios property

From: Praveen Talari

Date: Mon Aug 17 2026 - 12:25:21 EST


When operating in SPI target (slave) mode, the GENI SPI controller can
use an external GPIO to notify the SPI master about the target's
active state.

Document the optional ready-gpios property for the qcom,spi-geni-qcom
and qcom,sa8255p-geni-spi bindings, restricted to spi-slave nodes.

Signed-off-by: Praveen Talari <praveen.talari@xxxxxxxxxxxxxxxx>
---
Documentation/devicetree/bindings/spi/qcom,sa8255p-geni-spi.yaml | 9 +++++++++
Documentation/devicetree/bindings/spi/qcom,spi-geni-qcom.yaml | 9 +++++++++
2 files changed, 18 insertions(+)

diff --git a/Documentation/devicetree/bindings/spi/qcom,sa8255p-geni-spi.yaml b/Documentation/devicetree/bindings/spi/qcom,sa8255p-geni-spi.yaml
index 6552303a4f52..33eddb395a0a 100644
--- a/Documentation/devicetree/bindings/spi/qcom,sa8255p-geni-spi.yaml
+++ b/Documentation/devicetree/bindings/spi/qcom,sa8255p-geni-spi.yaml
@@ -39,6 +39,12 @@ properties:
- const: power
- const: perf

+ ready-gpios:
+ description:
+ GPIO used by the SPI target to notify the SPI master when it is
+ ready to service a transfer. Only applicable in target (slave) mode.
+ maxItems: 1
+
required:
- compatible
- reg
@@ -46,6 +52,9 @@ required:
- power-domains
- power-domain-names

+dependencies:
+ ready-gpios: [ spi-slave ]
+
allOf:
- $ref: /schemas/spi/spi-controller.yaml#

diff --git a/Documentation/devicetree/bindings/spi/qcom,spi-geni-qcom.yaml b/Documentation/devicetree/bindings/spi/qcom,spi-geni-qcom.yaml
index edf399681d7a..8d1c78701657 100644
--- a/Documentation/devicetree/bindings/spi/qcom,spi-geni-qcom.yaml
+++ b/Documentation/devicetree/bindings/spi/qcom,spi-geni-qcom.yaml
@@ -67,6 +67,12 @@ properties:
reg:
maxItems: 1

+ ready-gpios:
+ description:
+ GPIO used by the SPI target to notify the SPI master when it is
+ ready to service a transfer. Only applicable in target (slave) mode.
+ maxItems: 1
+
required:
- compatible
- clocks
@@ -74,6 +80,9 @@ required:
- interrupts
- reg

+dependencies:
+ ready-gpios: [ spi-slave ]
+
unevaluatedProperties: false

examples:

--
2.34.1