forked from espressif/esp-idf
docs(misc): update system docs for new chips
This commit is contained in:
Marius Vikhammer
@@ -123,6 +123,14 @@ config SOC_CPU_IDRAM_SPLIT_USING_PMP
|
||||
bool
|
||||
default y
|
||||
|
||||
config SOC_HP_CPU_HAS_MULTIPLE_CORES
|
||||
bool
|
||||
default y
|
||||
|
||||
config SOC_CPU_HAS_LOCKUP_RESET
|
||||
bool
|
||||
default y
|
||||
|
||||
config SOC_GPIO_PORT
|
||||
int
|
||||
default 1
|
||||
|
||||
@@ -162,6 +162,9 @@
|
||||
#define SOC_CPU_HAS_PMA 1
|
||||
#define SOC_CPU_IDRAM_SPLIT_USING_PMP 1
|
||||
|
||||
#define SOC_HP_CPU_HAS_MULTIPLE_CORES 1 // Convenience boolean macro used to determine if a target has multiple cores.
|
||||
#define SOC_CPU_HAS_LOCKUP_RESET 1
|
||||
|
||||
/*-------------------------- DIGITAL SIGNATURE CAPS ----------------------------------------*/
|
||||
/** The maximum length of a Digital Signature in bits. */
|
||||
// #define SOC_DS_SIGNATURE_MAX_BIT_LEN (3072)
|
||||
|
||||
@@ -3,7 +3,6 @@ api-guides/RF_calibration.rst
|
||||
api-guides/deep-sleep-stub.rst
|
||||
api-guides/coexist.rst
|
||||
api-guides/wifi.rst
|
||||
api-guides/wireshark-user-guide.rst
|
||||
api-guides/esp-wifi-mesh.rst
|
||||
api-guides/inc/external-ram-esp32-notes.rst
|
||||
api-guides/current-consumption-measurement-modules.rst
|
||||
@@ -41,7 +40,6 @@ api-reference/network/esp_wifi.rst
|
||||
api-reference/network/index.rst
|
||||
api-reference/system/sleep_modes.rst
|
||||
api-reference/system/mm_sync.rst
|
||||
api-reference/system/chip_revision.rst
|
||||
api-reference/system/async_memcpy.rst
|
||||
api-reference/system/power_management.rst
|
||||
api-reference/system/inc/power_management_esp32c5.rst
|
||||
|
||||
@@ -1,7 +1,3 @@
|
||||
api-guides/performance/speed.rst
|
||||
api-guides/performance/size.rst
|
||||
api-guides/performance/ram-usage.rst
|
||||
api-guides/performance/index.rst
|
||||
api-guides/phy.rst
|
||||
api-guides/app_trace.rst
|
||||
api-guides/low-power-mode.rst
|
||||
@@ -11,14 +7,12 @@ api-guides/lwip.rst
|
||||
api-guides/coexist.rst
|
||||
api-guides/wifi.rst
|
||||
api-guides/usb-otg-console.rst
|
||||
api-guides/wireshark-user-guide.rst
|
||||
api-guides/esp-wifi-mesh.rst
|
||||
api-guides/core_dump.rst
|
||||
api-guides/inc/external-ram-esp32-notes.rst
|
||||
api-guides/dfu.rst
|
||||
api-guides/current-consumption-measurement-modules.rst
|
||||
api-guides/wifi-security.rst
|
||||
api-guides/index.rst
|
||||
api-guides/openthread.rst
|
||||
api-reference/template.rst
|
||||
api-reference/storage/vfs.rst
|
||||
@@ -75,47 +69,12 @@ api-reference/network/esp_netif.rst
|
||||
api-reference/system/sleep_modes.rst
|
||||
api-reference/system/mm_sync.rst
|
||||
api-reference/system/app_trace.rst
|
||||
api-reference/system/chip_revision.rst
|
||||
api-reference/system/async_memcpy.rst
|
||||
api-reference/system/esp_timer.rst
|
||||
api-reference/system/system_time.rst
|
||||
api-reference/system/power_management.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-C61.rst
|
||||
api-reference/system/inc/power_management_esp32.rst
|
||||
api-reference/system/inc/power_management_esp32c61.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-C5.rst
|
||||
api-reference/system/inc/revisions_ESP32-H2.rst
|
||||
api-reference/system/inc/revisions_ESP32-C6.rst
|
||||
api-reference/system/inc/revisions_ESP32-S3.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-C6.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-H2.rst
|
||||
api-reference/system/inc/revisions_ESP32-C5.rst
|
||||
api-reference/system/inc/power_management_esp32c6.rst
|
||||
api-reference/system/inc/revisions_ESP32-C3.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-S3.rst
|
||||
api-reference/system/inc/power_management_esp32c3.rst
|
||||
api-reference/system/inc/revisions_ESP32.rst
|
||||
api-reference/system/inc/power_management_esp32p4.rst
|
||||
api-reference/system/inc/espefuse_summary_ESP32-C5.rst
|
||||
api-reference/system/inc/power_management_esp32h2.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-C3.rst
|
||||
api-reference/system/inc/power_management_esp32c5.rst
|
||||
api-reference/system/inc/espefuse_summary_ESP32.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-P4.rst
|
||||
api-reference/system/inc/espefuse_summary_ESP32-C61.rst
|
||||
api-reference/system/inc/power_management_esp32s2.rst
|
||||
api-reference/system/inc/espefuse_summary_ESP32-S3.rst
|
||||
api-reference/system/inc/revisions_ESP32-C2.rst
|
||||
api-reference/system/inc/revisions_ESP32-S2.rst
|
||||
api-reference/system/inc/revisions_ESP32-P4.rst
|
||||
api-reference/system/inc/espefuse_summary_ESP32-C6.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32.rst
|
||||
api-reference/system/inc/power_management_esp32s3.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-C2.rst
|
||||
api-reference/system/inc/power_management_esp32c2.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-S2.rst
|
||||
api-reference/system/mm.rst
|
||||
api-reference/system/index.rst
|
||||
api-reference/error-codes.rst
|
||||
api-reference/index.rst
|
||||
api-reference/protocols/icmp_echo.rst
|
||||
|
||||
@@ -1,44 +1,26 @@
|
||||
index.rst
|
||||
api-guides/openthread.rst
|
||||
api-guides/index.rst
|
||||
api-guides/c.rst
|
||||
api-guides/reproducible-builds.rst
|
||||
api-guides/core_dump_internals.rst
|
||||
api-guides/error-handling.rst
|
||||
api-guides/wifi-expansion.rst
|
||||
api-guides/deep-sleep-stub.rst
|
||||
api-guides/performance/index.rst
|
||||
api-guides/performance/ram-usage.rst
|
||||
api-guides/performance/speed.rst
|
||||
api-guides/performance/size.rst
|
||||
api-guides/app_trace.rst
|
||||
api-guides/esp-wifi-mesh.rst
|
||||
api-guides/startup.rst
|
||||
api-guides/usb-serial-jtag-console.rst
|
||||
api-guides/build-system.rst
|
||||
api-guides/thread-local-storage.rst
|
||||
api-guides/memory-types.rst
|
||||
api-guides/cplusplus.rst
|
||||
api-guides/core_dump.rst
|
||||
api-guides/lwip.rst
|
||||
api-guides/hardware-abstraction.rst
|
||||
api-guides/host-apps.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-faq.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-feature-list.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-index.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-terminology.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-architecture.rst
|
||||
api-guides/phy.rst
|
||||
api-guides/stdio.rst
|
||||
api-guides/flash_psram_config.rst
|
||||
api-guides/classic-bt/index.rst
|
||||
api-guides/classic-bt/overview.rst
|
||||
api-guides/unit-tests.rst
|
||||
api-guides/external-ram.rst
|
||||
api-guides/low-power-mode/index.rst
|
||||
api-guides/low-power-mode/low-power-mode-wifi.rst
|
||||
api-guides/low-power-mode/low-power-mode-soc.rst
|
||||
api-guides/general-notes.rst
|
||||
api-guides/wifi.rst
|
||||
api-guides/ble/index.rst
|
||||
api-guides/ble/overview.rst
|
||||
@@ -61,24 +43,11 @@ api-guides/jtag-debugging/using-debugger.rst
|
||||
api-guides/jtag-debugging/building-openocd-linux.rst
|
||||
api-guides/jtag-debugging/tips-and-quirks.rst
|
||||
api-guides/jtag-debugging/configure-builtin-jtag.rst
|
||||
api-guides/bootloader.rst
|
||||
api-guides/hlinterrupts.rst
|
||||
api-guides/kconfig/index.rst
|
||||
api-guides/kconfig/project-configuration-guide.rst
|
||||
api-guides/kconfig/component-configuration-guide.rst
|
||||
api-guides/kconfig/configuration_structure.rst
|
||||
api-guides/inc/linux-host-requirements.rst
|
||||
api-guides/fatal-errors.rst
|
||||
api-guides/wifi-security.rst
|
||||
api-guides/RF_calibration.rst
|
||||
api-guides/usb-otg-console.rst
|
||||
api-guides/partition-tables.rst
|
||||
api-guides/linker-script-generation.rst
|
||||
api-guides/current-consumption-measurement-modules.rst
|
||||
api-guides/coexist.rst
|
||||
api-guides/wireshark-user-guide.rst
|
||||
api-guides/code-quality/index.rst
|
||||
api-guides/code-quality/static-analyzer.rst
|
||||
api-guides/dfu.rst
|
||||
about.rst
|
||||
get-started/index.rst
|
||||
@@ -230,53 +199,20 @@ api-reference/peripherals/lcd/parl_lcd.rst
|
||||
api-reference/peripherals/pcnt.rst
|
||||
api-reference/peripherals/spi_features.rst
|
||||
api-reference/peripherals/ppa.rst
|
||||
api-reference/peripherals/ldo_regulator.rst
|
||||
api-reference/peripherals/ledc.rst
|
||||
api-reference/system/index.rst
|
||||
api-reference/system/freertos_idf.rst
|
||||
api-reference/system/misc_system_api.rst
|
||||
api-reference/system/chip_revision.rst
|
||||
api-reference/system/random.rst
|
||||
api-reference/system/soc_caps.rst
|
||||
api-reference/system/app_trace.rst
|
||||
api-reference/system/esp_function_with_shared_stack.rst
|
||||
api-reference/system/log.rst
|
||||
api-reference/system/mm_sync.rst
|
||||
api-reference/system/app_image_format.rst
|
||||
api-reference/system/ulp_macros.rst
|
||||
api-reference/system/ulp.rst
|
||||
api-reference/system/bootloader_image_format.rst
|
||||
api-reference/system/mm.rst
|
||||
api-reference/system/esp_https_ota.rst
|
||||
api-reference/system/perfmon.rst
|
||||
api-reference/system/wdts.rst
|
||||
api-reference/system/sleep_modes.rst
|
||||
api-reference/system/system_time.rst
|
||||
api-reference/system/himem.rst
|
||||
api-reference/system/console.rst
|
||||
api-reference/system/internal-unstable.rst
|
||||
api-reference/system/ulp_instruction_set.rst
|
||||
api-reference/system/ipc.rst
|
||||
api-reference/system/ota.rst
|
||||
api-reference/system/esp_event.rst
|
||||
api-reference/system/pthread.rst
|
||||
api-reference/system/esp_timer.rst
|
||||
api-reference/system/heap_debug.rst
|
||||
api-reference/system/efuse.rst
|
||||
api-reference/system/inc/power_management_esp32h21.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-H21.rst
|
||||
api-reference/system/inc/espefuse_summary_ESP32-H21.rst
|
||||
api-reference/system/inc/espefuse_summary_ESP32-H21_dump.rst
|
||||
api-reference/system/inc/revisions_ESP32-H21.rst
|
||||
api-reference/system/esp_err.rst
|
||||
api-reference/system/freertos.rst
|
||||
api-reference/system/freertos_additions.rst
|
||||
api-reference/system/ulp-lp-core.rst
|
||||
api-reference/system/power_management.rst
|
||||
api-reference/system/ulp-risc-v.rst
|
||||
api-reference/system/mem_alloc.rst
|
||||
api-reference/system/intr_alloc.rst
|
||||
api-reference/api-conventions.rst
|
||||
security/index.rst
|
||||
security/flash-encryption.rst
|
||||
security/secure-boot-v1.rst
|
||||
|
||||
@@ -1,44 +1,26 @@
|
||||
index.rst
|
||||
api-guides/openthread.rst
|
||||
api-guides/index.rst
|
||||
api-guides/c.rst
|
||||
api-guides/reproducible-builds.rst
|
||||
api-guides/core_dump_internals.rst
|
||||
api-guides/error-handling.rst
|
||||
api-guides/wifi-expansion.rst
|
||||
api-guides/deep-sleep-stub.rst
|
||||
api-guides/performance/index.rst
|
||||
api-guides/performance/ram-usage.rst
|
||||
api-guides/performance/speed.rst
|
||||
api-guides/performance/size.rst
|
||||
api-guides/app_trace.rst
|
||||
api-guides/esp-wifi-mesh.rst
|
||||
api-guides/startup.rst
|
||||
api-guides/usb-serial-jtag-console.rst
|
||||
api-guides/build-system.rst
|
||||
api-guides/thread-local-storage.rst
|
||||
api-guides/memory-types.rst
|
||||
api-guides/cplusplus.rst
|
||||
api-guides/core_dump.rst
|
||||
api-guides/lwip.rst
|
||||
api-guides/hardware-abstraction.rst
|
||||
api-guides/host-apps.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-faq.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-feature-list.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-index.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-terminology.rst
|
||||
api-guides/esp-ble-mesh/ble-mesh-architecture.rst
|
||||
api-guides/phy.rst
|
||||
api-guides/stdio.rst
|
||||
api-guides/flash_psram_config.rst
|
||||
api-guides/classic-bt/index.rst
|
||||
api-guides/classic-bt/overview.rst
|
||||
api-guides/unit-tests.rst
|
||||
api-guides/external-ram.rst
|
||||
api-guides/low-power-mode/index.rst
|
||||
api-guides/low-power-mode/low-power-mode-wifi.rst
|
||||
api-guides/low-power-mode/low-power-mode-soc.rst
|
||||
api-guides/general-notes.rst
|
||||
api-guides/wifi.rst
|
||||
api-guides/ble/index.rst
|
||||
api-guides/ble/overview.rst
|
||||
@@ -61,24 +43,11 @@ api-guides/jtag-debugging/using-debugger.rst
|
||||
api-guides/jtag-debugging/building-openocd-linux.rst
|
||||
api-guides/jtag-debugging/tips-and-quirks.rst
|
||||
api-guides/jtag-debugging/configure-builtin-jtag.rst
|
||||
api-guides/bootloader.rst
|
||||
api-guides/hlinterrupts.rst
|
||||
api-guides/kconfig/index.rst
|
||||
api-guides/kconfig/project-configuration-guide.rst
|
||||
api-guides/kconfig/component-configuration-guide.rst
|
||||
api-guides/kconfig/configuration_structure.rst
|
||||
api-guides/inc/linux-host-requirements.rst
|
||||
api-guides/fatal-errors.rst
|
||||
api-guides/wifi-security.rst
|
||||
api-guides/RF_calibration.rst
|
||||
api-guides/usb-otg-console.rst
|
||||
api-guides/partition-tables.rst
|
||||
api-guides/linker-script-generation.rst
|
||||
api-guides/current-consumption-measurement-modules.rst
|
||||
api-guides/coexist.rst
|
||||
api-guides/wireshark-user-guide.rst
|
||||
api-guides/code-quality/index.rst
|
||||
api-guides/code-quality/static-analyzer.rst
|
||||
api-guides/dfu.rst
|
||||
about.rst
|
||||
get-started/index.rst
|
||||
@@ -141,7 +110,6 @@ api-reference/storage/fatfs.rst
|
||||
api-reference/storage/fatfsgen.rst
|
||||
api-reference/storage/nvs_encryption.rst
|
||||
api-reference/storage/partition.rst
|
||||
api-reference/error-codes.rst
|
||||
api-reference/bluetooth/index.rst
|
||||
api-reference/bluetooth/esp_gatts.rst
|
||||
api-reference/bluetooth/esp_hf_ag.rst
|
||||
@@ -235,51 +203,20 @@ api-reference/peripherals/spi_features.rst
|
||||
api-reference/peripherals/ppa.rst
|
||||
api-reference/peripherals/ldo_regulator.rst
|
||||
api-reference/peripherals/ledc.rst
|
||||
api-reference/system/index.rst
|
||||
api-reference/system/freertos_idf.rst
|
||||
api-reference/system/misc_system_api.rst
|
||||
api-reference/system/chip_revision.rst
|
||||
api-reference/system/random.rst
|
||||
api-reference/system/soc_caps.rst
|
||||
api-reference/system/app_trace.rst
|
||||
api-reference/system/esp_function_with_shared_stack.rst
|
||||
api-reference/system/log.rst
|
||||
api-reference/system/mm_sync.rst
|
||||
api-reference/system/app_image_format.rst
|
||||
api-reference/system/ulp_macros.rst
|
||||
api-reference/system/ulp.rst
|
||||
api-reference/system/bootloader_image_format.rst
|
||||
api-reference/system/mm.rst
|
||||
api-reference/system/esp_https_ota.rst
|
||||
api-reference/system/perfmon.rst
|
||||
api-reference/system/wdts.rst
|
||||
api-reference/system/sleep_modes.rst
|
||||
api-reference/system/system_time.rst
|
||||
api-reference/system/himem.rst
|
||||
api-reference/system/async_memcpy.rst
|
||||
api-reference/system/console.rst
|
||||
api-reference/system/internal-unstable.rst
|
||||
api-reference/system/ulp_instruction_set.rst
|
||||
api-reference/system/ipc.rst
|
||||
api-reference/system/ota.rst
|
||||
api-reference/system/esp_event.rst
|
||||
api-reference/system/pthread.rst
|
||||
api-reference/system/esp_timer.rst
|
||||
api-reference/system/heap_debug.rst
|
||||
api-reference/system/efuse.rst
|
||||
api-reference/system/inc/power_management_esp32h4.rst
|
||||
api-reference/system/inc/show-efuse-table_ESP32-H4.rst
|
||||
api-reference/system/inc/espefuse_summary_ESP32-H4.rst
|
||||
api-reference/system/inc/espefuse_summary_ESP32-H4_dump.rst
|
||||
api-reference/system/esp_err.rst
|
||||
api-reference/system/freertos.rst
|
||||
api-reference/system/freertos_additions.rst
|
||||
api-reference/system/ulp-lp-core.rst
|
||||
api-reference/system/power_management.rst
|
||||
api-reference/system/ulp-risc-v.rst
|
||||
api-reference/system/mem_alloc.rst
|
||||
api-reference/system/intr_alloc.rst
|
||||
api-reference/api-conventions.rst
|
||||
security/index.rst
|
||||
security/flash-encryption.rst
|
||||
security/secure-boot-v1.rst
|
||||
|
||||
@@ -3,7 +3,7 @@ Minimizing RAM Usage
|
||||
|
||||
:link_to_translation:`zh_CN:[中文]`
|
||||
|
||||
{IDF_TARGET_STATIC_MEANS_HEAP:default="Wi-Fi library, Bluetooth controller", esp32s2="Wi-Fi library", esp32c6="Wi-Fi library, Bluetooth controller, IEEE 802.15.4 library", esp32h2="Bluetooth controller, IEEE 802.15.4 library"}
|
||||
{IDF_TARGET_STATIC_MEANS_HEAP:default="Wi-Fi library, Bluetooth controller", esp32s2="Wi-Fi library", esp32c6="Wi-Fi library, Bluetooth controller, IEEE 802.15.4 library", esp32c61="Wi-Fi library, Bluetooth controller", esp32h2="Bluetooth controller, IEEE 802.15.4 library", esp32h21="Bluetooth controller, IEEE 802.15.4 library", esp32h4="Bluetooth controller, IEEE 802.15.4 library"}
|
||||
|
||||
In some cases, a firmware application's available RAM may run low or run out entirely. In these cases, it is necessary to tune the memory usage of the firmware application.
|
||||
|
||||
|
||||
@@ -82,7 +82,7 @@ The following configuration options reduces the final binary size of almost any
|
||||
- Reduce the compiled-in log output by lowering the app :ref:`CONFIG_LOG_DEFAULT_LEVEL`. If the :ref:`CONFIG_LOG_MAXIMUM_LEVEL` is changed from the default then this setting controls the binary size instead. Reducing compiled-in logging reduces the number of strings in the binary, and also the code size of the calls to logging functions.
|
||||
- If your application does not require dynamic log level changes and you do not need to control logs per module using tags, consider disabling :ref:`CONFIG_LOG_DYNAMIC_LEVEL_CONTROL` and changing :ref:`CONFIG_LOG_TAG_LEVEL_IMPL`. It reduces IRAM usage by approximately 260 bytes, DRAM usage by approximately 264 bytes, and flash usage by approximately 1 KB compared to the default option, it also speeds up logging.
|
||||
- Set the :ref:`CONFIG_COMPILER_OPTIMIZATION_ASSERTION_LEVEL` to ``Silent``. This avoids compiling in a dedicated assertion string and source file name for each assert that may fail. It is still possible to find the failed assert in the code by looking at the memory address where the assertion failed.
|
||||
- Besides the :ref:`CONFIG_COMPILER_OPTIMIZATION_ASSERTION_LEVEL`, you can disable or silent the assertion for the HAL component separately by setting :ref:`CONFIG_HAL_DEFAULT_ASSERTION_LEVEL`. It is to notice that ESP-IDF lowers the HAL assertion level in bootloader to be silent even if :ref:`CONFIG_HAL_DEFAULT_ASSERTION_LEVEL` is set to full-assertion level. This is to reduce the bootloader size.
|
||||
- Besides the :ref:`CONFIG_COMPILER_OPTIMIZATION_ASSERTION_LEVEL`, you can disable or silent the assertion for the HAL component separately by setting :ref:`CONFIG_HAL_DEFAULT_ASSERTION_LEVEL`. In the bootloader, ESP-IDF lowers the HAL assertion level to be silent even if :ref:`CONFIG_HAL_DEFAULT_ASSERTION_LEVEL` is set to full-assertion level. This is to reduce the bootloader size.
|
||||
- Setting :ref:`CONFIG_COMPILER_OPTIMIZATION_CHECKS_SILENT` removes specific error messages for particular internal ESP-IDF error check macros. This may make it harder to debug some error conditions by reading the log output.
|
||||
:esp32: - If the binary needs to run on only certain revision(s) of ESP32, increasing :ref:`CONFIG_ESP32_REV_MIN` to match can result in a reduced binary size. This will make a large difference if setting ESP32 minimum revision 3, and PSRAM is enabled.
|
||||
:esp32c3: - If the binary needs to run on only certain revision(s) of ESP32-C3, increasing :ref:`CONFIG_ESP32C3_REV_MIN` to match can result in a reduced binary size. This is particularly true if setting ESP32-C3 minimum revision 3 and using Wi-Fi, as some functionality was moved to ROM code.
|
||||
|
||||
@@ -4,7 +4,7 @@ Speed Optimization
|
||||
:link_to_translation:`zh_CN:[中文]`
|
||||
|
||||
{IDF_TARGET_CONTROLLER_CORE_CONFIG:default="CONFIG_BT_CTRL_PINNED_TO_CORE", esp32="CONFIG_BTDM_CTRL_PINNED_TO_CORE_CHOICE", esp32s3="CONFIG_BT_CTRL_PINNED_TO_CORE_CHOICE"}
|
||||
{IDF_TARGET_RF_TYPE:default="Wi-Fi/Bluetooth", esp32s2="Wi-Fi", esp32c6="Wi-Fi/Bluetooth/802.15.4", esp32h2="Bluetooth/802.15.4, esp32c5="Wi-Fi/Bluetooth/802.15.4"}
|
||||
{IDF_TARGET_RF_TYPE:default="Wi-Fi/Bluetooth", esp32s2="Wi-Fi", esp32c6="Wi-Fi/Bluetooth/802.15.4", esp32c61="Wi-Fi/Bluetooth", esp32h2="Bluetooth/802.15.4, esp32h21="Bluetooth/802.15.4, esp32h4="Bluetooth/802.15.4, esp32c5="Wi-Fi/Bluetooth/802.15.4"}
|
||||
|
||||
Overview
|
||||
--------
|
||||
|
||||
@@ -24,7 +24,7 @@ ESP-IDF FreeRTOS is a FreeRTOS implementation based on Vanilla FreeRTOS v10.5.1,
|
||||
|
||||
ESP-IDF FreeRTOS is currently the default FreeRTOS implementation for ESP-IDF.
|
||||
|
||||
.. only:: not esp32p4
|
||||
.. only:: not esp32p4 and not esp32h4
|
||||
|
||||
.. _amazon_smp_freertos:
|
||||
|
||||
|
||||
@@ -47,7 +47,7 @@ Although an SMP system allows threads to switch cores, there are scenarios where
|
||||
SMP on an ESP Target
|
||||
^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
ESP targets such as ESP32, ESP32-S3, and ESP32-P4 are dual-core SMP SoCs. These targets have the following hardware features that make them SMP-capable:
|
||||
ESP targets such as ESP32, ESP32-S3, ESP32-P4 and ESP32-H4 are dual-core SMP SoCs. These targets have the following hardware features that make them SMP-capable:
|
||||
|
||||
- Two identical cores are known as Core 0 and Core 1. This means that the execution of a piece of code is identical regardless of which core it runs on.
|
||||
- Symmetric memory (with some small exceptions).
|
||||
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v1.0
|
||||
@@ -1,16 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
* - ECO1
|
||||
- v0.1
|
||||
* - ECO2
|
||||
- v0.2
|
||||
* - ECO3
|
||||
- v0.3
|
||||
* - ECO4
|
||||
- v0.4
|
||||
@@ -1,10 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
* - ECO0
|
||||
- v0.0
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v0.1
|
||||
@@ -1,14 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v0.1
|
||||
* - ECO2
|
||||
- v0.2
|
||||
@@ -1,8 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
@@ -1,10 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
* - ECO0
|
||||
- v0.0
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v1.0
|
||||
@@ -1,14 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v0.1
|
||||
* - ECO2
|
||||
- v0.2
|
||||
@@ -1,20 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v1.0
|
||||
* - ECO1.1
|
||||
- v1.1
|
||||
* - ECO2
|
||||
- v2.0
|
||||
* - ECO3
|
||||
- v3.0
|
||||
* - ECO4
|
||||
- v3.1
|
||||
@@ -22,7 +22,7 @@ Overview
|
||||
|
||||
The {IDF_TARGET_NAME} has one core, with 28 external asynchronous interrupts. Each interrupt's priority is independently programmable. In addition, there are also 4 core local interrupt sources (CLINT). See **{IDF_TARGET_NAME} Technical Reference Manual** [`PDF <{IDF_TARGET_TRM_EN_URL}#riscvcpu>`__] for more details.
|
||||
|
||||
.. only:: esp32p4
|
||||
.. only:: esp32p4 or esp32h4
|
||||
|
||||
The {IDF_TARGET_NAME} has two cores, with 32 external asynchronous interrupts each. Each interrupt's priority is independently programmable. In addition, there are also 3 core local interrupt sources (CLINT) on each core. See **{IDF_TARGET_NAME} Technical Reference Manual** [`PDF <{IDF_TARGET_TRM_EN_URL}#riscvcpu>`__] for more details.
|
||||
|
||||
@@ -41,7 +41,7 @@ Non-shared interrupts can be either level- or edge-triggered. Shared interrupts
|
||||
To illustrate why shared interrupts can only be level-triggered, take the scenario where peripheral A and peripheral B share the same edge-triggered interrupt. Peripheral B triggers an interrupt and sets its interrupt signal high, causing a low-to-high edge, which in turn latches the CPU's interrupt bit and triggers the ISR. The ISR executes, checks that peripheral A did not trigger an interrupt, and proceeds to handle and clear peripheral B's interrupt signal. Before the ISR returns, the CPU clears its interrupt bit latch. Thus, during the entire interrupt handling process, if peripheral A triggers an interrupt, it will be missed due the CPU clearing the interrupt bit latch.
|
||||
|
||||
|
||||
.. only:: esp32 or esp32s3
|
||||
.. only:: SOC_HP_CPU_HAS_MULTIPLE_CORES and CONFIG_IDF_TARGET_ARCH_XTENSA
|
||||
|
||||
Multicore Issues
|
||||
----------------
|
||||
@@ -71,7 +71,7 @@ To illustrate why shared interrupts can only be level-triggered, take the scenar
|
||||
|
||||
The remaining interrupt sources are from external peripherals.
|
||||
|
||||
.. only:: esp32p4
|
||||
.. only:: SOC_HP_CPU_HAS_MULTIPLE_CORES and CONFIG_IDF_TARGET_ARCH_RISCV
|
||||
|
||||
Multicore Considerations
|
||||
------------------------
|
||||
|
||||
@@ -4,7 +4,7 @@ Miscellaneous System APIs
|
||||
:link_to_translation:`zh_CN:[中文]`
|
||||
|
||||
{IDF_TARGET_BASE_MAC_BLOCK: default="BLK1", esp32="BLK0"}
|
||||
{IDF_TARGET_CPU_RESET_DES: default="the CPU is reset", esp32="both CPUs are reset", esp32s3="both CPUs are reset", esp32p4="both CPUs are reset"}
|
||||
{IDF_TARGET_CPU_RESET_DES: default="the CPU is reset", esp32="both CPUs are reset", esp32s3="both CPUs are reset", esp32p4="both CPUs are reset", esp32h4="both CPUs are reset"}
|
||||
|
||||
Software Reset
|
||||
--------------
|
||||
|
||||
@@ -3,13 +3,6 @@ System Time
|
||||
|
||||
:link_to_translation:`zh_CN:[中文]`
|
||||
|
||||
{IDF_TARGET_RTC_CLK_FRE:default="Not updated", esp32="150 kHz", esp32s2="90 kHz", esp32s3="136 kHz", esp32c3="136 kHz", esp32c2="136 kHz", esp32c5="136 kHz", esp32c6="136 kHz", esp32h2="136 kHz", esp32p4="136 kHz"}
|
||||
{IDF_TARGET_INT_OSC_FRE:default="Not updated", esp32="8.5 MHz", esp32s2="8.5 MHz", esp32s3="17.5 MHz", esp32c3="17.5 MHz", esp32c2="17.5 MHz"}
|
||||
{IDF_TARGET_INT_OSC_FRE_DIVIDED:default="Not updated", esp32="about 33 kHz", esp32s2="about 33 kHz", esp32s3="about 68 kHz", esp32c3="about 68 kHz", esp32c2="about 68 kHz"}
|
||||
{IDF_TARGET_EXT_CRYSTAL_PIN:default="Not updated", esp32="32K_XP and 32K_XN", esp32s2="XTAL_32K_P and XTAL_32K_N", esp32s3="XTAL_32K_P and XTAL_32K_N", esp32c3="XTAL_32K_P and XTAL_32K_N", esp32c5="XTAL_32K_P and XTAL_32K_N", esp32c6="XTAL_32K_P and XTAL_32K_N", esp32h2="XTAL_32K_P and XTAL_32K_N", esp32p4="XTAL_32K_P and XTAL_32K_N"}
|
||||
{IDF_TARGET_EXT_OSC_PIN:default="Not updated", esp32="32K_XN", esp32s2="XTAL_32K_P", esp32s3="XTAL_32K_P", esp32c3="XTAL_32K_P", esp32c2="GPIO0", esp32c5="XTAL_32K_P", esp32c6="XTAL_32K_P", esp32h2="XTAL_32K_P", esp32p4="XTAL_32K_P"}
|
||||
|
||||
|
||||
Overview
|
||||
--------
|
||||
|
||||
@@ -38,13 +31,13 @@ The RTC timer has the following clock sources:
|
||||
|
||||
.. list::
|
||||
|
||||
- ``Internal {IDF_TARGET_RTC_CLK_FRE} RC oscillator`` (default): Features the lowest Deep-sleep current consumption and no dependence on any external components. However, the frequency stability of this clock source is affected by temperature fluctuations, so time may drift in both Deep-sleep and Light-sleep modes.
|
||||
- ``Internal 90-150 kHz (depending on chip) RC oscillator`` (default): Features the lowest Deep-sleep current consumption and no dependence on any external components. However, the frequency stability of this clock source is affected by temperature fluctuations, so time may drift in both Deep-sleep and Light-sleep modes.
|
||||
|
||||
:not esp32c2: - ``External 32 kHz crystal``: Requires a 32 kHz crystal to be connected to the {IDF_TARGET_EXT_CRYSTAL_PIN} pins. This source provides a better frequency stability at the expense of a slightly higher (by 1 μA) Deep-sleep current consumption.
|
||||
:not esp32c2: - ``External 32 kHz crystal``: Requires a 32 kHz crystal to be connected to the external crystal pins. This source provides a better frequency stability at the expense of a slightly higher (by 1 μA) Deep-sleep current consumption. Refer to the `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__ for information on which pins to connect to.
|
||||
|
||||
- ``External 32 kHz oscillator at {IDF_TARGET_EXT_OSC_PIN} pin``: Allows using 32 kHz clock generated by an external circuit. The external clock signal must be connected to the {IDF_TARGET_EXT_OSC_PIN} pin. The amplitude should be less than 1.2 V for sine wave signal and less than 1 V for square wave signal. Common mode voltage should be in the range of 0.1 < Vcm < 0.5xVamp, where Vamp stands for signal amplitude. In this case, the {IDF_TARGET_EXT_OSC_PIN} pin cannot be used as a GPIO pin.
|
||||
- ``External 32 kHz oscillator``: Allows using 32 kHz clock generated by an external circuit. The external clock signal must be connected to the external oscillator pin. The amplitude should be less than 1.2 V for sine wave signal and less than 1 V for square wave signal. Common mode voltage should be in the range of 0.1 < Vcm < 0.5xVamp, where Vamp stands for signal amplitude. Refer to the `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__ for information on which pin to connect to.
|
||||
|
||||
:not esp32c5 and not esp32c6 and not esp32h2 and not esp32p4: - ``Internal {IDF_TARGET_INT_OSC_FRE} oscillator, divided by 256 ({IDF_TARGET_INT_OSC_FRE_DIVIDED})``: Provides better frequency stability than the ``Internal {IDF_TARGET_RTC_CLK_FRE} RC oscillator`` at the expense of a higher (by 5 μA) Deep-sleep current consumption. It also does not require external components.
|
||||
:esp32 or esp32s2 or esp32s3 or esp32c2 or esp32c3: - ``Internal 8.5-17.5 MHz oscillator (depending on chip), divided by 256``: Provides better frequency stability than the ``Internal 90-150 kHz RC oscillator`` at the expense of a higher (by 5 μA) Deep-sleep current consumption. It also does not require external components.
|
||||
|
||||
The choice depends on your requirements for system time accuracy and power consumption in sleep modes. To modify the RTC clock source, set :ref:`CONFIG_RTC_CLK_SRC` in project configuration.
|
||||
|
||||
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- 版本（主版本号.次版本号）
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v1.0
|
||||
@@ -1,16 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- 版本（主版本号.次版本号）
|
||||
* - ECO1
|
||||
- v0.1
|
||||
* - ECO2
|
||||
- v0.2
|
||||
* - ECO3
|
||||
- v0.3
|
||||
* - ECO4
|
||||
- v0.4
|
||||
@@ -1,10 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- 版本（主版本号.次版本号）
|
||||
* - ECO0
|
||||
- v0.0
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- 版本（主版本号.次版本号）
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v0.1
|
||||
@@ -1,14 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- 版本（主版本号.次版本号）
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v0.1
|
||||
* - ECO2
|
||||
- v0.2
|
||||
@@ -1,8 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- Revision (Major.Minor)
|
||||
@@ -1,10 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- 版本（主版本号.次版本号）
|
||||
* - ECO0
|
||||
- v0.0
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- 版本（主版本号.次版本号）
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v1.0
|
||||
@@ -1,14 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- 版本（主版本号.次版本号）
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v0.1
|
||||
* - ECO2
|
||||
- v0.2
|
||||
@@ -1,20 +0,0 @@
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
:width: 2 5
|
||||
:align: center
|
||||
|
||||
* - ECO
|
||||
- 版本（主版本号.次版本号）
|
||||
* - ECO0
|
||||
- v0.0
|
||||
* - ECO1
|
||||
- v1.0
|
||||
* - ECO1.1
|
||||
- v1.1
|
||||
* - ECO2
|
||||
- v2.0
|
||||
* - ECO3
|
||||
- v3.0
|
||||
* - ECO4
|
||||
- v3.1
|
||||
Reference in New Issue
Block a user