examples/peripherals/usb/README.md

# USB-OTG Examples

See the [README.md](../../README.md) file in the upper level [examples](../../) directory for more information about examples.

## Common Pin Assignments

Pin assignment is only needed for ESP chips that have a USB-OTG peripheral.
If your board doesn't have a USB connector connected to the USB-OTG dedicated GPIOs, you may have to DIY a cable and connect **D+** and **D-** to the pins listed below.

```
ESP BOARD       USB CONNECTOR (type A)
                   --
                  | || VBUS (5V)
[USB_DM]  ------> | || D-
[USB_DP]  ------> | || D+
                  | || GND
                   --
```

### USB PHY pin mapping

|              | USB_DP | USB_DM |
| ------------ | ------ | ------ |
| ESP32-S2/S3  | GPIO20 | GPIO19 |
| ESP32-P4 2.0 | pin 51 | pin 50 |
| ESP32-P4 1.1 | GPIO27 | GPIO26 |

> Note: On the ESP32-P4, the USB 2.0 PHY pins are dedicated to USB-OTG functionality and cannot be used as general-purpose GPIOs.
tiny_usb: rename Kconfig name 1. Renamed Kconfig file of tinyusb (distinguish tinyusb stack from usb peripheral) 2. bugfix/typofix/doc update of tinyusb 2021-07-09 11:15:26 +08:00			`# USB-OTG Examples`

docs(usb_host): Update usb_host example READMEs for P4 Closes https://github.com/espressif/esp-idf/issues/14578 Closes https://github.com/espressif/esp-idf/issues/12142 2024-10-29 12:01:11 +01:00			`See the [README.md](../../README.md) file in the upper level [examples](../../) directory for more information about examples.`
tiny_usb: rename Kconfig name 1. Renamed Kconfig file of tinyusb (distinguish tinyusb stack from usb peripheral) 2. bugfix/typofix/doc update of tinyusb 2021-07-09 11:15:26 +08:00
			`## Common Pin Assignments`

docs(usb_host): Update usb_host example READMEs for P4 Closes https://github.com/espressif/esp-idf/issues/14578 Closes https://github.com/espressif/esp-idf/issues/12142 2024-10-29 12:01:11 +01:00			`Pin assignment is only needed for ESP chips that have a USB-OTG peripheral.`
tiny_usb: rename Kconfig name 1. Renamed Kconfig file of tinyusb (distinguish tinyusb stack from usb peripheral) 2. bugfix/typofix/doc update of tinyusb 2021-07-09 11:15:26 +08:00			`If your board doesn't have a USB connector connected to the USB-OTG dedicated GPIOs, you may have to DIY a cable and connect D+ and D- to the pins listed below.`

			```
refactor(usb/phy): Merge P4 and S2/S3 PHYs into one module P4 had separate PHY implementation for initial bring-up, now we can merge it with the original PHY driver. 2025-01-08 13:00:02 +01:00			`ESP BOARD USB CONNECTOR (type A)`
			`--`
			`\| \|\| VBUS (5V)`
			`[USB_DM] ------> \| \|\| D-`
			`[USB_DP] ------> \| \|\| D+`
			`\| \|\| GND`
			`--`
tiny_usb: rename Kconfig name 1. Renamed Kconfig file of tinyusb (distinguish tinyusb stack from usb peripheral) 2. bugfix/typofix/doc update of tinyusb 2021-07-09 11:15:26 +08:00			```

refactor(usb/phy): Merge P4 and S2/S3 PHYs into one module P4 had separate PHY implementation for initial bring-up, now we can merge it with the original PHY driver. 2025-01-08 13:00:02 +01:00			`### USB PHY pin mapping`

			`\| \| USB_DP \| USB_DM \|`
			`\| ------------ \| ------ \| ------ \|`
			`\| ESP32-S2/S3 \| GPIO20 \| GPIO19 \|`
			`\| ESP32-P4 2.0 \| pin 51 \| pin 50 \|`
			`\| ESP32-P4 1.1 \| GPIO27 \| GPIO26 \|`
docs(usb_host): Update usb_host example READMEs for P4 Closes https://github.com/espressif/esp-idf/issues/14578 Closes https://github.com/espressif/esp-idf/issues/12142 2024-10-29 12:01:11 +01:00
			`> Note: On the ESP32-P4, the USB 2.0 PHY pins are dedicated to USB-OTG functionality and cannot be used as general-purpose GPIOs.`