[PATCH v1 00/11] arm64: dts: freescale: Add SPI aliases to Toradex SoMs

[PATCH v1 00/11] arm64: dts: freescale: Add SPI aliases to Toradex SoMs

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

Toradex SoM families (Verdin, Apalis, Colibri, Aquila, Lino) and the
SMARC and OSM standards define the interfaces available to the carrier
board and their numbering or naming as part of the module pinout. The
Linux SPI bus number instead follows the SoC dtsi aliases where they
exist (i.MX8MM, i.MX8MP, i.MX8QM, i.MX8QXP) or is assigned dynamically
(i.MX91, i.MX93, i.MX95), so the bus number in sysfs and the spidev
device name do not match the module interface.

Add spiN aliases to the SoM dtsi files so the Linux bus number follows
the module interface numbering, zero-based like the existing
serial and can aliases: SPI_1 is spi0 and SPI_2 is spi1, SMARC SPI0 and
SPI1 map directly, OSM SPI_A is spi0 and SPI_B is spi1, the single
Colibri SPI is spi0. Where the SoC dtsi already gives the same
controller another alias, that inherited alias is deleted so each
controller carries a single one. SPI controllers that are not part of
the module pinout get no alias of their own.

Francesco Dolcini (11):
  arm64: dts: freescale: imx8mm-verdin: Add SPI alias
  arm64: dts: freescale: imx8mp-verdin: Add SPI alias
  arm64: dts: freescale: imx95-verdin: Add SPI alias
  arm64: dts: freescale: imx8x-colibri: Add SPI alias
  arm64: dts: freescale: imx8mp-toradex-smarc: Add SPI aliases
  arm64: dts: freescale: imx95-toradex-smarc: Add SPI aliases
  arm64: dts: freescale: imx95-aquila: Add SPI aliases
  arm64: dts: freescale: imx8-apalis: Add SPI aliases
  arm64: dts: freescale: imx93-imx91-lino-common: Add SPI aliases
  arm64: dts: freescale: imx93-imx91-toradex-osm-common: Add SPI aliases
  arm64: dts: freescale: imx95-toradex-osm: Add SPI aliases

 arch/arm64/boot/dts/freescale/imx8-apalis-v1.1.dtsi          | 3 +++
 arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi             | 2 ++
 arch/arm64/boot/dts/freescale/imx8mp-toradex-smarc.dtsi      | 2 ++
 arch/arm64/boot/dts/freescale/imx8mp-verdin.dtsi             | 1 +
 arch/arm64/boot/dts/freescale/imx8x-colibri.dtsi             | 5 +++++
 arch/arm64/boot/dts/freescale/imx93-imx91-lino-common.dtsi   | 2 ++
 .../boot/dts/freescale/imx93-imx91-toradex-osm-common.dtsi   | 2 ++
 arch/arm64/boot/dts/freescale/imx95-aquila.dtsi              | 2 ++
 arch/arm64/boot/dts/freescale/imx95-toradex-osm.dtsi         | 2 ++
 arch/arm64/boot/dts/freescale/imx95-toradex-smarc.dtsi       | 2 ++
 arch/arm64/boot/dts/freescale/imx95-verdin.dtsi              | 1 +
 11 files changed, 24 insertions(+)

-- 
2.47.3

[PATCH v1 01/11] arm64: dts: freescale: imx8mm-verdin: Add SPI alias

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The Verdin family pinout defines the SoM interfaces and their
numbering, SPI_1 being the SPI bus available to the carrier board,
implemented by ecspi2 on Verdin iMX8MM.

imx8mm.dtsi numbers ecspi2 as spi1, so the Linux bus number in sysfs
and the spidev name do not match the Verdin interface. Add a spi0
alias in the SoM dtsi and delete the inherited spi1, so ecspi2 is
bus 0, zero-based with SPI_1 being spi0, and carries a single alias.
ecspi3, internal to the SoM with the CAN controller and the TPM, keeps
the spi2 alias inherited from the SoC.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi b/arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi
index 1ac9d000d415..0369803a4d46 100644
--- a/arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi
@@ -16,6 +16,8 @@ chosen {
 	aliases {
 		rtc0 = &rtc_i2c;
 		rtc1 = &snvs_rtc;
+		spi0 = &ecspi2;
+		/delete-property/ spi1;
 	};
 
 	/* Fixed clock dedicated to SPI CAN controller */
-- 
2.47.3

[PATCH v1 02/11] arm64: dts: freescale: imx8mp-verdin: Add SPI alias

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The Verdin family pinout defines the SoM interfaces and their
numbering, SPI_1 being the SPI bus available to the carrier board,
implemented by ecspi1 on Verdin iMX8MP.

Without an alias the Linux SPI bus number is assigned dynamically and
can change with the carrier board or probe order. Add a spi0 alias so
the bus number in sysfs and the spidev name follow the Verdin interface
numbering, zero-based with SPI_1 being spi0. This replaces the spi0
alias imx8mp.dtsi gives to flexspi, Verdin QSPI_1, which gets a
dynamic bus number instead.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx8mp-verdin.dtsi | 1 +
 1 file changed, 1 insertion(+)

diff --git a/arch/arm64/boot/dts/freescale/imx8mp-verdin.dtsi b/arch/arm64/boot/dts/freescale/imx8mp-verdin.dtsi
index 6887d5555d30..ae8aba856240 100644
--- a/arch/arm64/boot/dts/freescale/imx8mp-verdin.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx8mp-verdin.dtsi
@@ -18,6 +18,7 @@ aliases {
 		ethernet1 = &fec;
 		rtc0 = &rtc_i2c;
 		rtc1 = &snvs_rtc;
+		spi0 = &ecspi1;
 	};
 
 	backlight: backlight {
-- 
2.47.3

[PATCH v1 03/11] arm64: dts: freescale: imx95-verdin: Add SPI alias

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The Verdin family pinout defines the SoM interfaces and their
numbering, SPI_1 being the SPI bus available to the carrier board,
implemented by lpspi6 on Verdin iMX95.

Without an alias the Linux SPI bus number is assigned dynamically and
can change with the carrier board or probe order. Add a spi0 alias so
the bus number in sysfs and the spidev name follow the Verdin interface
numbering, zero-based with SPI_1 being spi0.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx95-verdin.dtsi | 1 +
 1 file changed, 1 insertion(+)

diff --git a/arch/arm64/boot/dts/freescale/imx95-verdin.dtsi b/arch/arm64/boot/dts/freescale/imx95-verdin.dtsi
index d13b395e98ca..d239fecd53c5 100644
--- a/arch/arm64/boot/dts/freescale/imx95-verdin.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx95-verdin.dtsi
@@ -32,6 +32,7 @@ aliases {
 		serial2 = &lpuart1;
 		serial3 = &lpuart2;
 		serial4 = &lpuart6;
+		spi0 = &lpspi6;
 		usb0 = &usb2;
 		usb1 = &usb3;
 	};
-- 
2.47.3

[PATCH v1 04/11] arm64: dts: freescale: imx8x-colibri: Add SPI alias

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The Colibri family pinout defines the SoM interfaces, SPI being the
single SPI bus available to the carrier board, implemented by lpspi2
on Colibri iMX8X.

imx8qxp.dtsi numbers lpspi2 as spi2, so the Linux bus number in sysfs
and the spidev name do not match the Colibri interface. Add a spi0
alias in the SoM dtsi and delete the inherited spi2, so lpspi2 is
bus 0 and carries a single alias.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx8x-colibri.dtsi | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/arch/arm64/boot/dts/freescale/imx8x-colibri.dtsi b/arch/arm64/boot/dts/freescale/imx8x-colibri.dtsi
index 2415487d3a5d..8f04bc3decda 100644
--- a/arch/arm64/boot/dts/freescale/imx8x-colibri.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx8x-colibri.dtsi
@@ -6,6 +6,11 @@
 #include "dt-bindings/pwm/pwm.h"
 
 / {
+	aliases {
+		spi0 = &lpspi2;
+		/delete-property/ spi2;
+	};
+
 	backlight: backlight {
 		compatible = "pwm-backlight";
 		pinctrl-names = "default";
-- 
2.47.3

[PATCH v1 05/11] arm64: dts: freescale: imx8mp-toradex-smarc: Add SPI aliases

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The SMARC specification defines the module interfaces and their
numbering, SPI0 and SPI1 being the SPI buses available to the carrier
board, implemented by ecspi1 and ecspi2 on Toradex SMARC iMX8MP.

Without aliases the Linux SPI bus numbers are assigned dynamically and
can change with the carrier board or probe order. Add spi0 and spi1
aliases so the bus numbers in sysfs and the spidev names match the
SMARC interface numbering. This replaces the spi0 alias imx8mp.dtsi
gives to flexspi, which is not used on Toradex SMARC iMX8MP.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx8mp-toradex-smarc.dtsi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/arch/arm64/boot/dts/freescale/imx8mp-toradex-smarc.dtsi b/arch/arm64/boot/dts/freescale/imx8mp-toradex-smarc.dtsi
index eb8b9db7e3cd..f3d21d788b85 100644
--- a/arch/arm64/boot/dts/freescale/imx8mp-toradex-smarc.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx8mp-toradex-smarc.dtsi
@@ -20,6 +20,8 @@ aliases {
 		serial1 = &uart4;
 		serial2 = &uart2;
 		serial3 = &uart3;
+		spi0 = &ecspi1;
+		spi1 = &ecspi2;
 	};
 
 	chosen {
-- 
2.47.3

[PATCH v1 06/11] arm64: dts: freescale: imx95-toradex-smarc: Add SPI aliases

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The SMARC specification defines the module interfaces and their
numbering, SPI0 and SPI1 being the SPI buses available to the carrier
board, implemented by lpspi6 and lpspi4 on Toradex SMARC iMX95.

Without aliases the Linux SPI bus numbers are assigned dynamically and
can change with the carrier board or probe order. Add spi0 and spi1
aliases so the bus numbers in sysfs and the spidev names match the
SMARC interface numbering.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx95-toradex-smarc.dtsi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/arch/arm64/boot/dts/freescale/imx95-toradex-smarc.dtsi b/arch/arm64/boot/dts/freescale/imx95-toradex-smarc.dtsi
index 671c4dce0a99..82e21986bf95 100644
--- a/arch/arm64/boot/dts/freescale/imx95-toradex-smarc.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx95-toradex-smarc.dtsi
@@ -26,6 +26,8 @@ aliases {
 		serial2 = &lpuart6;
 		serial3 = &lpuart3;
 		serial4 = &lpuart5;
+		spi0 = &lpspi6;
+		spi1 = &lpspi4;
 	};
 
 	chosen {
-- 
2.47.3

[PATCH v1 07/11] arm64: dts: freescale: imx95-aquila: Add SPI aliases

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The Aquila family pinout defines the SoM interfaces and their
numbering, SPI_1 and SPI_2 being the SPI buses available to the carrier
board, implemented by lpspi6 and lpspi4 on Aquila iMX95.

Without aliases the Linux SPI bus numbers are assigned dynamically and
can change with the carrier board or probe order. Add spi0 and spi1
aliases so the bus numbers in sysfs and the spidev names follow the
Aquila interface numbering, zero-based with SPI_1 being spi0.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx95-aquila.dtsi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/arch/arm64/boot/dts/freescale/imx95-aquila.dtsi b/arch/arm64/boot/dts/freescale/imx95-aquila.dtsi
index a1870f7b2eca..e7c20dfffd34 100644
--- a/arch/arm64/boot/dts/freescale/imx95-aquila.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx95-aquila.dtsi
@@ -31,6 +31,8 @@ aliases {
 		serial1 = &lpuart7;
 		serial2 = &lpuart1;
 		serial3 = &lpuart2;
+		spi0 = &lpspi6;
+		spi1 = &lpspi4;
 		usb0 = &usb3;
 		usb1 = &usb2;
 	};
-- 
2.47.3

[PATCH v1 08/11] arm64: dts: freescale: imx8-apalis: Add SPI aliases

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The Apalis family pinout defines the SoM interfaces and their
numbering, SPI1 and SPI2 being the SPI buses available to the carrier
board, implemented by lpspi0 and lpspi2 on Apalis iMX8.

imx8qm.dtsi numbers lpspi0 as spi0 and lpspi2 as spi2, so SPI2 does
not match the Apalis numbering. Add spi0 and spi1 aliases in the SoM
dtsi, zero-based with SPI1 being spi0, and delete the inherited spi2,
so lpspi2 is bus 1 and carries a single alias.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx8-apalis-v1.1.dtsi | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/arch/arm64/boot/dts/freescale/imx8-apalis-v1.1.dtsi b/arch/arm64/boot/dts/freescale/imx8-apalis-v1.1.dtsi
index 64604f91d567..806f5a8a51c8 100644
--- a/arch/arm64/boot/dts/freescale/imx8-apalis-v1.1.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx8-apalis-v1.1.dtsi
@@ -8,6 +8,9 @@
 / {
 	aliases {
 		ethernet0 = &fec1;
+		spi0 = &lpspi0;
+		spi1 = &lpspi2;
+		/delete-property/ spi2;
 	};
 
 	chosen {
-- 
2.47.3

[PATCH v1 09/11] arm64: dts: freescale: imx93-imx91-lino-common: Add SPI aliases

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The Lino family pinout defines the SoM interfaces and their numbering,
SPI_1 and SPI_2 being the SPI buses available to the carrier board,
implemented by lpspi8 and lpspi1 on Lino iMX93 and iMX91.

Without aliases the Linux SPI bus numbers are assigned dynamically and
can change with the carrier board or probe order. Add spi0 and spi1
aliases so the bus numbers in sysfs and the spidev names follow the
Lino interface numbering, zero-based with SPI_1 being spi0.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx93-imx91-lino-common.dtsi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/arch/arm64/boot/dts/freescale/imx93-imx91-lino-common.dtsi b/arch/arm64/boot/dts/freescale/imx93-imx91-lino-common.dtsi
index f8f13f785860..787df739ea55 100644
--- a/arch/arm64/boot/dts/freescale/imx93-imx91-lino-common.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx93-imx91-lino-common.dtsi
@@ -29,6 +29,8 @@ aliases {
 		serial1 = &lpuart7;
 		serial2 = &lpuart1;
 		serial3 = &lpuart2;
+		spi0 = &lpspi8;
+		spi1 = &lpspi1;
 		usb0 = &usbotg1;
 		usb1 = &usbotg2;
 	};
-- 
2.47.3

[PATCH v1 10/11] arm64: dts: freescale: imx93-imx91-toradex-osm-common: Add SPI aliases

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The OSM specification defines the module interfaces and their naming,
SPI_A and SPI_B being the SPI buses available to the carrier board,
implemented by lpspi8 and lpspi1 on Toradex OSM iMX93 and iMX91.

Without aliases the Linux SPI bus numbers are assigned dynamically and
can change with the carrier board or probe order. Add spi0 and spi1
aliases so the bus numbers in sysfs and the spidev names follow the
OSM interface order, SPI_A being spi0 and SPI_B spi1.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 .../boot/dts/freescale/imx93-imx91-toradex-osm-common.dtsi      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/arch/arm64/boot/dts/freescale/imx93-imx91-toradex-osm-common.dtsi b/arch/arm64/boot/dts/freescale/imx93-imx91-toradex-osm-common.dtsi
index 8b0131d4e6e2..f6fd64176893 100644
--- a/arch/arm64/boot/dts/freescale/imx93-imx91-toradex-osm-common.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx93-imx91-toradex-osm-common.dtsi
@@ -30,6 +30,8 @@ aliases {
 		serial1 = &lpuart6;
 		serial2 = &lpuart7;
 		serial3 = &lpuart2;
+		spi0 = &lpspi8;
+		spi1 = &lpspi1;
 		usb0 = &usbotg1;
 		usb1 = &usbotg2;
 	};
-- 
2.47.3

[PATCH v1 11/11] arm64: dts: freescale: imx95-toradex-osm: Add SPI aliases

[Francesco Dolcini]

From: Francesco Dolcini <francesco.dolcini@toradex.com>

The OSM specification defines the module interfaces and their naming,
SPI_A and SPI_B being the SPI buses available to the carrier board,
implemented by lpspi4 and lpspi1 on Toradex OSM iMX95.

Without aliases the Linux SPI bus numbers are assigned dynamically and
can change with the carrier board or probe order. Add spi0 and spi1
aliases so the bus numbers in sysfs and the spidev names follow the
OSM interface order, SPI_A being spi0 and SPI_B spi1.

Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
---
 arch/arm64/boot/dts/freescale/imx95-toradex-osm.dtsi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/arch/arm64/boot/dts/freescale/imx95-toradex-osm.dtsi b/arch/arm64/boot/dts/freescale/imx95-toradex-osm.dtsi
index 8eb7ea4ed9ee..dc2ef7035246 100644
--- a/arch/arm64/boot/dts/freescale/imx95-toradex-osm.dtsi
+++ b/arch/arm64/boot/dts/freescale/imx95-toradex-osm.dtsi
@@ -30,6 +30,8 @@ aliases {
 		serial2 = &lpuart5;
 		serial3 = &lpuart3;
 		serial4 = &lpuart2;
+		spi0 = &lpspi4;
+		spi1 = &lpspi1;
 		usb0 = &usb2;
 		usb1 = &usb3;
 	};
-- 
2.47.3

Re: [PATCH v1 01/11] arm64: dts: freescale: imx8mm-verdin: Add SPI alias

[Frank Li]

On Thu, Nov 12, 2026 at 04:02:23PM +0100, Francesco Dolcini wrote:
> From: Francesco Dolcini <francesco.dolcini@toradex.com>
>
> The Verdin family pinout defines the SoM interfaces and their
> numbering, SPI_1 being the SPI bus available to the carrier board,
> implemented by ecspi2 on Verdin iMX8MM.
>
> imx8mm.dtsi numbers ecspi2 as spi1, so the Linux bus number in sysfs
> and the spidev name do not match the Verdin interface. Add a spi0
> alias in the SoM dtsi and delete the inherited spi1, so ecspi2 is
> bus 0, zero-based with SPI_1 being spi0, and carries a single alias.
> ecspi3, internal to the SoM with the CAN controller and the TPM, keeps
> the spi2 alias inherited from the SoC.
>
> Signed-off-by: Francesco Dolcini <francesco.dolcini@toradex.com>
> ---
>  arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi | 2 ++
>  1 file changed, 2 insertions(+)
>
> diff --git a/arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi b/arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi
> index 1ac9d000d415..0369803a4d46 100644
> --- a/arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi
> +++ b/arch/arm64/boot/dts/freescale/imx8mm-verdin.dtsi
> @@ -16,6 +16,8 @@ chosen {
>  	aliases {
>  		rtc0 = &rtc_i2c;
>  		rtc1 = &snvs_rtc;
> +		spi0 = &ecspi2;
> +		/delete-property/ spi1;

Can you avoid delete property for new platform?

Frank

>  	};
>
>  	/* Fixed clock dedicated to SPI CAN controller */
> --
> 2.47.3
>
>