tests: drivers: spi: Add test case for MLTPAN-57 workaround

The MLTPAN-57 test case workaround uses fast SPIM (SPIM00)

Signed-off-by: Bartosz Miller <[email protected]>

Author: nordic-bami

tests/drivers/spi/spim_pan/boards/nrf54lxx_cpuapp_fast.overlay

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+&pinctrl {
+	dut_spi_default: dut_spi_default {
+		group1 {
+			psels = <NRF_PSEL(SPIM_SCK, 2, 1)>,
+				<NRF_PSEL(SPIM_MISO, 2, 4)>,
+				<NRF_PSEL(SPIM_MOSI, 2, 2)>;
+		};
+	};
+
+	dut_spi_sleep: dut_spi_sleep {
+		group1 {
+			psels = <NRF_PSEL(SPIM_SCK, 2, 1)>,
+				<NRF_PSEL(SPIM_MISO, 2, 4)>,
+				<NRF_PSEL(SPIM_MOSI, 2, 2)>;
+			low-power-enable;
+		};
+	};
+};
+
+dut_spi_fast: &spi00 {
+	compatible = "nordic,nrf-spim";
+	status = "okay";
+	pinctrl-0 = <&dut_spi_default>;
+	pinctrl-1 = <&dut_spi_sleep>;
+	pinctrl-names = "default", "sleep";
+	overrun-character = <0x00>;
+	zephyr,pm-device-runtime-auto;
+	cs-gpios = <&gpio2 5 GPIO_ACTIVE_LOW>;
+
+	dut_spi_dt: test-spi-dev@0 {
+		compatible = "vnd,spi-device";
+		reg = <0>;
+		spi-max-frequency = <DT_FREQ_M(16)>;
+	};
+};
+
+&gpio2 {
+	status = "okay";
+};
+
+tst_timer: &timer20 {
+	status = "okay";
+};
+
+&dppic20 {
+	status = "okay";
+};
+
+&mx25r64 {
+	status = "disabled";
+};

tests/drivers/spi/spim_pan/src/main.c

@@ -16,10 +16,23 @@
 
 /* SPI MODE 0 */
 #define SPI_MODE (SPI_OP_MODE_MASTER | SPI_WORD_SET(8) | SPI_LINES_SINGLE | SPI_TRANSFER_MSB)
+
+#if DT_NODE_EXISTS(DT_NODELABEL(dut_spi_fast))
+#define DUT_SPI_NODE	    DT_NODELABEL(dut_spi_fast)
+#define DUT_SPI_FAST	    1
+#define TEST_BUFFER_SIZE    4
+#define MX25R64_RDID	    0x9F
+#define MX25R64_MFG_ID	    0xC2
+#define MX25R64_MEM_TYPE    0x28
+#define MX25R64_MEM_DENSITY 0x17
+#define MAX_READ_REPEATS    10
+#else
+#define DUT_SPI_NODE	 DT_NODELABEL(dut_spi)
 #define TEST_BUFFER_SIZE 64
+#endif
 
 static struct spi_dt_spec spim_spec = SPI_DT_SPEC_GET(DT_NODELABEL(dut_spi_dt), SPI_MODE, 0);
-NRF_SPIM_Type *spim_reg = (NRF_SPIM_Type *)DT_REG_ADDR(DT_NODELABEL(dut_spi));
+NRF_SPIM_Type *spim_reg = (NRF_SPIM_Type *)DT_REG_ADDR(DUT_SPI_NODE);
 
 static nrfx_timer_t test_timer = NRFX_TIMER_INSTANCE(DT_REG_ADDR(DT_NODELABEL(tst_timer)));
 
@@ -71,6 +84,8 @@ static uint32_t configure_test_timer(nrfx_timer_t *timer)
 
 ZTEST(spim_pan, test_spim_mltpan_8_workaround)
 {
+	Z_TEST_SKIP_IFDEF(DUT_SPI_FAST);
+
 	int err;
 
 	struct spi_buf tx_spi_buf = {.buf = tx_buffer, .len = TEST_BUFFER_SIZE};
@@ -99,6 +114,8 @@ ZTEST(spim_pan, test_spim_mltpan_8_workaround)
 
 ZTEST(spim_pan, test_spim_mltpan_55_workaround)
 {
+	Z_TEST_SKIP_IFDEF(DUT_SPI_FAST);
+
 	int err;
 
 	uint8_t ppi_channel;
@@ -132,6 +149,7 @@ ZTEST(spim_pan, test_spim_mltpan_55_workaround)
 
 	timer_cc_before = nrfx_timer_capture(&test_timer, NRF_TIMER_CC_CHANNEL0);
 	err = spi_transceive_dt(&spim_spec, &tx_spi_buf_set, &rx_spi_buf_set);
+	zassert_ok(err, "SPI transceive failed: %d\n", err);
 	timer_cc_after = nrfx_timer_capture(&test_timer, NRF_TIMER_CC_CHANNEL0);
 
 	TC_PRINT("Timer count before: %u, timer count after: %u\n", timer_cc_before,
@@ -142,4 +160,79 @@ ZTEST(spim_pan, test_spim_mltpan_55_workaround)
 	zassert_mem_equal(tx_buffer, rx_buffer, TEST_BUFFER_SIZE - 1, "TX buffer != RX buffer\n");
 }
 
+/*
+ * Reference: MLTPAN-57
+ * SPIM00 does not operate as expected
+ * SPIM00 is the fast SPIM instance
+ * Requires workaround
+ */
+
+ZTEST(spim_pan, test_spim_mltpan_57_workaround)
+{
+	Z_TEST_SKIP_IFNDEF(DUT_SPI_FAST);
+#if defined(DUT_SPI_FAST)
+	int err;
+
+	uint8_t ppi_channel;
+
+	uint32_t domain_id;
+	nrfx_gppi_handle_t gppi_handle;
+
+	uint32_t timer_cc_before, timer_cc_after, tx_amount;
+
+	uint32_t timer_task;
+	uint32_t spim_event;
+
+	memset(tx_buffer, 0xFF, TEST_BUFFER_SIZE);
+	tx_buffer[0] = MX25R64_RDID;
+
+	domain_id = nrfx_gppi_domain_id_get((uint32_t)test_timer.p_reg);
+	ppi_channel = nrfx_gppi_channel_alloc(domain_id);
+	zassert_true(ppi_channel > 0, "Failed to allocate GPPI channel");
+
+	timer_task = configure_test_timer(&test_timer);
+	spim_event = nrf_spim_event_address_get(spim_reg, NRF_SPIM_EVENT_END);
+
+	zassert_ok(nrfx_gppi_conn_alloc(spim_event, timer_task, &gppi_handle),
+		   "Failed to allocate DPPI connection\n");
+	nrfx_gppi_conn_enable(gppi_handle);
+
+	struct spi_buf tx_spi_buf = {.buf = tx_buffer, .len = TEST_BUFFER_SIZE};
+	struct spi_buf_set tx_spi_buf_set = {.buffers = &tx_spi_buf, .count = 1};
+
+	struct spi_buf rx_spi_buf = {.buf = rx_buffer, .len = TEST_BUFFER_SIZE};
+	struct spi_buf_set rx_spi_buf_set = {.buffers = &rx_spi_buf, .count = 1};
+
+	for (int i = 0; i < MAX_READ_REPEATS; i++) {
+		TC_PRINT("RDID attempt %u\n", i + 1);
+
+		timer_cc_before = nrfx_timer_capture(&test_timer, NRF_TIMER_CC_CHANNEL0);
+		err = spi_transceive_dt(&spim_spec, &tx_spi_buf_set, &rx_spi_buf_set);
+		timer_cc_after = nrfx_timer_capture(&test_timer, NRF_TIMER_CC_CHANNEL0);
+		TC_PRINT("SPIM prescaler: %u\n", spim_reg->PRESCALER);
+		zassert_ok(err, "SPI transceive failed: %d\n", err);
+
+		tx_amount = nrf_spim_tx_amount_get(spim_reg);
+		TC_PRINT("END events count: %u\n", timer_cc_after - timer_cc_before);
+		TC_PRINT("TX.AMOUNT: %u\n", tx_amount);
+
+		zassert_equal(timer_cc_after - timer_cc_before, 1,
+			      "END event has not been generated\n");
+		zassert_equal(tx_amount, ARRAY_SIZE(tx_buffer), "TX.AMOUNT != TX Buffer size\n");
+
+		for (int i = 0; i < ARRAY_SIZE(rx_buffer); i++) {
+			TC_PRINT("rx_buffer[%d] = 0x%x\n", i, rx_buffer[i]);
+		}
+
+		/* First RX byte is dummy */
+		zassert_equal(rx_buffer[1], MX25R64_MFG_ID,
+			      "Read MX25R64 device ID is different than expected\n");
+		zassert_equal(rx_buffer[2], MX25R64_MEM_TYPE,
+			      "Read MX25R64 memory type is different than expected\n");
+		zassert_equal(rx_buffer[3], MX25R64_MEM_DENSITY,
+			      "Read MX25R64 memory density is different than expected\n");
+	}
+#endif
+}
+
 ZTEST_SUITE(spim_pan, NULL, test_setup, NULL, NULL, NULL);

tests/drivers/spi/spim_pan/testcase.yaml

@@ -2,20 +2,31 @@ common:
   sysbuild: true
   depends_on: gpio
   harness: ztest
-  harness_config:
-    fixture: gpio_loopback
   tags:
     - drivers
     - spim
     - ci_tests_drivers_spi
-  platform_allow:
-    - nrf54h20dk/nrf54h20/cpuapp
-    - nrf54l15dk/nrf54l15/cpuapp
-    - nrf54lm20dk/nrf54lm20a/cpuapp
-    - nrf54ls05dk/nrf54ls05b/cpuapp
-    - nrf54lv10dk/nrf54lv10a/cpuapp
-  integration_platforms:
-    - nrf54l15dk/nrf54l15/cpuapp
 
 tests:
-  drivers.spim_pan: {}
+  drivers.spim_pan:
+    platform_allow:
+      - nrf54h20dk/nrf54h20/cpuapp
+      - nrf54l15dk/nrf54l15/cpuapp
+      - nrf54lm20dk/nrf54lm20a/cpuapp
+      - nrf54ls05dk/nrf54ls05b/cpuapp
+      - nrf54lv10dk/nrf54lv10a/cpuapp
+    integration_platforms:
+      - nrf54l15dk/nrf54l15/cpuapp
+    harness_config:
+      fixture: gpio_loopback
+
+  drivers.spim_pan.fast:
+    platform_allow:
+      - nrf54l15dk/nrf54l15/cpuapp
+      - nrf54lm20dk/nrf54lm20a/cpuapp
+    integration_platforms:
+      - nrf54lm20dk/nrf54lm20a/cpuapp
+    extra_args:
+      - DTC_OVERLAY_FILE='boards/nrf54lxx_cpuapp_fast.overlay'
+    harness_config:
+      fixture: external_flash