search

Xinyuan-LilyGO / T-Deck

306 stars 54 forks source link

readme

✨ LilyGO T-Deck ✨

English | 中文

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

Optional:

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

ArduinoIDE

  1. Install Arduino IDE
  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
  3. 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
  4. Open ArduinoIDE ,Tools , Look at the picture to choose T-Deck(ESP32S3) T-Keyboard(ESP32C3)
    s3 c3
  5. 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. 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

  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 exists. Please remove it and test again.

4️⃣ Where to buy:

  1. AliExpress
  2. LilyGo Store

5️⃣ Pins:

See utilities.h