T-ETH LTE Quick Start
Required Libraries
| Library | Version | Source |
|---|---|---|
| TinyGSM | Latest | GitHub |
| ETHClass2 | Latest | GitHub |
Arduino
PlatformIO (Recommended)
- Install VS Code and the PlatformIO IDE extension
- Clone the repository:bash
git clone https://github.com/Xinyuan-LilyGO/LilyGO-T-ETH-Series.git - Open
platformio.iniand uncomment theT-ETH-LTEenvironment - Click ✓ to build, connect via USB-C, click → to upload
Arduino IDE
Board Settings
| Setting | Value |
|---|---|
| Board | ESP32S3 Dev Module |
| Upload Speed | 921600 |
| USB CDC On Boot | Enable |
| CPU Frequency | 240 MHz (WiFi) |
| Flash Size | 16 MB (128Mb) |
| Partition Scheme | 16M Flash (3MB APP/9.9MB FATFS) |
| PSRAM | OPI 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.
