From 1183ef825b6d1fbb316b1df150d846bac0c09aeb Mon Sep 17 00:00:00 2001
From: Jonathan Swoboda <154711427+swoboda1337@users.noreply.github.com>
Date: Mon, 16 Mar 2026 01:09:55 -0400
Subject: [PATCH] [usb_host] Fix ESP-IDF 6.0 compatibility for external USB
 host component (#14844)

---
 esphome/components/usb_host/__init__.py | 5 +++++
 esphome/idf_component.yml               | 4 ++++
 2 files changed, 9 insertions(+)

diff --git a/esphome/components/usb_host/__init__.py b/esphome/components/usb_host/__init__.py
index e4c11be489..5eb0371e5c 100644
--- a/esphome/components/usb_host/__init__.py
+++ b/esphome/components/usb_host/__init__.py
@@ -4,7 +4,9 @@ from esphome.components.esp32 import (
     VARIANT_ESP32P4,
     VARIANT_ESP32S2,
     VARIANT_ESP32S3,
+    add_idf_component,
     add_idf_sdkconfig_option,
+    idf_version,
     only_on_variant,
 )
 import esphome.config_validation as cv
@@ -64,6 +66,9 @@ async def register_usb_client(config):
 
 
 async def to_code(config: ConfigType) -> None:
+    # IDF 6.0 moved USB host to an external component
+    if idf_version() >= cv.Version(6, 0, 0):
+        add_idf_component(name="espressif/usb", ref="1.3.0")
     add_idf_sdkconfig_option("CONFIG_USB_HOST_CONTROL_TRANSFER_MAX_SIZE", 1024)
     if config.get(CONF_ENABLE_HUBS):
         add_idf_sdkconfig_option("CONFIG_USB_HOST_HUBS_SUPPORTED", True)
diff --git a/esphome/idf_component.yml b/esphome/idf_component.yml
index 59876e8b3d..c949c3b026 100644
--- a/esphome/idf_component.yml
+++ b/esphome/idf_component.yml
@@ -43,5 +43,9 @@ dependencies:
     version: "1.0.0"
     rules:
       - if: "idf_version >=6.0.0"
+  espressif/usb:
+    version: "1.3.0"
+    rules:
+      - if: "idf_version >=6.0.0 && target in [esp32s2, esp32s3, esp32p4]"
   esp32async/asynctcp:
     version: 3.4.91