1. Introduction
This manual provides comprehensive instructions for the TENSTAR ROBOT SPI TFT LCD Display Modules, available in 2.4-inch, 2.8-inch, and 3.5-inch sizes. These modules feature a Serial Peripheral Interface (SPI) for communication and are designed for use with microcontrollers, supporting both 5V and 3.3V logic levels. They are ideal for various embedded projects requiring a compact and colorful display.
2. Specifications
The TENSTAR ROBOT SPI TFT LCD Display Modules come in three different sizes, each with specific characteristics. All models feature an IPS TFT panel and utilize an SPI interface for efficient data transfer.
2.1. 2.4 Inch Display Module
| Feature | Detail |
|---|---|
| Resolution | 240RGBx320 |
| Panel Type | TFT (IPS) |
| Interface | SPI |
| Driver Chip | ST7789V |
| Size (LxWxH) | 47mm x 71mm x 13.5mm |
2.2. 2.8 Inch Display Module
| Feature | Detail |
|---|---|
| Resolution | 240RGBx320 |
| Panel Type | TFT (IPS) |
| Interface | SPI |
| Driver Chip | ST7789 |
| Size (LxWxH) | 55mm x 81mm x 4.4mm |
2.3. 3.5 Inch Display Module
| Feature | Detail |
|---|---|
| Resolution | 320RGBx480 |
| Panel Type | TFT (IPS) |
| Interface | SPI |
| Driver Chip | ST7796S |
| Size (LxWxH) | 59mm x 95mm x 8.3mm |
3. Setup
Before connecting the display module, ensure your microcontroller supports SPI communication and the correct voltage levels (5V or 3.3V). The module includes an iron frame for protection.
3.1. Pinout and Wiring
Refer to the detailed pinout diagrams provided in the specifications image (Section 2) for precise connections. The common SPI pins are:
- VCC: Power supply (5V or 3.3V, depending on your microcontroller and module version).
- GND: Ground.
- SCK (SCL): Serial Clock.
- MOSI (SDA): Master Out Slave In (Data).
- CS: Chip Select.
- DC (A0): Data/Command selection.
- RES (RST): Reset pin.
Ensure all connections are secure and correctly aligned to prevent damage to the module or your microcontroller.
4. Operating
To operate the display module, you will need a microcontroller (e.g., Arduino, ESP32, Raspberry Pi) and appropriate software libraries. These libraries handle the low-level communication with the display's driver chip (ST7789V or ST7796S) and provide functions for drawing text, shapes, and images.
4.1. Software Libraries
Search for libraries compatible with the specific driver chip of your module (ST7789V for 2.4/2.8 inch, ST7796S for 3.5 inch) and your chosen microcontroller platform. Popular libraries often include support for these common TFT drivers.
4.2. Basic Usage
- Initialize the Display: Call the initialization function provided by your chosen library, passing the correct pin assignments.
- Clear the Screen: Use a function to clear the display to a solid color.
- Draw Elements: Use library functions to draw pixels, lines, rectangles, circles, text, and images.
- Update Display: Some libraries automatically update the display, while others may require an explicit update command.
5. Maintenance
- Cleaning: Use a soft, dry, lint-free cloth to gently wipe the display surface. Avoid abrasive materials or harsh chemicals.
- Handling: Handle the module by its edges to avoid touching the display area or damaging components on the PCB.
- Storage: Store the module in a dry, anti-static environment, away from direct sunlight and extreme temperatures.
- Static Discharge: Always take precautions against electrostatic discharge (ESD) when handling the module.
6. Troubleshooting
- Display is blank or shows garbage:
- Verify all wiring connections (VCC, GND, SCK, MOSI, CS, DC, RES) are correct and secure.
- Ensure the power supply voltage is appropriate (5V or 3.3V) and stable.
- Check your code for correct pin assignments and display initialization sequence.
- Confirm you are using the correct library for your specific driver chip (ST7789V or ST7796S) and display resolution.
- Colors are incorrect or inverted:
- Some libraries or display modes might require color inversion settings. Check library documentation for relevant functions.
- Display is rotated incorrectly:
- Most display libraries offer functions to set screen rotation. Adjust these parameters in your code.
- Partial display or flickering:
- Ensure sufficient power is supplied to the module.
- Check for loose connections or damaged wires.
- Verify that the SPI clock speed is not too high for your setup.
7. User Tips
- Library Selection: When searching for libraries, include the driver chip model (e.g., "Arduino ST7789V library" or "ESP32 ST7796S library") for best results. Adafruit GFX library is a popular choice that supports many TFT displays with specific driver extensions.
- Pinout Confirmation: Always double-check the pinout on your specific module against the provided diagrams, as minor variations can occur.
- Raspberry Pi Compatibility: These modules can be used with Raspberry Pi. You will need to enable SPI on your Raspberry Pi and use appropriate Python libraries (e.g., Luma.LCD, or custom code using
spidev). - Voltage Levels: While the modules are generally compatible with both 5V and 3.3V logic, always confirm the VCC input voltage requirement for your specific module to avoid damage.
8. Warranty and Support
For technical assistance, troubleshooting beyond this manual, or warranty inquiries, please contact the seller directly through your purchase platform. Provide your order details and a clear description of the issue for prompt support.
