LILYGO T-Deck Plus LoRa Mesh Radio User Manual

1. Introduzzjoni

The LILYGO T-Deck Plus is a versatile LoRa Mesh Radio designed for off-grid communication and tracking. It integrates an ESP32-S3 microcontroller, GPS, and LoRaWAN capabilities, making it an ideal pocket tracker node for Meshtastic networks. With its full-color large display, QWERTY keyboard, and long-lasting 3000mAh Lithium-ion battery with Type-C fast charging, it offers efficient text communication and real-time GPS location updates.

The device supports open-source Meshtastic firmware, enabling you to utilize inexpensive LoRa radios for remote communication in areas without existing or reliable communication infrastructure. It's a community-driven, open-source project that provides ultra-long-range, low-power data transmission.

2. X'hemm fil-Kaxxa

Upon unboxing your LILYGO T-Deck Plus, you should find the following components:

• Apparat LILYGO T-Deck Plus
• External LoRa Antenna
• Karta ta' Informazzjoni dwar il-Prodott

Watch the unboxing and initial setup video:

Video: Unboxing and initial setup of the LILYGO T-Deck Plus, demonstrating antenna attachment and power-on sequence.

A visual representation of the device and its packaging:

Image: LILYGO T-Deck Plus device, antenna, and product card.

3. Setup

3.1 It-twaħħil tal-antenna

1. Carefully remove the LILYGO T-Deck Plus from its packaging.
2. Locate the antenna connector on the top of the device.
3. Screw the provided external LoRa antenna clockwise onto the connector until it is finger-tight. Do not overtighten.

Immaġni: Quddiem u wara view of the LILYGO T-Deck with antenna attached.

3.2 L-Ewwel Tixgħel u l-Konfigurazzjoni

1. Press and hold the power button (usually located on the side) until the screen illuminates.
2. The device will display the Meshtastic boot screen.
3. Follow the on-screen prompts to set your frequency band (e.g., 868MHz or 915MHz) and device name. Use the QWERTY keyboard for input and navigation buttons to select options.

Refer to the product video for a visual guide on initial power-on and configuration steps.

4. Istruzzjonijiet Operattivi

4.1 Meshtastic Communication

The LILYGO T-Deck Plus is pre-loaded with Meshtastic firmware, enabling peer-to-peer communication over LoRa. The device's screen displays key information such as message status, number of online nodes, uptime, LoRa frequency, Signal-to-Noise Ratio (SNR), and Received Signal Strength Indicator (RSSI).

• Tibgħat Messaġġi: Use the QWERTY keyboard to type messages and send them to other nodes in your Meshtastic network.
• Nirċievu Messaġġi: New messages will appear on the device's display.
• Status tan-nodu: Monitor the network status, including the number of active nodes, directly from the device's interface.

Image: LILYGO T-Deck Plus displaying Meshtastic interface with network status.

4.2 Pożizzjonament tal-GPS

The integrated GPS module provides real-time location data. This information can be viewed on the device itself or transmitted to a paired smartphone via the Meshtastic app.

• Real-time Location: The device can display its current latitude and longitude.
• Map Integration: When connected to a smartphone running the Meshtastic app, your location and the location of other nodes can be visualized on a map.

Image: Meshtastic app on a smartphone showing GPS location tracking.

4.3 Konnettività

The LILYGO T-Deck Plus supports multiple connectivity options:

• LoRa: For long-range, low-power mesh communication.
• Bluetooth: To connect with smartphones for app integration.
• Wi-Fi: For network connectivity and potential firmware updates.
• USB: For charging, data transfer, and firmware flashing.

Image: Connectivity options for the LILYGO T-Deck Plus.

5. Installazzjoni tas-softwer

The LILYGO T-Deck Plus is highly customizable and supports firmware development using PlatformIO or Arduino IDE.

5.1 PlatformIO Quick Start

1. Installa VisualStudioCode u Python.
2. Fittex għal the PlatformIO plugin in the VisualStudioCode extension marketplace and install it.
3. After the installation is complete, you may need to restart VisualStudioCode.
4. After restarting VisualStudioCode, select File in the upper left corner of VisualStudioCode -> Iftaħ Folder -> select the T-Deck directory.
5. Ikklikkja fuq il- platformio.ini file, u fil- platformio column, uncomment 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 via USB.
8. Click (→) to upload firmware.
9. Click (plug symbol) to monitor serial output.

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

5.2 Is-Setup tal-Arduino IDE

1. Installa 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. If 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>. Jekk m'hemmx libraries directory, please create a new one. Please note that you are not copying the lib directory, but copying the folders within the lib direttorju.
4. Open Arduino IDE, Għodda, and select the appropriate board:
   • T-Deck(ESP32S3)
   • T-Keyboard (ESP32C3)

6. Speċifikazzjonijiet

Image: Device dimensions with antenna.

Image: Device dimensions and weight (150g).

7 Issolvi l-problemi

• Kwistjonijiet tal-Wiri tal-Iskrin: If the screen display is incorrect, verify that your TFT_eSPI initialization sequence is consistent with the latest updates. As of 2024/08/02, TFT_eSPI versions higher than 2.0.14 may have compatibility issues. Consider downgrading to a version below 2.0.14 if you experience abnormal operation with Arduino IDE.
• Ebda Qawwa: Ensure the device is fully charged using the Type-C port. Check the power button for proper function.
• No LoRa Signal/Communication: Verify the antenna is securely attached. Ensure both devices are within range and on the same frequency band (868MHz or 915MHz). Obstacles like dense foliage can significantly reduce LoRa range.
• GPS Mhux Qed Jissakkar: Kun żgur li l-apparat għandu ċar view of the sky. GPS signal acquisition can take longer in certain environments or after a long period of inactivity.
• Problemi ta' Konnettività (Bluetooth/Wi-Fi): Check device settings to ensure Bluetooth/Wi-Fi is enabled. For app connections, ensure the Meshtastic app is updated and permissions are granted.

8. Għajnuniet għall-Utenti

• Meshtastic Firmware: The device typically comes with Meshtastic software pre-installed, allowing for immediate use.
• Wi-Fi and GPS: Yes, the LILYGO T-Deck Plus is equipped with both Wi-Fi and GPS capabilities.
• LoRa vs. Satellite Communication: LoRa is a terrestrial radio technology designed for long-range, low-power communication between devices. It is not a satellite communication system like Zoleo. While effective for off-grid communication, its range can be affected by terrain and dense obstacles like forests, unlike satellite systems which offer broader coverage.
• Aġġornamenti tal-Firmware: Regularly check the official LILYGO GitHub repository or Meshtastic project for the latest firmware updates to ensure optimal performance and access to new features.
• Ħajja tal-batterija: To maximize battery life, consider adjusting screen brightness and LoRa transmission power settings if available in the firmware.

9. Manutenzjoni

• Tindif: Uża drapp artab u niexef biex tnaddaf l-apparat. Evita li tuża kimiċi ħarxa jew materjali li joborxu.
• Ħażna: Aħżen l-apparat f'post frisk u niexef 'il bogħod mix-xemx diretta u minn temperaturi estremi.
• Kura tal-batterija: For optimal battery longevity, avoid fully discharging the battery frequently. If storing for extended periods, charge the device to about 50-70% and recharge every few months.
• Kura tal-antenna: Handle the antenna carefully to prevent bending or damage. Ensure it is securely attached during use.

10. Garanzija u Appoġġ

For detailed warranty information and technical support, please refer to the official LILYGO documentation or contact their customer service. A comprehensive user manual in PDF format is also available for download:

Niżżel il-Manwal tal-Utent (PDF)

Link: Official User Manual (PDF) for additional guides and documents.