[PATCH v4] spi: dt-bindings: snps,dw-apb-ssi: Document Axiado AX3005

From: Swark Yang

Date: Thu Aug 06 2026 - 01:09:29 EST


The Axiado AX3005 SPI controller is software-compatible with the
Synopsys DesignWare APB SSI 1.01a programming interface.

Document the "axiado,ax3005-spi" SoC-specific compatible with
"snps,dwc-ssi-1.01a" as its fallback. This preserves identification of
the AX3005 integration while allowing the controller to use the
existing DesignWare APB SSI support.

Signed-off-by: Swark Yang <syang@xxxxxxxxxx>
---
This SPI binding was previously submitted as patch 6/8 of the AX3005
v3 multi-subsystem series.

Following maintainer feedback, the binding updates are now submitted
separately to their respective subsystem maintainers, as there are no
cross-subsystem dependencies requiring them to be submitted together.

This submission contains only the AX3005 SPI binding. The corresponding
SPI controller nodes remain in the separate AX3005 arm64 Devicetree
series.

Changes in v4:

- Submit the SPI binding separately from the previous multi-subsystem
AX3005 series.
- Expand the commit message to explain compatibility with the Synopsys
DesignWare APB SSI 1.01a programming interface.
- Replace the AX3005-specific schema entry with a generic group for
vendor controllers compatible with v1.01a.
- Place the new group after the vendor-controller group using
"snps,dw-apb-ssi" as its fallback.
- Use an enum for the vendor-specific compatible so that the group can
be extended with additional controllers.

Previously submitted as:

[PATCH v3 6/8] dt-bindings: spi: dw-apb-ssi:
add Axiado AX3005 SPI variant

https://lore.kernel.org/all/20260716-upstream-axiado-ax3005-upstream-v3-6-c429095143ec@xxxxxxxxxx/
---
Documentation/devicetree/bindings/spi/snps,dw-apb-ssi.yaml | 5 +++++
1 file changed, 5 insertions(+)

diff --git a/Documentation/devicetree/bindings/spi/snps,dw-apb-ssi.yaml b/Documentation/devicetree/bindings/spi/snps,dw-apb-ssi.yaml
index 95a5bd894e93..7f698195cc43 100644
--- a/Documentation/devicetree/bindings/spi/snps,dw-apb-ssi.yaml
+++ b/Documentation/devicetree/bindings/spi/snps,dw-apb-ssi.yaml
@@ -53,6 +53,11 @@ properties:
- sophgo,sg2042-spi
- thead,th1520-spi
- const: snps,dw-apb-ssi
+ - description: Vendor controllers compatible with v1.01a
+ items:
+ - enum:
+ - axiado,ax3005-spi
+ - const: snps,dwc-ssi-1.01a
- description: Vendor controllers which use snps,dwc-ssi-2.00a as fallback
items:
- enum:

---
base-commit: 1590cf0329716306e948a8fc29f1d3ee87d3989f
change-id: 20260805-upstrea-ax3005-spi-v4-3f1a03ec6495

Best regards,
--
Swark Yang <syang@xxxxxxxxxx>