GODIYMODULES 1.54 Inch 240x240 IPS TFT Display Module ST7789 User Manual

1. הקדמה

This manual provides comprehensive instructions for the GODIYMODULES 1.54 Inch Full Color TFT Display Module, featuring an HD IPS LCD LED screen with a 240x240 resolution and an ST7789 controller. Designed for integration with microcontrollers such as Arduino, ESP32, Raspberry Pi, 8051, PIC, and AVR, this module utilizes a Serial Peripheral Interface (SPI) for communication. This document covers product overview, setup, wiring, operation, specifications, troubleshooting, and maintenance to ensure proper use and functionality.

פיגורע 1: פראָנט view of the 1.54-inch TFT display module, showing the screen and the included male header pins for connection.

2. פּראָדוקט איבערview

2.1 שליסל פֿעיִקייטן

• ווייַז טיפּ: 1.54-inch Full Color TFT IPS LCD
• רעזאלוציע: 240x240 פּיקסעלס
• Controller IC: ST7789
• צובינד: סיריאַל פּעריפעראַל צובינד (SPI)
• קאַמפּאַטאַבילאַטי: Designed for use with various Microcontroller Units (MCUs) including Arduino, ESP32, Raspberry Pi, 8051, PIC, and AVR.
• ווייַז קוואַליטעט: HD IPS panel for superior viewינג אַנגלעס און וויבראַנט פארבן.

2.2 קאָמפּאָנענטן אַרייַנגערעכנט

• 1 x GODIYMODULES 1.54 Inch TFT Display Module
• 1 x Male Header Pin Strip (for soldering)

3. סעטאַפּ און וויירינג

The 1.54-inch TFT display module communicates via SPI. Proper wiring is essential for correct operation. The module requires soldering the included header pins before use.

3.1 פּינאָוט באַשרייַבונג

פיגורע 2: דערציען view of the display module circuit board, detailing the ST7789 driver IC and connection pins.

3.2 Wiring Diagram for Arduino

Below is a typical wiring configuration for connecting the display module to an Arduino board. Note that specific pin assignments may vary slightly depending on the Arduino model (e.g., Uno, Nano, ESP32). Always consult your MCU's documentation for hardware SPI pins.

Figure 3: Wiring diagram showing connections between an MCU (e.g., Arduino) and the 1.54-inch TFT display module.

באַמערקונג: The silkscreen labels on the module for SCL and SDA refer to SPI communication, not I2C. Do not confuse them with I2C pins (e.g., A4 & A5 on some Arduinos).

4. אַפּערייטינג ינסטרוקטיאָנס

To operate the display module, you will typically use a compatible library for your chosen microcontroller. For Arduino, libraries such as Adafruit GFX Library and Adafruit ST7789 Library are commonly used.

4.1 Software Setup (Arduino Exampל)

1. אינסטאַלירן ביבליאָטעקן: Open your Arduino IDE. Go to סקעטש > ארייננעמען ביבליאטעק > פירן ביבליאטעקן... זוכן פֿאַר "Adafruit GFX" and "Adafruit ST7789" and install them.
2. Include Headers: In your Arduino sketch, include the necessary headers:

   #include <Adafruit_GFX.h>
   #include <Adafruit_ST7789.h>

3. Define Pins: Define the pins connected to the display module in your sketch. For example, using the pins from Table 2:

   #define TFT_CS    10
   #define TFT_DC    9
   #define TFT_RST   8  // Or set to -1 if you share Arduino reset pin

4. Initialize Display: Initialize the display object in your setup function:

   Adafruit_ST7789 tft = Adafruit_ST7789(TFT_CS, TFT_DC, TFT_RST);
   
   void setup() {
     tft.init(240, 240); // Initialize ST7789 screen
     tft.setRotation(2); // Adjust rotation as needed
     tft.fillScreen(ST77XX_BLACK);
     tft.setTextWrap(false);
     tft.setTextColor(ST77XX_WHITE);
     tft.setTextSize(1);
     tft.setCursor(0, 0);
     tft.print("Hello, World!");
   }

5. Drawing Functions: Use the GFX library functions to draw text, shapes, and images on the display. Refer to the Adafruit GFX library documentation for a full list of functions.

5. ספּעסאַפאַקיישאַנז

6. טראָובלעשאָאָטינג

• Display is blank or shows garbage:
  • טשעק וויירינג: Verify all connections (GND, VCC, SCL, SDA, RES, DC, CS) are secure and correctly connected to the appropriate microcontroller pins as per the wiring diagram. Pay close attention to SPI pin assignments (SCL/SCK, SDA/MOSI).
  • מאַכט צושטעלן: Ensure the VCC pin receives the correct voltage (typically 3.3V or 5V, depending on your MCU's logic level and the module's tolerance).
  • Library Installation: Confirm that all necessary libraries (e.g., Adafruit GFX, Adafruit ST7789) are correctly installed in your IDE.
  • איניציאליזאציע קאוד: Double-check your code for correct pin definitions and display initialization parameters (e.g., tft.init(240, 240)).
  • SPI vs. I2C Confusion: This module uses SPI. Ensure you are not attempting to connect it using I2C pins or I2C libraries, despite some pin labels potentially causing confusion.
• Colors are incorrect or washed out:
  • ראָטאַטיאָן באַשטעטיקן: אומרעכט setRotation() might affect how colors are interpreted or displayed. Experiment with different rotation values.
  • Library Version: Ensure you are using up-to-date libraries.
• Display works on one MCU (e.g., ESP32) but not another (e.g., Arduino):
  • פּין קאָמפּאַטאַביליטי: Verify that the SPI pins and other control pins are correctly mapped for the specific MCU you are using. Pin numbers for SPI can differ between Arduino boards (Uno, Nano, Mega) and other platforms like ESP32 or Raspberry Pi.
  • לאָגיק לעוועלס: פאַרזיכערן וואָלtage compatibility. Some MCUs operate at 3.3V logic, while others use 5V. The display module typically supports both, but incorrect voltage levels can cause issues.

7. וישאַלט

The 1.54-inch TFT display module is a delicate electronic component. Follow these guidelines for proper maintenance:

• האַנדלינג: Always handle the module by its edges to avoid touching the screen surface or electronic components.
• רייניקונג: If necessary, gently clean the screen with a soft, lint-free cloth. Avoid abrasive materials or harsh chemical cleaners.
• סטאָרידזש: האַלט דעם מאָדול אין אַן אַנטי-סטאַטישן זעקל אין אַ טרוקענער, קילער סביבה, אַוועק פון דירעקטער זון און עקסטרעמע טעמפּעראַטורן.
• סאַדערינג: When soldering header pins, use appropriate soldering techniques to prevent damage to the board or components.

8. וואָראַנטי און שטיצן

Specific warranty information for this product is not provided in the available documentation. For any technical support, warranty claims, or further inquiries, please contact the seller or manufacturer directly through the platform where the product was purchased.