Documentation

English

中文

English

中文

Appearance

T-Lora Pager get it now ​

T-LoraPager front view
T-LoraPager physical image
T-LoraPager component overview
T-LoraPager dimension diagram

Overview ​

T-LoraPager is a handheld AIOT programmable development device launched by LILYGO, integrating ESP32-S3 high-performance Wi-Fi/Bluetooth dual-mode chip with multiple wireless communication modules. The device features a compact appearance and foldable external antenna design, ensuring wireless performance while maintaining aesthetics. Multiple version options are provided, mainly differing in LoRa modules (LR1121, SX1262 or CC1101), allowing users to choose according to application requirements.

The development board is feature-rich, integrating QWERT keyboard, AI-enabled IMU (BHI260AP), 2.33-inch strip screen (480×222 resolution), U-blox GPS module (MIA-M10Q), RFID/NFC, RTC circuit, TI power management chip, ES8311 audio codec (supporting microphone, speaker, headphone), rotary encoder, GPIO expansion interface, etc. The back design includes 1/4 fixed screw interface and M2 screw pillars, with a lanyard included for easy carrying and fixing. The factory firmware includes UI Demo designed by LILYGO, enabling smooth interaction through the encoder, suitable for smart wearables, IoT positioning, data collection and other scenario development.

Quick Start ​

Example Support ​

ExamplePlatformIO/ArduinoESP-IDFDescription
UI Demo✓Factory UI Demo Program
LoRa Example✓LoRa Communication Example
GPS Example✓GPS Positioning Example
Keyboard Example✓Keyboard Input Example
Audio Example✓Audio Playback Example

PlatformIO ​

  1. Install Visual Studio Code.
  2. Search for and install "PlatformIO IDE" in extensions.
  3. Download T-LoraPager project code from GitHub.
  4. Open the project folder in VS Code, edit the platformio.ini file to select the desired environment.
  5. Connect the device, compile and flash the program.

Arduino ​

  1. Install Arduino IDE
  2. Install Arduino ESP32 V3.3.0-alpha1 or higher or latest version
  3. Download LilyGoLib library
  4. Open Arduino IDE -> Sketch -> Include Library -> Add .ZIP Library -> Select the library zip file downloaded in step 3
  5. Install LilyGoLib-ThirdParty
    • Copy all directories from LilyGoLib-ThirdParty to the ArduinoIDE libraries directory. If there is no libraries directory, please create it manually.
    • Please note: do not copy the LilyGoLib-ThirdParty directory itself, but copy all folders under that directory to the libraries directory
    • How to find library file location on your computer, please refer here
      • Windows: C:\Users\{Username}\Documents\Arduino
      • macOS: /Users/{Username}/Documents/Arduino
      • Linux: /home/{Username}/Arduino

Please note that the libraries in LilyGoLib-ThirdParty are not necessarily the latest versions. Before confirming the hardware is working properly, please do not upgrade the dependent library versions. ArduinoIDE will prompt that new library versions are available for upgrade every time it opens. Please confirm normal operation before attempting to update to the latest versions. If you encounter issues, please revert to the dependent library versions that worked properly.

  1. File -> Examples -> LilyGOLib -> helloworld
  2. Tools -> Board -> esp32, please select the corresponding configuration from the table below
Arduino IDE SettingValue
BoardLilyGo-T-LoRa-Pager
PortYour port
USB CDC On BootEnabled
CPU Frequency240MHZ(WiFi)
Core Debug LevelNone
USB DFU On BootDisable
Erase All Flash Before Sketch UploadDisable
Events Run OnCore 1
JTAG AdapterDisable
Arduino Runs OnCore 1
USB Firmware MSC On BootDisable
Partition Scheme16M Flash(3M APP/9.9MB FATFS)
Board RevisionRadio-SX1262
Upload ModeUART0/Hardware CDC
Upload Speed921600
USB ModeCDC and JTAG
  1. Board Revision Option, please select according to the actual purchased RF type. 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)
  2. Select Port
  3. Click Upload, wait for compilation and writing to complete
  4. If unable to upload the program or the USB device keeps popping up on the computer, please manually put the device into download mode. How to enter download mode, please refer to here
  • If there is no serial message output, please check if USB CDC ON Boot is set to Enabled.
  • The board revision varies according to the actual RF module model. The current default version is SX1262.
  • This library depends on the latest arduino-esp32 version. If it is lower than V3.3.0-alpha1, it will report an error.

Development Platforms ​

  1. Platform IO
  2. Arduino IDE
  3. Micropython
  4. VS Code

Video ​

Key Features ​

  • ESP32-S3 high-performance Wi-Fi / Bluetooth 5 (LE) dual-mode chip
  • Multiple LoRa module options: SX1262 (433–920 MHz), LR1121 (Sub-1G + 2.4G), CC1101 (Sub-1G), SX1280 (2.4G), SI4432
  • 2.33-inch IPS LCD display (480 × 222, ST7796, SPI)
  • QWERT keyboard (TCA8418) + rotary encoder input
  • AI-enabled IMU: Bosch BHI260AP
  • U-blox MIA-M10Q GNSS (4-constellation concurrent)
  • RFID / NFC: ST25R3916 (SPI)
  • ES8311 audio codec with microphone, speaker, and headphone support (24-bit, 8–96 kHz)
  • 16 MB Flash + 8 MB PSRAM
  • TF card slot (up to 32 GB, FAT32)
  • RTC: NXP PCF85063A
  • TI power management: BQ25896 charger + BQ27220 fuel gauge
  • Haptic feedback: TI DRV2605
  • 1/4-inch fixed screw interface + 4 × M2 mounting holes + lanyard support
  • Dimensions: 106 × 89 × 23 mm

Product Parameters ​

FeaturesParams
SOCESP32-S3 @ Dual-core Xtensa LX7 processor, 240MHz main frequency
Flash16MB (QSPI)
PSRAM8MB (QSPI)
Wi-Fi2.4 GHz Wi-Fi
USBUSB OTG, USB Serial/JTAG.
Display2.33" @ 480 × 222, ST7796
Display Backlight DriverAW9364 16-Level Led Driver
GNSS ModuleUBlox MIA-M10Q
LoRa433 MHz ~ 920 MHz @ Semtech SX1262 (Optional LR1121 / CC1101)
NFCST ST25R3916
Smart sensorSelf-learning AI @ AI6-axis IMU, Bosch BHI260AP
Real-Time ClockNXP PCF85063A
Battery ChargerTi BQ25896
Battery GaugeTi BQ27220
Haptic driverTi DRV2605
Audio Codec24-bit @ 8k-96kHz, ES8311, I2S protocol
SpeakerNsiway NS4150B (3W Class D)
Microphone#FIXME
Keyboard34keys @ TCA8418
Rotary Encoder#FIXME
GPIO ExpandXINLUDA XL9555
SD Card SocketMaximum 32GB (FAT32 format)

Pin Diagram ​

summary

Display ​

ST7796BLRESETSCKMOSIMISOCSDC
ESP32-S3GPIO42NCGPIO35GPIO34GPIO33GPIO38GPIO37

SDCard ​

SDCardSCKMOSIMISOCSPower ENInsert Detect
ESP32-S3GPIO35GPIO34GPIO33GPIO21
XL9555GPIO14GPIO12

Audio ​

ES8311WSSCKMCLKDATA-OUTDATA-IN
ESP32-S3GPIO18GPIO11GPIO10GPIO45GPIO17

Keyboard & Encoder & Button ​

TCA8418SCLSDAINTPower ENRESET
ESP32-S3GPIO2GPIO3GPIO6
XL9555GPIO10GPIO2
EncoderABCenter
ESP32-S3GPIO40GPIO41GPIO7
ButtonPin
ESP32-S3GPIO0

NFC ​

ST25R3916SCKMOSIMISOCSINTPower EN
ESP32-S3GPIO35GPIO34GPIO33GPIO39GPIO1
XL9555GPIO5

Sensor ​

TCA8418SCLSDAINT
ESP32-S3GPIO2GPIO3GPIO8
DRV2605SCLSDA
ESP32-S3GPIO2GPIO3
BQ27220SCLSDA
ESP32-S3GPIO2GPIO3
BQ25896SCLSDA
ESP32-S3GPIO2GPIO3

GNSS ​

MIA-M10QTXDRXDPPSPower ENRESET
ESP32-S3GPIO12GPIO4GPIO13
XL9555GPIO4GPIO7

LoRa ​

SX1262 / SX1280SCKMOSIMISOCSINTRESETBUSYPower EN
ESP32-S3GPIO35GPIO34GPIO33GPIO36GPIO14GPIO47GPIO48
XL9555GPIO3

Expand(XL9555) ​

XL9555SCLSDA
ESP32-S3GPIO2GPIO3

External scoket(Adaptation nRF24L01) ​

FUNCSCLSDAMISOSCKTXD
PINGPIO2GPIO3GPIO33GPIO35GPIO43GND
PIN5VXL9555 IO9GPIO9GPIO34GPIO443V3
FUNCCEGPIOMOSIRXD

Dimension Diagram ​

summary

Schematic ​

Datasheet ​

Software Development ​

FAQ ​

  • Q. How to choose between different versions of T-LoraPager? A. Choose LoRa module according to application requirements: SX1262 for long-distance communication, LR1121 for multi-band support, CC1101 for low-cost Sub-1GHz applications.

  • Q. What to do if the device cannot flash the program? A. Ensure USB CDC On Boot is enabled, and hold the BOOT button while clicking RESET to enter download mode.

  • Q. GPS positioning is slow or no signal? A. Ensure use in outdoor open areas, and check if the antenna connection is good.

Version History ​

VersionRelease dateUpdate description
V1.02024-08-05Initial Version

Power Consumption Tests ​

ModeWake-Up ModeCurrent
DeepSleepBootButton530uA
DeepSleepTimer530uA
LightSleepBootButton~2.26mA
Power OFFPowerButton26uA