WSAL18079 – 1.54inch LCD Module/en

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

The 1.54inch LCD module (240×240) uses an ST7789VW driver and a SPI interface; it is intended for Raspberry Pi, STM32, Arduino UNO and VisionFive2.

Related products at JW Tech

• WSAL18079 – 240×240, General 1.54inch LCD Display Module, IPS, 65K RGB

Technical overview

• Resolution: 240(H) × 240(V) pixels on an IPS panel.
• Display size: 27.72 mm × 27.72 mm; module dimensions 50 mm × 35 mm; pixel pitch 0.1155 mm per pixel.
• Interface: 4-wire SPI with MOSI, SCLK, CS, DC, RST, BL plus VCC/GND.
• Driver ST7789VW supports RGB444, RGB565 and RGB666; the demos use RGB565.
• Supply voltage: 3.3 V or 5 V depending on target system; supply and logic levels must be consistent.
• Raspberry Pi connection via a PH2.0 8-pin cable to GPIO pins 19, 23, 24, 22, 13, 12.
• STM32F103RBT6 demo uses PA7/PA5/PB6/PA8/PA9/PC7 for DIN/CLK/CS/DC/RST/BL.
• Arduino UNO uses D11/D13/D10/D7/D8/D9 for the same signals.
• VisionFive2 uses board pins 19/23/24/22/13/12 according to the pin mapping table.

Commands and examples – verify before use: 

sudo raspi-config
sudo reboot
sudo make clean && sudo make -j 8
sudo ./main 1.54
sudo python3 1inch54_LCD_test.py
python3 1inch54_LCD_test.py

Notes and version constraints

• Voltage levels: VCC must match the logic level (3.3 V or 5 V), otherwise the module may not function properly.
• Version-sensitive notes: On Bookworm only lgpio is available; bcm2835/wiringPi cannot be installed there. Bullseye requires 'apt' instead of 'apt-get'.
• The C/Python demos cover multiple screen sizes; for this module use parameter 1.54.
• SPI timing (CPHA=0, CPOL=0) from the datasheet must be observed when porting.
• Exact pinout can vary by board variant; verify the actual hardware before wiring.

Source and revision record

• 1.54inch LCD Module - Waveshare Wiki
• Source revision: 105201
• Captured: 2026-09-01T03:01:33+00:00
• SHA-256: f5e9d25876da166a624430673e96bb50a9d4ec159982ab0a9d32cb7d07c10f8b