LILYGO T-Display Bar

Version History:

Purchase Link

Table of Contents

• Description
• Preview
• Modules
• Quick Start
• Pin Overview
• Related Tests
• FAQ
• Projects
• Resources
• Dependent Libraries

Description

LILYGO T-Display Bar is a highly integrated embedded smart display module, featuring the ESP32-S3 high-performance chip at its core, combining multi-functional sensors with high-precision display technology. Its core configuration is as follows:

Display System

• Equipped with a 2.25-inch IPS full-color LCD screen, using ST7789 driver IC, with a resolution of 76×284 pixels (RGB arrangement).
• Supports capacitive touch (independent Touch_IRQ/Touch_RST control), providing a smooth human-machine interaction experience.
• Connected via SPI bus (CS/DC/RST/BL/MOSI/SCLK pins), optimizing display control efficiency.

Intelligent Sensing Capability

• Integrated BH1260AP AI sensor, supporting six-axis IMU (accelerometer + gyroscope) and personalized motion tracking.
• Equipped with I²C interface (SDA/SCL) and dedicated control pins (EN/RST/IRQ), enabling low-power environmental sensing and real-time data interaction.

Expandability and Interfaces

• Provides QWIIC ecosystem interface (compatible with I²C devices), supporting rapid expansion of sensor modules.
• Integrated TF card storage (SPI interface: MOSI/MISO/SCK/CS) and buzzer driver (BUZZer_IO).
• Uses USB Type-C interface, supporting 5V/500mA power supply and integrated program burning design.

Physical Characteristics

• Compact structural design (69×23×15mm), suitable for both industrial deployment and portable device requirements.
• Highly optimized pin layout (such as TFT CS/DC multiplexed with ESP32-GPIO), simplifying secondary development processes.

Preview

Physical Images

Pinout Diagram

Modules

MCU

• Chip: ESP32-S3-R8
• PSRAM: 8M (OPI PSRAM)
• FLASH: 16M
• Other Notes: For more information, please visit Espressif Official ESP32-S3 Datasheet

Screen

• Size: 2.25-inch IPS LCD
• Resolution: 76x284px
• Type: IPS LCD
• Driver IC: ST7789
• Compatible Libraries: TFT_eSPI
• Bus Protocol: SPI

Touch

• Chip: CST816
• Bus Protocol: I2C

Sensor

• Chip: BHI260AP
• Functions: Supports six-axis IMU (accelerometer + gyroscope), AI sensor
• Bus Protocol: I2C

Overview

Quick Start

Example Support

PlatformIO

1. Install Visual Studio Code according to your system.
2. Open the "Extensions" sidebar in Visual Studio Code (or press Ctrl+Shift+X), search for the "PlatformIO IDE" extension and install it.
3. While the extension is installing, download the project from GitHub. You can click the green "<> Code" button to download the main branch, or download a "Releases" version from the sidebar.
4. After the extension installation is complete, open the Explorer sidebar (or press Ctrl+Shift+E), click "Open Folder", find the project code you just downloaded (the entire folder), click "Add", and the project files will be added to your workspace.
5. Open the "platformio.ini" file in the project folder (PlatformIO should automatically open it after adding the folder). Under the "[platformio]" section, uncomment the line selecting the example program you want to upload (starting with "default_envs = xxx"). Then click the "√" at the bottom left to compile. If the compilation is successful, connect the board to your computer and click the "→" at the bottom left to upload.

Arduino

1. Install Arduino IDE according to your system.
2. Open the "example" directory in the project folder, select the example project folder, and open the file ending with ".ino" to open the Arduino IDE project workspace.
3. Open the "Tools" menu -> "Board" -> "Boards Manager", find or search for "esp32", and install the board files by "Espressif Systems". Then return to the "Board" menu and select the board type under "ESP32 Arduino". The board type to choose is determined by the "board = xxx" header in the "[env]" section of the "platformio.ini" file. If the corresponding board is not available, you need to manually add the board from the "board" directory in the project folder.
4. Open the "[File]" -> "[Preferences]" menu, find the "[Sketchbook location]" field. Copy and paste all library files and folders from the "libraries" directory in the project folder into the "libraries" folder at this location.
5. Select the correct settings in the "Tools" menu as shown in the table below.

ESP32-S3

6. Select the correct port.
7. Click the "√" in the top right corner to compile. If the compilation is successful, connect the board to your computer and click the "→" to upload.

Development Platforms

1. Micropython
2. Arduino IDE
3. Platform IO

Pin Overview

Related Tests

(Test data to be added)

FAQ

• Q. I still don't know how to set up the programming environment after reading the above tutorial. What should I do?
  A. If you still don't understand how to set up the environment after reading the above tutorial, you can refer to the LilyGo-Document documentation for setup instructions.

• Q. Why does Arduino IDE prompt me to upgrade library files when I open it? Should I upgrade or not?
  A. Choose not to upgrade library files. Different versions of library files may not be compatible with each other, so upgrading is not recommended.

• Q. Why is there no serial data output from the "Uart" interface on my board? Is it broken?
  A. Because the project file is configured by default to use the USB interface as Uart0 serial output for debugging, and the "Uart" interface is connected to Uart0, it won't output any data without configuration.
  PlatformIO users: Open the project file "platformio.ini", change the option "-DARDUINO_USB_CDC_ON_BOOT=true" under "build_flags = xxx" to "-DARDUINO_USB_CDC_ON_BOOT=false" to use the external "Uart" interface normally.
  Arduino users: Open the "Tools" menu, select USB CDC On Boot: "Disabled" to use the external "Uart" interface normally.

• Q. Why does my board keep failing to upload programs?
  A. Please hold down the "BOOT" button and try uploading again.

Projects

• T-Display-Bar

Resources

• ESP32-S3 Datasheet
• BHI260AP Datasheet

Dependent Libraries

• ESP32-BLE-Mouse
• ArduinoJson
• lvgl
• MadgwickAHRS
• SensorsLib
• XPowersLib
• TFT_eSPI