[PATCH v3 02/13] spi: dt-bindings: cdns,qspi-nor: add PHY tuning pattern partition property
From: Santhosh Kumar K
Date: Wed May 27 2026 - 13:59:44 EST
PHY tuning requires a known data pattern to be readable from flash.
When no partition is explicitly identified, the controller must search
all available partitions to locate the pattern by label, which adds
overhead and relies on label naming conventions outside the
controller's control.
Add cdns,phy-pattern-partition, a phandle property that allows the DT
author to directly reference the flash partition holding the PHY tuning
pattern. The controller uses this partition during calibration, avoiding
the partition search entirely.
Signed-off-by: Santhosh Kumar K <s-k6@xxxxxx>
---
.../bindings/spi/cdns,qspi-nor-peripheral-props.yaml | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/Documentation/devicetree/bindings/spi/cdns,qspi-nor-peripheral-props.yaml b/Documentation/devicetree/bindings/spi/cdns,qspi-nor-peripheral-props.yaml
index 510b82c177c0..0ffcdf5b00d0 100644
--- a/Documentation/devicetree/bindings/spi/cdns,qspi-nor-peripheral-props.yaml
+++ b/Documentation/devicetree/bindings/spi/cdns,qspi-nor-peripheral-props.yaml
@@ -39,4 +39,12 @@ properties:
Delay in nanoseconds between setting qspi_n_ss_out low and
first bit transfer.
+ cdns,phy-pattern-partition:
+ $ref: /schemas/types.yaml#/definitions/phandle
+ description:
+ Phandle to the flash partition containing the PHY tuning pattern.
+ When present, the controller uses this partition to locate the
+ pattern data during PHY tuning instead of searching all partitions
+ by label.
+
additionalProperties: true
--
2.34.1