Waveshare 1.28inch Round LCD Display Module User Manual

1. Introdución

The Waveshare 1.28inch Round LCD Display Module is a compact, high-resolution display designed for various embedded applications. It features a 240x240 pixel resolution with 65K RGB colors, providing a clear and vibrant visual experience. The module utilizes an SPI interface, minimizing the number of required I/O pins for connection to microcontrollers and single-board computers. It is embedded with the GC9A01 driver and is compatible with popular development boards such as Raspberry Pi, Jetson Nano, Arduino, and STM32.

Waveshare 1.28inch Round LCD Display Module front view showing a colorful watch face interface.

Figura 1: Fronte view of the Waveshare 1.28inch Round LCD Display Module displaying a watch face with time, date, steps, distance, and calorie information.

2. Características clave

Resolución: 240x240 pixels, offering clear and detailed visuals.
Profundidade de cor: 65K RGB colors for rich and vibrant display effects.
Interface: SPI (Serial Peripheral Interface) for efficient data transfer and reduced pin count.
Condutor: Embedded GC9A01 display driver.
Compatibilidade: Supports various controller boards including Raspberry Pi, Jetson Nano, Arduino, and STM32.
Recursos de desenvolvemento: Comes with example code and documentation for Raspberry Pi, Arduino, and STM32.

Waveshare 1.28inch Round LCD Display Module with key specifications highlighted: 1.28 inch size, 240x240 resolution, 65K RGB colors, SPI interface, and GC9A01 driver.

Figura 2: Acabadoview of the 1.28inch Round LCD Display Module highlighting its main features and specifications.

3. Contido do paquete

Ao abrir o paquete, debes atopar os seguintes elementos:

1x Waveshare 1.28inch Round LCD Display Module
1x PH2.0 8PIN 20cm cable

Image showing the package contents: one 1.28inch LCD Module and one PH2.0 8PIN 20cm cable.

Figura 3: Contido incluído no paquete do produto.

4. Setup and Hardware Connection

This section details the physical connection of the 1.28inch Round LCD Display Module to compatible development boards. The module uses an SPI interface for communication.

4.1 Descrición do pinout

De volta view of the Waveshare 1.28inch Round LCD Display Module showing the pinout labels: VCC, GND, DIN, CLK, CS, DC, RST, BL.

Figura 4: De volta view of the display module showing the 8-pin connector and pin labels.

Etiqueta de Pin	Descrición
VCC	Power supply (3.3V / 5V input)
GND	Terra
DIN	SPI data input (MOSI)
CLK	SPI clock input (SCK)
CS	Selección de chip, baixa activa
DC	Selección de datos/comando (alta para datos, baixa para comando)
RST	Restablecer, activo baixo
BL	Control de contraluz

4.2 Connecting with Raspberry Pi

Follow the diagram below to connect the display module to a Raspberry Pi board. Ensure correct pin mapping for VCC, GND, DIN (MOSI), CLK (SCK), CS, DC, RST, and BL.

Wiring diagram showing connection of the 1.28inch LCD module to a Raspberry Pi. VCC to 3.3V, GND to GND, DIN to MOSI, CLK to SCLK, CS to CE0, DC to P25, RST to P24, BL to P18.

Figura 5: Hardware connection diagram for Raspberry Pi.

4.3 Connecting with Arduino Board

Refer to the diagram for connecting the display module to an Arduino board. Pay attention to the specific digital and analog pins used for SPI communication and control signals.

Wiring diagram showing connection of the 1.28inch LCD module to an Arduino board. VCC to 5V, GND to GND, DIN to D11, CLK to D13, CS to D10, DC to D9, RST to D8, BL to D7.

Figura 6: Hardware connection diagram for Arduino.

For other compatible boards like Jetson Nano or STM32, consult the respective board's documentation and the Waveshare product wiki for specific wiring instructions and exampcódigo le.

5. Funcionamento e programación

The Waveshare 1.28inch Round LCD Display Module requires programming to display content. Waveshare provides comprehensive development resources, including example code and libraries, for various platforms.

5.1 Configuración do software

Obtain Resources: Visit the official Waveshare product wiki page for the 1.28inch Round LCD Display Module to download the latest development resources, including drivers, libraries, and example code for Raspberry Pi, Arduino, and STM32.
Install Libraries: Follow the instructions provided in the downloaded resources to install the necessary libraries for your chosen development environment (e.g., Arduino IDE, Python for Raspberry Pi).
Carga ExampCódigo: Open and compile the provided example code to verify the display's functionality and understand basic operations.

5.2 Basic Display Control

The display is controlled via the SPI protocol. Key functions typically include:

Inicialización: Sending a sequence of commands to the GC9A01 driver to configure the display.
Drawing Pixels/Shapes: Writing pixel data to the display memory.
Visualización de texto: Using fonts to render text on the screen.
Visualización da imaxe: Loading and displaying bitmap images.
Control de retroiluminación: Adjusting the brightness of the display backlight via the BL pin.

Consulte o example code for detailed implementation of these functions.

6. Mantemento e coidados

To ensure the longevity and optimal performance of your Waveshare 1.28inch Round LCD Display Module, follow these general maintenance guidelines:

Manexo: Handle the module by its edges to avoid touching the display surface or electronic components.
Limpeza: Use un pano suave e sen fiapos, lixeiramente dampened with water or a mild screen cleaner, to gently wipe the display surface. Avoid abrasive materials or harsh chemicals.
Almacenamento: Garde o módulo nun ambiente seco e sen po, lonxe da luz solar directa e de temperaturas extremas.
Fonte de alimentación: Asegúrese de que a fonte de alimentación voltage is within the specified range (3.3V / 5V) to prevent damage.
Electricidade estática: Take precautions against electrostatic discharge (ESD) when handling the module, as electronic components are sensitive to static.

7 Solución de problemas

If you encounter issues with your display module, consider the following troubleshooting steps:

Sen visualización/pantalla en branco:
- Verify all connections (VCC, GND, DIN, CLK, CS, DC, RST, BL) are secure and correctly wired according to the diagrams.
- Check the power supply to the module and the host board.
- Ensure the backlight (BL) pin is correctly controlled and receiving power.
- Confirm that the initialization code for the GC9A01 driver is correctly executed in your program.
Incorrect or Garbled Display:
- Double-check your SPI communication settings (mode, clock speed).
- Ensure the data format and command sequences sent to the GC9A01 driver match the specifications.
- Verify that the display buffer is being updated correctly in your code.
Slow Refresh Rate:
- SPI communication speed can impact refresh rates. Ensure your host board is configured for the fastest stable SPI clock speed.
- Optimize your drawing routines to minimize the amount of data sent over SPI.
Module Gets Warm:
- Some heat generation is normal, especially with continuous operation. Ensure adequate ventilation.
- Verifique que a entrada voltage is not exceeding 5V.
Problemas de compatibilidade:
- While compatible with many boards, specific libraries or pin mappings might be required. Consult Waveshare's documentation for your exact host board. (Note: Some users reported issues with Teensy 4, while it worked with Arduino Nano/Teensy 3.2/3.5).

8. Especificacións técnicas

Característica	Especificación
Tamaño de visualización	1.28 polgadas (redondo)
Resolución	240 x 240 píxeles
Profundidade de cor	65K RGB colors
Condutor IC	GC9A01
Interface	SPI de 4 fíos
Vol. Operativotage	3.3 V/5 V
Dimensións	40.4 x 37.5mm (overall), φ32.4mm (display area)
Tamaño de píxeles	0.135 x 0.135 mm
Peso do elemento	0.704 onzas
Fabricante	Waveshare

Detailed specifications table for the 1.28inch LCD module, including operating voltage, resolution, communication interface, display panel type, driver, display size, pixel size, and dimensions.

Figura 7: Detailed technical specifications and pin descriptions.

9. Soporte e Recursos

For further assistance, detailed documentation, and the latest development resources, please visit the official Waveshare website or product wiki page for this module. You can typically find:

Detailed tutorials and guides.
Example code for various programming languages and platforms.
Datasheets for the GC9A01 driver IC.
Community forums or contact information for technical support.

Fabricante: Waveshare

Oficial Websitio: www.waveshare.com

For specific product support, search for "1.28inch Round LCD Display Module" on the Waveshare wiki.

	Manual do usuario do módulo LCD de Waveshare de 2.4 polgadas Unha guía completa do módulo de pantalla TFT LCD de 2.4 polgadas de Waveshare, que detalla as súas características, especificacións e uso con Raspberry Pi, STM32 e Arduino. Obtén información sobre a interface SPI, o controlador IL9341, as conexións de hardware e o software.ampficheiros para integrar esta pantalla de resolución 240x320 nos teus proxectos.
	Manual do módulo de papel electrónico Waveshare de 2.66 polgadas Comprehensive user guide for the Waveshare 2.66-inch e-Paper module, detailing its features, specifications, SPI timing, working protocol, precautions, and integration guides for Raspberry Pi, Jetson Nano, STM32, and Arduino platforms, including API descriptions and FAQs.
	Waveshare 2.13inch e-Paper HAT (B) User Manual and Technical Guide Comprehensive guide for the Waveshare 2.13inch e-Paper HAT (B), covering hardware connections, software setup, programming principles, and troubleshooting for Raspberry Pi, Arduino, Jetson Nano, and STM32.
	Manual do usuario do módulo OLED de 0.91 polgadas - Waveshare Manual de usuario para o módulo OLED Waveshare de 0.91 polgadas (128 x 32 píxeles) con controlador SSD1306. Abarca máis deview, features, pinout, I2C communication, and demo code for STM32, Raspberry Pi (BCM2835, WiringPi, Python), and Arduino.
	Manual do usuario e guía de integración do sensor de distancia VL53L1X Un manual de usuario completo para o sensor de distancia de tempo de voo (ToF) Waveshare VL53L1X. Detalla as especificacións, as características e as conexións do sensor, e ofrece guías paso a paso para a integración con plataformas de desenvolvemento populares como Raspberry Pi, Arduino e STM32, incluíndo instrucións de código de demostración.
	Manual de usuario e guía técnica do relé Modbus RTU de 32 canles Manual de usuario completo e guía técnica para o Modbus RTU Relay 32CH. Abarca a seguridade, o hardware, a integración de software (Raspberry Pi, STM32, Arduino, PLC) e os protocolos de comandos Modbus RTU para a automatización industrial.

Waveshare 1.28inch LCD Module