LilyGo Modem Series Documentation
repository·main·Indexed 43 days ago
https://github.com/xinyuan-lilygo/lilygo-modem-seriesDocumentation, examples, and hardware guides for LilyGo cellular modem modules integrated with ESP32 and ESP32-S3 microcontrollers, including the A7608X, A7670X, and PCI-E series. Covers pinout configurations, power management, antenna interfaces, and setup instructions for PlatformIO and Arduino IDE.
What's inside LilyGo Modem Series
- SensorLib is a multi-platform library providing drivers for commonly used I2C and SPI devices. It supports a variety of sensors including Real-Time Clocks (RTC), IMUs (Motion Sensors), I/O expanders (GPIO Expansion), Haptic Drivers, Light Sensors, and Touchpads.
Overview of Adafruit Bus IO Library
mainThe Adafruit Bus IO Library is a helper library designed to abstract I2C and SPI transactions and register management. It provides a unified interface for hardware communication, making it easier to manage bus-based peripherals without dealing directly with low-level register logic for every device.What is LilyGo Modem AT Debug Firmware?
mainThe LilyGo Modem AT Debug Firmware is a specialized set of firmware used to test and debug modem AT commands. It is intended for quick troubleshooting of modem functionality on LilyGo modem series hardware.Overview of ICM20948_WE Library
mainTheICM20948_WElibrary is an Arduino library designed for the ICM-20948 9-axis accelerometer, gyroscope, and magnetometer. It supports both I2C and SPI communication interfaces. Note that Digital Motion Processor (DMP) features are not implemented in this library.Overview of LilyGo T-SIM-DC-Shield
mainThe T-SIM-DC-Shield is a power and expansion shield designed for various LilyGo SIM series products. It provides DC power input and specific pin mappings for different modem boards.
Supported Boards
- T-SIM7000G-Standard-Series ✅
- T-SIM7600G-Standard-Series ✅
- T-SIM7670G-Standard-Series ✅
- T-SIM7080G-Standard-Series ✅
- T-A7670X-Standard-Series ✅
- T-SIM7670G-ESP32S3 Version ✅
- T-A7608X-ESP32S3 Version ✅
- T-A7670X-ESP32 Version ✅
- T-A7608X-ESP32 Version ✅
- T-SIM7000G-ESP32 Version ✅
- T-SIM7600G-ESP32 Version ✅
- T-SIM7080G-ESP32S3 (PMU Version) ❌
- T-A7670G+L76K-ESP32 Version ❌
Overview of TinyGPSPlus NMEA parsing library
mainTinyGPSPlus is an Arduino library designed to parse NMEA data streams from GPS modules. It provides compact and easy-to-use methods for extracting critical data such as position, date, time, altitude, speed, and course from consumer GPS devices. Compared to the original TinyGPS library, TinyGPSPlus offers a simpler programmer interface and the ability to extract arbitrary data from various NMEA sentences, including proprietary ones.Overview of LilyGo Standard Series ESP32-S3 Boards
mainThe LilyGo Standard Series consists of cellular IoT development boards based on the ESP32-S3-WROOM-1 (NR16R2) platform. These boards feature a unified hardware design and pin layout, making them pin-compatible and allowing for seamless switching between different cellular modules.
Core Hardware Specifications:
- MCU: ESP32-S3-WROOM-1 (NR16R2)
- Flash: 16MB (Quad-SPI)
- PSRAM: 2MB (Quad-SPI)
Common Features:
- QWIIC interface (I2C/UART)
- Seamless power switching (USB-C, Battery, or Solar)
- GNSS routing to SoC
- eSIM pad support
- Integrated BMS (Battery Management System)
- 24-pin FPC camera interface
- Pin-compatible design across the series
Overview of RadioLib
mainRadioLib is a universal wireless communication library for embedded devices designed to integrate various wireless modules, protocols, and digital modes into a single consistent system. It provides a hardware abstraction layer that allows it to run in both Arduino and non-Arduino environments. It is highly portable and supports a wide range of radio modules and communication protocols.Structure of the RadioLib ESP-IDF example
mainThe ESP-IDF example is organized into the following files:
main/CMakeLists.txt: The IDF component CMake configuration.main/EspHal.h: The example implementation of the RadioLib HAL for ESP-IDF.main/idf_component.yml: The manifest declaring the RadioLib dependency for the ESP-IDF build system.main/main.cpp: The primary application source code.
T-ETH-Elite ESP32S3 Hardware Specifications
mainProduct Details
- SOC: ESP32-S3-WROOM-1
- Flash: 16MB (Quad-SPI)
- PSRAM: 8MB (OPI)
Electrical Parameters
- USB-C Input Voltage: 5V
- POE: Class 0 / IEEE 802.3AF (36~57V)
Buttons and Antennas
- BOOT Button: Used for custom functions or entering download mode. Hold BOOT before powering on to enter waiting mode for downloading.
- RESET Button: Resets the device.
- SIM/MAIN Antenna: LTE main antenna interface.
- GPS/GNSS Antenna: GPS active antenna interface.
LED Indicators
- Module Status: RED (on the modem)
- Module Network Status: RED (on the modem) Note: These LEDs cannot be turned off via software.
Identify the correct AT debug firmware for your LilyGo modem
mainThe
firmware/directory contains AT debug firmware used to test and debug modem AT commands for rapid troubleshooting. Firmware is categorized by the underlying chip architecture (ESP32 or ESP32-S3) and specific product models.ESP32 Versions
- T-A7670X:
esp32-t-a7670x_atdebug_20251201_0x0.bin - T-Call-A7670X-v1.0:
esp32-t-call-a7670x-v1.0-atdebug-20251201_0x0.bin - T-Call-A7670X-v1.1:
esp32-t-call-a7670x-v1.1_atdebug_20251201_0x0.bin - T-A7608:
esp32-t-a7608x-atdebug-20251201_0x0.bin - T-SIM7000G:
esp32-t-sim7000g_atdebug_20251201_0x0.bin - T-SIM7070G:
esp32-t-sim7070g_atdebug_20251201_0x0.bin - T-SIM7600G:
esp32-t-sim7600x-atdebug_20251201_0x0.bin - T-PCI-E:
esp32-t-pcie-atdebug-20251201_0x0.bin - T-A7670X (External GPS):
esp32-t-a7670x-external-gps-a7670g-only-20260127_0x0.bin
ESP32-S3 Versions
- T-A7608-S3:
esp32s3-t-a7608x-atdebug-20251201_0x0.bin - T-SIM7670G-S3:
esp32s3-t-sim7670g-atdebug-251201_0x0.bin - T-ETH-Elite-S3:
esp32s3-t-eth-elite-atdebug-20251201_0x0.bin
Standard Series
Standard series boards use pin-compatible layouts, so you do not need to distinguish between different modems when using these firmwares:
- Standard Series AT Debug:
esp32s3-standard-series-atdebug-20251201_0x0.bin - Standard Series Camera WebServer SoftAP:
esp32s3-standard-series-camera-web-server-softap-20251201_0x0.bin - Standard Series External GPS Expansion Board:
esp32s3-standard-series-external-gps-20260108_0x0.bin
- T-A7670X:
Electrical Parameters of SimShield
mainThe SimShield expansion board features three-way current detection, a LoRa transceiver, and wide-range DC input. It is compatible with the full range of LilyGo T-Sim expansion boards.
Voltage Specifications:
- DC Interface Input: 7V to 36V
- Battery Interface Input: 4.2V
- +5V Output: Maximum current of 2A
- +3V3 Output: Provided by the motherboard. Warning: Do not connect peripheral devices to the +3V3 pin if they exceed 100mA, as current capacity varies by motherboard.