Update devboard_as_flasher.rst to additionally include ESP32 S series (#4523)

This commit is contained in:
Shivam Maurya 2024-12-21 04:49:11 +05:30 committed by GitHub
parent c6c0c3e971
commit 85a290f543
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -3,7 +3,8 @@ Using an ESP devboard as a USB-UART bridge
.. _devboard-as-flasher:
ESP development boards usually have an onboard USB interface, either built into the chip (e.g. ESP32-S3) or via an onboard USB-UART bridge chip.
ESP development boards usually have an onboard USB interface,
either built into the chip (e.g. ESP32-S Series) or via an onboard USB-UART bridge chip.
However some ESP based devices not designed for development work don't bother with this,
and only expose the UART0 pins (TX and RX) for flashing purposes.
@ -16,7 +17,8 @@ and will not change anything already flashed onto it - it's purely a way to use
We will refer to the devboard with functional USB_UART bridge chip as flasher board for this guide.
Make sure you've read the :doc:`/guides/physical_device_connection` for properly understanding the functionality of your flasher devboard.
Make sure you've read the :doc:`/guides/physical_device_connection`
for properly understanding the functionality of your flasher devboard.
.. figure:: /guides/images/devboard-as-flasher.png
:align: center
@ -28,7 +30,7 @@ You need to make the following electrical connections:
.. note::
- Most ESP32 S and C series boards do *not* have a separate USB-UART chip - they have it built into the ESP - so are not suitable for this application.
- Most ESP32 S and C series devboards do *not* have a separate USB-UART chip - they have it built into the ESP. See below for instructions regarding ESP32-S series.
- The 5V connection on either board may be labelled either ``5V`` or ``VIN``. Some boards may not have a 5V connection and will require 3.3V only.
- Rather than powering the target board from the flasher board, it is also possible to use a separate power supply, just make sure all the ground pins are connected together.
@ -48,3 +50,35 @@ the ESP chip on flasher module from booting and polluting the serial lines.
- Do not connect 3V3 to VIN of the target devices with a 3V3 LDO as it may lead to brownouts.
Once the connections are made, plug the flasher board into your computer via USB and proceed with flashing the target board via whichever means you intend to use.
Making an ESP32-S Series devboard act like a USB-UART bridge
------------------------------------------------------------
.. _esp32s-usb-uart-bridge:
Users with ESP32-S2/S3 devboards can have a look at https://github.com/espressif/esp-usb-bridge instead.
But be warned, it demands flashing your S2/S3 board using ESP-IDF to act like a USB_UART bridge first.
In the SDKconfig, make sure to verify the GPIO pins for the TxD/RxD signals.
The connections needed to flash a target device using an ESP32-S devboard are:
- ``VU/VUSB/5V`` or ``3V3`` on the flasher devboard to ``VIN`` or ``3V3`` respectively of the target device
- ``GND``, or ground of flasher devboard to ``GND`` of the target device
- ``TxD`` of flasher devboard to ``RX`` of the target device
- ``RxD`` of flasher devboard to ``TX`` of the target device
Because we are using the internal UART of the ESP the TX and RX lines should be crossed.
This is in contrast to the aforementioned devboards with external USB_UART bridge chip.
.. note::
Because we have made our ESP32-S Series board act like a USB_UART bridge,
flashing another binary on it won't work because the exposed COM port corresponds to the USB_UART bridge.
For that, you need to first manually put it into DOWNLOAD mode.
(by holding RESET and tapping BOOT button)
See Also
--------
- :doc:`Guides </guides/index>`
- :ghedit:`Edit`