diff --git a/components/driver/Kconfig b/components/driver/Kconfig index ce13140885..f0bcbcfe72 100644 --- a/components/driver/Kconfig +++ b/components/driver/Kconfig @@ -87,6 +87,7 @@ menu "Driver Configurations" default y depends on !HEAP_PLACE_FUNCTION_INTO_FLASH select PERIPH_CTRL_FUNC_IN_IRAM + select HAL_SPI_MASTER_FUNC_IN_IRAM help Place the SPI master ISR in to IRAM to avoid possible cache miss. @@ -114,6 +115,7 @@ menu "Driver Configurations" bool "Place SPI slave ISR function into IRAM" default y select PERIPH_CTRL_FUNC_IN_IRAM + select HAL_SPI_SLAVE_FUNC_IN_IRAM help Place the SPI slave ISR in to IRAM to avoid possible cache miss. diff --git a/components/hal/Kconfig b/components/hal/Kconfig index 8b5678d790..8c3452ba4e 100644 --- a/components/hal/Kconfig +++ b/components/hal/Kconfig @@ -90,4 +90,17 @@ menu "Hardware Abstraction Layer (HAL) and Low Level (LL)" but you will lose the possibility to debug this module, and some new features will be added and bugs will be fixed in the IDF source but cannot be synced to ROM. + + config HAL_SPI_MASTER_FUNC_IN_IRAM + bool + depends on SPI_MASTER_ISR_IN_IRAM + help + Enable this option to place SPI master hal layer functions into IRAM. + + config HAL_SPI_SLAVE_FUNC_IN_IRAM + bool + depends on SPI_SLAVE_ISR_IN_IRAM + help + Enable this option to place SPI slave hal layer functions into IRAM. + endmenu diff --git a/components/hal/linker.lf b/components/hal/linker.lf index fe94161376..6c9a303f13 100644 --- a/components/hal/linker.lf +++ b/components/hal/linker.lf @@ -8,8 +8,10 @@ entries: if IDF_TARGET_ESP32 = n && APP_BUILD_TYPE_PURE_RAM_APP = n: cache_hal (noflash) if SOC_GPSPI_SUPPORTED = y: - spi_hal_iram (noflash) - spi_slave_hal_iram (noflash) + if HAL_SPI_MASTER_FUNC_IN_IRAM = y: + spi_hal_iram (noflash) + if HAL_SPI_SLAVE_FUNC_IN_IRAM = y: + spi_slave_hal_iram (noflash) if UART_ISR_IN_IRAM = y || ESP_PANIC_HANDLER_IRAM = y: uart_hal_iram (noflash) else: diff --git a/docs/en/api-guides/performance/ram-usage.rst b/docs/en/api-guides/performance/ram-usage.rst index 28f8106ad8..5d8b8ab44d 100644 --- a/docs/en/api-guides/performance/ram-usage.rst +++ b/docs/en/api-guides/performance/ram-usage.rst @@ -139,6 +139,7 @@ The following options will reduce IRAM usage of some ESP-IDF features: :esp32: - If the application uses PSRAM and is based on ESP32 rev. 3 (ECO3), setting :ref:`CONFIG_ESP32_REV_MIN` to ``3`` will disable PSRAM bug workarounds, saving ~10kB or more of IRAM. - Disabling :ref:`CONFIG_ESP_EVENT_POST_FROM_IRAM_ISR` prevents posting ``esp_event`` events from :ref:`iram-safe-interrupt-handlers` but will save some IRAM. - Disabling :ref:`CONFIG_SPI_MASTER_ISR_IN_IRAM` prevents spi_master interrupts from being serviced while writing to flash, and may otherwise reduce spi_master performance, but will save some IRAM. + - Disabling :ref:`CONFIG_SPI_SLAVE_ISR_IN_IRAM` prevents spi_slave interrupts from being serviced while writing to flash, will save some IRAM. - Setting :ref:`CONFIG_HAL_DEFAULT_ASSERTION_LEVEL` to disable assertion for HAL component will save some IRAM especially for HAL code who calls `HAL_ASSERT` a lot and resides in IRAM. - Refer to sdkconfig menu ``Auto-detect flash chips`` and you can disable flash drivers which you don't need to save some IRAM. - Enable :ref:`CONFIG_HEAP_PLACE_FUNCTION_INTO_FLASH`. Provided that :ref:`CONFIG_SPI_MASTER_ISR_IN_IRAM` is not enabled and the heap functions are not (incorrectly) used from ISRs, this option is safe to enable in all configuration. diff --git a/docs/en/api-reference/peripherals/spi_master.rst b/docs/en/api-reference/peripherals/spi_master.rst index 78c4c14429..7b12177fbd 100644 --- a/docs/en/api-reference/peripherals/spi_master.rst +++ b/docs/en/api-reference/peripherals/spi_master.rst @@ -493,6 +493,8 @@ Typical transaction duration for one byte of data are given below. - Polling Transaction via DMA: {IDF_TARGET_TRANS_TIME_POLL_DMA} µs. - Polling Transaction via CPU: {IDF_TARGET_TRANS_TIME_POLL_CPU} µs. +Note that these data are tested with :ref:`CONFIG_SPI_MASTER_ISR_IN_IRAM` enabled. SPI transaction related code are placed in the internal memory. If this option is turned off (for example, for internal memory optimization), the transaction duration may be affected. + SPI Clock Frequency ^^^^^^^^^^^^^^^^^^^