T-Display-S3 User Guide Version 1.
About This Guide This document is intended to help users set up the basic software development environment for developing applications using hardware based on the T-Display. Through a simple example, this document illustrates how to use Arduino, including the menu based configuration wizard, compiling the Arduino and firmware download to the ESP32-S3 module. Release Notes Date Version Release notes 2022.11 V1.0 First release.
Table of Contents 1. Introduction............................................................................................................................. 1 1.1. T-Display-S3 .........................................................................................................................1 1.2. Arduino .....................................................................................................................................1 1.3. Preparation ...........................................
1. Introduction ! 1. Introduction 1.1. T-Display-S3 T-Display-S3 is a development board. It can work independently. It consists of ESP32-S3 MCU supporting Wi-Fi + BLE communication protocol and motherboard PCB. The screen is 1.9 inch IPS LCD ST7789V. At the core of this module is the ESP32S3R8 chip. ESP32-S3 integrates Wi-Fi (2.4 GHz band) and Bluetooth 5.0(LE) solutions on a single chip, along with dual high performance cores and many other versatile peripherals.
2. Get Started ! 2. Get Started 2.1. Download the Arduino Software The quickest how to install the Arduino Software (IDE) on Windows machines 2.1.1. Quick Start Guide The website provides a quick start tutorial • Windows: https://www.arduino.cc/en/Guide/Windows • Linux: https://www.arduino.cc/en/Guide/Linux • Mac OS X: https://www.arduino.cc/en/Guide/MacOSX 2.1.2.
! 2. Get Started 2.2. Install the Arduino Software Wait for installation Xinyuan ! /12 3 2022.
3. Start a Project ! Configure 3. 3.1. Download Git Download the installation package Git.exe 3.2. Pre-build configuration Click Arduino icon, then right click and select ``Open folder where `` Select hardware -> Mouse ** Right click ** -> Click Git Bash Here 3.3. Cloning a remote repository $ mkdir espressif $ cd espressif $ git clone --recursive https://github.com/espressif/arduino-esp32.git esp32 Xinyuan ! /12 4 2022.
4. Connect ! 4. Connect You are almost there. To be able to proceed further, connect ESP32-S3 board to PC, check under what serial port the board is visible and verify if serial communication works. Xinyuan ! /12 5 2022.
4. Configure ! Test Demo 5. Select File>>Example>>WiFi>>WiFiScan ! Xinyuan ! /12 6 2022.
5. Build and Flash ! Upload Sketch 6. 6.1. Select Board Tools< Upload Xinyuan ! /12 7 2022.
5. Build and Flash ! 6.2. Serial Monitor Tools ->Serial Monitor Xinyuan ! /12 8 2022.
6. SSC Command Reference ! 7. SSC Command Reference Here lists some common Wi-Fi commands for you to test the module. 7.1. op Description op commands are used to set and query the Wi-Fi mode of the system. Example op -Q op -S -o wmode Parameter Table 6-1. op Command Parameter Parameter Description -Q Query Wi-Fi mode. -S Set Wi-Fi mode. There are 3 Wi-Fi modes: wmode • mode = 1: STA mode • mode = 2: AP mode • mode = 3: STA+AP mode 7.2.
6. SSC Command Reference ! Parameter Description -s ssid Scan or connect Access Points with the ssid. -b bssid Scan the Access Points with the bssid. -n channel Scan the channel. -h Show scan results with hidden ssid Access Points. -Q Show STA connect stutus. -D Disconnected with current Access Points. 7.3. ap Description ap commands are used to set the parameter of AP network interface.
6. SSC Command Reference ! Parameter Table 6-4. mac Command Parameter Parameter Description -Q Show MAC address. -o mode • mode = 1: MAC address in STA mode. • mode = 2: MAC address in AP mode. 7.5. dhcp Description dhcp commands are used to enable or disable dhcp server/client. Example dchp -S [-o mode] dhcp -E [-o mode] dhcp -Q [-o mode] Parameter Table 6-5. dhcp Command Parameter Parameter Description -S Start DHCP (Client/Server). -E End DHCP (Client/Server). -Q show DHCP status.
6. SSC Command Reference ! Parameter Table 6-6. ip Command Parameter Parameter Description -Q Show IP address. -o mode • mode = 1 : IP address of interface STA. • mode = 2 : IP address of interface AP. • mode = 3 : both -S Set IP address. -i ip IP address. -m mask Subnet address mask. -g gateway Default gateway. 7.7. reboot Description reboot command is used to reboot the board. Example reboot 7.8. ram ram command is used to query the size of the remaining heap in the system.
FCC Caution: Any Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment. This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
