Zum Inhalt springen

WSAL24155 – 1.28inch Touch LCD/en

Aus JW Tech Wiki
Version vom 6. September 2026, 09:56 Uhr von JWTechPublisher (Diskussion | Beiträge) (Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Documentation notice: This technical documentation was independently rewritten from an archived supplier source. Check technical details and commands against the product version and manufacturer documentation before use.

Summary

This module combines a 240×240 IPS display with a capacitive touch panel and communicates via 4-wire SPI and I2C.

Related products at JW Tech

Technical overview

  • Resolution 240 × 240 pixels on a round IPS panel
  • LCD driver IC: GC9A01 with 129,600 bytes of internal GRAM
  • Touch driver IC: CST816S/T, capacitive touch, I2C communication
  • Operating voltage: 3.3 V or 5 V – supply and logic voltages must match
  • Pins: VCC, GND, MISO, MOSI, SCLK, LCD_CS, LCD_DC, LCD_RST, LCD_BL, TP_SDA, TP_SCL, TP_INT, TP_RST
  • SPI protocol: 4-wire SPI, CPOL=0, CPHA=0, MSB first
  • I2C device address: 7-bit address 0x15 (write 0x2A, read 0x2B)
  • Dimensions: display Φ32.4 mm; module 39.15 × 37 mm, cutout Φ38.5 mm
  • Pixel size: 0.135 × 0.135 mm
  • Available for Raspberry Pi, Pico, STM32 and Arduino – demos provided

Commands and examples – verify before use: 

sudo raspi-config → Interfacing Options → SPI → Yes
sudo raspi-config → Interfacing Options → I2C → Yes
sudo reboot
git clone https://github.com/WiringPi/WiringPi && cd WiringPi && ./build
sudo apt-get install python-pip python-pil python-numpy
sudo pip install RPi.GPIO smbus spidev
sudo wget https://files.waveshare.com/upload/f/fb/1.28inch_Touch_LCD_RPI.zip
cd ~ && sudo unzip ./1.28inch_Touch_LCD_RPI.zip && cd 1.28inch_Touch_LCD_RPI/c
sudo make clean && sudo make -j && sudo ./main
cd ~/1.28inch_Touch_LCD_RPI/python/examples && sudo python 1inch28_LCD_test.py

Notes and version constraints

  • Supply and logic voltages must be identical, otherwise malfunction may occur
  • The SPI interface must not be occupied by other devices – check /boot/config.txt
  • Raspberry Pi versions may differ; commands apply to current Pi models
  • Demo files are downloaded from an external URL – availability not guaranteed
  • For precise register values and timing details, refer to the GC9A01 datasheet

Source and revision record