WSAL24155 – 1.28inch Touch LCD/en
Erscheinungsbild
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
- 1.28inch Touch LCD - Waveshare Wiki
- Source revision: 105669
- Captured: 2026-09-04T03:55:49+00:00
- SHA-256:
9a762af82d813c51c5dd811599c061020ce16fd5ed90e5a3adb12153c9d79332