Documentation

中文

English

中文

English

主题

LILYGO T-LoraPager get it now ​

T-LoraPager 正面图
T-LoraPager 实物图
T-LoraPager 引脚图

概述 ​

T-LoraPager 是一款 LILYGO 推出的手持式 AIOT 可编程开发设备，集成了 ESP32-S3 高性能 Wi-Fi/蓝牙双模芯片与多种无线通信模块。设备采用小巧外观与可折叠外部天线设计，在保证无线性能的同时兼顾美观。提供多种版本选择，主要区别在于 LoRa 模块（LR1121、SX1262 或 CC1101），用户可根据应用需求选购。

开发板功能丰富，集成 QWERT 键盘、支持 AI 的 IMU（BHI260AP）、2.33 英寸长条屏（480×222 分辨率）、U-blox GPS 模组（MIA-M10Q）、RFID/NFC、RTC 电路、TI 电源管理芯片、ES8311 音频编解码器（支持麦克风、扬声器、耳机）、旋转编码器、GPIO 扩展接口等。背部设计有 1/4 固定螺丝接口与 M2 螺丝柱，并附带挂绳，便于携带与固定。出厂固件包含 LILYGO 设计的 UI Demo，可通过编码器进行流畅交互，适合智能穿戴、物联网定位、数据采集等场景开发。

快速开始 ​

示例支持 ​

示例PlatformIO/ArduinoESP-IDF描述
UI Demo✓出厂 UI 演示程序
LoRa Example✓LoRa 通信示例
GPS Example✓GPS 定位示例
Keyboard Example✓键盘输入示例
Audio Example✓音频播放示例

PlatformIO ​

  1. 安装 Visual Studio Code。
  2. 在扩展中搜索并安装 "PlatformIO IDE"。
  3. 从 GitHub 下载 T-LoraPager 项目代码。
  4. 在 VS Code 中打开项目文件夹，编辑 platformio.ini 文件选择所需环境。
  5. 连接设备，编译并烧录程序。

Arduino ​

  1. 安装 Arduino IDE。
  2. 安装 Arduino ESP32 V3.3.0-alpha1 或更高版本
    • Arduino 管理器网址：https://espressif.github.io/arduino-esp32/package_esp32_dev_index.json
  3. 下载 LilyGoLib 库
  4. 打开 Arduino IDE -> 项目 -> 加载库 -> 添加 .ZIP 库 -> 选择下载的库压缩包
  5. 安装 LilyGoLib-ThirdParty：将所有目录复制到 Arduino IDE 的库目录中
  6. 文件 -> 示例 -> LilyGOLib -> helloworld
  7. 工具 -> 开发板 -> esp32，选择如下配置：
Arduino IDE 设置值
BoardLilyGo-T-LoRa-Pager
Upload Speed921600
USB ModeCDC and JTAG
USB CDC On BootEnabled
USB Firmware MSC On BootDisabled
USB DFU On BootDisabled
CPU Frequency240MHz (WiFi)
Core Debug LevelNone
Partition Scheme16M Flash (3MB APP/9.9MB FATFS)
Board RevisionRadio-SX1262（根据购买版本选择）
Upload ModeUART0/Hardware CDC
Arduino Runs OnCore 1
Events Run OnCore 1

开发板版本选项（根据购买的射频类型选择）：

  • Radio-SX1262（Sub 1G LoRa）
  • Radio-SX1280（2.4G LoRa）
  • Radio-CC1101（Sub 1G (G)MSK, FSK, ASK, OOK）
  • Radio-LR1121（Sub 1G + 2.4G LoRa）
  • Radio-SI4432（Sub 1G ISM）

注意：如果串口没有消息输出，请检查 USB CDC ON Boot 是否设置为 Enabled。本库依赖于最新版 arduino-esp32 V3.3.0-alpha1 或更高版本。

开发平台 ​

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

视频 ​

主要特点 ​

  • ESP32-S3：16 MB Flash，8 MB PSRAM，Wi-Fi + 蓝牙 5.0
  • SX1262 LoRa（433-920MHz，可选 LR1121/CC1101），MIA-M10Q GPS，ST25R3916 NFC
  • BHI260AP AI IMU 传感器，PCF85063A RTC，ES8311 音频编解码器
  • 2.33 英寸 ST7796 IPS LCD（480×222），QWERT 键盘，旋转编码器
  • BQ25896 充电，BQ27220 电量监测，DRV2605 振动电机
  • TF 卡槽，GPIO 扩展接口，1/4 英寸螺丝接口

产品参数 ​

组件描述
MCUESP32-S3
Flash16MB
PSRAM8MB
屏幕2.33 英寸 ST7796 IPS LCD (480×222)
LoRaSX1262 (433-920MHz)，可选 LR1121/CC1101
GPSMIA-M10Q (U-blox)
NFCST25R3916 (SPI)
AI 传感器BHI260AP
音频ES8311（麦克风 + 扬声器 + 耳机）
RTCPCF85063A
充电芯片BQ25896
电量监测BQ27220
振动电机DRV2605
存储TF 卡（最大 32GB FAT32）
无线2.4 GHz Wi-Fi & Bluetooth 5 (LE)
USB1 × TYPE-C
输入QWERT 键盘（TCA8418）+ 旋转编码器
IO 扩展XL9555 (I²C)
扩展接口GPS 接口 + 2 × Knockout + 2.54mm 2×8 GPIO
按键RESET + BOOT
固定孔1/4 英寸螺丝接口 + 4 × M2 背孔
尺寸106 × 89 × 23mm

引脚图 ​

T-LoraPager 引脚图T-LoraPager 概述图

引脚映射 ​

名称GPIO可用
Custom PinGPIO9（外部12-Pin接口）✅
Uart1 TX43（外部12-Pin接口）✅
Uart1 RX44（外部12-Pin接口）✅
SDA3❌
SCL2❌
SPI MOSI34❌
SPI MISO33❌
SPI SCK35❌
SD CS21❌
Keyboard INT6❌
Keyboard BL46❌
Rotary Encoder A40❌
Rotary Encoder B41❌
Rotary Encoder SW7❌
RTC INT1❌
NFC CS39❌
NFC INT5❌
Sensor INT8❌
Audio WS18❌
Audio SCK11❌
Audio MCLK10❌
Audio Dout45❌
Audio Din17❌
GNSS TX12❌
GNSS RX4❌
GNSS PPS13❌
LoRa RST47❌
LoRa BUSY48❌
LoRa CS36❌
LoRa INT14❌
Display CS38❌
Display DC37❌
Display BL42❌

尺寸图 ​

T-LoraPager 三视图

原理图 ​

数据手册 ​

软件开发 ​

依赖库 ​

常见问题 ​

  • Q. 如何选择不同版本的 T-LoraPager？
    A. 根据应用需求选择 LoRa 模块：SX1262 适用于长距离通信，LR1121 支持多频段，CC1101 适用于低成本 Sub-1GHz 应用。

  • Q. 设备无法烧录程序怎么办？
    A. 确保 USB CDC On Boot 已启用，并按住 BOOT 按键再点击 RESET 进入下载模式。

  • Q. GPS 定位慢或无信号？
    A. 确保在户外开阔地区使用，并检查天线连接是否良好。

  • Q. Arduino ESP32 版本要求是什么？
    A. 本库依赖于 arduino-esp32 V3.3.0-alpha1 或更高版本，低版本会报错。

功耗测试 ​

模式唤醒方式电流
DeepSleepBootButton530uA
DeepSleepTimer530uA
LightSleepBootButton~2.26mA
Power OFFPowerButton26uA

版本历史 ​

VersionUpdate dateUpdate description
T-LoraPager_V1.02024-08-05初始版本