LilyGo-AMOLED-Series
depends on lvgl v8.3.x version. Currently lvgl has released lvgl v9.0 version. When compilation error occurs, please check whether lvgl belongs to v8.3.xLilyGo-AMOLED-Series
esp-idf version example, please jump to this LilyGo-Display-IDFProduct(PinMap) | SOC | Flash | PSRAM | Resolution | Size |
---|---|---|---|---|---|
T-Display-AMOLED-Lite | ESP32-S3R8 | 16MB | 8MB(OPI) | 194x368 | 1.47 Inch |
T-Display-S3 AMOLED | ESP32-S3R8 | 16MB | 8MB(OPI) | 240x536 | 1.91 Inch |
T4-S3 | ESP32-S3R8 | 16MB | 8MB(OPI) | 450x600 | 2.41 Inch |
Current consumption | Working current | sleep current | sleep mode |
---|---|---|---|
T-Display-AMOLED-Lite | (240MHz) WiFi On 90~230+ mA | About 1.1mA | timer wakeup |
T-Display-S3 AMOLED | (240MHz) WiFi On 90~230+ mA | About 160uA | external wakeup |
T4-S3 | (240MHz) WiFi On 90~230+ mA | About 160uA | external wakeup |
examples/
βββ Factory # Factory example
βββ AdjustBrightness # Adjust brightness example
βββ DS18x20_Temperature # OneWire example
βββ LumenMeter # 1.47-inch AMOLED Built-in Ambient Light Sensor Example
βββ LVGL_SD_Images # Display pictures saved in SD card
βββ Lvgl_Images # Screen color test
βββ PMU_ADC # PMU Voltage detection example , only support 1.47-inch AMOLED
βββ PMU_Interrupt # PMU interrupt example , only support 1.47-inch AMOLED
βββ CameraShield # Extern camera shield example, only supports 1.91 inches
βββ SPI_SDCard # External SD card example, SPI communication
βββ QWIIC_GPS_Shield # Extern GPS Shield example,use Serial communication
βββ QWIIC_HP303BSensor # Extern Temperature Pressure Sensor example,use Wire communication
βββ QWIIC_MAX3010X # External heart rate module,use Wire communication
βββ TFT_eSPI_Sprite # Use TFT_eSPI Sprite example
βββ TFT_eSPI_Sprite_ArcFill # Use TFT_eSPI Sprite example
βββ TFT_eSPI_Sprite_graphicstest_small # Use TFT_eSPI Sprite example
βββ TFT_eSPI_Sprite_RLE_Font # Use TFT_eSPI Sprite example
βββ TFT_eSPI_Sprite_Rotation # Screen rotation, only available for 1.91, 2.41 inches
βββ LVGL_Rotation # Screen rotation, only available for 1.91, 2.41 inches
βββ Touchpad # Touchpad example
βββ lvgl # LVGL examples
βββ event
βββ get_started
βββ layouts
β βββ flex
β βββ grid
βββ scroll
βββ style
βββ third_party
β βββ ImageDecoder
β βββ gif
βββ widgets
βββ ...
PlatformIO
plugin in the VisualStudioCode
extension and install it.VisualStudioCode
VisualStudioCode
, select File
in the upper left corner of VisualStudioCode
-> Open Folder
-> select the LilyGO AMOLED Series
directoryplatformio.ini
file, and in the platformio
columnsrc_dir = xxxx
to make sure only one line worksInstall Arduino IDE
Sketch
-> Include Library
-> Manage Libraries
Library Search
-> LilyGO AMOLED Series
-> Install
-> Install ALL
Library Search
-> lvgl
-> v8.3.11
-> Install
File
-> Examples
-> LilyGO AMOLED Series
-> Any Examples
Tools , Look at the picture to choose |
Arduino IDE Setting | Value |
---|---|---|
Board | ESP32S3 Dev Module | |
Port | Your port | |
USB CDC On Boot | Enable | |
CPU Frequency | 240MHZ(WiFi) | |
Core Debug Level | None | |
USB DFU On Boot | Disable | |
Erase All Flash Before Sketch Upload | Disable | |
Events Run On | Core1 | |
Flash Mode | QIO 80MHZ | |
Flash Size | 16MB(128Mb) | |
Arduino Runs On | Core1 | |
USB Firmware MSC On Boot | Disable | |
Partition Scheme | 16M Flash(3M APP/9.9MB FATFS) | |
PSRAM | OPI PSRAM | |
Upload Mode | UART0/Hardware CDC | |
Upload Speed | 921600 | |
USB Mode | CDC and JTAG |
Select Port
Click upload
, Wait for compilation and writing to complete
If it cannot be written, or the USB device keeps flashing, please check the FAQ below
Install Arduino IDE
Download LilyGO AMOLED Series
, move to Arduino library folder (e.g. C:\Users\YourName\Documents\Arduino\libraries)
Copy all folders in libdeps folder to Arduino library folder (e.g. C:\Users\YourName\Documents\Arduino\libraries)
Open ArduinoIDE ,Tools , Make your selection according to the table below |
Arduino IDE Setting | Value |
---|---|---|
Board | ESP32S3 Dev Module | |
Port | Your port | |
USB CDC On Boot | Enable | |
CPU Frequency | 240MHZ(WiFi) | |
Core Debug Level | None | |
USB DFU On Boot | Disable | |
Erase All Flash Before Sketch Upload | Disable | |
Events Run On | Core1 | |
Flash Mode | QIO 80MHZ | |
Flash Size | 16MB(128Mb) | |
Arduino Runs On | Core1 | |
USB Firmware MSC On Boot | Disable | |
Partition Scheme | 16M Flash(3M APP/9.9MB FATFS) | |
PSRAM | OPI PSRAM | |
Upload Mode | UART0/Hardware CDC | |
Upload Speed | 921600 | |
USB Mode | CDC and JTAG |
File
-> Examples
-> LilyGO AMOLED Series
-> Any Examples
Select Port
Click upload
, Wait for compilation and writing to complete
If it cannot be written, or the USB device keeps flashing, please check the FAQ below
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.
If the above is invalid, burn the binary file to check whether the hardware is normal
1.47 inches AMOLED(T-Display-AMOLED-Lite) does not support hardware screen rotation function
If you use external power supply instead of USBC, please turn off the CDC option. This is because the board will wait for USB access when it starts.
Tools -> USB CDC On Boot -> Disable
build_flags =
; Enable -DARDUINO_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
How to find the location of your own libraries, please see here
C:\Users\{username}\Documents\Arduino
/Users/{username}/Documents/Arduino
/home/{username}/Arduino
Product(PinMap) | schematic | Dimensions | PCB 3D | Shell |
---|---|---|---|---|
T-Display-AMOLED-Lite | schematic | DWG | STP | x |
T-Display-S3 AMOLED | schematic | DWG | STP | STP |
T4-S3 | schematic | DWG | STP | STP |