boards/xtensa/esp32s3: New board WaveShare ESP32-S3-Touch-LCD-1.28 (WIP).

* New board name is esp32s3-ws-lcd128.
* Supports Kconfig delectable w/wo touch variants (gpios difference).
* Created board documentation.
* Supported configurations: nsh, ostest, coremark, touch-lvgl, notouch-lvgl,
  watchdog.
* Does not have touch panel driver yet.
* Work in progress.

Signed-off-by: Tomasz 'CeDeROM' CEDRO <tomek@cedro.info>

Author: cederom

Documentation/applications/examples/lvgldemo/index.rst

@@ -1,3 +1,5 @@
+.. _lvgldemo:
+
 ======================
 ``lvgldemo`` LVGL Demo
 ======================

Documentation/platforms/xtensa/esp32s3/boards/esp32s3-ws-lcd128/ESP32-S3-LCD-1.28-details-inter.jpg

@@ -0,0 +1,185 @@
+=================
+ESP32S3-WS-LCD128
+=================
+
+.. tags:: chip:esp32s3
+
+.. figure:: ESP32-S3-Touch-LCD-1.28.jpg 
+   :align: center
+
+This board definition is a starting point for development with 
+`ESP32-S3-LCD-1.28 <https://www.waveshare.com/esp32-s3-lcd-1.28.htm>`__ and
+`ESP32-S3-Touch-LCD-1.28 <https://www.waveshare.com/esp32-s3-touch-lcd-1.28.htm>`__
+which are low-cost ($16/$22) open-source hardware designed by
+`WaveShare <https://www.waveshare.com/>`_. High-performance Xtensa based
+ESP32-S3 MCU, small size, onboard round 1.28" LCD display, capacitive touch
+screen (Touch version only), Li-ion accumulator charge manager, 6-axis sensor
+(3-axis accelerometer and 3-axis gyroscope), and quick module attachmend
+1.27mm connectors (non-Touch version only), makes it a perfect candidate 
+for integration into your projects and products quickly.
+
+.. list-table::
+   :width: 100%
+   :class: borderless
+
+   * - .. figure:: ESP32-S3-LCD-1.28-details-intro.jpg
+          :target: https://www.waveshare.com/wiki/ESP32-S3-LCD-1.28
+          :align: center
+
+          ESP32-S3-LCD-1.28.
+
+     - .. figure:: ESP32-S3-Touch-LCD-1.28-details-intro.jpg
+          :target: https://www.waveshare.com/wiki/ESP32-S3-Touch-LCD-1.28
+          :align: center
+
+          ESP32-S3-Touch-LCD-1.28.
+
+These boards are almost identical. Touch version has touch screen,
+while non-Touch version has two connectors exposing more GPIOs at the bottom,
+thus slightly different signal routes. Because of that similarity, a single
+board definition is provided by NuttX, while features and configuration
+details are build time Kconfig selectable.
+
+Both boards are based on existing :ref:`esp32s3` chip implementation.
+WaveShare WIKI contians board details, generic examples, documentation, and
+schematics for the
+`ESP32-S3-LCD-1.28 <https://www.waveshare.com/wiki/ESP32-S3-LCD-1.28>`__ and
+`ESP32-S3-Touch-LCD-1.28 <https://www.waveshare.com/wiki/ESP32-S3-Touch-LCD-1.28>`__.
+
+.. note:: Implementation is experimental and still early stage of development!
+
+
+Features
+========
+
+  - ESP32-S3R2 Xtensa® 32-bit LX7 dual-core processor, up to 240MHz frequency.
+  - 2.4GHz Wi-Fi (802.11 b/g/n) and Bluetooth® 5 (BLE) with onboard antenna.
+  - Built in 512KB of SRAM and 384KB ROM, on-chip 2MB PSRAM, external 16MB
+    W25Q128JVSIQ NOR Flash memory.
+  - USB-C connector and CH343P USB-to-UART converter (flashing, console).
+  - Onboard GC9A01A controlled round 1.28" 240×240 resolution 65K color LCD.
+  - Onboard QMI8658 6-axis IMU (3-axis accelerometer and 3-axis gyroscope).
+  - Onboard 3.7V MX1.25 lithium battery re/discharge header, ETA6096 charger.
+  - Touch version:
+
+    - CST816S capacitive touch display controller.
+    - 6 × GPIO exposed over SH1.0 connector.
+
+  - Non-Touch version:
+
+    - 32 x GPIO exposed over 2 x 2x10 1.27mm female connectors.
+
+
+Pinouts
+=======
+
+  - ESP32-S3-LCD-1.28:
+
+    .. figure:: ESP32-S3-LCD-1.28-details-inter.jpg
+       :align: center
+
+  - ESP32-S3-Touch-LCD-1.28:
+
+     .. figure:: ESP32-S3-Touch-LCD-1.28-details-inter.jpg
+        :align: center
+
+Dimensions
+==========
+
+  - ESP32-S3-LCD-1.28:
+
+    .. figure:: ESP32-S3-LCD-1.28-details-size.jpg
+       :align: center
+
+  - ESP32-S3-Touch-LCD-1.28:
+
+     .. figure:: ESP32-S3-Touch-LCD-1.28-details-size-1.jpg
+        :align: center
+
+     .. figure:: ESP32-S3-Touch-LCD-1.28-details-size-2.jpg
+        :align: center
+
+
+Serial Console
+==============
+
+UART0 is by default used for the serial console. It connects to the on-board
+CH343P converter and is available on the USB-C connector that can be also used
+for firmware flashing.
+
+
+Buttons
+=======
+
+Board Buttons
+-------------
+
+There are two buttons labeled BOOT and RESET. The RESET button is not available
+to the software and can be used as manual hardware Reset trigger.
+The BOOT button is connected to IO0 and on reset / power-on it triggers the
+BootROM serial bootloader when pressed. After reset the BOOT button can be used
+as software input.
+
+
+Configurations
+==============
+
+All of the available configurations provide basic testing utilities or serve
+as an example starting point for your own projects.
+Use them by running the following commands::
+
+    $ ./tools/configure.sh esp32s3-ws-lcd128:<config_name>
+    $ make flash ESPTOOL_PORT=<serial_port_device> -j
+
+Notes:
+
+  - ``<config_name>`` is the name of board configuration you want to use
+    (i.e. nsh, lvgl). Then use a serial console terminal like ``cu`` or
+    ``minicom`` configured to 115200 8N1.
+  - ``<serial_port_device>`` is usually ``/dev/ttyUSB0`` or ``/dev/cuaU0``
+    depending on the OS you are using.
+  - On BSD systems use GNU Make (``gmake``) in place of ``make``.
+
+coremark
+--------
+
+Provides CoreMark benchmarking utility.
+
+notouch-lvgl
+------------
+
+This is a demonstration of the LVGL graphics library running on the NuttX's
+GC9A01A LCD driver. Demo will launch itself on boot and you should see it on
+the screen right away. This configuration uses the :ref:`lvgldemo` application.
+
+.. note:: This configuration has ``CONFIG_ARCH_BOARD_ESP32S3_WS_LCD128_NOTOUCH``
+          set. It selects LCD pins valid for the Non-Touch board variant.
+
+nsh
+---
+
+Basic NuttShell configuration (console enabled in UART0, exposed via
+USB connection by means of CH343P converter, at 115200 bps).
+
+
+ostest
+------
+
+Provides ``ostest`` NuttX self-test utility.
+
+touch-lvgl
+----------
+
+This is a demonstration of the LVGL graphics library running on the NuttX's
+GC9A01A LCD driver. Demo will launch itself on boot and you should see it on
+the screen right away. This configuration uses the :ref:`lvgldemo` application.
+
+.. note:: This configuration has ``CONFIG_ARCH_BOARD_ESP32S3_WS_LCD128_TOUCH``
+          set. It selects LCD pins valid for the Touch board variant.
+
+.. warning:: Touch screen driver is not yet implemented! Work in progress.
+
+watchdog
+--------
+
+Provides watchdog testing utilities.