✨ LilyGO T-Deck ✨

English | 中文

1️⃣ Examples preview

examples 
├─Keyboard_ESP32C3       # ESP32C3 keyboard I2C slave
├─Keyboard_T_Deck_Master # T-Deck read from keyboard
├─Microphone             # Noise detection  
├─Touchpad               # Read touch coordinates 
└─UnitTest               # Factory hardware unit testing           

2️⃣ Quick Start

PlatformIO

1. Install VisualStudioCode and Python
2. Search for the PlatformIO plugin in the VisualStudioCode extension and install it.
3. After the installation is complete, you need to restart VisualStudioCode
4. After restarting VisualStudioCode, select File in the upper left corner of VisualStudioCode -> Open Folder -> select the T-Deck directory
5. Click on the platformio.ini file, and in the platformio column, cancel the sample line that needs to be used, please make sure that only one line is valid
6. Click the (✔) symbol in the lower left corner to compile
7. Connect the board to the computer USB
8. Click (→) to upload firmware
9. Click (plug symbol) to monitor serial output

ArduinoIDE

1. Install ArduinoIDE
2. Copy all the folders in the T-Deck/lib directory to <C:\Users\UserName\Documents\Arduino\libraries>. If there is no libraries directory, please create a new one. Please note that you are not copying the lib directory, but copying the folders in the lib directory
3. Open ArduinoIDE -> Tools

• Board -> ESP32S3 Dev Module
• USB CDC On Boot -> Enable ## Note that you need to change Enable to Disable when USB is not connected, so USB CDC will not prevent the board from starting
• CPU Frequency -> 240MHz
• USB DFU On Boot -> Disable
• Flash Mode -> QIO 80MHz
• Flash Size -> 16MB(128Mb)
• USB Firmware MSC On Boot -> Disable
• PSRAM -> OPI PSRAM
• Partition Scheme -> 16M Flash(3MB APP/9.9MB FATFS)
• USB Mode -> Hardware CDC and JIAG
• Upload Mode -> UART0/Hardware CDC
• Upload Speed -> 921600

4. Insert USB into the PC and click Upload <If the upload fails, keep pressing the BOOT button, click RST, and then click Upload. When the upload is complete, click RST to exit the download mode>

3️⃣ Tips:

1. If a microphone is used, the GPIOO button cannot be used
2. If the sketch cannot be uploaded, then you need to press down the middle of the trackball, and then insert the USB, this means the chip is in the download mode, and then click to upload the sketch.
3. The programming and burning interface of ESP32C3 is located at the 6Pin header on the side of the RST button, and the order starts from the top of the RST button, which are 3V3, GND, RST, BOOT, RX, TX

4️⃣ Where to buy:

1. AliExpress
2. LilyGo Store

5️⃣ Pins:

See utilities.h