✨ LilyGO T-SIM7080G-MicroPython ✨

English | 中文

News

• SIM7080G supports NB-IoT and Cat-M in global frequency bands, but does not support 2G/3G/4G. Please confirm that the SIM card used supports NB-IoT or Cat-M before use.
• The SIM card must be inserted first before starting the SIM7080. If the SIM card is inserted after the SIM7080 is turned on, the modem will not be able to detect the SIM card.

1️⃣ Examples preview

examples 
├─ATDebug                           # AT Commands Example
├─BLE5_extended_scan                # Official BLE5 Example
├─BLE5_multi_advertising            # Official BLE5 Example
├─BLE5_periodic_advertising         # Official BLE5 Example    
├─BLE5_periodic_sync                # Official BLE5 Example
├─MinimalCameraExample              # Example of camera use
├─MinimalDeepSleepExample           # DeepSleep example
├─MinimalLowBattPowerExample        # Low Battery example
├─MinimalModemGPSExample            # SIM7080G GPS example
├─MinimalModemNBIOTExample          # SIM7080G NBIOT example
├─MinimalModemPowerSaveMode         # SIM7080G power maintenance example
├─MinimalModemSleepMode             # SIM7080G sleep example
├─MinimalModemAndEspSleep           # SIM7080G & ESP32 sleep example
├─MinimalModemUpgrade               # Upgrade SIM7080 built-in firmware
├─MinimalPowersCurrentExample       # Example of PMU charge current debug
├─MinimalPowersExample              # Example of PMU
├─MinimalSDCardExample              # Example of using SDCard            
├─ModemMqttsExample                 # MQTTS Example    
├─SIM7080G-ATT-NB-IOT-AWS-MQTT      # MQTTS AWS By @bootcampiot
├─SIM7080G-ATT-NB-IOT-HTTP-HTTPS    # HTTP/HTTPS  By @bootcampiot
└─SIM7080G-ATT-NB-IOT-SSL-Mosquitto # MQTTS Mosquitto By @bootcampiot

2️⃣ Quick start ⚡

RT-Thread MicroPython (Recommended)

1. Install Python (according to you to download the corresponding operating system version, suggest to download version 3.7 or later), MicroPython requirement 3. X version, if you have already installed, you can skip this step).

2. Install VisualStudioCode,Choose installation based on your system type.

3. Open the "Extension" section of the Visual Studio Code software sidebar(Alternatively, use "Ctrl+Shift+X" to open the extension),Search for the "RT-Thread MicroPython" extension and download it.

4. During the installation of the extension, you can go to GitHub to download the program. You can download the main branch by clicking on the "<> Code" with green text, or you can download the program versions from the "Releases" section in the sidebar.

5. After the installation of the extension is completed, open the Explorer in the sidebar(Alternatively, use "Ctrl+Shift+E" go open it),Click on "Open Folder," locate the project code you just downloaded (the entire folder), and click "Add." At this point, the project files will be added to your workspace.

6. Open the VisualStudioCode terminal (or use Ctrl+`), and enter the command to install the esptools tool.

   pip install esptool
   

7. ESP32S3 erase the flash memory and enter commands in the terminal:

   python -m esptool --chip esp32s3 --port COMX erase_flash
   

   Note：

   1. COMX is the port number. Change it to the port number corresponding to your computer.

8. ESP32S3 upload the MicroPython firmware:

   python -m esptool --chip esp32s3 --port COMX --baud 460800 --before=default_reset --after=hard_reset write_flash -z 0x0 D:\LilyGo-T-SIM7080G-MicroPython\firmware\LilyGo-T-SIM7080G-MicroPython-firmware.bin
   

   Note：

   1. COMX is the port number. Change it to the port number corresponding to your computer.
   2. D:\LilyGo-T-SIM7080G-MicroPython\firmware\LilyGo-T-SIM7080G-MicroPython-firmware.bin is the firmware path. Change it to the corresponding storage path.
   3. If you need to make your own MicroPython firmware, please refer to Tutorial for the operation.

9. Click on "Device Connected/Disconnected" at the lower left corner, and then click on the pop-up window "COMX" at the top to connect the serial port. A pop-up pops up at the lower right corner saying "Connection successful" and the connection is complete.

10. After opening the code, click on“▶”at the lower left corner to run the program“Run this MicroPython file directly on the device”，Or use theAlt+Q），if you want to stop the program, click on the lower left corner of the“⏹”stop running the program.(If you need to run the program automatically on the board, please copy the code to the "main.py" file under the "exampels" folder and save it. Select the "main.py" file with the left mouse button. Right-click the mouse and select "Download this file/folder to device", then press the reset button on the board to run the program automatically.)

Important

1. Unable to upload any code? Please see the FAQ below

Use reference

Product	Youtube link	explanation	Status
T -7080G	Youtube link	How to update the firmware of SIM7080G series products	✅
LilyGo device	Youtube link	How to enter boot mode to download the firmware	✅

3️⃣ Tips

0. T-SIM7080 has two USB ports, the USB-C port is used to upload sketches and Serial output, and Micro-USB is used for SIM7080G firmware version upgrade
1. ⚠ SIM7080G cannot connect to cellular network and GPS positioning at the same time
2. Board integrated PMU (Power management chip), with short circuit and overload protection. By default,PWRKEYneeds to be pressed for 6 seconds to turn off the board power supply, and pressPWRKEYfor 128 milliseconds to turn on the power supply. If you need to modify the power off pressing time, please refer toMinimalPowersExample
3. If the charging function is required, thePMU TS Pindetection function needs to be turned off. By default, there is no NTC sensor on the board, so the TS Pin detection needs to be disabled before the charging function can be used normally. If theTS Pindetection function is not turned off, the PMU charging indicator will flash after the battery is inserted, and charging will be disabled
4. The VSYS pin is the system path voltage of the PMU. The voltage of this pin is equal to the input voltage. The output of this pin is equal to the input voltage. If the input voltage source is USB-C, then this pin is the voltage of USB-C. If it is a battery, then this pin is the voltage of the battery.
5. The DC5 power supply voltage can be adjusted, and the maximum output current should not exceed 1A
6. DC1 is the core power supply voltage, and the default output is 3.3V. Please do not adjust the DC1 voltage through software
7. When the firmware cannot be uploaded, please hold down the 'BOOT' button on the board and then press the 'RST' button. At this point, you should be able to see the port in the device manager of your computer, and then upload the firmware again
8. When the power supply channel of the ESP32S3 is closed incorrectly, please insert USB, and then press and hold the BOOT button of the board, and then press and hold the PWRKEY button. At this time, the board enters the download mode, and the sketch can be uploaded normally
9. If the power supply of the board cannot be turned on when the battery is connected, please check that the mechanical switch beside the USB is turned toON, and then press the board PWR for 2 seconds. At this time, the board should start to work
10. The range of solar input voltage is 4.4~6V. Please select an appropriate solar panel and set the maximum charging current as 500mA
11. If the camera is not connected, all IO ports are available. If the camera is used, the board has only GPIO45 and GPIO46 is idle
12. T-SIM7080G uses Octal SPI PSRAM, so GPIO35~GPIO37 is unavailable. Please do not use these IOs
13. ⚠ Please understand the risks to be faced before changing the voltage of peripherals, otherwise do not try to change the voltage of cameras and other on-board devices, which may cause permanent damage
14. ⚠ Please do not turn off the BLDO1 power supply, otherwise ESP32S3 and SIM7080G cannot communicate normally
15. Please check the Operating Instructions for updating the built-in firmware of the modem. Generally, upgrading the firmware is not recommended
16. The board uses USB as the JTAG upload port. When printing serial port information on USB_CDC_ON_BOOT configuration needs to be turned on. If the port cannot be found when uploading the program or the USB has been used for other functions, the port does not appear. Please enter the upload mode manually.
    1. Connect the board via the USB cable
    2. Press and hold the BOOT button , While still pressing the BOOT button, press RST
    3. Release the RST
    4. Release the BOOT button
    5. Upload sketch
17. If you encounter a problem that you cannot register a network, please refer to this issue#100

4️⃣ Where to buy:

1. AliExpress
2. LilyGo Store

5️⃣ Pins

Camera	PWDN	Reset	XCLK	SDA	SCL	VSYNC	HREF	PCLK
GPIO	N/A	18	8	2	1	16	17	12
Camera	D9	D8	D7	D6	D5	D4	D3	D2
GPIO	9	10	11	13	21	48	47	14

• If you do not use a camera, you can freely allocate IO ports here. Assuming you need to allocate I2C, please use the display to call Wire and pass the required IO ports, such as

  int sda = 13;  // You can also use other IO ports
  int scl = 21;  // You can also use other IO ports
  Wire.begin(sda,scl)

Modem	PWR	RXD	TXD	RI	DTR
GPIO	41	4	5	3	42

PMU	SDA	SCL	IRQ
GPIO	15	7	6

SDCard	CMD	CLK	DATA
GPIO	39	38	40

6️⃣ Power domain

Modem	Camera	ESP32S3	SDCard	Level conversion
DC3/BLDO2(GPS)	ALDO1/ALDO2/ALDO4	DC1	ALDO3	BLDO1

7️⃣ Voltage range

Battery Voltage requirements	Minimum	Maximum	Charging Current
SIM7080G	3.5V	4.2V	Custom adjustment, maximum 1A

• It is recommended to use flat top 18650 batteries with a capacity of more than 2500mA

Solar Voltage requirements	Minimum	Maximum	Charging Current
SIM7080G	4.4V	6V	500mA

Tip

It is recommended to use a solar panel with an output voltage of 6V or 5V and a power of about 5-10W. Solar energy can only charge the battery. Without the battery, the panel cannot supply power. Please note that this is only a suggestion. It is not necessary to use a 5-10W solar panel. 1W is also acceptable. The size of the solar panel determines the current and speed of solar charging. Please note that depending on the environment, the sunshine time may not exceed one hour per day. At this time, if the solar panel is too small and the light is not sufficient, it cannot be charged.

8️⃣ ON-BOARD LED

FUNCTION	COLOR
MODEM STATUS	RED (Near the modem)
MODEM NETWORK STATE	RED (Near the modem)
CHARGE LED	BLUE (Controlled by PMU, default charging indicator)

• The network status light can be turned off by command, please see the AT manual AT+CNETLIGHT command
• Status light cannot be turned off

MODEM NETWORK STATE

Network light status	Module working status
64ms on/ 800ms off	When not registered on the network
64ms on/ 3000ms off	Already registered on the network (PS domain registration successful)
64ms on/ 300ms off	During data transmission (PPP dial-up state and when using internal TCP/FTP/HTTP and other data services)
Off	Power off or PSM sleep mode