ESP32-S3 | The component 'esp_hal_usb' could not be found. | NOTICE: espressif__usb overrides usb since "project_managed_components" type got higher priority than "idf_components" (IEC-492)

[itismejy]

Answers checklist.

• I have read the component documentation ESP-IDF Components and the issue is not addressed there.
• I am using target and esp-idf version as defined in component's idf_component.yml
• I have searched the issue tracker for a similar issue and not found any related issue.

Which component are you using? If you choose Other, provide details in More Information.

device/esp_tinyusb

ESP-IDF version.

6.0

Development Kit.

ESP32-S3-Xiao

Used Component version.

5.4

More Information.

-- Configuring incomplete, errors occurred!
HINT: The component 'esp_hal_usb' could not be found. This could be because: component name was misspelled, the component was not added to the build, the component has been moved to the IDF component manager, the component has been removed and refactored into some other component or the component may not be supported by the selected target.
Please look out for component in 'https://components.espressif.com' and add using 'idf.py add-dependency' command.
Refer to the migration guide for more details about moved components.
Refer to the build-system guide for more details about how components are found and included in the build.
cmake failed with exit code 1, output of the command is in the /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/build/log/idf_py_stderr_output_38123 and /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/build/log/idf_py_stdout_output_38123
jasonyang@Jasons-MacBook-Pro-3 wakeword_vad_capture %

Full logs:
Command: cmake -G Ninja -DPYTHON_DEPS_CHECKED=1 -DPYTHON=/Users/jasonyang/.espressif/python_env/idf6.0_py3.9_env/bin/python -DESP_PLATFORM=1 -DCCACHE_ENABLE=0 /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture
-- IDF_TARGET is not set, guessed 'esp32s3' from sdkconfig '/Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/sdkconfig'
-- Found Git: /usr/bin/git (found version "2.50.1 (Apple Git-155)")
-- Minimal build - OFF
-- The C compiler identification is GNU 14.2.0
-- The CXX compiler identification is GNU 14.2.0
-- The ASM compiler identification is GNU
-- Found assembler: /Users/jasonyang/.espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119/xtensa-esp-elf/bin/xtensa-esp32s3-elf-gcc
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /Users/jasonyang/.espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119/xtensa-esp-elf/bin/xtensa-esp32s3-elf-gcc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /Users/jasonyang/.espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119/xtensa-esp-elf/bin/xtensa-esp32s3-elf-g++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Building ESP-IDF components for target esp32s3
NOTICE: Dependencies lock doesn't exist, solving dependencies.
NOTICE: Using component placed at /Users/jasonyang/Documents/Development/ai_pin/esp_idf/components/espressif__esp_websocket_client for dependency "espressif/esp_websocket_client", specified in /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/main/idf_component.yml
...................NOTICE: Updating lock file at /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/dependencies.lock
NOTICE: Processing 9 dependencies:
NOTICE: [1/9] espressif/dl_fft (0.3.1)
NOTICE: [2/9] espressif/esp-dsp (1.7.0)
NOTICE: [3/9] espressif/esp-sr (2.3.1)
NOTICE: [4/9] espressif/esp_codec_dev (1.1.0)
NOTICE: [5/9] espressif/esp_modem (1.4.2)
NOTICE: [6/9] espressif/esp_websocket_client (1.6.1) (/Users/jasonyang/Documents/Development/ai_pin/esp_idf/components/espressif__esp_websocket_client)
NOTICE: [7/9] espressif/usb (1.2.0)
NOTICE: [8/9] espressif/usb_host_cdc_acm (2.3.0)
NOTICE: [9/9] idf (6.0.0)
NOTICE: espressif__usb overrides usb since "project_managed_components" type got higher priority than "idf_components"
-- Configuring incomplete, errors occurred!

Other logs:
Command: cmake -G Ninja -DPYTHON_DEPS_CHECKED=1 -DPYTHON=/Users/jasonyang/.espressif/python_env/idf6.0_py3.9_env/bin/python -DESP_PLATFORM=1 -DCCACHE_ENABLE=0 /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture
-- IDF_TARGET is not set, guessed 'esp32s3' from sdkconfig '/Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/sdkconfig'
-- Found Git: /usr/bin/git (found version "2.50.1 (Apple Git-155)")
-- Minimal build - OFF
-- The C compiler identification is GNU 14.2.0
-- The CXX compiler identification is GNU 14.2.0
-- The ASM compiler identification is GNU
-- Found assembler: /Users/jasonyang/.espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119/xtensa-esp-elf/bin/xtensa-esp32s3-elf-gcc
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /Users/jasonyang/.espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119/xtensa-esp-elf/bin/xtensa-esp32s3-elf-gcc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /Users/jasonyang/.espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119/xtensa-esp-elf/bin/xtensa-esp32s3-elf-g++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Building ESP-IDF components for target esp32s3
NOTICE: Dependencies lock doesn't exist, solving dependencies.
NOTICE: Using component placed at /Users/jasonyang/Documents/Development/ai_pin/esp_idf/components/espressif__esp_websocket_client for dependency "espressif/esp_websocket_client", specified in /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/main/idf_component.yml
...................NOTICE: Updating lock file at /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/dependencies.lock
NOTICE: Processing 9 dependencies:
NOTICE: [1/9] espressif/dl_fft (0.3.1)
NOTICE: [2/9] espressif/esp-dsp (1.7.0)
NOTICE: [3/9] espressif/esp-sr (2.3.1)
NOTICE: [4/9] espressif/esp_codec_dev (1.1.0)
NOTICE: [5/9] espressif/esp_modem (1.4.2)
NOTICE: [6/9] espressif/esp_websocket_client (1.6.1) (/Users/jasonyang/Documents/Development/ai_pin/esp_idf/components/espressif__esp_websocket_client)
NOTICE: [7/9] espressif/usb (1.2.0)
NOTICE: [8/9] espressif/usb_host_cdc_acm (2.3.0)
NOTICE: [9/9] idf (6.0.0)
NOTICE: espressif__usb overrides usb since "project_managed_components" type got higher priority than "idf_components"
-- Configuring incomplete, errors occurred!

[itismejy]

The main thing I'm looking for is to turn on usb in idf.py menuconfig, so I can connect my SIM7670G to ESP32-S3 Xiao with a USB cable for internet data

[github-actions]

Hi @itismejy! Please be aware that the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems. We hope that this message will help you until an Espressif Engineer looks at your issue.

---

The knowledge sources confirm two relevant points:

1. In ESP-IDF v6.0, the generic usb component has been moved out of ESP-IDF into the ESP Component Registry and must be added via the Component Manager. [ESP32-S3 USB migration]
2. There is a new esp_hal_usb component in ESP-IDF that provides a USB hardware abstraction layer, and it is currently marked as beta. [esp_hal_usb README]

However, the provided sources do not describe how to obtain esp_hal_usb via the Component Registry, nor do they show an espressif/esp_hal_usb package or any migration note that says it has been moved out of ESP-IDF. Because of that, I cannot state with certainty that esp_hal_usb is currently available as a standalone managed component.

From the logs you shared:

• You are already pulling espressif/usb from the registry (NOTICE: [7/9] espressif/usb (1.2.0)), and it overrides the built‑in usb component: NOTICE: espressif__usb overrides usb since "project_managed_components" type got higher priority than "idf_components". [USB moved to registry; Component Manager usage]
• CMake then fails because it cannot find a component named esp_hal_usb.

Given only the information in the knowledge sources, the most accurate guidance I can provide is:

1. esp_hal_usb is an internal ESP-IDF component
   It lives under components/esp_hal_usb in the ESP-IDF tree and is intended primarily as a HAL used by higher‑level USB drivers (such as the espressif/usb host stack). [esp_hal_usb README]
   The sources do not show it as a separate Component Registry package.

2. You should not need to add esp_hal_usb manually as a managed dependency
   Normally, if you are using IDF 6.0 and the correct espressif/usb / esp_tinyusb versions, any dependency on esp_hal_usb should be satisfied by the ESP-IDF tree itself, not by a separate espressif/esp_hal_usb component. The error suggests that CMake is trying to resolve esp_hal_usb as a managed component instead of using the one from ESP-IDF, but the knowledge sources do not explain why.

3. What you can safely do based on the docs
   From the migration guides and Component Manager docs, the only supported, documented steps are:

   • Ensure you are on ESP-IDF 6.0 as required by the component (you already are). [USB moved to registry]
   • Add the usb component from the registry if you need the USB Host stack:

     idf.py add-dependency "espressif/usb"

     [USB moved to registry]
   • Add other USB‑related components (like esp_tinyusb) via idf.py add-dependency as documented in the Component Manager guide. [Component Manager usage]

Because the knowledge sources do not contain:

• an espressif/esp_hal_usb package entry, or
• a migration note explaining how to resolve “The component esp_hal_usb could not be found” when using device/esp_tinyusb,

I cannot give a definitive, step‑by‑step fix for this specific build failure without going beyond the provided documentation.

For the GitHub issue, you can accurately report:

• esp_hal_usb is an internal ESP-IDF USB HAL component, currently in beta, and used by higher‑level USB drivers. [esp_hal_usb README]
• In IDF 6.0, the public usb component has been moved to the Component Registry and must be added via idf.py add-dependency "espressif/usb". [ESP32-S3 USB migration]
• The current documentation does not describe esp_hal_usb as a separate managed component, nor how to resolve this exact error when using device/esp_tinyusb, so further clarification from the esp-usb maintainers is required.

[itismejy]

It doesnt seem to exist:
jasonyang@Jasons-MacBook-Pro-3 wakeword_vad_capture % ls -d /Users/jasonyang/esp/esp-idf/components/esp_hal_usb
ls: /Users/jasonyang/esp/esp-idf/components/esp_hal_usb: No such file or directory
ls $IDF_PATH/components/esp_hal_usb

I tried to go to ESP-iDF 6.1, and it has it

Is it not there for 6.0?

In 6.1 I get:
Executing action: reconfigure
Running cmake in directory /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/build
Executing "cmake -G Ninja -B /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/build -DPYTHON_DEPS_CHECKED=1 -DPYTHON=/Users/jasonyang/.espressif/python_env/idf6.0_py3.9_env/bin/python -DESP_PLATFORM=1 -DCCACHE_ENABLE=False /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture"...
-- IDF_TARGET not set, using default target: esp32
-- Found Git: /usr/bin/git (found version "2.50.1 (Apple Git-155)")
-- Component directory /Users/jasonyang/esp/esp-idf/components/idf_test does not contain a CMakeLists.txt file. No component will be added
-- Component directory /Users/jasonyang/esp/esp-idf/components/json does not contain a CMakeLists.txt file. No component will be added
-- Component directory /Users/jasonyang/esp/esp-idf/components/mqtt does not contain a CMakeLists.txt file. No component will be added
-- Minimal build - OFF
-- The C compiler identification is GNU 15.2.0
-- The CXX compiler identification is GNU 15.2.0
-- The ASM compiler identification is GNU
-- Found assembler: /Users/jasonyang/.espressif/tools/xtensa-esp-elf/esp-15.2.0_20251204/xtensa-esp-elf/bin/xtensa-esp32-elf-gcc
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /Users/jasonyang/.espressif/tools/xtensa-esp-elf/esp-15.2.0_20251204/xtensa-esp-elf/bin/xtensa-esp32-elf-gcc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /Users/jasonyang/.espressif/tools/xtensa-esp-elf/esp-15.2.0_20251204/xtensa-esp-elf/bin/xtensa-esp32-elf-g++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Building ESP-IDF components for target esp32
NOTICE: Dependencies lock doesn't exist, solving dependencies.
NOTICE: Using component placed at /Users/jasonyang/Documents/Development/ai_pin/esp_idf/components/espressif__esp_websocket_client for dependency "espressif/esp_websocket_client", specified in /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/main/idf_component.yml
............NOTICE: Updating lock file at /Users/jasonyang/Documents/Development/ai_pin/esp_idf/wakeword_vad_capture/dependencies.lock
NOTICE: Processing 7 dependencies:
NOTICE: [1/7] espressif/dl_fft (0.3.1)
NOTICE: [2/7] espressif/esp-dsp (1.7.0)
NOTICE: [3/7] espressif/esp-sr (2.3.1)
NOTICE: [4/7] espressif/esp_codec_dev (1.1.0)
NOTICE: [5/7] espressif/esp_modem (1.4.2)
NOTICE: [6/7] espressif/esp_websocket_client (1.6.1) (/Users/jasonyang/Documents/Development/ai_pin/esp_idf/components/espressif__esp_websocket_client)
NOTICE: [7/7] idf (6.1.0)
-- ESP-TEE is currently supported only on the esp32c6;esp32h2;esp32c5;esp32c61 SoCs
CMake Error at /Users/jasonyang/esp/esp-idf/tools/cmake/build.cmake:378 (message):
Failed to resolve component 'newlib' required by component 'nvs_flash':
unknown name.
Call Stack (most recent call first):
/Users/jasonyang/esp/esp-idf/tools/cmake/build.cmake:427 (__build_resolve_and_add_req)
/Users/jasonyang/esp/esp-idf/tools/cmake/build.cmake:428 (__build_expand_requirements)
/Users/jasonyang/esp/esp-idf/tools/cmake/build.cmake:422 (__build_expand_requirements)
/Users/jasonyang/esp/esp-idf/tools/cmake/build.cmake:422 (__build_expand_requirements)
/Users/jasonyang/esp/esp-idf/tools/cmake/build.cmake:751 (__build_expand_requirements)
/Users/jasonyang/esp/esp-idf/tools/cmake/project.cmake:742 (idf_build_process)
CMakeLists.txt:8 (project)

-- Configuring incomplete, errors occurred!
HINT: newlib component has been renamed to esp_libc. Any REQUIRES newlib can simply be deleted as esp_libc is REQUIRED by default.

[tore-espressif]

@itismejy Thank you for the bug report.

IDF v6.0 has not been released yet. So I assume that you work on some arbitrarily picked commit from release/v6.0 branch.
Could you please try updating your local esp-idf to latest beta tag? eg

> git fetch
> git checkout v6.0-beta2

This should fix your inconsistent state

[itismejy]

Hi there,

Thank you for the response, I will try tomorrow.

I am trying to connect ESP32-S3 with my modem SIM7670G using USB rather than UART.

What usb_host_cdc_acm version is compatible?

Additionally, I'm getting this in the logs ->
NOTICE: espressif__usb overrides usb since "project_managed_components" type got higher priority than "idf_components"

Which one is the correct one and do I still need esp_modem or can I remove that from idfcomponent.yml?

Thanks!

[tore-espressif]

@itismejy I'll close this issue as answered. Feel free to reopen if there are more questions