1. Prodotto finitoview
The LILYGO T-Display Keyboard Shell Kit is an integrated development board featuring an ESP32 WiFi and Bluetooth wireless module, a 1.14-inch LCD display, and a functional keyboard, all housed within a 3D printed casing. This kit is designed for various development projects requiring wireless connectivity, a compact display, and user input capabilities. It includes a 500mA battery for portable operation.

Figura 1.1: Davanti view of the LILYGO T-Display Keyboard Shell Kit. This image displays the device's compact form factor, with the LCD screen showing a colorful 'TTGO' logo and the numeric keypad clearly visible.
2. Cosa c'è nella scatola
Disimballare con attenzione il contenuto e assicurarsi che siano presenti tutti gli articoli:
- 1 x LILYGO T-Display Keyboard with Shell (integrated LCD Display Controller and TTGO Development Board)
- 1 x Cavo USB di tipo C
- 1 x 500mA Battery (pre-installed or included for installation)

Figura 2.1: Kit contents. This image shows the assembled T-Display Keyboard with its shell and the included Type-C USB cable, labeled for clarity.
3. Istruzioni per l'installazione
Follow these steps to set up your LILYGO T-Display Keyboard Shell Kit:
- Ispezione iniziale: Before assembly or use, inspect all components for any visible damage.
- Collegamento della batteria: If the 500mA battery is not pre-installed, carefully connect it to the designated battery connector on the TTGO Development Board. Ensure correct polarity.
- Montaggio (se richiesto): If you received the components separately, carefully place the TTGO Development Board with the LCD and keyboard into the 3D printed shell. Secure it according to the design, ensuring all buttons and ports align correctly.
- Primo addebito: Connect the device to a 5V USB power source using the provided Type-C USB cable. The device will begin charging. It is recommended to fully charge the battery before first use.
- Connessione al computer: For programming and initial configuration, connect the device to your computer using the Type-C USB cable. Your computer should recognize the device as a serial port.

Figura 3.1: Lato view showing the Type-C USB port. This port is used for both charging the internal battery and for data communication with a computer for programming and debugging.
4. Istruzioni per l'uso
The LILYGO T-Display Keyboard Shell Kit is a versatile development platform. Its operation largely depends on the firmware loaded onto the ESP32 module. Below are general guidelines:
- Accensione/spegnimento: The device typically powers on automatically when connected to USB or when the battery is charged and connected. Some models may have a small power button on the side.
- Programmazione:
- Connect the device to your computer via the Type-C USB cable.
- Install the necessary ESP32 development environment (e.g., Arduino IDE with ESP32 board support, PlatformIO).
- Refer to the official LILYGO GitHub repository for example code, libraries, and detailed programming guides: github.com/Xinyuan-LilyGO/T-Display-keyboard.
- Upload your custom firmware to the ESP32.
- Utilizzo del display LCD: The 1.14-inch LCD display can be programmed to show text, graphics, and sensor data. Libraries for display control are available in the GitHub repository.
- Utilizzo della tastiera: The integrated keyboard provides input for your applications. Firmware examples will demonstrate how to read key presses.
- Wireless Connectivity (WiFi/Bluetooth): Utilize the ESP32's built-in WiFi and Bluetooth capabilities for network communication, data transfer, and IoT applications.
5. Manutenzione
Una corretta manutenzione garantisce la longevità e le prestazioni ottimali del tuo dispositivo:
- Pulizia: Use a soft, dry cloth to clean the exterior of the device. For the LCD screen, use a microfiber cloth. Avoid abrasive cleaners or solvents.
- Cura della batteria: Per prolungare la durata della batteria, evitare di scaricarla completamente frequentemente. Conservare il dispositivo in un luogo fresco e asciutto se non utilizzato per periodi prolungati.
- Condizioni ambientali: Operate the device within its specified temperature and humidity ranges. Avoid exposure to extreme temperatures, direct sunlight, or moisture.
- Aggiornamenti del firmware: Regularly check the official LILYGO GitHub repository for firmware updates or improvements that may enhance functionality or address issues.
6. Risoluzione Dei Problemi
If you encounter issues with your LILYGO T-Display Keyboard Shell Kit, refer to the following common troubleshooting steps:
- Il dispositivo non si accende:
- Ensure the battery is correctly connected and charged.
- Verify the Type-C USB cable is securely connected to a working power source.
- Display non funzionante:
- Controlla se il dispositivo è acceso.
- Ensure your uploaded firmware correctly initializes and drives the LCD. Test with a known working example from the GitHub repository.
- La tastiera non risponde:
- Verify that your firmware includes the correct code to read input from the keyboard matrix.
- Check for any physical obstructions or damage to the keys.
- Il computer non riconosce il dispositivo:
- Ensure the Type-C USB cable is functional and properly connected.
- Install the necessary USB-to-serial drivers for the ESP32 chip (e.g., CP210x or CH340 drivers, depending on the specific board revision).
- Prova una porta USB o un computer diverso.
- Problemi di connettività WiFi/Bluetooth:
- Confirm that your firmware correctly configures and initializes the WiFi or Bluetooth module.
- Check network credentials (SSID, password) for WiFi connections.
- Ensure the device is within range of the access point or Bluetooth device.
7. Specifiche
| Caratteristica | Dettaglio |
|---|---|
| Nome del modello | T-Display Keyboard Shell Kit |
| Processore | Espressif ESP32 (1 processor) |
| Memoria RAM | LPDDR2, LPDDR3 |
| Display | 1.14-inch LCD Display Controller |
| Connettività | Wi-Fi, Bluetooth |
| Sistema operativo | FreeRTOS (supportato) |
| Batteria | 500mA (integrated) |
| Dimensioni (circa) | Lunghezza: 110 mm, Larghezza: 59.5 mm, Altezza: 28 mm |

Figura 7.1: Approximate dimensions of the device. This image provides a visual representation of the kit's physical size, indicating its length, width, and height.
8. Informazioni sulla garanzia
Specific warranty details for the LILYGO T-Display Keyboard Shell Kit are typically provided by the retailer or manufacturer at the time of purchase. Please retain your proof of purchase for any warranty claims. For the most accurate and up-to-date warranty information, it is recommended to contact LILYGO directly or refer to the documentation included with your product.
9. Supporto
For further assistance, technical documentation, example code, and community support, please refer to the following resources:
- Official LILYGO GitHub Repository: This is the primary resource for software, firmware, and detailed technical information.
github.com/Xinyuan-LilyGO/T-Display-keyboard - Contatto del produttore: For product-specific inquiries or issues not covered in the documentation, you may contact LILYGO directly through their official channels.
- Forum e comunità online: Engage with the ESP32 and LILYGO user communities for peer support and project ideas.