Waveshare 1.28-inch Round LCD Display Module with Touch Panel User Manual

1. Introducció

The Waveshare 1.28-inch Round LCD Display Module with Touch Panel is a compact and versatile display solution. It features a 240x240 resolution IPS screen with 65K colors, offering clear and vibrant visuals. The module integrates a GC9A01 driver chip for the display and a CST816S capacitive touch control chip, utilizing SPI and I2C communication respectively. This design minimizes the required I/O pins, making it compatible with various controller boards such as Raspberry Pi, Raspberry Pi Pico, and STM32.

Imatge 1: Part superior view of the Waveshare 1.28-inch Round LCD Display Module, showing the main board, connector, and mounting holes.

2. Característiques

• Visualització: 240×240 resolution, 65K colors, IPS panel for clear and colorful displaying effect.
• Panell tàctil: High touch screen transmittance, fast response, and long lifetime.
• Driver Chips: Embedded GC9A01 driver chip for display and CST816S capacitive touch control chip.
• Comunicació: Uses SPI for display and I2C for touch, minimizing required I/O pins.
• Compatibilitat: Supports controller boards like Raspberry Pi, Raspberry Pi Pico, and STM32.

3. Contingut del paquet

El paquet inclou els articles següents:

• 1.28inch Touch LCD x1
• GH1.25 13Pin cable x1

Image 2: The package contains one 1.28-inch Touch LCD module and one GH1.25 13-pin cable.

4. Especificacions

5. Interfícies de control

The module features a 13-pin connector for interfacing with various microcontrollers. Below is a diagram of the control interfaces and a table describing each pin's function.

Image 3: Diagram showing the pin labels on the 1.28-inch Touch LCD module's connector.

For detailed pin connections to specific controller boards, refer to the Pin Connection Reference secció.

6. Configuració

To set up your 1.28-inch Touch LCD module, follow these general steps:

1. Identifica els pins: Refer to the "Control Interfaces" section to understand the function of each pin on the module's connector.
2. Connectar el cable: Use the provided GH1.25 13Pin cable to connect the display module to your chosen microcontroller board (e.g., Raspberry Pi, Pico, Arduino, STM32). Ensure correct pin-to-pin mapping for VCC, GND, SPI (MISO, MOSI, SCLK, CS, DC, RST, BL), and I2C (SDA, SCL, INT, RST) lines.
3. Font d'alimentació: Connect the VCC and GND pins to the appropriate power supply (3.3V or 5V) from your microcontroller.
4. Configuració del programari: Install necessary libraries and drivers for the GC9A01 display controller and CST816S touch controller on your microcontroller. Waveshare provides online development resources and exampcodi per a diverses plataformes.
5. Prova inicial: Run a basic example program to verify that the display and touch functions are working correctly.

6.1 Pin Connection Reference

The table below provides a reference for connecting the 1.28-inch Touch LCD to common development boards.

Image 4: Visual representation of the pin connection reference table for various microcontrollers.

7. Funcionament

Once the module is correctly wired and the necessary software is loaded onto your microcontroller, you can begin operating the display and touch functions.

• Inicialització de la pantalla: Ensure your code initializes the GC9A01 display controller correctly, setting up the resolution, color depth, and other display parameters.
• Drawing Graphics: Use the provided graphics libraries (or implement your own) to draw text, shapes, and images on the LCD.
• Entrada tàctil: The CST816S touch controller communicates via I2C. Your software should periodically read touch data from the controller to detect touches, gestures, and coordinates.
• Interacció: Implement logic in your microcontroller code to respond to touch inputs, such as button presses, swipes, or taps, to control your application or display different information.

8. Ús Example

The 1.28-inch Touch LCD module can be integrated into various projects. A common application involves connecting it to a development board like a Raspberry Pi or an STM32 board to create a compact user interface.

Image 5: The 1.28-inch Touch LCD module connected via its 13-pin cable to an mbed ARM Cortex-M0/M3/M4 development board, displaying a circular user interface.

This setup allows for displaying real-time data, controlling device functions, or creating interactive menus. The module's small size and touch capability make it suitable for wearable projects, smart home devices, or compact control panels.

9. Manteniment

Proper maintenance ensures the longevity and optimal performance of your display module:

• Neteja: Use a soft, lint-free cloth to gently wipe the screen surface. Avoid abrasive materials or harsh chemicals that could damage the display or touch layer.
• Manipulació: Handle the module by its edges to avoid touching the sensitive components on the PCB or applying pressure to the display.
• Emmagatzematge: Emmagatzemeu el mòdul en un entorn sec i antiestàtic, allunyat de la llum solar directa i de temperatures extremes.
• Potència: Assegureu-vos sempre el volum correctetage (3.3V or 5V) is supplied to the module. Incorrect voltage pot causar danys permanents.

10. Solució De Problemes

If you encounter issues with your 1.28-inch Touch LCD module, consider the following troubleshooting steps:

• Sense pantalla:
  • Comproveu les connexions d'alimentació (VCC, GND) i assegureu-vos que el volum sigui correcte.tage.
  • Verify SPI connections (MISO, MOSI, SCLK, CS, DC, RST, BL) are secure and correctly mapped.
  • Confirm display driver (GC9A01) initialization in your software.
  • Ensure the backlight pin (LCD_BL) is correctly configured and receiving power.
• El tacte no respon:
  • Check I2C connections (TP_SDA, TP_SCL) and ensure they are secure.
  • Verify touch controller (CST816S) initialization and I2C communication in your software.
  • Ensure the TP_INT and TP_RST pins are correctly connected and handled by your microcontroller.
  • Clean the screen surface for any obstructions.
• Incorrect Colors/Graphics:
  • Review your display initialization code, especially color depth and pixel format settings.
  • Check for correct data transmission over SPI.
• Pantalla parpellejant:
  • Assegureu-vos una font d'alimentació estable.
  • Comproveu si hi ha connexions soltes.
  • Verify SPI clock speed is within the recommended range for the GC9A01.

For more detailed troubleshooting and specific error codes, please refer to the official Waveshare documentation and community forums.

11. Garantia i Suport

Waveshare provides electronic development resources and manuals for their products. For the most up-to-date information, detailed tutorials, sample code, and technical support, please visit the official Waveshare weblloc.

Oficial Weblloc: www.waveshare.com

Please check the product page on the official website for specific warranty information and contact details for technical assistance.