1. Install [Visual Studio Code](https://code.visualstudio.com/) and [Python](https://www.python.org/)
2. Search for the `PlatformIO` plugin in the `VisualStudioCode` extension and install it.
3. After the installation is complete, you need to restart `VisualStudioCode`
4. After restarting `VisualStudioCode`, select `File` in the upper left corner of `VisualStudioCode` -> `Open Folder` -> select the `LilyGO AMOLED Series` directory
5. Wait for the installation of third-party dependent libraries to complete
6. Click on the `platformio.ini` file, and in the `platformio` column
7. Uncomment one of the lines `default_envs = xxxx` to make sure only one line works
8. Click the (✔) symbol in the lower left corner to compile
9. Connect the board to the computer USB
10. Click (→) to upload firmware
11. Click (plug symbol) to monitor serial output
12. If it cannot be written, or the USB device keeps flashing, please check the **FAQ** below
* For more examples of esp32 chip functions, please refer to [arduino-esp32-libraries](https://github.com/espressif/arduino-esp32/tree/master/libraries)
1. The program can be written normally, but there is still no display after writing
* If you are using **TFT_eSPI**, then you can try running `Arduino_GFXDemo` first. If nothing is displayed after writing, you can determine that there is a problem with the hardware.
* If `Arduino_GFXDemo` is written normally, but **TFT_eSPI** is not displayed, then it can be judged that `User_Setup_Select` has been overwritten, then please read the third article of **FAQ** to reconfigure **TFT_eSPI**
2. How to update **TFT_eSPI**, or confirm whether the **TFT_eSPI** pin configuration is correct?
* Search for **TFT_eSPI** in the ArduinoIDE library manager and click Update.
* Enter the default library manager installation location and open the **TFT_eSPI** folder. The default installation location is:(e.g. C:\Users\YourName\Documents\Arduino\libraries)
* Open User_Setup_Select.h, comment out #include<User_Setup.h> which is enabled by default, or delete it
* Search **Setup206_LilyGo_T_Display_S3**, find it, cancel the previous comment, then save it, and finally close it, so that TFT_eSPI uses the pin definition of T-Display-S3 by default
```c
#include<User_Setups/Setup206_LilyGo_T_Display_S3.h> // For the LilyGo T-Display S3 based ESP32S3 with ST7789 170 x 320 TFT
```
3. Can't upload any sketch，Please enter the upload mode manually.
* Connect the board via the USB cable
* Press and hold the **BOOT** button , While still pressing the **BOOT** button
* Press **RST** button
* Release the **RST** button
* Release the **BOOT** button (If there is no **BOOT** button, disconnect IO0 from GND.)
* Upload sketch
* Press the **RST** button to exit download mode
4. If you use external power supply instead of USB-C, please turn off the CDC option. This is because the board will wait for USB access when it starts.
* For Arduino IDE users, it can be turned off in the options , Please note that turning off USB CDC will turn off Serial redirection to USBC. At this time, you will not see any Serial message output when opening the port from USB-C, but output from GPIO43 and GPIO44.
```c
Tools -> USB CDC On Boot -> Disable
```
* For platformio users, you can add the following compilation flags in the ini file
```c
build_flags =
; Enable UARDUINO_USB_CDC_ON_BOOT will start printing and wait for terminal access during startup
; -DARDUINO_USB_CDC_ON_BOOT=1
; Enable UARDUINO_USB_CDC_ON_BOOT will turn off printing and will not block when using the battery
-UARDUINO_USB_CDC_ON_BOOT
```
5. If all the above are invalid, please flash the factory firmware for quick verification, please check [here](./firmware/README.MD)
6. Can I use an external 5V pin for power? Please see here [issues/205](https://github.com/Xinyuan-LilyGO/T-Display-S3/issues/205)
