lilygo T-SIM 7000G

Contents

LILYGO® TTGO T-SIM7000G SIM Development Board User Manual

Model: T-SIM 7000G

1. Introduction

The LILYGO® TTGO T-SIM7000G is a versatile development board integrating an ESP32 microcontroller with WiFi and Bluetooth capabilities, alongside a SIM7000 series module for cellular communication (2G/NB-IoT/Cat-M) and GPS functionality. This board is designed for various Internet of Things (IoT) applications requiring wireless connectivity and location tracking. It features enhanced battery protection, improved GPS power management for reduced consumption, and integrated solar charging capabilities.

Front and back view of the LILYGO TTGO T-SIM7000G development board

Figure 1: LILYGO® TTGO T-SIM7000G Development Board (Front and Back)

2. Key Features

  • Enhanced Battery Management: Includes protection against reverse polarity, overcharging, and over-discharging.
  • Improved GPS Power Management: Optimized to reduce power consumption, achieving a minimum sleep mode power of 300uA.
  • Solar Charging: Upgraded charging functionality with an integrated solar charging IC.
  • Integrated Connectivity: ESP32 for Wi-Fi (802.11 b/g/n) and Bluetooth (V4.2 BR/EDR and BLE).
  • Cellular Module: SIM7000 series for 2G (GSM), NB-IoT, and Cat-M communication.
  • Global Positioning: Integrated GPS module for location tracking.
  • Storage: Supports TF Card for expanded storage.
  • Flexible Power Options: Can be powered via USB-C, 18650 battery, or solar panel.

3. Package Contents

Ensure all items are present in your package:

Contents of the LILYGO TTGO T-SIM7000G product package

Figure 2: Product Package Contents

  • 1x T-SIM7000G Development Board
  • 1x SIM Antenna
  • 1x GPS Antenna
  • 1x Power Cable
  • 2x Pin Headers

4. Technical Specifications

Table of ESP32 MCU, SIM7000 Series, and Power Consumption Parameters

Figure 3: Technical Specifications Table

General Specifications
ParameterValue
Dimensions (WxHxD)111mm x 37mm x 20mm
Weight50g
Brand Namelilygo
Model NumberT-SIM 7000G
PackageYes
ESP32 MCU Parameters
ParameterValue
Clock Speed240Mhz
Flash4MB/16MB
AntennaOn-board
PSRAM8MB
Wireless ConnectivityWi-Fi: 802.11 b/g/n, Bluetooth: V4.2 BR/EDR and BLE
Peripheral InterfacesI2C/SPI/UART/SDIO/I2S/CAN
SIM7000 Series Parameters
ParameterValue
Form factorLCC, 68PIN
Dimensions (mm)24*24*2.6
Supply Voltage (V)3.0~4.3
SIM CardSupport 1.8V/3.0V
TF CardSupport
ProtocolTCP/UDP/LWM2M/COAP/MQTT/FTP/HTTP/TLS/DTLS/NTP
Power Consumption
ModeConsumption
Power Off7uA
PSM9uA
Sleep1mA
Idle11mA

5. Product Pin Diagram

Refer to the detailed pin diagram below for understanding the board's layout and connections.

Detailed pin diagram for ESP32 SIM Card T-SIM7000G V1.1, showing pin functions and connections for TF Card, 18650 Battery, and SIM7000G

Figure 4: T-SIM7000G V1.1 Pin Diagram

6. Setup Instructions

6.1. Component Overview

Labeled diagram of the T-SIM7000G board's components

Figure 5: T-SIM7000G Component Layout

Familiarize yourself with the board's key components:

  • Solar Charging Cable Interface: For connecting a solar panel.
  • Power Switch: Controls power when using a battery.
  • Nano SIM Slot: For inserting your Nano SIM card.
  • USB Interface: For power and data connection to a computer.
  • TF Card Slot: For inserting a MicroSD (TF) card.
  • Reset Button: To reset the board.

6.2. Antenna Connection

Connect the SIM and GPS antennas to their respective U.FL connectors on the board. Ensure a secure connection.

Close-up of SIM and GPS antenna connections on the board

Figure 6: SIM and GPS Antenna Connection

Detail of antenna connection points

Figure 7: Antenna Connection Detail

6.3. SIM Card Insertion

Insert a Nano SIM card into the Nano SIM slot. Ensure the USIM card supports 2G (GSM)/NB-IOT access.

6.4. Powering the Board

  • USB-C: Connect the board to your computer using a USB-C cable. This provides power and allows for programming.
  • 18650 Battery: Insert an 18650 battery into the battery holder on the back of the board. Observe correct polarity.
  • Bottom view of the board showing the 18650 battery holder

    Figure 8: 18650 Battery Holder

  • Solar Panel: Connect a solar panel (recommended 4.4V to 6V) to the solar charging cable interface.
  • Diagram showing solar panel connection to the board via a power cable

    Figure 9: Solar Panel Connection

6.5. Attaching Additional Modules (Optional)

If using additional modules, such as a LoRa shield, carefully align and connect them to the pin headers.

Hands demonstrating how to attach a module to the main board

Figure 10: Module Attachment

7. Operating Instructions

7.1. Initial Network Test

To initialize a network test, ensure your GPS antenna is connected. The blue indicator light will flash during positioning. Once the location is locked, latitude and longitude will be displayed.

Screenshot of serial terminal output showing GPS positioning data

Figure 11: GPS Positioning Output

After the network test is complete, you can enter AT commands in the serial terminal.

7.2. Network Mode Configuration

The SIM7000 series supports various network modes. You can configure the network mode using AT commands or within your code. For example, to set the network mode to LTE only (mode 38):

String res;
do {
res = modem.setNetworkMode(38); // 38 for LTE only
delay(500);
} while (res != "OK");
Code snippet for setting network mode using modem.setNetworkMode()

Figure 12: Network Mode Setting Example

To set the preferred mode (e.g., CAT-M and NB-IoT, mode 3):

do {
res = modem.setPreferredMode(3); // 3 for CAT-M and NB-IoT
delay(500);
} while (res != "OK");
Code snippet for setting preferred mode using modem.setPreferredMode()

Figure 13: Preferred Mode Setting Example

You can also configure locked bands. For example, to configure NB-IoT band 8:

modem.sendAT("+CBANDCFG=\"NB-IOT\",8");
Code snippet for configuring locked bands using modem.sendAT()

Figure 14: Locked Band Configuration Example

7.3. GPS Usage

When using GPS, the SIM7070 positioning and cellular functions cannot be used simultaneously. Disconnect the network when positioning, and turn off GPS when connecting to the network.

For Version 20200415, when using GPS, the SIM7000G (GPIO4) / SIM7070G (GPIO5) (physical pin number 48) needs to be set to HIGH to enable the antenna:

modem.sendAT("+CGPIO=0,48,1,1");

Once finished, the pin can be set LOW to prevent power leakage to the GPS antenna, which helps battery life:

modem.sendAT("+CGPIO=0,48,1,0");

If using USB power or if battery life is not a concern, it can be left HIGH.

8. Firmware Update

For detailed instructions on how to update the firmware, please refer to the official GitHub repository:

Upgrade Guidelines on GitHub

Binary files are available in the firmware directory on GitHub. You can use the Flash Download Tools to download and flash the firmware.

9. Troubleshooting

  • No Power/Device Not Turning On:
    If the device doesn't turn on when connected via USB, ensure the USB cable is functional. The on/off switch only functions when using a battery; it is bypassed when powered by USB. If using an external battery pack connected to the VBAT pin, the on/off switch will be bypassed, requiring battery disconnection to power off.
  • Network Access Issues:
    The SIM7000/SIM707G does not support 4G networks. Ensure your USIM card supports 2G (GSM)/NB-IOT access. Initial network registration can be slow; please be patient. Try the examples/Arduino_NetworkTest sketch to diagnose connection issues.
  • GPS Not Functioning:
    Ensure the GPS antenna is securely connected. Remember that SIM7070 positioning and cellular functions cannot be used simultaneously. Disconnect the network when positioning and turn off GPS when connecting to the network. Check the GPS antenna power management settings (GPIO4/GPIO5 for SIM7000G/SIM7070G) as described in the operating instructions.
  • Software Upload Errors (Arduino IDE):
    If you encounter issues uploading sketches in Arduino IDE, ensure no SD card is inserted. The SD card uses IO2 as CS, which can interfere with the upload process. Remove the SD card before uploading new firmware.
  • Battery Voltage Reading:
    Battery voltage cannot be read using the onboard BAT ADC (pin 35) when the board is plugged into USB.
  • Flash Errors / Non-functional LEDs:
    If experiencing flash errors or non-responsive status LEDs, verify all connections are secure and the board is receiving adequate power. Re-flashing the firmware as per the instructions in Section 8 might resolve software-related issues.

10. User Tips

  • Power Supply Safety: When connecting external power sources, especially solar panels, always observe the positive and negative poles. Ensure the input voltage does not exceed 6V to prevent damage to the board. Recommended solar panel input is 4.4V to 6V.
  • GPS and Cellular Coexistence: For optimal performance and power efficiency, avoid using GPS positioning and cellular functions simultaneously. Disconnect the network when actively using GPS, and disable GPS when cellular connectivity is prioritized.
  • GPS Antenna Power Management: To conserve battery life, especially on Version 20200415, remember to explicitly disable the GPS antenna power (set GPIO4/GPIO5 LOW) when GPS is not in use.
  • Network Protocol Compatibility: Note that the SIM7000G module supports HTTP fully but does not support HTTPS. Plan your network communications accordingly.
  • External Connections: For robust external wiring, consider using terminal screw block connectors for secure and reliable connections.
  • Image showing a terminal screw block connector wired to the board

    Figure 15: Terminal Block Connection Example

11. Warranty and Support

For technical support, documentation, and community resources, please visit the official LILYGO GitHub repository: https://github.com/Xinyuan-LilyGO/LilyGo-Modem-Series.

This module is a development board designed for verification test experiments. When purchasing and using, it must comply with local wireless management regulations, including the selection of frequencies that comply with local laws.

For any product-related inquiries or issues, please contact the manufacturer or your point of purchase for assistance.

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.