:orphan:

.. title:: choice SPIRAM_SPEED: Set RAM clock speed

.. _choice_43:

.. describe:: choice SPIRAM_SPEED: Set RAM clock speed

*Set RAM clock speed*

*Set RAM clock speed*

Type: ``bool``

Help
====

.. code-block:: none

    Select the speed for the SPI RAM chip.
    If SPI RAM is enabled, we only support three combinations of SPI speed mode we supported now:

    1. Flash SPI running at 40Mhz and RAM SPI running at 40Mhz
    2. Flash SPI running at 80Mhz and RAM SPI running at 40Mhz
    3. Flash SPI running at 80Mhz and RAM SPI running at 80Mhz

    Note: If the third mode(80Mhz+80Mhz) is enabled for SPI RAM of type 32MBit, one of the HSPI/VSPI host
    will be occupied by the system. Which SPI host to use can be selected by the config item
    SPIRAM_OCCUPY_SPI_HOST. Application code should never touch HSPI/VSPI hardware in this case. The
    option to select 80MHz will only be visible if the flash SPI speed is also 80MHz.
    (ESPTOOLPY_FLASHFREQ_79M is true)

Help
====

.. code-block:: none

    Select the speed for the SPI RAM chip.
    If SPI RAM is enabled, we only support three combinations of SPI speed mode we supported now:

    1. Flash SPI running at 40Mhz and RAM SPI running at 40Mhz
    2. Flash SPI running at 80Mhz and RAM SPI running at 40Mhz
    3. Flash SPI running at 80Mhz and RAM SPI running at 80Mhz

    Note: If the third mode(80Mhz+80Mhz) is enabled for SPI RAM of type 32MBit, one of the HSPI/VSPI host
    will be occupied by the system. Which SPI host to use can be selected by the config item
    SPIRAM_OCCUPY_SPI_HOST. Application code should never touch HSPI/VSPI hardware in this case. The
    option to select 80MHz will only be visible if the flash SPI speed is also 80MHz.
    (ESPTOOLPY_FLASHFREQ_79M is true)

Direct dependencies
===================

(\ :kconfig:`ESP_SPIRAM <CONFIG_ESP_SPIRAM>` && \ :kconfig:`SOC_ESP32 <CONFIG_SOC_ESP32>` && \ :ref:`<choice: SoC/CPU/Configuration Selection> <choice_41>`) || (\ :kconfig:`ESP_SPIRAM <CONFIG_ESP_SPIRAM>` && \ :kconfig:`SOC_ESP32 <CONFIG_SOC_ESP32>` && \ :ref:`<choice: SoC/CPU/Configuration Selection> <choice_41>`)

*(Includes any dependencies from ifs and menus.)*

Defaults
========

- \ :kconfig:`SPIRAM_SPEED_40M <CONFIG_SPIRAM_SPEED_40M>`
- \ :kconfig:`SPIRAM_SPEED_40M <CONFIG_SPIRAM_SPEED_40M>`

Choice options
==============

- \ :kconfig:`SPIRAM_SPEED_40M <CONFIG_SPIRAM_SPEED_40M>`
- \ :kconfig:`SPIRAM_SPEED_80M <CONFIG_SPIRAM_SPEED_80M>`
- \ :kconfig:`SPIRAM_SPEED_40M <CONFIG_SPIRAM_SPEED_40M>`
- \ :kconfig:`SPIRAM_SPEED_80M <CONFIG_SPIRAM_SPEED_80M>`

Kconfig definitions
===================



At ``<Zephyr SoC>/xtensa/esp32/Kconfig.soc:88``

Included via ``Kconfig:8`` → ``Kconfig.zephyr:38`` → ``<Zephyr SoC>/Kconfig:7`` → ``<BuildDir>/kconfig/Kconfig.soc:1``

Menu path: (Top) → SoC/CPU/Configuration Selection → ESP32 → Support for external, SPI-connected RAM → SPI RAM config

.. code-block:: kconfig

    choice SPIRAM_SPEED
    	bool "Set RAM clock speed"
    	default SPIRAM_SPEED_40M
    	depends on ESP_SPIRAM && SOC_ESP32 && <choice>
    	help
    	  Select the speed for the SPI RAM chip.
    	  If SPI RAM is enabled, we only support three combinations of SPI speed mode we supported now:
	  
    	  1. Flash SPI running at 40Mhz and RAM SPI running at 40Mhz
    	  2. Flash SPI running at 80Mhz and RAM SPI running at 40Mhz
    	  3. Flash SPI running at 80Mhz and RAM SPI running at 80Mhz
	  
    	  Note: If the third mode(80Mhz+80Mhz) is enabled for SPI RAM of type 32MBit, one of the HSPI/VSPI host
    	  will be occupied by the system. Which SPI host to use can be selected by the config item
    	  SPIRAM_OCCUPY_SPI_HOST. Application code should never touch HSPI/VSPI hardware in this case. The
    	  option to select 80MHz will only be visible if the flash SPI speed is also 80MHz.
    	  (ESPTOOLPY_FLASHFREQ_79M is true)

----

At ``<Zephyr SoC>/xtensa/esp32/Kconfig.soc:88``

Included via ``Kconfig:8`` → ``Kconfig.zephyr:38`` → ``<Zephyr SoC>/Kconfig:9``

Menu path: (Top) → SoC/CPU/Configuration Selection → ESP32 → Support for external, SPI-connected RAM → SPI RAM config

.. code-block:: kconfig

    choice SPIRAM_SPEED
    	bool "Set RAM clock speed"
    	default SPIRAM_SPEED_40M
    	depends on ESP_SPIRAM && SOC_ESP32 && <choice>
    	help
    	  Select the speed for the SPI RAM chip.
    	  If SPI RAM is enabled, we only support three combinations of SPI speed mode we supported now:
	  
    	  1. Flash SPI running at 40Mhz and RAM SPI running at 40Mhz
    	  2. Flash SPI running at 80Mhz and RAM SPI running at 40Mhz
    	  3. Flash SPI running at 80Mhz and RAM SPI running at 80Mhz
	  
    	  Note: If the third mode(80Mhz+80Mhz) is enabled for SPI RAM of type 32MBit, one of the HSPI/VSPI host
    	  will be occupied by the system. Which SPI host to use can be selected by the config item
    	  SPIRAM_OCCUPY_SPI_HOST. Application code should never touch HSPI/VSPI hardware in this case. The
    	  option to select 80MHz will only be visible if the flash SPI speed is also 80MHz.
    	  (ESPTOOLPY_FLASHFREQ_79M is true)

*(The 'depends on' condition includes propagated dependencies from ifs and menus.)*