LILYGO T-Embed

Contents

LILYGO T-Embed ESP32-S3 Development Board User Manual

Brand: LILYGO

Model: T-Embed

1. Product Introduction

The LILYGO T-Embed is a versatile development board built around the ESP32-S3 dual-core LX7 microprocessor. Designed for custom control panel applications, it features a 1.9-inch ST7789 IPS TFT LCD display, a custom macro knob with 7 APA102 full-color RGB LEDs, and integrated Wi-Fi and Bluetooth 5 connectivity. It offers 16MB Flash and 8MB PSRAM, providing ample resources for various projects. The board supports dual power supply via USB Type-C or Li-Po battery, making it suitable for both desktop and portable use.

LILYGO T-Embed device showing brightness settings on the LCD and RGB lighting on the macro knob. Also shows top and bottom views of the 'Pure Black' and 'White Orange' variants.
LILYGO T-Embed device showing brightness settings on the LCD and RGB lighting on the macro knob. Also shows top and bottom views of the 'Pure Black' and 'White Orange' variants.

2. What's in the Box

Your LILYGO T-Embed package should contain the following items:

  • 1 x T-Embed Development Board (Pure Black / White Orange / White Black / Transparent, depending on your selection)
  • 1 x IDC3 Box Header Connector 2.54 (2*8P)
  • 1 x Box Header Cable 2.54 8pin 10cm
  • 1 x JST 1.25mm 2P Connector
  • 1 x 1511 Speaker (8Ω 1W)
Exploded view of the T-Embed components: T-Embed board, IDC3 Box Header Connector, Box Header Cable, JST 1.25mm 2P, 1511 Speaker.
Exploded view of the T-Embed components: T-Embed board, IDC3 Box Header Connector, Box Header Cable, JST 1.25mm 2P, 1511 Speaker.

3. Specifications

LILYGO T-Embed ESP32-S3 Key Specifications
FeatureDescription
MCUESP32-S3 Dual-core LX7 microprocessor
Wireless ConnectivityWi-Fi 802.11 b/g/n, BLE 5
Programming PlatformArduino-ide, ESP-IDF
Flash Memory16MB
PSRAM8MB
Display1.9 inch ST7789 IPS TFT LCD (SPI Interface, 170(H)RGB x 320(V) Resolution)
RGB LEDs7 x APA102 Full Color RGB
Power SupplyUSB Type-C / Li-Po Battery (Dual Power Supply)
Onboard FunctionsReset Button, Boot Button, Bat voltage detection (IO04)
Dimensions (PCB)Length: 96mm, Width: 39mm, Height: 11mm
Compatible Audio & Video Equipment StylePlayer, Professional Audio Equipment, Display Equipment
T-Embed Specifications image detailing MCU, Wireless Connectivity, Programming Platform, Flash, PSRAM, Onboard functions, LCD details, and power supply options.
T-Embed Specifications image detailing MCU, Wireless Connectivity, Programming Platform, Flash, PSRAM, Onboard functions, LCD details, and power supply options.
Dimensions of the T-Embed PCB: Length (L: 96mm), Width (W: 39mm), Height (H: 11mm).
Dimensions of the T-Embed PCB: Length (L: 96mm), Width: 39mm, Height: 11mm.

4. Hardware Overview and Pin Diagram

The T-Embed board integrates various components and pinouts for extensive customization and development. Familiarize yourself with the layout and pin assignments for proper use.

Detailed pinout diagram for LILYGO T-Embed ESP32-S3, showing LCD pins, Microphone pins, Speaker pins, RGB LED pins, Encoder pins, TF Card Slot pins, GPIO PINOUT, SDA, SCL, JST 1.25, RESET, Power_On, USB Type-C, Speaker Slot, Boot button.
Detailed pinout diagram for LILYGO T-Embed ESP32-S3, showing LCD pins, Microphone pins, Speaker pins, RGB LED pins, Encoder pins, TF Card Slot pins, GPIO PINOUT, SDA, SCL, JST 1.25, RESET, Power_On, USB Type-C, Speaker Slot, Boot button.

Key Components:

  • ESP32-S3 Module: The core processing unit.
  • 1.9 inch LCD: For visual feedback and user interface.
  • Macro Knob: Rotary encoder with push-button functionality, surrounded by RGB LEDs.
  • USB Type-C Port: For power and data communication.
  • JST GH 1.25mm Connector: For external peripherals or power.
  • TF Card Slot: For expandable storage, e.g., for music files.
  • Speaker Slot: Connects to the included 1511 Speaker.
  • Microphone: For audio input.
  • Reset Button: To restart the device.
  • Boot Button: For entering bootloader mode for firmware flashing.

5. Setup Instructions

5.1 Powering the Device

The T-Embed supports dual power supply options:

  • USB Type-C: Connect a standard USB Type-C cable to the board and a power source (e.g., computer USB port, USB wall adapter). This will power the device and allow for data communication.
  • Li-Po Battery: Connect a compatible Li-Po battery to the JST 1.25mm 2P connector. The board includes battery voltage detection on IO04. Ensure correct polarity when connecting the battery.

5.2 Initial Firmware and Connection

To get started with the T-Embed, you will typically need to flash firmware. The device is compatible with Arduino-IDE and ESP-IDF programming platforms.

  • Connect the T-Embed to your computer via the USB Type-C cable.
  • Refer to the official LILYGO GitHub repository for detailed instructions on setting up your development environment and flashing initial firmware.

6. Operating Instructions

6.1 Basic Interaction

The T-Embed features an LCD display and a macro knob for user interaction:

  • LCD Display: The 1.9-inch TFT LCD provides visual feedback for menus, settings, and application data.
  • Macro Knob: Rotate the knob to navigate menus or adjust values. Press the knob to select an option or confirm an action. The surrounding RGB LEDs can provide visual cues or status indicators.
Hands interacting with the T-Embed's LCD and macro knob to adjust brightness settings.
Hands interacting with the T-Embed's LCD and macro knob to adjust brightness settings.

6.2 Factory Firmware Routines

If your device comes with factory firmware, here are some common operations:

  • Entering Clock Interface: After entering the "self test" mode, download "ESP Touch" and connect to Wi-Fi.
  • Accessing Music Function: Insert a TF card (FAT32 format) containing MP3 or WAV audio files into the TF card slot.
  • Modifying/Customizing Firmware: Download the firmware program from the official GitHub repository.
Instructions for factory firmware: How to enter clock interface, access music function, and modify/customize firmware. Includes a QR code for GitHub.
Instructions for factory firmware: How to enter clock interface, access music function, and modify/customize firmware. Includes a QR code for GitHub.

7. Customization and 3D Printing

The LILYGO T-Embed is designed with customization in mind. You can create your own enclosures or accessories using 3D printing.

  • 3D Print Files: Official 3D print files for the shell are available on the LILYGO GitHub repository. This allows you to print your own back cover or custom enclosures.
  • Note: The 3D printed back cover is not included with the product and must be printed separately if desired.

3D Print File Link: https://github.com/Xinyuan-LilyGO/T-Embed/tree/main/Shell_file

8. User Tips

  • Battery Usage: While the T-Embed supports Li-Po batteries, a battery is not included in the package. Ensure you use a compatible Li-Po battery and connect it with correct polarity. The device can also be powered via USB-C.
  • Enclosure: The product does not come with a pre-installed back cover. Consider 3D printing one using the provided files to protect the internal components and provide a finished look.
  • Firmware Development: For advanced customization, delve into the Arduino-IDE or ESP-IDF platforms. The LILYGO GitHub provides a wealth of resources and examples.

9. Troubleshooting

  • Device Not Powering On: Ensure the USB-C cable is securely connected to a working power source, or that the Li-Po battery is charged and correctly connected.
  • Display Not Working: Check if the device is powered on. If using custom firmware, verify that the display initialization code is correct.
  • Connectivity Issues (Wi-Fi/Bluetooth): Ensure your firmware includes the necessary Wi-Fi/Bluetooth libraries and configuration. Check for interference or incorrect network credentials.
  • Firmware Upload Failure: Verify that the correct drivers are installed for the ESP32-S3. Ensure the device is in bootloader mode (often by holding the Boot button while connecting USB or pressing it during a reset). Check your IDE settings for correct board and port selection.
  • Speaker Not Producing Sound: Ensure the speaker is correctly connected to the speaker slot. Verify that your firmware is sending audio data to the correct I2S pins.

10. Maintenance

  • Cleaning: Use a soft, dry cloth to clean the device. Avoid using liquids or abrasive cleaners.
  • Storage: Store the T-Embed in a cool, dry place away from direct sunlight and extreme temperatures.
  • Handling: Handle the board with care to avoid damaging components, especially if not enclosed in a protective case.
  • Firmware Updates: Regularly check the official LILYGO GitHub repository for firmware updates and bug fixes to ensure optimal performance and access to new features.

11. Warranty and Support

For detailed warranty information, technical support, and community resources, please refer to the official LILYGO channels.

  • Official GitHub Repository: The primary resource for documentation, code examples, and community support. https://github.com/Xinyuan-LilyGO/T-Embed
  • Contacting Support: If you have specific questions or encounter issues not covered in the documentation, please refer to the contact information provided on the LILYGO official website or store page.

Ask a question about this manual

Ask about setup, troubleshooting, compatibility, parts, safety, or missing instructions. Manuals+ will review the question and use this page’s manual context to help answer it.

After a successful submission, we securely hash the supplied account or form email before sending it to Microsoft Advertising for conversion attribution. Privacy details.