65 lines
2.4 KiB
Markdown
65 lines
2.4 KiB
Markdown
<h1 align = "center">✨ LilyGO T-Deck ✨</h1>
|
|
|
|
## **English | [中文](README_CN.MD)**
|
|
|
|
|
|
|
|
## 1️⃣ Examples preview
|
|
|
|
````
|
|
|
|
examples
|
|
├─Keyboard_ESP32C3 # ESP32C3 keyboard I2C slave
|
|
├─Microphone # Noise detection
|
|
└─UnitTest # Factory hardware unit testing
|
|
|
|
````
|
|
|
|
## 2️⃣ Quick Start
|
|
|
|
### PlatformIO
|
|
|
|
1. Install [VisualStudioCode](https://code.visualstudio.com/) and [Python](https://www.python.org/)
|
|
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](https://www.arduino.cc/en/software)
|
|
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
|
|
|
|
## 4️⃣ Where to buy:
|
|
|
|
1. [AliExpress]()
|
|
2. [LilyGo Store]()
|
|
|
|
|
|
|
|
## 5️⃣ Pins:
|
|
|
|
See [utilities.h](./examples//UnitTest//utilities.h) |