|
|
@ -1,4 +1,4 @@ |
|
|
|
.. zephyr:board:: esp32_devkitc_wrover |
|
|
|
.. zephyr:board:: esp32_devkitc |
|
|
|
|
|
|
|
|
|
|
|
Overview |
|
|
|
Overview |
|
|
|
******** |
|
|
|
******** |
|
|
@ -8,7 +8,7 @@ with integrated Wi-Fi & dual-mode Bluetooth. The ESP32 series employs a |
|
|
|
Tensilica Xtensa LX6 microprocessor in both dual-core and single-core |
|
|
|
Tensilica Xtensa LX6 microprocessor in both dual-core and single-core |
|
|
|
variations. ESP32 is created and developed by Espressif Systems, a |
|
|
|
variations. ESP32 is created and developed by Espressif Systems, a |
|
|
|
Shanghai-based Chinese company, and is manufactured by TSMC using their 40nm |
|
|
|
Shanghai-based Chinese company, and is manufactured by TSMC using their 40nm |
|
|
|
process. For more information, check `ESP32-DevKitC-WROVER`_. |
|
|
|
process. For more information, check `ESP32-DevKitC`_. |
|
|
|
|
|
|
|
|
|
|
|
The features include the following: |
|
|
|
The features include the following: |
|
|
|
|
|
|
|
|
|
|
@ -115,7 +115,7 @@ To build the sample application using sysbuild use the command: |
|
|
|
.. zephyr-app-commands:: |
|
|
|
.. zephyr-app-commands:: |
|
|
|
:tool: west |
|
|
|
:tool: west |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:board: esp32_devkitc_wrover |
|
|
|
:board: esp32_devkitc |
|
|
|
:goals: build |
|
|
|
:goals: build |
|
|
|
:west-args: --sysbuild |
|
|
|
:west-args: --sysbuild |
|
|
|
:compact: |
|
|
|
:compact: |
|
|
@ -164,16 +164,16 @@ Build and flash applications as usual (see :ref:`build_an_application` and |
|
|
|
|
|
|
|
|
|
|
|
.. zephyr-app-commands:: |
|
|
|
.. zephyr-app-commands:: |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:board: esp32_devkitc_wrover/esp32/procpu |
|
|
|
:board: esp32_devkitc/esp32/procpu |
|
|
|
:goals: build |
|
|
|
:goals: build |
|
|
|
|
|
|
|
|
|
|
|
The usual ``flash`` target will work with the ``esp32_devkitc_wrover`` board |
|
|
|
The usual ``flash`` target will work with the ``esp32_devkitc`` board |
|
|
|
configuration. Here is an example for the :zephyr:code-sample:`hello_world` |
|
|
|
configuration. Here is an example for the :zephyr:code-sample:`hello_world` |
|
|
|
application. |
|
|
|
application. |
|
|
|
|
|
|
|
|
|
|
|
.. zephyr-app-commands:: |
|
|
|
.. zephyr-app-commands:: |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:board: esp32_devkitc_wrover/esp32/procpu |
|
|
|
:board: esp32_devkitc/esp32/procpu |
|
|
|
:goals: flash |
|
|
|
:goals: flash |
|
|
|
|
|
|
|
|
|
|
|
Open the serial monitor using the following command: |
|
|
|
Open the serial monitor using the following command: |
|
|
@ -188,14 +188,14 @@ message in the monitor: |
|
|
|
.. code-block:: console |
|
|
|
.. code-block:: console |
|
|
|
|
|
|
|
|
|
|
|
***** Booting Zephyr OS vx.x.x-xxx-gxxxxxxxxxxxx ***** |
|
|
|
***** Booting Zephyr OS vx.x.x-xxx-gxxxxxxxxxxxx ***** |
|
|
|
Hello World! esp32_devkitc_wrover |
|
|
|
Hello World! esp32_devkitc |
|
|
|
|
|
|
|
|
|
|
|
Debugging |
|
|
|
Debugging |
|
|
|
********* |
|
|
|
********* |
|
|
|
|
|
|
|
|
|
|
|
ESP32 support on OpenOCD is available at `OpenOCD ESP32`_. |
|
|
|
ESP32 support on OpenOCD is available at `OpenOCD ESP32`_. |
|
|
|
|
|
|
|
|
|
|
|
On the ESP32-DevKitC-WROVER board, the JTAG pins are not run to a |
|
|
|
On the ESP32-DevKitC board, the JTAG pins are not run to a |
|
|
|
standard connector (e.g. ARM 20-pin) and need to be manually connected |
|
|
|
standard connector (e.g. ARM 20-pin) and need to be manually connected |
|
|
|
to the external programmer (e.g. a Flyswatter2): |
|
|
|
to the external programmer (e.g. a Flyswatter2): |
|
|
|
|
|
|
|
|
|
|
@ -223,14 +223,14 @@ Here is an example for building the :zephyr:code-sample:`hello_world` applicatio |
|
|
|
|
|
|
|
|
|
|
|
.. zephyr-app-commands:: |
|
|
|
.. zephyr-app-commands:: |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:board: esp32_devkitc_wrover/esp32/procpu |
|
|
|
:board: esp32_devkitc/esp32/procpu |
|
|
|
:goals: build flash |
|
|
|
:goals: build flash |
|
|
|
|
|
|
|
|
|
|
|
You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application. |
|
|
|
You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application. |
|
|
|
|
|
|
|
|
|
|
|
.. zephyr-app-commands:: |
|
|
|
.. zephyr-app-commands:: |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:zephyr-app: samples/hello_world |
|
|
|
:board: esp32_devkitc_wrover/esp32/procpu |
|
|
|
:board: esp32_devkitc/esp32/procpu |
|
|
|
:goals: debug |
|
|
|
:goals: debug |
|
|
|
|
|
|
|
|
|
|
|
Note on Debugging with GDB Stub |
|
|
|
Note on Debugging with GDB Stub |
|
|
@ -249,7 +249,7 @@ References |
|
|
|
|
|
|
|
|
|
|
|
.. target-notes:: |
|
|
|
.. target-notes:: |
|
|
|
|
|
|
|
|
|
|
|
.. _`ESP32-DevKitC-WROVER`: https://docs.espressif.com/projects/esp-idf/en/stable/esp32/hw-reference/esp32/get-started-devkitc.html# |
|
|
|
.. _`ESP32-DevKitC`: https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32/esp32-devkitc/index.html |
|
|
|
.. _`ESP32 Datasheet`: https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf |
|
|
|
.. _`ESP32 Datasheet`: https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf |
|
|
|
.. _`ESP32 Technical Reference Manual`: https://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf |
|
|
|
.. _`ESP32 Technical Reference Manual`: https://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf |
|
|
|
.. _`JTAG debugging for ESP32`: https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/jtag-debugging/index.html |
|
|
|
.. _`JTAG debugging for ESP32`: https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/jtag-debugging/index.html |