diff --git a/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-eye/index.rst b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-eye/index.rst index 8858b4fc20..baf528c791 100644 --- a/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-eye/index.rst +++ b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-eye/index.rst @@ -40,6 +40,45 @@ nsh Basic NuttShell configuration (console enabled in USB JTAG SERIAL Device, exposed via USB connection at 9600 bps). +usbnsh +------ + +Basic NuttShell configuration console enabled over USB Device (USB CDC/ACM). + +Before using this configuration, please confirm that your computer detected +that USB JTAG/serial interface used to flash the board:: + + usb 3-5.2.3: New USB device strings: Mfr=1, Product=2, SerialNumber=3 + usb 3-5.2.3: Product: USB JTAG/serial debug unit + usb 3-5.2.3: Manufacturer: Espressif + usb 3-5.2.3: SerialNumber: XX:XX:XX:XX:XX:XX + cdc_acm 3-5.2.3:1.0: ttyACM0: USB ACM device + +Then you can run the configuration and compilation procedure:: + + $ ./tools/configure.sh esp32s3-eye:usbnsh + $ make flash ESPTOOL_PORT=/dev/ttyACM0 -j8 + +Then run the minicom configured to /dev/ttyACM0 115200 8n1 and +press three times to force the nsh to show up:: + + NuttShell (NSH) NuttX-12.1.0 + nsh> ? + help usage: help [-v] [] + + . break dd exit ls ps source umount + [ cat df false mkdir pwd test unset + ? cd dmesg free mkrd rm time uptime + alias cp echo help mount rmdir true usleep + unalias cmp env hexdump mv set truncate xd + basename dirname exec kill printf sleep uname + + Builtin Apps: + nsh sh + nsh> uname -a + NuttX 12.1.0 38a73cd970 Jun 18 2023 16:58:46 xtensa esp32s3-eye + nsh> + Flashing ======== diff --git a/boards/xtensa/esp32s3/esp32s3-eye/configs/usbnsh/defconfig b/boards/xtensa/esp32s3/esp32s3-eye/configs/usbnsh/defconfig new file mode 100644 index 0000000000..143de3f708 --- /dev/null +++ b/boards/xtensa/esp32s3/esp32s3-eye/configs/usbnsh/defconfig @@ -0,0 +1,50 @@ +# +# This file is autogenerated: PLEASE DO NOT EDIT IT. +# +# You can use "make menuconfig" to make any modifications to the installed .config file. +# You can then do "make savedefconfig" to generate a new defconfig file that includes your +# modifications. +# +# CONFIG_ARCH_LEDS is not set +# CONFIG_NSH_ARGCAT is not set +# CONFIG_NSH_CMDOPT_HEXDUMP is not set +CONFIG_ARCH="xtensa" +CONFIG_ARCH_BOARD="esp32s3-eye" +CONFIG_ARCH_BOARD_COMMON=y +CONFIG_ARCH_BOARD_ESP32S3_EYE=y +CONFIG_ARCH_CHIP="esp32s3" +CONFIG_ARCH_CHIP_ESP32S3=y +CONFIG_ARCH_CHIP_ESP32S3WROOM1=y +CONFIG_ARCH_INTERRUPTSTACK=2048 +CONFIG_ARCH_STACKDUMP=y +CONFIG_ARCH_XTENSA=y +CONFIG_BOARDCTL_USBDEVCTRL=y +CONFIG_BOARD_LOOPSPERMSEC=16717 +CONFIG_BUILTIN=y +CONFIG_CDCACM=y +CONFIG_CDCACM_CONSOLE=y +CONFIG_DEBUG_FULLOPT=y +CONFIG_DEBUG_SYMBOLS=y +CONFIG_DEV_ZERO=y +CONFIG_ESP32S3_GPIO_IRQ=y +CONFIG_ESP32S3_OTG=y +CONFIG_ESP32S3_UART0=y +CONFIG_FS_PROCFS=y +CONFIG_IDLETHREAD_STACKSIZE=3072 +CONFIG_INIT_ENTRYPOINT="nsh_main" +CONFIG_INTELHEX_BINARY=y +CONFIG_NSH_ARCHINIT=y +CONFIG_NSH_BUILTIN_APPS=y +CONFIG_NSH_FILEIOSIZE=512 +CONFIG_NSH_LINELEN=64 +CONFIG_NSH_READLINE=y +CONFIG_PREALLOC_TIMERS=4 +CONFIG_RAM_SIZE=114688 +CONFIG_RAM_START=0x20000000 +CONFIG_RR_INTERVAL=200 +CONFIG_SCHED_WAITPID=y +CONFIG_START_DAY=6 +CONFIG_START_MONTH=12 +CONFIG_START_YEAR=2011 +CONFIG_SYSLOG_BUFFER=y +CONFIG_SYSTEM_NSH=y