T-Display-S3/README.md

88 lines
4.5 KiB
Markdown
Raw Normal View History

2022-07-01 08:14:00 +00:00
<h1 align = "center"> 🌟T-Display-S3🌟</h1>
## Description
2023-01-31 14:29:59 +00:00
T-Display-S3 is a ESP32-S3 development board. It is equipped with a color 1.9" LCD screen and two programmable buttons. Communication using I8080 interface. Retains the same layout design as T-Display. You can directly use ESP32S3 for USB communication or programming.
2022-07-01 08:14:00 +00:00
2023-01-31 14:29:59 +00:00
## Pinout
2022-07-01 08:14:00 +00:00
2022-10-07 02:55:26 +00:00
![](image/T-DISPLAY-S3.jpg)
2022-07-01 08:14:00 +00:00
2022-10-07 02:55:26 +00:00
## Product 📷
2022-07-01 08:14:00 +00:00
| Product | Product Link |
| :--------: | :---------: |
2022-08-11 08:22:46 +00:00
| T-Display-S3 | [Website](https://www.lilygo.cc/products/t-display-s3) |
| T-Display-S3 | [Amazon](https://www.amazon.com/dp/B0B7X5RVTH?ref=myi_title_dp) |
| T-Display-S3 | [Aliexpress](https://www.aliexpress.com/item/3256804310228562.html) |
2022-07-01 08:14:00 +00:00
## Quick Start
2022-11-22 05:48:24 +00:00
### Notice
2023-01-31 14:29:59 +00:00
The board uses USB as the JTAG upload port. When printing serial port information on USB, CDC_ON_BOOT configuration needs to be turned on.
If the port cannot be found when uploading the program or the USB has been used for other functions, the port does not appear.
Please enter the upload mode manually.
- Press and hold the BOOT button when the power is off, the button is located behind the RST button.
- When the USB is connected, first press and hold the BOOT button, then click reset and then release the BOOT button
### Arduino
1. In Arduino Preferences, on the Settings tab, enter the `https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json` URL in the `Additional boards manager URLs` input box.
2. Click OK and the software will install.
3. Search for ESP32 in Tools → Board Manager and install ESP32-Arduino SDK (version 2.0.3 or above)
2022-10-11 10:37:55 +00:00
![](image/Arduino_board.png)
2023-01-31 14:29:59 +00:00
4. Copy everything from this repository lib folder to [Arduino library folder](https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries#manual-installation) (e.g. `C:\Users\YourName\Documents\Arduino\libraries`)
5. Select the correct settings in the Tools menu as shown below.
| Setting | Value |
| :----------------------- | :------------------------------- |
| USB CDC On Boot | Enabled |
| CPU Frequency | 240MHz (WiFi) |
| Core Debug Level | None |
| USB DFU On Boot | Enabled |
| Events Run On | Core 1 |
| Flash Mode | QIO 80MHz |
| Flash Size | 16MB (128Mb) |
| JTAG Adapter | Integrated USB JTAG |
| Arduino Runs On | Core 1 |
| USB Firmware MSC On Boot | Disabled |
| Partition Scheme | Huge APP (3MB No OTA/1MB SPIFFS) |
| PSRAM | OPI PSRAM |
| USB Mode | Hardware CDC and JTAG |
### PlatformIO
- PlatformIO plug-in installation: Click on the extension on the left column -> search platformIO -> install the first plug-in
- Click Platforms -> Embedded -> search Espressif 32 in the input box -> select the corresponding firmware installation
2022-10-11 10:37:55 +00:00
2023-01-31 14:29:59 +00:00
### ESP-IDF
2022-07-01 08:14:00 +00:00
2023-02-05 09:55:58 +00:00
- The installation method varies depending on the system, it is recommended to refer to the [official manual](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html) for installation.
2022-07-01 08:14:00 +00:00
2023-01-31 14:29:59 +00:00
## Q&A
2022-07-01 08:14:00 +00:00
2023-01-31 14:29:59 +00:00
- Why doesn't the [TFT_eSPI](https://github.com/Bodmer/TFT_eSPI) library display properly?
2022-10-07 02:55:26 +00:00
2023-01-31 14:29:59 +00:00
> Some settings, withing the TFT_eSPI library, need to be modified. A modified library is provided in this repository in the lib folder. Copy it to your [Arduino library folder](https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries#manual-installation).
>
> Alternatively you must patch your clone of a TFT_eSPI library with `Micky_commit.patch`.
2022-07-01 08:14:00 +00:00
2022-09-23 09:40:58 +00:00
## Tips
2022-10-07 02:55:26 +00:00
2022-09-23 09:40:58 +00:00
1. Use board as delivered. Connect board to usb to computer without
touching anything else. Upload the code. The code will start right after
download and run. Unplug the board and connect to usb again. The board
will not do anything.
2. Use board as delivered. Push down boot button. While boot button is
pushed, connect usb to computer. Release boot button. Upload the code.
The code will not start right after download. Nothing will happen.
Unplug the board and connect to usb again.The board will now boot the
code. Unplug the board from USB to computer and connect to other power
source like LiPO battery. Again the board will start the code. The
computer is not needed again.
New code can be loaded to the board by going to step 1 or 2. Both will
2022-10-07 02:55:26 +00:00
still work.