feat(mspi): split dma and mspi alignment

components/esp_hw_support/mspi/esp_mspi_align/esp_mspi_align.c

@@ -0,0 +1,59 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <stdint.h>
+#include <sys/param.h>
+#include "sdkconfig.h"
+#include "esp_efuse.h"
+#include "esp_memory_utils.h"
+#include "esp_private/esp_mspi_align.h"
+#if CONFIG_SPIRAM
+#include "esp_psram.h"
+#endif /* CONFIG_SPIRAM */
+#include "soc/soc_caps.h"
+
+#define MSPI_FLASH_ENC_ALIGNMENT  SOC_MEMSPI_ENCRYPTION_ALIGNMENT
+#define MSPI_PSRAM_ECC_ALIGNMENT  SOC_MEMSPI_ENCRYPTION_ALIGNMENT
+
+size_t esp_mspi_get_alignment(const void *ptr)
+{
+    size_t alignment = 1;
+    bool generic_query = ptr == NULL;
+    bool __attribute__((unused)) is_psram = esp_ptr_external_ram(ptr);
+    bool is_drom = esp_ptr_in_drom(ptr);
+    bool is_psram_enc = false;
+
+#if CONFIG_SPIRAM
+    is_psram_enc = is_psram && !esp_psram_ptr_is_no_enc(ptr);
+#endif /* CONFIG_SPIRAM */
+
+    if (esp_efuse_is_flash_encryption_enabled() && (generic_query || is_drom || is_psram_enc)) {
+        alignment = MAX(alignment, MSPI_FLASH_ENC_ALIGNMENT);
+    }
+
+#if CONFIG_SPIRAM_ECC_ENABLE
+    if (generic_query || is_psram) {
+        alignment = MAX(alignment, MSPI_PSRAM_ECC_ALIGNMENT);
+    }
+#endif
+
+    return alignment;
+}
+
+bool esp_mspi_buffer_alignment_satisfied(const void *ptr, size_t size)
+{
+    // Zero-length is not a valid MSPI transfer, so it never satisfies the check.
+    if (ptr == NULL || size == 0) {
+        return false;
+    }
+
+    size_t alignment = esp_mspi_get_alignment(ptr);
+    if (alignment <= 1) {
+        return true;
+    }
+    uintptr_t addr = (uintptr_t)ptr;
+    return ((addr & (alignment - 1)) == 0) && ((size & (alignment - 1)) == 0);
+}

components/esp_hw_support/mspi/esp_mspi_align/include/esp_private/esp_mspi_align.h

@@ -0,0 +1,46 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#include <stddef.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include "sdkconfig.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief Get MSPI alignment requirement for an address
+ *
+ * The address is used so future targets can apply different alignment rules to
+ * different MSPI-backed regions. Pass NULL when only the generic external-memory
+ * requirement is needed and no concrete address is available yet.
+ *
+ * @param ptr Buffer pointer in the region to be accessed, or NULL for generic query
+ * @return Required alignment in bytes, or 1 when no extra MSPI alignment is needed
+ */
+size_t esp_mspi_get_alignment(const void *ptr);
+
+/**
+ * @brief Check whether a buffer satisfies MSPI strict alignment requirements
+ *
+ * Returns false when @p ptr is NULL or @p size is 0 (not a valid transfer).
+ * When strict alignment is not required, returns true for any non-empty buffer.
+ * When required, both @p ptr and @p size must be aligned to the rule returned by
+ * @ref esp_mspi_get_alignment for that address.
+ *
+ * @param ptr Buffer pointer
+ * @param size Transfer size in bytes
+ * @return true if alignment requirements are satisfied
+ */
+bool esp_mspi_buffer_alignment_satisfied(const void *ptr, size_t size);
+
+#ifdef __cplusplus
+}
+#endif

components/esp_hw_support/mspi/linker.lf

@@ -1,3 +1,10 @@
+[mapping:esp_mspi_align]
+archive: libesp_hw_support.a
+entries:
+    if APP_BUILD_TYPE_PURE_RAM_APP = n:
+        esp_mspi_align:esp_mspi_get_alignment (noflash)
+        esp_mspi_align:esp_mspi_buffer_alignment_satisfied (noflash)
+
 [mapping:mspi_timing_tuning_driver]
 archive: libesp_hw_support.a
 entries: