[PATCH v4 03/11] dt-bindings: spi: Document the spi-dqs-not-wired property

From: Miquel Raynal

Date: Fri Nov 20 2026 - 12:15:02 EST


The DQS line is a data strobe line that is typically driven by flash
memories (NOR and NAND) when the data flows from the peripheral to the
host controller when running at high frequencies in order for the data
bits to be sampled by the host at the right moment. The SPI bus already
features a clock but this clock is driven by the host, which means it is
not accounting for any chip internal delay.

Hardware engineers, if they do not expect the frequency to be configured
above the usual limits (dozens of MHz), may not route the DQS line
between the SPI controller and the peripheral.

Describe this possibility with a new optional property so that the DQS
output can be left disabled on designs where this would be
wasteful. Keeping DQS enabled while it is not routed mostly costs
spectral business and extra power consumption. Hence my proposal to keep
"wired" as a safe default.

Signed-off-by: Miquel Raynal <miquel.raynal@xxxxxxxxxxx>
---
.../devicetree/bindings/spi/spi-peripheral-props.yaml | 10 ++++++++++
1 file changed, 10 insertions(+)

diff --git a/Documentation/devicetree/bindings/spi/spi-peripheral-props.yaml b/Documentation/devicetree/bindings/spi/spi-peripheral-props.yaml
index d730442e5255..fed6bf5ce72b 100644
--- a/Documentation/devicetree/bindings/spi/spi-peripheral-props.yaml
+++ b/Documentation/devicetree/bindings/spi/spi-peripheral-props.yaml
@@ -138,6 +138,16 @@ properties:
pattern. Used when the device cannot load the pattern dynamically during
PHY tuning.

+ spi-dqs-not-wired:
+ $ref: /schemas/types.yaml#/definitions/flag
+ description:
+ The DQS (data strobe) line of the peripheral is not routed to the
+ controller. This is only meaningful for peripherals that have a DQS
+ pin, typically octal DDR SPI memories. Not routing this line is a
+ possible board design choice, for example to save a pin when the
+ memory is used at lower frequencies. If this property is absent,
+ the DQS line, if relevant, is assumed to be wired.
+
stacked-memories:
description: Several SPI memories can be wired in stacked mode.
This basically means that either a device features several chip

--
2.56.0