ESPHome 2026.6.0-dev
Loading...
Searching...
No Matches
tinyusb_component.cpp
Go to the documentation of this file.
1#if defined(USE_ESP32_VARIANT_ESP32P4) || defined(USE_ESP32_VARIANT_ESP32S2) || defined(USE_ESP32_VARIANT_ESP32S3)
2#include "tinyusb_component.h"
4#include "esphome/core/log.h"
5#include "tinyusb_default_config.h"
6
7namespace esphome::tinyusb {
8
9static const char *const TAG = "tinyusb";
10
12 // Use the device's MAC address as its serial number if no serial number is defined
13 if (this->string_descriptor_[SERIAL_NUMBER] == nullptr) {
14 static char mac_addr_buf[13];
15 get_mac_address_into_buffer(mac_addr_buf);
16 this->string_descriptor_[SERIAL_NUMBER] = mac_addr_buf;
17 }
18
19 // Start from esp_tinyusb defaults to keep required task settings valid across esp_tinyusb updates.
20 this->tusb_cfg_ = TINYUSB_DEFAULT_CONFIG();
21 this->tusb_cfg_.port = TINYUSB_PORT_FULL_SPEED_0;
22 this->tusb_cfg_.phy.skip_setup = false;
23 this->tusb_cfg_.descriptor = {
24 .device = &this->usb_descriptor_,
25 .string = this->string_descriptor_,
26 .string_count = SIZE,
27 };
28
29 // Defense-in-depth: esp_tinyusb's tinyusb_descriptors_set() fails with
30 // ESP_ERR_INVALID_ARG when no configuration descriptor is provided and
31 // no class that has a built-in default (CDC/MSC/NCM) is compiled in. In
32 // that case the internal task exits without notifying us, and
33 // tinyusb_driver_install() blocks 5s on the notify-take -- long enough
34 // to trip the task watchdog. Bail early so the rest of the device can
35 // still boot.
36#if !(CFG_TUD_CDC > 0 || CFG_TUD_MSC > 0 || CFG_TUD_NCM > 0)
37 if (this->tusb_cfg_.descriptor.full_speed_config == nullptr) {
38 ESP_LOGE(TAG, "No USB class configured");
39 this->mark_failed();
40 return;
41 }
42#endif
43
44 esp_err_t result = tinyusb_driver_install(&this->tusb_cfg_);
45 if (result != ESP_OK) {
46 ESP_LOGE(TAG, "tinyusb_driver_install failed: %s", esp_err_to_name(result));
47 this->mark_failed();
48 }
49}
50
52 ESP_LOGCONFIG(TAG,
53 "TinyUSB:\n"
54 " Product ID: 0x%04X\n"
55 " Vendor ID: 0x%04X\n"
56 " Manufacturer: '%s'\n"
57 " Product: '%s'\n"
58 " Serial: '%s'\n",
59 this->usb_descriptor_.idProduct, this->usb_descriptor_.idVendor, this->string_descriptor_[MANUFACTURER],
60 this->string_descriptor_[PRODUCT], this->string_descriptor_[SERIAL_NUMBER]);
61}
62
63} // namespace esphome::tinyusb
64#endif // USE_ESP32_VARIANT_ESP32P4 || USE_ESP32_VARIANT_ESP32S2 || USE_ESP32_VARIANT_ESP32S3
void mark_failed()
Mark this component as failed.
const char * string_descriptor_[SIZE]
tusb_desc_device_t usb_descriptor_
void get_mac_address_into_buffer(std::span< char, MAC_ADDRESS_BUFFER_SIZE > buf)
Get the device MAC address into the given buffer, in lowercase hex notation.
Definition helpers.cpp:744