From 653bbdedec6a15e29f2f828a7f5794f677a7a193 Mon Sep 17 00:00:00 2001 From: Matias N Date: Sat, 20 Mar 2021 14:39:39 -0300 Subject: [PATCH] Documentation: add ESP32 and DevKitC docs --- .../esp32-devkitc/esp32-core-board-v2.jpg | Bin 0 -> 48460 bytes .../esp32-devkitc/esp32-devkitc-v4-front.jpg | Bin 0 -> 45574 bytes .../esp32/boards/esp32-devkitc/index.rst | 52 ++++++++++++++ .../platforms/xtensa/esp32/index.rst | 68 +++++++++++++++++- NOTICE | 2 + 5 files changed, 120 insertions(+), 2 deletions(-) create mode 100644 Documentation/platforms/xtensa/esp32/boards/esp32-devkitc/esp32-core-board-v2.jpg create mode 100644 Documentation/platforms/xtensa/esp32/boards/esp32-devkitc/esp32-devkitc-v4-front.jpg create mode 100644 Documentation/platforms/xtensa/esp32/boards/esp32-devkitc/index.rst diff --git a/Documentation/platforms/xtensa/esp32/boards/esp32-devkitc/esp32-core-board-v2.jpg b/Documentation/platforms/xtensa/esp32/boards/esp32-devkitc/esp32-core-board-v2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..7548f35a41590f1fcc6523f1d2e4e8dd6dac4e96 GIT binary patch literal 48460 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 literal 0 HcmV?d00001 diff --git a/Documentation/platforms/xtensa/esp32/boards/esp32-devkitc/esp32-devkitc-v4-front.jpg b/Documentation/platforms/xtensa/esp32/boards/esp32-devkitc/esp32-devkitc-v4-front.jpg new file mode 100644 index 0000000000000000000000000000000000000000..04fb7391d66c6d7b34a0a0828877bb7b16c566c6 GIT binary patch literal 45574 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 is a development board for the ESP32 SoC from Espressif, based on a ESP-WROOM-32 module. You can find the original V2 version and the newer V4 variant. They are +pin compatible. + +.. list-table:: + :align: center + + * - .. figure:: esp32-core-board-v2.jpg + :align: center + + ESP32 DevKitC/Core V2 + + - .. figure:: esp32-devkitc-v4-front.jpg + :align: center + + ESP32 DevKitC V4 + +Features +======== + + - ESP32 WROOM Module + - USB-to-UART bridge via micro USB port + - Power LED + - EN and BOOT buttons (BOOT accessible to user) + - SPI FLASH (size varies according to model + +Pin Mapping +=========== + +.. todo:: To be updated + +===== ========== ========== +Pin Signal Notes +===== ========== ========== +? ? ? +===== ========== ========== + +Configurations +============== + +nsh +--- + +Basic NuttShell configuration (console enabled in UART0, exposed via USB connection, at 115200 bps). + +wapi +---- + +Enables WiFi support diff --git a/Documentation/platforms/xtensa/esp32/index.rst b/Documentation/platforms/xtensa/esp32/index.rst index c6ccd60718..71d78d0e37 100644 --- a/Documentation/platforms/xtensa/esp32/index.rst +++ b/Documentation/platforms/xtensa/esp32/index.rst @@ -2,13 +2,77 @@ Espressif ESP32 =============== +ESP32 series of SoCs from Espressif are single and dual-core chips based on +Xtensa architecture, with support for Bluetooth and WiFi. + Toolchain ========= -OpenOCD -------- +You can use the prebuilt `compiler `__ for Xtensa architecture and `OpenOCD `__ for ESP32 by Espressif. For flashing firmware, you will need to install ``esptool.py`` by running:: + + pip install esptool + + +Flashing +======== + +Firmware for ESP32 is flashed via the USB/UART interface using the ``esptool.py`` tool. To flash your NuttX firmware simply run:: + + make download ESPTOOL_PORT= + +where ```` is typically ``/dev/ttyUSB0`` or similar. You can change the baudrate by passing ``ESPTOOL_BAUD``. + +Bootloader and partitions +------------------------- + +ESP32 requires a bootloader to be flashed as well as a set of FLASH partitions. This is only needed the first time +(or any time you which to modify either of these). An easy way is to use prebuilt binaries for NuttX from `here `_. In there you will find instructions to rebuild these if necessary. +Once you downloaded both binaries, you can flash them by adding an ``ESPTOOL_BINDIR`` parameter, pointing to the directiry where these binaries were downloaded:: + + make download ESPTOOL_PORT= ESPTOOL_BINDIR= + +.. note:: It is recommended that if this is the first time you are using the board with NuttX that you perform a complete + SPI FLASH erase:: + + esptool.py erase_flash Peripheral Support ================== +.. todo:: To be updated +========== ======= ===== +Peripheral Support NOTES +========== ======= ===== +? ? ? +========== ======= ===== + +WiFi +==== + +A standard network interface will be configured and can be initialized such as:: + + ifup wlan0 + wapi psk wlan0 mypasswd 1 + wapi essid wlan0 myssid 1 + renew wlan0 + +In this case a connection to AP with SSID ``myssid`` is done, using ``mypasswd`` as +password. IP address is obtained via DHCP using ``renew`` command. You can check +the result by running ``ifconfig`` afterwards. + +.. tip:: Boards usually expose a ``wapi`` defconfig which enables WiFi + +Bluetooth +========= + +Bluetooth is not currently supported. + +Supported Boards +================ + +.. toctree:: + :glob: + :maxdepth: 1 + + boards/*/* diff --git a/NOTICE b/NOTICE index 1e0440be5e..56d89a1e54 100644 --- a/NOTICE +++ b/NOTICE @@ -65,3 +65,5 @@ Documentation - nRF52832-MDK board pinout image is obtained from MakerDiary GitHub repository, under the terms of the MIT license, Copyright (c) 2019 makerdiary.com - Sparkfun nRF52832 breakout board image is licensed under CC-BY 2.0 terms +- Espressif ESP32 DevKitC images are licensed under the terms of Apache 2.0, + Copyright (C) 2015-2019 Espressif Systems