This is an automated email from the ASF dual-hosted git repository.
xiaoxiang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit db1a14adac91528f89dcafb1cd93cdcb03458555
Author: wangjianyu3 <wangjian...@xiaomi.com>
AuthorDate: Thu Jun 19 19:34:59 2025 +0800
docs/esp32s3-devkit: update doc for fastboot
Update doc for fastboot USB and TCP network transport.
Signed-off-by: wangjianyu3 <wangjian...@xiaomi.com>
---
.../xtensa/esp32s3/boards/esp32s3-devkit/index.rst | 72 ++++++++++++++++++++--
1 file changed, 68 insertions(+), 4 deletions(-)
diff --git
a/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-devkit/index.rst
b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-devkit/index.rst
index 2db6dc4953..f32726bacf 100644
--- a/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-devkit/index.rst
+++ b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-devkit/index.rst
@@ -1038,8 +1038,8 @@ To test it, just run the following::
fastboot
--------
-The basic Fastboot configuration is based on esp32s3-devkit:usb_device.
-More details about usage of fastboot, please refer to `fastbootd — NuttX
latest documentation
<https://nuttx.apache.org/docs/latest/applications/system/fastboot/index.html>`_.
+| The Fastboot configuration is based on esp32s3-devkit:usb_device and
esp32s3-devkit:wifi, and support both **USB** and **TCP** network transport.
+| More details about usage of fastboot, please refer to `fastbootd — NuttX
latest documentation
<https://nuttx.apache.org/docs/latest/applications/system/fastboot/index.html>`_.
You can run the configuration and compilation procedure::
@@ -1052,15 +1052,37 @@ To test it, just run the following (**Default is host
side**):
sudo apt install fastboot
-2. List devices running fastboot::
+2. Specify a device / List devices:
+
+ List devices only supported for USB transport::
fastboot devices
- Example::
+ # Examples
$ fastboot devices
1234 fastboot
+ To specific a device, use "-s" option::
+
+ # Usage
+ #
+ # -s tcp:HOST[:PORT] Specify a TCP network device.
+ # -s SERIAL Specify a USB device.
+
+ fastboot -s SERIAL COMMAND
+ fastboot -s tcp:HOST[:PORT] COMMAND
+
+ # Examples
+
+ $ fastboot -s 1234 oem shell ifconfig
+ wlan0 Link encap:Ethernet HWaddr a0:85:e3:f4:43:30 at RUNNING mtu 1500
+ inet addr:192.168.211.111 DRaddr:192.168.211.107 Mask:255.255.255.0
+
+ PS C:\workspace> fastboot.exe -s tcp:192.168.211.111 oem shell ifconfig
+ wlan0 Link encap:Ethernet HWaddr a0:85:e3:f4:43:30 at RUNNING mtu 1500
+ inet addr:192.168.211.111 DRaddr:192.168.211.107 Mask:255.255.255.0
+
3. Display given variable::
fastboot getvar <NAME>
@@ -1117,3 +1139,45 @@ To test it, just run the following (**Default is host
side**):
0050: 44 ff c9 3b 55 51 93 b3 fb 1e 88 9e e9 2d 69 36 D..;UQ.......-i6
0060: 10 d0 70 27 92 91 32 25 f5 cc 1f 59 ea 39 31 24 ..p'..2%...Y.91$
0070: 3f 2e b0 fe ef 87 df 9b d4 7d 79 2e de 64 f6 ed ?........}y..d..
+
+fastboot_usb
+------------
+
+| The basic Fastboot configuration is based on esp32s3-devkit:usb_device and
support **USB** transport only.
+| More details about usage of fastboot, please refer to `fastbootd — NuttX
latest documentation
<https://nuttx.apache.org/docs/latest/applications/system/fastboot/index.html>`_.
+
+You can run the configuration and compilation procedure::
+
+ $ ./tools/configure.sh -l lckfb-szpi-esp32s3:fastboot_usb
+ $ make flash ESPTOOL_PORT=/dev/ttyACMx -j
+
+fastboot_tcp
+------------
+
+| The basic Fastboot configuration is based on esp32s3-devkit:wifi and support
**TCP** transport only.
+| More details about usage of fastboot, please refer to `fastbootd — NuttX
latest documentation
<https://nuttx.apache.org/docs/latest/applications/system/fastboot/index.html>`_.
+
+You can run the configuration and compilation procedure::
+
+ $ ./tools/configure.sh -l esp32s3-devkit:fastboot_tcp
+ $ make flash ESPTOOL_PORT=/dev/ttyACMx -j
+
+To test it, just run the following::
+
+ # Device side
+
+ nsh> wapi psk wlan0 mypasswd 3
+ nsh> wapi essid wlan0 myssid 1
+ nsh> renew wlan0
+
+ # Host side
+
+ PS C:\workspace> fastboot.exe -s tcp:HOST[:PORT] oem shell ls
+ /:
+ data/
+ dev/
+ etc/
+ proc/
+ var/
+ OKAY [ 0.063s]
+ Finished. Total time: 0.064s
