Skip to content

T-ETH LTE Quick Start

Required Libraries

LibraryVersionSource
TinyGSMLatestGitHub
ETHClass2LatestGitHub

Arduino

  1. Install VS Code and the PlatformIO IDE extension
  2. Clone the repository:
    bash
    git clone https://github.com/Xinyuan-LilyGO/LilyGO-T-ETH-Series.git
  3. Open platformio.ini and uncomment the T-ETH-LTE environment
  4. Click to build, connect via USB-C, click to upload

Arduino IDE

Board Settings

SettingValue
BoardESP32S3 Dev Module
Upload Speed921600
USB CDC On BootEnable
CPU Frequency240 MHz (WiFi)
Flash Size16 MB (128Mb)
Partition Scheme16M Flash (3MB APP/9.9MB FATFS)
PSRAMOPI PSRAM

Peripheral Examples

Ethernet (ETHClass2)

cpp
#include <ETHClass2.h>

void onEthEvent(arduino_event_id_t event) {
  if (event == ARDUINO_EVENT_ETH_GOT_IP) {
    Serial.print("IP: "); Serial.println(ETH2.localIP());
  }
}

void setup() {
  Serial.begin(115200);
  WiFi.onEvent(onEthEvent);
  ETH2.begin();
}

void loop() { delay(1000); }

LTE Data (TinyGSM)

cpp
#define TINY_GSM_MODEM_SIM7600
#include <TinyGsmClient.h>

// LTE modem UART pins — check utilities.h
HardwareSerial modemSerial(1);
TinyGsm modem(modemSerial);

void setup() {
  Serial.begin(115200);
  modemSerial.begin(115200, SERIAL_8N1, /*RX=*/4, /*TX=*/5);
  // Power on LTE module
  pinMode(12, OUTPUT);
  digitalWrite(12, HIGH); delay(1000);
  digitalWrite(12, LOW);  delay(2000);

  modem.restart();
  Serial.println("Modem: " + modem.getModemInfo());
  modem.gprsConnect("your.apn", "", "");
  Serial.println("LTE connected: " + String(modem.isGprsConnected()));
}

void loop() { delay(1000); }

FAQ

Q: Upload keeps failing?
A: Hold BOOT, press and release RST, then release BOOT to enter download mode.

Q: LTE modem not responding?
A: Ensure a valid nano SIM is inserted. Check that the LTE antenna is connected. Power cycle the board after SIM insertion.