What is LILYGO T-Lora Pager?
LILYGO T-Lora Pager is a compact handheld development device with LoRa wireless communication, based on the ESP32-S3 microcontroller. It features a QWERTY keyboard, 2.33-inch color display, GPS, NFC, audio support, and various sensors. It’s designed for AIOT applications and is compatible with Arduino IDE and other development platforms.
Arduino IDE Quick Start Guide
Tip: As of 2025/04/28, platformio does not support the latest esp-arduino v3 and above. The current supported version is v2.0.17 (based on IDF v4.4.7) .
-
Install the Arduino IDE.
-
Install the Arduino ESP32 board package version 3.3.0-alpha1 or later (preferably the latest version).
Use the Arduino Board Manager URL: https://espressif.github.io/arduino-esp32/package_esp32_dev_index.json -
Download the LilyGoLib library.
-
In the Arduino IDE, go to Sketch -> Include Library -> Add .ZIP Library, and select the LilyGoLib ZIP file you downloaded.
-
Install the LilyGoLib-ThirdParty package:
-
Copy all the folders inside the LilyGoLib-ThirdParty directory into your Arduino IDE’s libraries folder.
If the libraries folder does not exist, please create it.
Note: Do not copy the entire LilyGoLib-ThirdParty directory itself, only the folders contained within it. -
To locate your Arduino libraries folder on your computer:
Windows: C:\Users\{username}\Documents\Arduino
macOS: /Users/{username}/Documents/Arduino
Linux: /home/{username}/Arduino
Tip: Please be aware that the libraries included in LilyGoLib-ThirdParty may not be the most up-to-date versions. Do not update the dependent libraries to newer versions unless you have confirmed that the hardware is functioning correctly. Every time you open the Arduino IDE, it may notify you of available library updates. Before upgrading, ensure your hardware runs properly with the current versions. If you experience any issues after updating, revert to the previously working versions of the dependent libraries. You can check the current list of dependent library versions here.
-
Open Arduino IDE and navigate to File -> Examples -> LilyGOLib -> helloworld
-
Set up the board by going to Tools -> Board -> esp32, then select the appropriate option from the table below:
| Arduino IDE Setting | Value |
| Board | LilyGo-T-LoRa-Pager |
| Port | Your port |
| USB CDC On Boot | Enabled |
| CPU Frequency | 240MHZ(WiFi) |
| Core Debug Level | None |
| USB DFU On Boot | Disable |
| Erase All Flash Before Sketch Upload | Disable |
| Events Run On | Core 1 |
| JTAG Adapter | Disable |
| Arduino Runs On | Core 1 |
| USB Firmware MSC On Boot | Disable |
| Partition Scheme | 16M Flash(3M APP/9.9MB FATFS) |
| Board Revision | Radio-SX1262 |
| Upload Mode | UART0/Hardware CDC |
| Upload Speed | 921600 |
| USB Mode | CDC and JTAG |
-
Board Revision options must be selected based on the RF module you have purchased. Current options include:
-
Radio-SX1262 (Sub 1G LoRa)
-
Radio-SX1280 (2.4G LoRa)
-
Radio-CC1101 (Sub 1G (G)MSK, 2(G)FSK, 4(G)FSK, ASK, OOK)
-
Radio-LR1121 (Sub 1G + 2.4G LoRa)
-
Radio-SI4432 (Sub 1G ISM)
-
Select the correct Port.
-
Click Upload and wait for the sketch to compile and upload.
-
If you are unable to upload the sketch or the USB device repeatedly connects and disconnects, please manually put the device into download mode. Instructions for entering this mode can be found T-LoRa-Pager Enter Download Mode.
Note:
-
If no data appears in the serial output, verify that USB CDC On Boot is set to Enabled.
-
The Board Revision should match the actual RF module installed, with the default being SX1262.
-
This library requires the latest version of arduino-esp32. Versions lower than V3.3.0-alpha1 will produce an error.
LILYGO T-LoRa-Pager Download Mode Instructions
If your USB ports keep popping in and out, download mode is needed only when the sketch upload fails. Normally, this step is not necessary.
To enter download mode:
-
Connect your board via a USB-C cable.
-
Press and hold the BOOT button.
-
While holding BOOT, release the RST button.
-
Then release the BOOT button.
-
The USB port should now remain stable without flashing. You can proceed by clicking Upload.
-
Press the RST button to exit download mode.
If the new code uploads successfully but the device does not power on or behaves abnormally, please use the provided factory test code to check if the peripherals are functioning correctly. You can download the firmware and instructions for testing here.
