LILYGO T-Deck Pro get it now
概述
LILYGO T-Deck Pro 是一款基于 ESP32-S3 芯片的高度集成多功能开发平台，支持 4G 通信和 LoRa 远距离无线传输，配备电子墨水屏（EPD）及触摸功能，兼顾低功耗显示与交互。其硬件模块涵盖 GPS 定位、陀螺仪传感、麦克风语音输入、SD 卡存储、机械键盘以及自学习 AI IMU，适用于物联网、户外设备、智能终端等场景。可以根据需求选择版本：版本一搭载音频模块 PCM512A，版本二搭载 4G 模块 A7682E，提供灵活配置，满足工业控制、环境监测、便携设备等多元化需求。
快速开始
示例支持
| 示例 | PlatformIO | Arduino | 描述 |
|---|---|---|---|
| A7682E/test_AT | ✓ | 4G 模块 AT 指令测试 | |
| 出厂程序 | ✓ | ✓ | 出厂固件 |
| 更多示例 | ✓ | ✓ | 参考 GitHub 仓库 |
PlatformIO
- 安装 Visual Studio Code 和 Python，克隆或下载项目。
- 在 VS Code 扩展中搜索并安装
PlatformIO插件，安装后重启。 - 打开项目后，PlatformIO 自动下载所需三方库，首次下载时间较长，请耐心等待。
- 打开
platformio.ini，在example中取消注释选择示例，按 Ctrl+S 保存。 - 点击 (✔) 编译，连接设备后点击 (→) 烧录。
Arduino
- 安装 Arduino IDE，安装 Espressif Systems 的 ESP32 开发板支持包。
- 将项目
libraries目录中的所有库复制到 Arduino 库目录。 - 在"工具"菜单中选择正确的设置：
| Arduino IDE 设置 | 值 |
|---|---|
| Board | ESP32S3 Dev Module |
| Upload Speed | 921600 |
| USB Mode | Hardware CDC and JTAG |
| USB CDC On Boot | Enabled |
| USB Firmware MSC On Boot | Disabled |
| USB DFU On Boot | Disabled |
| CPU Frequency | 240MHz (WiFi) |
| Flash Mode | QIO 80MHz |
| Flash Size | 16MB (128Mb) |
| Core Debug Level | None |
| Partition Scheme | 16M Flash (3MB APP/9.9MB FATFS) |
| PSRAM | OPI PSRAM |
| Arduino Runs On | Core 1 |
| Events Run On | Core 1 |
- 选择正确端口，编译并烧录。
开发平台
视频
主要特点
- ESP32-S3FN16R8：16 MB Flash，8 MB PSRAM，Wi-Fi + 蓝牙 5.0
- SX1262 LoRa（433~920MHz），MIA-M10Q GPS，A7682E 4G LTE（可选）
- 3.1 英寸 GDEQ031T10 电子墨水屏（320×240），CST328 触摸
- TCA8418 机械键盘控制器，BHI260AP AI IMU 传感器
- LTR-553ALS 环境光传感器，麦克风语音输入
- PCM512A 音频模块（可选版本），BQ25896 + BQ27220 电池管理
产品参数
| 组件 | 描述 |
|---|---|
| MCU | ESP32-S3FN16R8 Dual-core LX7 |
| Flash | 16MB |
| PSRAM | 8MB |
| 屏幕 | 3.1 英寸 GDEQ031T10 EPD (320×240) |
| 触摸 | CST328 (I²C) |
| 键盘 | TCA8418 (I²C) |
| LoRa | SX1262 (433~920MHz) |
| GPS | MIA-M10Q GNSS |
| 4G | A7682E LTE Cat1（可选） |
| IMU | BHI260AP AI IMU |
| 光线传感器 | LTR-553ALS |
| 电池管理 | BQ25896 + BQ27220 |
| 电池 | 3.7V 1500mAh |
| 存储 | TF 卡 |
| 无线 | 2.4 GHz Wi-Fi + Bluetooth 5.0 |
| USB | 1 × TYPE-C (USB + OTG) |
| 扩展接口 | 1 × QWIIC + 2.54mm 2×20 GPIO |
| 尺寸 | 120 × 66 × 13.5mm |
A7682E 模块说明（4G 版本）
A7682E 为 LTE Cat1 模块，支持 LTE-FDD/GSM/GPRS/EDGE 无线通信，通过 AT 指令控制：
| 参数 | 值 |
|---|---|
| 频段 | LTE-FDD B1/B3/B5/B7/B8/B20 |
| GSM/GPRS/EDGE | 900/1800 MHz |
| LTE Cat1 速率 | 上行 5Mbps / 下行 10Mbps |
| 支持协议 | TCP/IP/IPv4/IPv6/HTTP/HTTPS/FTP/DNS |
| 供电电压 | 3.4V ~ 4.2V |
电子墨水屏刷新说明
| 刷新类型 | 视觉表现 | 使用建议 |
|---|---|---|
| 全屏刷新 | 伴随多次闪烁 | 基础刷新模式 |
| 快速刷新 | 闪烁一次 | 连续操作 ≤5 次后需全屏刷新 |
| 局部刷新 | 无闪烁 | 连续操作 ≤5 次后需全屏刷新 |
快速刷新和局部刷新连续操作 5 次后，必须执行一次全屏刷新，以消除残影堆积。
引脚图
引脚定义
c
// I2C
#define BOARD_I2C_SDA 13
#define BOARD_I2C_SCL 14
// I2C 设备地址
// CST328 触摸: 0x1A
// LTR-553ALS 光线: 0x23
// BHI260AP 陀螺仪: 0x28
// TCA8418 键盘: 0x34
// BQ27220 电量: 0x55
// BQ25896 充电: 0x6B
// 键盘
#define BOARD_KEYBOARD_INT 15
#define BOARD_KEYBOARD_LED 42
// 触摸
#define BOARD_TOUCH_INT 12
#define BOARD_TOUCH_RST 45
// SPI
#define BOARD_SPI_SCK 36
#define BOARD_SPI_MOSI 33
#define BOARD_SPI_MISO 47
// EPD 电子墨水屏
#define BOARD_EPD_DC 35
#define BOARD_EPD_CS 34
#define BOARD_EPD_BUSY 37
// SD 卡
#define BOARD_SD_CS 48
// LoRa
#define BOARD_LORA_CS 3
#define BOARD_LORA_BUSY 6
#define BOARD_LORA_RST 4
#define BOARD_LORA_INT 5
// GPS
#define BOARD_GPS_RXD 44
#define BOARD_GPS_TXD 43
#define BOARD_GPS_PPS 1
// A7682E 4G（可选版本）
#define BOARD_A7682E_RXD 10
#define BOARD_A7682E_TXD 11
#define BOARD_A7682E_RST 9
#define BOARD_A7682E_PWRKEY 40
// PCM512A 音频（可选版本）
#define BOARD_I2S_BCLK 7
#define BOARD_I2S_DOUT 8
#define BOARD_I2S_LRC 9
// 麦克风
#define BOARD_MIC_DATA 17
#define BOARD_MIC_CLOCK 18
// 使能引脚
#define BOARD_GPS_EN 39
#define BOARD_1V8_EN 38
#define BOARD_6609_EN 41
#define BOARD_LORA_EN 46
// 其他
#define BOARD_MOTOR_PIN 2
#define BOARD_BOOT_PIN 0尺寸图
原理图
数据手册
软件开发
依赖库
- GxEPD2-1.5.5
- RadioLib-6.4.2
- SensorLib
- TinyGPSPlus
- TinyGSM
- lvgl-8.3.9
- XPowersLib
- Adafruit TCA8418
- ESP32-audioI2S
常见问题
Q. 看了教程还是不会搭建编程环境怎么办？
A. 参考 LilyGo-Document 文档说明来搭建。Q. Arduino IDE 提示升级库文件，应该升级吗？
A. 建议不升级，不同版本的库文件可能不兼容，确认运行正常后再考虑升级。Q. 电子墨水屏出现残影怎么办？
A. 连续使用快速刷新或局部刷新 5 次后，必须执行一次全屏刷新来消除残影。Q. 板子一直烧录失败？
A. 请按住 "BOOT" 按键重新下载程序。
版本历史
不同硬件版本代码不兼容，请确认硬件版本后进入相应 git 分支。
| Version | 分支 | Update date | Update description |
|---|---|---|---|
| T-Deck-Pro V1.0 | HD-V1-250326 | 2024-05-16 | 初始版本 |
| T-Deck-Pro V1.1 | HD-V2-250915 | 2025-09-15 | 第二版 |
| T-Deck-Pro MAX V1.0 | HD-V3-250911 | 2025-09-11 | MAX 版本（暂未上市） |