LilyGo Modem Series Documentation

repository·main·Indexed 43 days ago

https://github.com/xinyuan-lilygo/lilygo-modem-series

Documentation, 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.

Tokens
72.8K
Snippets
136
Records
386
Agent score
55%

What's inside LilyGo Modem Series

  1. Overview of LilyGo T-SIM-DC-Shield

    main

    The 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 ❌
  2. Overview of TinyGPSPlus NMEA parsing library

    main
    TinyGPSPlus 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.
  3. Overview of LilyGo Standard Series ESP32-S3 Boards

    main

    The 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
  4. Overview of RadioLib

    main
    RadioLib 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.
  5. Structure of the RadioLib ESP-IDF example

    main

    The 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.
  6. T-ETH-Elite ESP32S3 Hardware Specifications

    main

    Product 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.
  7. Identify the correct AT debug firmware for your LilyGo modem

    main

    The 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
  8. Electrical Parameters of SimShield

    main

    The 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.