commit ec4e41902bdb7da5dec4ccf5fb3dc6eacf84a753
author Sylvio Alves <sylvio.alves@espressif.com> Fri Jul 09 00:59:48 2021 -0300
committer Christopher Friedt <chrisfriedt@gmail.com> Mon Aug 09 13:15:47 2021 -0400
tree 48b0e34acd4ee48d1d9610b15da211e04a9a9a01
parent beb739ff98d1ddb302efb605f088c6671cec0d26

doc: espressif: update espressif soc guidelines

Remove unnecessary path export for linux environment
Update serial port flashing information

Signed-off-by: Sylvio Alves <sylvio.alves@espressif.com>

boards/riscv/esp32c3_devkitm/doc/index.rst

diff --git a/boards/riscv/esp32c3_devkitm/doc/index.rst b/boards/riscv/esp32c3_devkitm/doc/index.rst
index 4cee3fc..f32dbcb 100644
--- a/boards/riscv/esp32c3_devkitm/doc/index.rst
+++ b/boards/riscv/esp32c3_devkitm/doc/index.rst
@@ -52,7 +52,6 @@
 
    export ZEPHYR_TOOLCHAIN_VARIANT="espressif"
    export ESPRESSIF_TOOLCHAIN_PATH="${HOME}/.espressif/tools/riscv32-esp-elf/1.24.0.123_64eb9ff-8.4.0/riscv32-esp-elf"
-   export PATH=$PATH:$ESPRESSIF_TOOLCHAIN_PATH/bin
 
 On Windows:
 
@@ -109,7 +108,9 @@
   --esp-idf-path ESP_IDF_PATH
                         path to ESP-IDF
   --esp-device ESP_DEVICE
-                        serial port to flash, default /dev/ttyUSB0
+                        serial port to flash, default $ESPTOOL_PORT if defined.
+                        If not, esptool will loop over available serial ports until
+                        it finds ESP32 device to flash.
   --esp-baud-rate ESP_BAUD_RATE
                         serial baud rate, default 921600
   --esp-flash-size ESP_FLASH_SIZE

boards/xtensa/esp32/doc/index.rst

diff --git a/boards/xtensa/esp32/doc/index.rst b/boards/xtensa/esp32/doc/index.rst
index 119edb2..87bbfa3 100644
--- a/boards/xtensa/esp32/doc/index.rst
+++ b/boards/xtensa/esp32/doc/index.rst
@@ -84,7 +84,6 @@
 
    export ZEPHYR_TOOLCHAIN_VARIANT="espressif"
    export ESPRESSIF_TOOLCHAIN_PATH="${HOME}/.espressif/tools/xtensa-esp32-elf/esp-2020r3-8.4.0/xtensa-esp32-elf"
-   export PATH=$PATH:$ESPRESSIF_TOOLCHAIN_PATH/bin
 
 On Windows:
 
@@ -143,7 +142,9 @@
   --esp-idf-path ESP_IDF_PATH
                         path to ESP-IDF
   --esp-device ESP_DEVICE
-                        serial port to flash, default /dev/ttyUSB0
+                        serial port to flash, default $ESPTOOL_PORT if defined.
+                        If not, esptool will loop over available serial ports until
+                        it finds ESP32 device to flash.
   --esp-baud-rate ESP_BAUD_RATE
                         serial baud rate, default 921600
   --esp-flash-size ESP_FLASH_SIZE

boards/xtensa/esp32s2_saola/doc/index.rst

diff --git a/boards/xtensa/esp32s2_saola/doc/index.rst b/boards/xtensa/esp32s2_saola/doc/index.rst
index 41d2294..000df28 100644
--- a/boards/xtensa/esp32s2_saola/doc/index.rst
+++ b/boards/xtensa/esp32s2_saola/doc/index.rst
@@ -57,10 +57,12 @@
    # on CMD:
    set ESPRESSIF_TOOLCHAIN_PATH=%USERPROFILE%\.espressif\tools\xtensa-esp32s2-elf\esp-2020r3-8.4.0\xtensa-esp32s2-elf
    set ZEPHYR_TOOLCHAIN_VARIANT=espressif
+   set PATH=%PATH%;%ESPRESSIF_TOOLCHAIN_PATH%\bin
 
    # on PowerShell
    $env:ESPRESSIF_TOOLCHAIN_PATH="$env:USERPROFILE\.espressif\tools\xtensa-esp32s2-elf\esp-2020r3-8.4.0\xtensa-esp32s2-elf"
    $env:ZEPHYR_TOOLCHAIN_VARIANT="espressif"
+   $env:Path += "$env:ESPRESSIF_TOOLCHAIN_PATH\bin"
 
 Finally, retrieve required submodules to build this port. This might take a while for the first time:
 
@@ -103,7 +105,9 @@
   --esp-idf-path ESP_IDF_PATH
                         path to ESP-IDF
   --esp-device ESP_DEVICE
-                        serial port to flash, default /dev/ttyUSB0
+                        serial port to flash, default $ESPTOOL_PORT if defined.
+                        If not, esptool will loop over available serial ports until
+                        it finds ESP32 device to flash.
   --esp-baud-rate ESP_BAUD_RATE
                         serial baud rate, default 921600
   --esp-flash-size ESP_FLASH_SIZE