drivers: usb: uhc_dwc2: add initial support

[roma-jam]

• DWC2 USB Host controller (UHC) #102931

Description

This is initial support of Synopsys DWC2 controller as a USB Host (esp32 vendor quirks included, so it might be tested on esp32s3).

These changes allow to init dwc2 as a host and enumerate attached USB device and utilize the Control Endpoint to get device information (for example, via shell example command: usbh device info) for different devices.

nRF54LM20 support

With vendor quirks #95723 it works with Full-speed devices as well, so the code might be tested on the nRF54LM20-DK board.

Limitations

• Not handling any errors during the transfer. If the transfer has finished with an error, there will be LOG_ERR() output followed by LOG_WRN() which reveals where handling is absent.
• Uses only one channel - channel number 0. Additional logic to claim vacant channel on uhc_dwc2_enqueue will be added as a follow-up.
• Supports only Control transfer. Bulk, Interrupt and Isochronous transfers will be added as a follow-up.
• High-speed is not working on nRF54. Will be fixed in the follow-up.
• Supports only Buffer DMA mode (Slave or Scatter Gather also might be added, but esp32s3 and nRF54 both have DMA)
• Does not synchronize cache (marked as TODO: in the code, where it should be done)
• Does not support Hub connection (when device is a downstream device of the external hub)

And some other small limitations, that marked as TODOs in the code and can be solved in the future as a follow-up (with test coverage or without. "With" is better IMHO).

Testing with usbh shell on ESP32S3

1. From the /samples/subsys/usb/shell folder, run

$ west build -b esp32s3_devkitc/esp32s3/procpu -- \
 -DCONFIG_SHELL=y \
 -DCONFIG_USB_HOST_STACK=y \
 -DCONFIG_USBH_SHELL=y \
 -DCONFIG_UDC_DWC2=n 

and get:

... 

Successfully created ESP32-S3 image.

then run:

$ west flash --esp-device /dev/ttyACM0 && west espressif monitor -p /dev/ttyACM0

and the the common usbh shell commands are available:

...

*** Booting Zephyr OS build 18c5216bfc70 ***
uart:~$ usbh init 
host: USB host initialized
uart:~$ usbh enable 
host: USB host enabled
[00:00:04.638,000] <inf> usbh_dev: New device with address 1 state 2
[00:00:04.640,000] <inf> usbh_dev: Configuration 1 bNumInterfaces 3
uart:~$ usbh device list 
1
uart:~$ usbh device info 1
Device Descriptor:
  bLength                        18
  bDescriptorType                 1
  bcdUSB                       2.00
  bDeviceClass                  239
  bDeviceSubClass                 2
  bDeviceProtocol                 1
  bMaxPacketSize0                64
  idVendor                   0x1E45
  idProduct                  0x8022
  bcdDevice                   58.01
  iManufacturer                   3
  iProduct                        1
  iSerial                         2
  bNumConfigurations              1
  Configuration Descriptor:
    bLength                         9
    bDescriptorType                 2
    wTotalLength               0x0144
    bNumInterfaces                  2
    bConfigurationValue             1
    iConfiguration                  4
    bmAttributes                 0x80
    bMaxPower                     500 mA
    Interface Association:
      bLength                         8
    ...

Related

• Follow-up in drivers: usb: uhc_dwc2: add bulk transfer support #105287
• Contains changes from drivers: usb: uhc: dwc2: Added port state handling [part4] #102966
• Contains changes from drivers: usb: uhc: Added dwc2 vendor quirks for esp32 [part3]  #102965
• Contains changes from drivers: usb: common: Added uhc dwc2 initial files [part2] #102963
• Refactoring of drivers: uhc_dwc2: Initial support #94266
• Relates to uhc: dwc2: vendor quirks for nRF54LM20 #95723

[josuah]

Some review pass to detail a bit more the ability to remove local definitions already provided in drivers/usb/common/usb_dwc2_hw.h.

[josuah]

I think I do not have any other modification to propose than those already opened.

It works with nRF54LM20 on this branch, and I anticipate it would also work on other platforms.

The driver is clearly a lot more robust than anything I could be coming-up with myself, and fixed many bugs due to my lack of deep understanding of DWC2 beyond the manual.

Thank you once again for bearing in, and for all of your help and expertise on this driver!

I will pursue with ISO support on top of it and stay reactive, i.e. rebase the nRF54LM20 branch frequently to keep testing things still work as you go.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[roma-jam]

Suggested change

	LOG_ERR("Thread channel%d unhanlded evetns: %08Xh", channel->index, events);
	LOG_ERR("Thread channel%d unhandled events: %08Xh", channel->index, events);

[roma-jam]

Hi everyone,

this PR is ready for the review and the incoming code might be tested with esp32s3 or nrf54lm20 (full-speed only for now).

For more details, please refer to the PR description.

[roma-jam]

This is a PHY clock selection, so it won't change after configuration.
Might be moved to/inside the dwc2_hal_init_host()