From 7ef1f5e13a80f0a70772c622817225fbaec28564 Mon Sep 17 00:00:00 2001 From: Yuan Ming Fu Date: Tue, 7 May 2024 19:28:22 +0800 Subject: [PATCH] example: use 26MHz XTAL default on esp32-c2 --- .gitlab-ci.yml | 2 +- docs/en/faq.rst | 20 +++++++++++++++++++ .../generic_switch/sdkconfig.defaults.esp32c2 | 4 ++++ examples/light/sdkconfig.defaults.esp32c2 | 4 ++++ .../light_switch/sdkconfig.defaults.esp32c2 | 4 ++++ .../sdkconfig.defaults.esp32c2 | 4 ++++ .../refrigerator/sdkconfig.defaults.esp32c2 | 4 ++++ .../sdkconfig.defaults.esp32c2 | 4 ++++ examples/zap_light/sdkconfig.defaults.esp32c2 | 4 ++++ 9 files changed, 49 insertions(+), 1 deletion(-) diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index 5d9a6b934..f2e9d7ef0 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -404,7 +404,7 @@ pytest_esp32c2_esp_matter_dut: - rm -rf connectedhomeip/connectedhomeip - ln -s ${CHIP_SUBMODULE_PATH} connectedhomeip/connectedhomeip - pip install -r tools/ci/requirements-pytest.txt - - pytest examples/ --target esp32c2 -m esp_matter_dut --junitxml=XUNIT_RESULT.xml + - pytest examples/ --target esp32c2 -m esp_matter_dut --junitxml=XUNIT_RESULT.xml --baud 74880 tags: ["esp32c2", "esp_matter_dut"] pytest_esp32h2_esp_matter_dut: diff --git a/docs/en/faq.rst b/docs/en/faq.rst index db4ca7de0..2fbd378c9 100644 --- a/docs/en/faq.rst +++ b/docs/en/faq.rst @@ -352,3 +352,23 @@ you can resolve this issue by clearing the component manager cache. # On macOS rm -rf ~/Library/Caches/Espressif/ComponentManager + + +A1.14 ESP32-C2 log garbled, unable to perform Matter commissioning and other abnormal issues +-------------------------------------------------------------------------------------------- + +When encountering the above issues, the following possible causes may exist: +1. Incorrect baud rate settings. See `UART console baud rate `__. +2. Incorrect XTAL crystal frequency settings. The default XTAL crystal frequency in the SDK examples is 26 Mhz, if the ESP32-C2 board used for testing is 40 MHz, please change the configuration as `CONFIG_XTAL_FREQ_40=y`. See `Main XTAL frequency `__. You can check the XTAL frequency with this command. + + :: + + $ esptool.py flash_id + esptool.py v4.7.0 + Serial port /dev/ttyUSB0 + Connecting.... + Detecting chip type... ESP32-C2 + Chip is ESP32-C2 (revision v1.0) + Features: WiFi, BLE + Crystal is 26MHz + MAC: 08:3a:8d:49:b3:90 diff --git a/examples/generic_switch/sdkconfig.defaults.esp32c2 b/examples/generic_switch/sdkconfig.defaults.esp32c2 index 45a1da886..2070d38fa 100644 --- a/examples/generic_switch/sdkconfig.defaults.esp32c2 +++ b/examples/generic_switch/sdkconfig.defaults.esp32c2 @@ -39,6 +39,10 @@ CONFIG_ESP_EVENT_POST_FROM_ISR=n # Chip revision CONFIG_ESP32C2_REV2_DEVELOPMENT=y +# Main XTAL Config +CONFIG_XTAL_FREQ_26=y +CONFIG_XTAL_FREQ_40=n + # ESP Ringbuf CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH=y CONFIG_RINGBUF_PLACE_ISR_FUNCTIONS_INTO_FLASH=y diff --git a/examples/light/sdkconfig.defaults.esp32c2 b/examples/light/sdkconfig.defaults.esp32c2 index 540d7e147..d55c8241b 100644 --- a/examples/light/sdkconfig.defaults.esp32c2 +++ b/examples/light/sdkconfig.defaults.esp32c2 @@ -39,6 +39,10 @@ CONFIG_ESP_EVENT_POST_FROM_ISR=n # Chip revision CONFIG_ESP32C2_REV2_DEVELOPMENT=y +# Main XTAL Config +CONFIG_XTAL_FREQ_26=y +CONFIG_XTAL_FREQ_40=n + # ESP Ringbuf CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH=y CONFIG_RINGBUF_PLACE_ISR_FUNCTIONS_INTO_FLASH=y diff --git a/examples/light_switch/sdkconfig.defaults.esp32c2 b/examples/light_switch/sdkconfig.defaults.esp32c2 index 45a1da886..2070d38fa 100644 --- a/examples/light_switch/sdkconfig.defaults.esp32c2 +++ b/examples/light_switch/sdkconfig.defaults.esp32c2 @@ -39,6 +39,10 @@ CONFIG_ESP_EVENT_POST_FROM_ISR=n # Chip revision CONFIG_ESP32C2_REV2_DEVELOPMENT=y +# Main XTAL Config +CONFIG_XTAL_FREQ_26=y +CONFIG_XTAL_FREQ_40=n + # ESP Ringbuf CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH=y CONFIG_RINGBUF_PLACE_ISR_FUNCTIONS_INTO_FLASH=y diff --git a/examples/managed_component_light/sdkconfig.defaults.esp32c2 b/examples/managed_component_light/sdkconfig.defaults.esp32c2 index 125c77e0f..7f138be8c 100644 --- a/examples/managed_component_light/sdkconfig.defaults.esp32c2 +++ b/examples/managed_component_light/sdkconfig.defaults.esp32c2 @@ -39,6 +39,10 @@ CONFIG_ESP_EVENT_POST_FROM_ISR=n # Chip revision CONFIG_ESP32C2_REV2_DEVELOPMENT=y +# Main XTAL Config +CONFIG_XTAL_FREQ_26=y +CONFIG_XTAL_FREQ_40=n + # ESP Ringbuf CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH=y CONFIG_RINGBUF_PLACE_ISR_FUNCTIONS_INTO_FLASH=y diff --git a/examples/refrigerator/sdkconfig.defaults.esp32c2 b/examples/refrigerator/sdkconfig.defaults.esp32c2 index 6d354f182..2aa4921dc 100644 --- a/examples/refrigerator/sdkconfig.defaults.esp32c2 +++ b/examples/refrigerator/sdkconfig.defaults.esp32c2 @@ -39,6 +39,10 @@ CONFIG_ESP_EVENT_POST_FROM_ISR=n # Chip revision CONFIG_ESP32C2_REV2_DEVELOPMENT=y +# Main XTAL Config +CONFIG_XTAL_FREQ_26=y +CONFIG_XTAL_FREQ_40=n + # ESP Ringbuf CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH=y CONFIG_RINGBUF_PLACE_ISR_FUNCTIONS_INTO_FLASH=y diff --git a/examples/room_air_conditioner/sdkconfig.defaults.esp32c2 b/examples/room_air_conditioner/sdkconfig.defaults.esp32c2 index 45a1da886..2070d38fa 100644 --- a/examples/room_air_conditioner/sdkconfig.defaults.esp32c2 +++ b/examples/room_air_conditioner/sdkconfig.defaults.esp32c2 @@ -39,6 +39,10 @@ CONFIG_ESP_EVENT_POST_FROM_ISR=n # Chip revision CONFIG_ESP32C2_REV2_DEVELOPMENT=y +# Main XTAL Config +CONFIG_XTAL_FREQ_26=y +CONFIG_XTAL_FREQ_40=n + # ESP Ringbuf CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH=y CONFIG_RINGBUF_PLACE_ISR_FUNCTIONS_INTO_FLASH=y diff --git a/examples/zap_light/sdkconfig.defaults.esp32c2 b/examples/zap_light/sdkconfig.defaults.esp32c2 index 45a1da886..2070d38fa 100644 --- a/examples/zap_light/sdkconfig.defaults.esp32c2 +++ b/examples/zap_light/sdkconfig.defaults.esp32c2 @@ -39,6 +39,10 @@ CONFIG_ESP_EVENT_POST_FROM_ISR=n # Chip revision CONFIG_ESP32C2_REV2_DEVELOPMENT=y +# Main XTAL Config +CONFIG_XTAL_FREQ_26=y +CONFIG_XTAL_FREQ_40=n + # ESP Ringbuf CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH=y CONFIG_RINGBUF_PLACE_ISR_FUNCTIONS_INTO_FLASH=y