| 中文 | English |
|---|
| Front | Back |
|---|---|
![]() |
![]() |
T-Deck-MAX Revision Update Notes:
-
Added the XL9555 IO expansion chip
-
Remove the distinction between the audio version and the 4G version. Now, integrate the 4G (A7682E) and the audio (ES8311) onto a single board.
-
Add a LoRa antenna selection switch, controlled by XL9555 to select the internal or external antenna. The default is the internal antenna.
-
Add an audio channel output selection switch, and control the selection of using A7682E / ES8311 audio output through XL9555.
-
Add the vibration motor driving chip DRV2605
How to confirm that your device is T-Deck-MAX?
Download the WireScan firmware and then open the serial port to confirm.
How to download the firmware? - click me
| Parameter | T-Deck-MAX |
|---|---|
| MCU | ESP32-S3 |
| Flash / PSRAM | 16M / 8M |
| LoRa | SX1262 |
| GPS | MIA-M10Q |
| Display | GDEQ031T10 (320x240) |
| 4G-Module | A7682E |
| Battery Capacity | 3.7V-1400mAh |
| Battery Chip | SY6970 (0x6A), BQ27220 (0x55) |
| Audio | ES8311 (0x18) |
| Touch | CST3530 (0x1A) |
| Gyroscope | BHI260AP (0x28) |
| Keyboard | TCA8418 (0x34) |
| IO Expansion | XL9555 (0x20) |
| Motor | DRV2605 (0x5A) |
Before flashing firmware, connect the device to your computer, select the correct COM port, and put the board into download mode:
- Press and hold the
BOOTbutton. - Press and release the
RSTbutton on the back. - Release the
BOOTbutton.
-
Download the tool from LILYGO Spark.
-
Search for your device
T-Deck Maxand download the corresponding firmware.
| Firmware | Note | Github |
|---|---|---|
| T-Deck-MAX_xxxxx.bin | Factory program |
- |
| crosspoint_lilygo_t_deck_max_xxxx.bin | Reader program | TDeckMax-Reader |
A7682E https://en.simcom.com/product/A7682E.html
A7682E is the LTE Cat 1 module that supports wirelesscommunication modes of LTE-FDD/GSM/GPRS/EDGE. It supports maximum 10Mbps downlink rate and 5Mbps uplink rate. A7682E supports multiple built-in network protocols.
Insert the SIM card and it supports calls, text messages and internet access.
Test the functionality of the A7682E using examples/A7682E/test_AT
Control Via AT Commands
Frequency Bands LTE-FDD B1/B3/B5/B7/B8/B20
GSM/GPRS/EDGE 900/1800 MHz
Supply Voltage 3.4V ~ 4.2V, Typ: 3.8V
LTE Cat 1 (Uplink up to 5Mbps, Downlink up to10Mbps)
EDGE (Uplink/Downlink up to 236.8Kbps)
GPRS (Uplink/Downlink up to 85.6Kbps)
Firmware update via USB/FOTA
Support language calls
Support sending and receiving SMS messages
network protocols (TCP/IP/IPV4/IPV6/Multi-PDP/FTP/FTPS/HTTP/HTTPS/DNS)
RNDIS/PPP/ECM
SSL
❗ Note: The speakers of A7682E and ES8311 are shared. Set IO12 of XL9555 to HIGH and output the audio of A7682E.
The sound is too weak. Set IO06 of the XL9555 to HIGH to enable the power amplifier. example
❗ Note: The speakers of A7682E and ES8311 are shared. Set IO12 of XL9555 to LOW and output the audio of ES8311.
The sound is too weak. Set IO06 of the XL9555 to HIGH to enable the power amplifier.
❗ Note:
The following lists all examples to help you quickly get started with each module:
| Example | Path | Description |
|---|---|---|
| WireScan | examples/WireScan/ |
I2C device scanner, open serial monitor after flashing to verify modules |
| test_wifi | examples/test_wifi/ |
WiFi connection test |
| test_BHI260AP | examples/test_BHI260AP/ |
Gyroscope (BHI260AP) test |
| test_GPS | examples/test_GPS/ |
GPS (MIA-M10Q) module test |
| keypad | examples/keypad/ |
Keyboard input test |
| XL9555/read | examples/XL9555/read/ |
IO expansion chip read example |
| XL9555/write | examples/XL9555/write/ |
IO expansion chip write example |
| Elink_paper/touch | examples/Elink_paper/touch/ |
Touch screen basic test |
| Elink_paper/display | examples/Elink_paper/display/ |
E-paper screen display example |
| Elink_paper/test_lvgl | examples/Elink_paper/test_lvgl/ |
LVGL graphics library example |
| Elink_paper/GDEQ031T10_Arduino | examples/Elink_paper/GDEQ031T10_Arduino/ |
E-paper Arduino library driver example |
| LoRa_sx1262/lora_send | examples/LoRa_sx1262/lora_send/ |
LoRa send example |
| LoRa_sx1262/lora_recv | examples/LoRa_sx1262/lora_recv/ |
LoRa receive example |
| A7682E/test_AT | examples/A7682E/test_AT/ |
4G module AT command test |
| ES8311/playWAV | examples/ES8311/playWAV/ |
WAV audio playback example |
| ES8311/playFormSD | examples/ES8311/playFormSD/ |
Audio playback from TF card example |
| battery/bq25896 | examples/battery/bq25896/ |
Battery management IC BQ25896 test |
| battery/bq27220 | examples/battery/bq27220/ |
Battery fuel gauge BQ27220 test |
| battery/sy6974 | examples/battery/sy6974/ |
Battery charging IC SY6974 test |
| motor/basic | examples/motor/basic/ |
Vibration motor basic example |
| motor/audio | examples/motor/audio/ |
Vibration motor audio feedback example |
| motor/realtime | examples/motor/realtime/ |
Vibration motor real-time control example |
| motor/complex | examples/motor/complex/ |
Vibration motor complex pattern example |
| tf_card | examples/tf_card/ |
TF card read/write test |
| eng_test | examples/eng_test/ |
Full system functionality test |
- First use: Flash
WireScanfirmware first, verify I2C communication is normal - Display related: Start with
Elink_paper/touchorElink_paper/display - Wireless communication: WiFi test uses
test_wifi, LoRa useslora_send/lora_recv - 4G communication: Use
A7682E/test_ATto test AT commands - Audio functions: Try
ES8311/playWAVfirst to play WAV files - Battery related: Use
battery/bq25896to check battery status
🟢 PlatformIO is recommended because these examples were developed on it. 🟢
- Install Visual Studio Code and Python, and clone or download the project;
- Search for the
PlatformIOplugin in theVisualStudioCodeextension and install it; - After the installation is complete, you need to restart
VisualStudioCode - After opening this project, PlatformIO will automatically download the required tripartite libraries and dependencies, the first time this process is relatively long, please wait patiently;
- After all the dependencies are installed, you can open the
platformio.iniconfiguration file, uncomment inexampleto select a routine, and then pressctrl+sto save the.iniconfiguration file; - Click ☑️ under VScode to compile the project, then plug in USB and select COM under VScode;
- Finally, click the ➡️ button to download the program to Flash;
-
Install Arduino IDE
-
Copy all files under
this project/lib/and paste them into the Arduino library path (generallyC:\Users\YourName\Documents\Arduino\libraries); -
Open the Arduino IDE and click
File->Openin the upper left corner to open an example inthis project/example/xxx/xxx.inounder this item; -
Then configure Arduino. After the configuration is completed in the following way, you can click the button in the upper left corner of Arduino to compile and download;
| Arduino IDE Setting | Value |
|---|---|
| Board | ESP32S3 Dev Module |
| Port | Your port |
| USB CDC On Boot | Enable |
| CPU Frequency | 240MHZ(WiFi) |
| Core Debug Level | None |
| USB DFU On Boot | Disable |
| Erase All Flash Before Sketch Upload | Disable |
| Events Run On | Core1 |
| Flash Mode | QIO 80MHZ |
| Flash Size | 16MB(128Mb) |
| Arduino Runs On | Core1 |
| USB Firmware MSC On Boot | Disable |
| Partition Scheme | 16M Flash(3M APP/9.9MB FATFS) |
| PSRAM | QSPI PSRAM |
| Upload Mode | UART0/Hardware CDC |
| Upload Speed | 921600 |
| USB Mode | CDC and JTAG |
Board-level macros are now centralized in a single public header:
Use it directly in examples:
#include <TDeckMaxBoard.h>Pin Mapping : pinmap
Sleep power consumption.
For more information, see the ./hardware directory.




