This is an automated email from the ASF dual-hosted git repository. acassis pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit f27c01214bb10ad12cf70a208d7f92e5e09e90bf Author: Alan Carvalho de Assis <[email protected]> AuthorDate: Sun Aug 16 12:11:53 2026 -0300 docs/esp32s3: Add documentation to ESP32S3-Touch-LCD-7 board This PR adds initial documentation to Waveshare ESP32S3-Touch-LCD-7 board. Signed-off-by: Alan C. Assis <[email protected]> --- .../esp32s3/boards/esp32s3-touch-lcd7/index.rst | 115 +++++++++++++++++++++ .../esp32s3-touch-lcd7/touch-lcd7-botton.png | Bin 0 -> 522240 bytes .../boards/esp32s3-touch-lcd7/touch-lcd7-top.png | Bin 0 -> 327316 bytes 3 files changed, 115 insertions(+) diff --git a/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-touch-lcd7/index.rst b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-touch-lcd7/index.rst new file mode 100644 index 00000000000..8d9231c79f7 --- /dev/null +++ b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-touch-lcd7/index.rst @@ -0,0 +1,115 @@ +================== +esp32s3-touch-lcd7 +================== + +.. tags:: chip:esp32, chip:esp32s3 + +This page discusses issues unique to NuttX configurations for the +ESP32S3-Touch-LCD-7 board. + +.. figure:: touch-lcd7-top.png + :align: center + +.. figure:: touch-lcd7-botton.png + :align: center + +The Waveshare ESP32-S3-Touch-LCD-7 is a feature rich board based on +ESP32-S3-WROOM-1 module. + +Features +======== + + - ESP32-S3-16R8 + - USB-to-UART bridge via micro USB port + - 8MB SPI FLASH + - 8MB PSRAM + - Onboard 7" LCD screen with 800 × 480 resolution, 65K colors + - Onboard CAN, RS485, I2C interfaces, TF card slot, and integrated full-speed USB + +Board documentation: https://docs.waveshare.com/ESP32-S3-Touch-LCD-7 + +BOARD LED +========= + +The board has three LEDs: POWER, CHARGE, DONE, but none programmable. + +BOARD BUTTONS +============== + +The board has 2 buttons: + + ======= ===== + BUTTON PINS + ======= ===== + RESET RST + BOOT IO0 + ======= ===== + +BOARD DISPLAY +=============== + + +The board has a 7-inch LCD: + + ========= ======== ========================= + ESP32-S3 LCD Description + ========= ======== ========================= + GPIO0 G3 Green data bit 3 + GPIO1 R3 Red data bit 3 + GPIO2 R4 Red data bit 4 + GPIO3 VSYNC Vertical sync signal + GPIO5 DE Data enable signal + GPIO7 PCLK Pixel clock signal + GPIO10 B7 Blue data bit 7 + GPIO14 B3 Blue data bit 3 + GPIO17 B6 Blue data bit 6 + GPIO18 B5 Blue data bit 5 + GPIO21 G7 Green data bit 7 + GPIO38 B4 Blue data bit 4 + GPIO39 G2 Green data bit 2 + GPIO40 R7 Red data bit 7 + GPIO41 R6 Red data bit 6 + GPIO42 R5 Red data bit 5 + GPIO45 G4 Green data bit 4 + GPIO46 HSYNC Horizontal sync signal + GPIO47 G6 Green data bit 6 + GPIO48 G5 Green data bit 5 + CH422G LCD - + EXIO2 DISP Backlight enable pin + ========= ======== ========================= + +Configurations +============== + +All of the configurations presented below can be tested by running the following commands: + +.. code-block:: console + + $ ./tools/configure.sh esp32s3-touch-lcd7:<config-name> + + Where <subdir> is one of the following: + +Configuration Directories +------------------------- + +usbnsh +------ + +Configures the NuttShell (nsh) located at apps/examples/nsh. This configuration enables a serial console over USB. + +After flashing and reboot your board you should see in your dmesg logs:: + + $ sudo dmesg | tail + [ 3315.687219] usb 3-1.1.1: new full-speed USB device number 10 using xhci_hcd + [ 3315.778666] usb 3-1.1.1: New USB device found, idVendor=0525, idProduct=a4a7, bcdDevice= 1.01 + [ 3315.778684] usb 3-1.1.1: New USB device strings: Mfr=1, Product=2, SerialNumber=3 + [ 3315.778689] usb 3-1.1.1: Product: CDC/ACM Serial + [ 3315.778694] usb 3-1.1.1: Manufacturer: NuttX + [ 3315.778697] usb 3-1.1.1: SerialNumber: 0 + [ 3315.829695] cdc_acm 3-1.1.1:1.0: ttyACM0: USB ACM device + [ 3315.829725] usbcore: registered new interface driver cdc_acm + [ 3315.829727] cdc_acm: USB Abstract Control Model driver for USB modems and ISDN adapters + + +You may need to press ENTER 3 times before the NSH show up. + diff --git a/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-touch-lcd7/touch-lcd7-botton.png b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-touch-lcd7/touch-lcd7-botton.png new file mode 100644 index 00000000000..7944a76f2dc Binary files /dev/null and b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-touch-lcd7/touch-lcd7-botton.png differ diff --git a/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-touch-lcd7/touch-lcd7-top.png b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-touch-lcd7/touch-lcd7-top.png new file mode 100644 index 00000000000..b041530e7a8 Binary files /dev/null and b/Documentation/platforms/xtensa/esp32s3/boards/esp32s3-touch-lcd7/touch-lcd7-top.png differ
