Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Xinyuan-LilyGO/T-Deck


https://github.com/Xinyuan-LilyGO/T-Deck

Last synced: 2 months ago
JSON representation

Awesome Lists containing this project

README 

        
✨ LilyGO T-Deck  ✨



## **English | [中文](README_CN.MD)**



## News:



1. T-Deck-Plus has assigned the pins on the **Grove** interface to the GPS module, so the **Grove** interface of T-Deck-Plus cannot be used.

2. T-Deck updated [TFT_eSPI ST7789 initialization sequence](https://github.com/Xinyuan-LilyGO/T-Deck/commit/6adb8884c689f174c29a6d7172a0daa367a582eb) on 20240726. Currently, the changes have not been pushed to the TFT_eSPI upstream branch. If you find that the screen display is incorrect during use, please check whether this is consistent with the initialization sequence in the warehouse.



## 1️⃣ Examples preview



````

examples 

├─Keyboard_ESP32C3       # ESP32C3 keyboard I2C slave

├─Keyboard_T_Deck_Master # T-Deck read from keyboard

├─LoRaWAN_Starter        # LoRaWAN example

├─Microphone             # Noise detection  

├─Touchpad               # Read touch coordinates 

├─GPSShield              # GPS Shield example

├─lvgl_example           # lvgl example

└─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



Optional:



You can upload the assets contents for the speaker demo, using the "Upload Filesystem Image" on PlatformIO menu.



### ArduinoIDE



1. Install [Arduino IDE](https://www.arduino.cc/en/software)

2. In Arduino Preferences, on the Settings tab, enter the `https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json` URL in the `Additional boards manager URLs` input box. **Please pay attention to the version. The test phase is using 2.0.14. It is not certain that versions above 2.0.14 can run. When the operation is abnormal, please downgrade to a version below 2.0.14.** , As of 2024/08/02, TFT_eSPI does not work on versions higher than 2.0.14, see [TFT_eSPI/issue3329](https://github.com/Bodmer/TFT_eSPI/issues/3329)

3. Copy all the folders in the `T-Deck/lib` directory to ``. 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

4. Open ArduinoIDE  ,`Tools` , Look at the picture to choose

    | T-Deck(ESP32S3)      | T-Keyboard(ESP32C3)  |

    | -------------------- | -------------------- |

    | ![s3](images/s3.jpg) | ![c3](images/c3.jpg) |

5. Insert USB into the PC and click Upload 



## 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. T-Keyboard 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, You need to connect USB TO TTL externally to burn the keyboard firmware. For TTL without automatic download circuit, before powering on, short-circuit the BOOT Pin and GND, and then power on. At this time, T-Keyboard will enter the download mode. After the burning is completed, you need to disconnect GND and BOOT before running the program.



   ![c3_boot](images/c3_boot.jpg)



4. T-Deck can't upload any sketch，Please enter the upload mode manually.

   1. Connect the board via the USB cable

   2. Press and hold the BOOT button , While still pressing the BOOT(On the trackball above the keyboard, press down) button

   3. Press RST button

   4. Release the RST button

   5. Release the BOOT button

   6. Upload sketch

   7. If you still cannot upload the sketch successfully according to the above method, please check whether the resistor in this [issue62](https://github.com/Xinyuan-LilyGO/T-Deck/issues/62) exists. Please remove it and test again.



## 4️⃣ Where to buy:



1. [AliExpress](https://www.aliexpress.com/item/1005005692235592.html)

2. [LilyGo Store](https://www.lilygo.cc/products/t-deck)



## 5️⃣ Pins:



See [utilities.h](./examples//UnitTest//utilities.h)