add s3 board

wemos · Aug 14, 2022 · 242061e · 242061e
1 parent e79d5b5
commit 242061e
Show file tree

Hide file tree

Showing 12 changed files with 176 additions and 1 deletion.
diff --git a/docs/en/_static/boards/s3_v1.0.0_1_16x16.jpg b/docs/en/_static/boards/s3_v1.0.0_1_16x16.jpg
diff --git a/docs/en/_static/boards/s3_v1.0.0_2_16x16.jpg b/docs/en/_static/boards/s3_v1.0.0_2_16x16.jpg
diff --git a/docs/en/_static/boards/s3_v1.0.0_4_16x9.jpg b/docs/en/_static/boards/s3_v1.0.0_4_16x9.jpg
diff --git a/docs/en/_static/files/dim_s3_v1.0.0.pdf b/docs/en/_static/files/dim_s3_v1.0.0.pdf
diff --git a/docs/en/_static/files/sch_s3_v1.0.0.pdf b/docs/en/_static/files/sch_s3_v1.0.0.pdf
diff --git a/docs/en/index.rst b/docs/en/index.rst
@@ -11,6 +11,7 @@ HOME
    S2 <s2/index>
    C3 <c3/index>
    W600 <w600/index>
+   S3 <s3/index>
 
 .. toctree::
    :hidden:
@@ -33,8 +34,14 @@ Boards
 |D1_MINI_IMG|_      |D32_PRO_IMG|_      |SHT30_IMG|_  
 `S2`_               `C3`_               `W600`_  
 |S2_MINI_IMG|_      |C3_MINI_IMG|_      |W600_PICO_IMG|_ 
+`S3`_ 
+|S3_IMG|_  
 =================== =================== ===================
 
+.. _S3: ./s3/index.html
+.. |S3_IMG| image:: ./_static/boards/s3_v1.0.0_1_16x16.jpg
+.. _S3_IMG: ./s3/index.html
+
 .. _C3: ./c3/index.html
 .. |C3_MINI_IMG| image:: ./_static/boards/c3_mini_v1.0.0_1_16x16.jpg
 .. _C3_MINI_IMG: ./c3/index.html

diff --git a/docs/en/s3/index.rst b/docs/en/s3/index.rst
@@ -0,0 +1,26 @@
+S3 Boards
+===================
+
+.. toctree::
+   :maxdepth: 1
+   :hidden:
+
+   S3 <s3>
+
+
+
+==================  ================== 
+ **S3**            
+ |S3_IMG|_             
+==================  ==================
+
+.. |S3_IMG| image:: ../_static/boards/s3_v1.0.0_1_16x16.jpg
+.. _S3_IMG: ./s3.html
+
+
+
+
+
+
+
+
diff --git a/docs/en/s3/s3.rst b/docs/en/s3/s3.rst
@@ -0,0 +1,69 @@
+S3
+================
+
+==================  ==================  
+ |TOP_IMG|_           |BOTTOM_IMG|_  
+==================  ==================
+
+.. |TOP_IMG| image:: ../_static/boards/s3_v1.0.0_1_16x16.jpg
+.. _TOP_IMG: ../_static/boards/s3_v1.0.0_1_16x16.jpg
+
+.. |BOTTOM_IMG| image:: ../_static/boards/s3_v1.0.0_2_16x16.jpg
+.. _BOTTOM_IMG: ../_static/boards/s3_v1.0.0_2_16x16.jpg
+
+WiFi & Bluetooth 5 (LE) boards based ESP32-S3-WROOM-1. 
+`[Buy it]`_
+
+.. _[Buy it]: https://www.aliexpress.com/item/1005003145192016.html
+
+Features
+------------------
+* based ESP32-S3-WROOM-1
+* 2x Type-C USB (OTG, UART)
+* 16MB Flash (Quad SPI)
+* 8MB PSRAM (Octal SPI)
+* 31x IO
+* 1x LOLIN I2C Port
+* ADC, DAC, I2C, SPI, UART, USB OTG
+* Compatible with MicroPython, Arduino and ESP-IDF
+* Default firmware: MicroPython
+
+Tutorials
+----------------------
+
+* :doc:`../tutorials/s3/get_started_with_micropython_s3`
+* :doc:`../tutorials/s3/get_started_with_arduino_s3`
+
+Documentation
+----------------------
+
+* `Schematic V1.0.0[PDF] <../_static/files/sch_s3_v1.0.0.pdf>`_
+* `Dimension V1.0.0[PDF] <../_static/files/dim_s3_v1.0.0.pdf>`_
+* `ESP32-S3-WROOM-1 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s3-wroom-1_wroom-1u_datasheet_en.pdf>`_
+
+
+Technical specs
+----------------------
+
++----------------------+------------+
+| Operating Voltage    | 3.3V       |
++----------------------+------------+
+| Digital I/O Pins     | 31         |
++----------------------+------------+
+| Clock Speed          | 240MHz     |
++----------------------+------------+
+| Flash                | 16M Bytes  |
++----------------------+------------+
+| PSRAM                | 8M Bytes   |
++----------------------+------------+
+| Size                 | 65.3*25.4mm|
++----------------------+------------+
+| Weight               | 9.0g       |
++----------------------+------------+
+
+Pin
+----------------------
+
+.. image:: ../_static/boards/s3_v1.0.0_4_16x9.jpg
+   :target: ../_static/boards/s3_v1.0.0_4_16x9.jpg
+
diff --git a/docs/en/tutorials/index_arduino.rst b/docs/en/tutorials/index_arduino.rst
@@ -8,7 +8,7 @@ Arduino Tutorials
    Get started with Arduino [D32 series] <d32/get_started_with_arduino_d32>
    Get started with Arduino [S2 series] <s2/get_started_with_arduino_s2>
    Get started with Arduino [C3 series] <c3/get_started_with_arduino_c3>
-
+   Get started with Arduino [S3 series] <s3/get_started_with_arduino_s3>
 
 
 

diff --git a/docs/en/tutorials/index_micropython.rst b/docs/en/tutorials/index_micropython.rst
@@ -8,6 +8,7 @@ MicroPython Tutorials
    Get started with MicroPython [D32 series] <d32/get_started_with_micropython_d32>
    Get started with MicroPython [S2 series] <s2/get_started_with_micropython_s2>
    Get started with MicroPython [C3 series] <c3/get_started_with_micropython_c3>
+   Get started with MicroPython [S3 series] <s3/get_started_with_micropython_s3>
    Get started with MicroPython [W600 series] <w600/get_started_with_micropython_w600>
 
 

diff --git a/docs/en/tutorials/s3/get_started_with_arduino_s3.rst b/docs/en/tutorials/s3/get_started_with_arduino_s3.rst
@@ -0,0 +1,19 @@
+Get started with Arduino [S3 series]
+==================================================
+
+Requirements
+---------------
+  * `Python <https://www.python.org/downloads/>`_
+  * `Arduino IDE <https://www.arduino.cc/>`_
+  * :doc:`../../ch340_driver`
+
+Installing Hardware package
+-----------------------------
+  * `esp32 arduino package <https://github.com/espressif/arduino-esp32>`_ 
+
+
+Configure Board
+-------------------
+  * Use lastest `esp32 arduino package`_ 
+  * Choose board **LOLIN S3**
+
diff --git a/docs/en/tutorials/s3/get_started_with_micropython_s3.rst b/docs/en/tutorials/s3/get_started_with_micropython_s3.rst
@@ -0,0 +1,53 @@
+Get started with MicroPython [S3 series]
+=======================================================
+
+Flash MicroPython firmware
+----------------------------
+
+The boards were already flashed micropython firmware.
+If they lost firmware or you need lastest firmware, 
+you can flash MicroPython firmware by yourself.
+
+Requirements
+---------------
+
+* :doc:`../../ch340_driver`
+* `Python <https://www.python.org/downloads/>`_
+* `esptool <https://github.com/espressif/esptool>`_ 
+
+.. highlight:: bash
+
+::
+
+      pip install esptool
+      
+S3 Firmware
+------------------
+
+* `S3 Firmware <https://micropython.org/download/>`_
+
+
+
+
+* Flash using esptool.py
+
+  .. highlight:: bash
+
+  ::
+
+    esptool.py --port PORT_NAME erase_flash
+    esptool.py --port PORT_NAME --baud 1000000 write_flash -z 0 FIRMWARE.bin
+
+.. note::  
+  Don't forget to change **PORT_NAME** and **FIRMWARE.bin**.
+
+  In Linux, **PORT_NAME** is like /dev/ttyUSB0.
+  In windows, **PORT_NAME** is like COM4.
+
+
+Quick reference
+-------------------------
+* `Quick reference for the ESP32 <https://docs.micropython.org/en/latest/esp32/quickref.html>`_
+
+
+