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)
                          --
                         | || VCC
[USBPHY_DM_NUM]  ------> | || D-
[USBPHY_DP_NUM]  ------> | || D+
                         | || GND
                          --
```
Refer to `soc/usb_pins.h` to find the real GPIO number of **USBPHY_DP_NUM** and **USBPHY_DM_NUM**.

|             | USB_DP | USB_DM |
| ----------- | ------ | ------ |
| ESP32-S2/S3 | GPIO20 | GPIO19 |
| ESP32-P4    | pin 51 | pin 50 |

> 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.`

			```
			`ESP BOARD USB CONNECTOR (type A)`
			`--`
			`\| \|\| VCC`
			`[USBPHY_DM_NUM] ------> \| \|\| D-`
			`[USBPHY_DP_NUM] ------> \| \|\| D+`
			`\| \|\| GND`
			`--`
			```
			Refer to `soc/usb_pins.h` to find the real GPIO number of USBPHY_DP_NUM and USBPHY_DM_NUM.

			`\| \| USB_DP \| USB_DM \|`
			`\| ----------- \| ------ \| ------ \|`
			`\| ESP32-S2/S3 \| GPIO20 \| GPIO19 \|`
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			`\| ESP32-P4 \| pin 51 \| pin 50 \|`

			`> 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.`