lewisxhe / act

🌟LilyGO AMOLED Series🌟

1️⃣Support Product

Product(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-AMOLED	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	Aboud 1.1mA	timer wakeup
T-Display-S3 AMOLED	(240MHz) WiFi On 90~230+ mA	Aboud 160uA	external wakeup
T4-AMOLED	(240MHz) WiFi On 90~230+ mA	Aboud 160uA	external wakeup

2️⃣Examples

examples/
├── Factory                # Factory example
├── LumenMeter             # 1.47-inch AMOLED Built-in Ambient Light Sensor Example
├── PMU_ADC                # PMU Voltage detection example , only support 1.47-inch AMOLED
├── PMU_Interrupt          # PMU interrupt example , only support 1.47-inch AMOLED
├── QWIIC_GPS_Shield       # Extern GPS Shield example,use Serial communication
├── QWIIC_HP303BSensor     # Extern Temperature Pressure Sensor example,use Wire communication
├── TFT_eSPI_Sprite        # Use TFT_eSPI Sprite example
├── Touchpad               # Touchpad example
└── lvgl                   # LVGL examples
    ├── event
    ├── get_started
    ├── layouts
    │   ├── flex
    │   └── grid
    ├── scroll
    ├── style
    ├── third_party
    │   ├── ImageDecoder
    │   └── gif
    └── widgets
        └── ...

3️⃣ PlatformIO Quick Start (Recommended)

1. Install Visual Studio Code and Python
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 src_dir = 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

4️⃣ Arduino IDE Quick Start

• It is recommended to use platformio without cumbersome steps

1. Install Arduino IDE
2. Install Arduino ESP32 2.0.5 or above , below 3.0
3. Download LilyGO AMOLED Series , move to Arduino library folder (e.g. C:\Users\YourName\Documents\Arduino\libraries)
4. Copy all folders in libdeps folder to Arduino library folder (e.g. C:\Users\YourName\Documents\Arduino\libraries)
5. Open ArduinoIDE ,Tools , Look at the picture to choose
6. File -> Examples -> LilyGO AMOLED Series -> Any Examples
7. Select Port
8. Click upload , Wait for compilation and writing to complete
9. If it cannot be written, or the USB device keeps flashing, please check the FAQ below

📽️ Arduino IDE Video steps

5️⃣ ESP32 basic examples

• BLE Examples
• WiFi Examples
• SPIFFS Examples
• FFat Examples
• For more examples of esp32 chip functions, please refer to arduino-esp32-libraries

6️⃣ FAQ

1. 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.

   1. Connect the board via the USB cable
   2. Press and hold the BOOT button , While still pressing the BOOT button, press RST
   3. Release the RST
   4. Release the BOOT button
   5. Upload sketch

2. If the above is invalid, burn the binary file to check whether the hardware is normal

3. AMOLED does not support hardware screen rotation function

7️⃣ Resource

• AMOLED Driver datasheet
• Touchpad Driver datasheet
• PMU datasheet
• Light Sensor datasheet
• ESP32S3
• Board schematic
• Board 3D step
• Board Dimensions

8️⃣ Depends on required libraries

• XPowersLib
• SensorLib
• lvgl 8.3.9
• AceButton
• Adafruit_NeoPixel
• TinyGPSPlusl