JWTechPublisher: Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex

2026-09-05T22:40:42Z

Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex

Neue Seite

__NOINDEX__
'''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 Waveshare 1.3inch LCD HAT is a 240x240 pixel IPS display for the Raspberry Pi via SPI. It uses the ST7789VM controller and connects through GPIO pins. The guide covers enabling SPI, driver installation (bcm2835, wiringPi, lgpio), Python demos, and the FBCP framebuffer driver.

== Related products at JW Tech ==
* [https://shop.jw-tech.eu/p/WSAL14972 WSAL14972 – 240x240, 1.3inch IPS LCD display HAT for Raspberry Pi]

== Technical overview ==
* Resolution: 240 (H) x 240 (V) pixels; display size 23.4 mm x 23.4 mm; pixel pitch approx. 0.0975 mm/pixel.
* Interface: 4-wire SPI (SCLK, MOSI, CS, DC, RST, BL).
* Operating voltage: 3.3 V.
* Controller: ST7789VM – single-chip driver for graphic TFT-LCDs up to 262K colors; supports RGB444/RGB565/RGB666; demo codes use RGB565.
* Raspberry Pi pinout: KEY1=P21, KEY2=P20, KEY3=P16; Joystick UP=P6, DOWN=P19, LEFT=P5, RIGHT=P26, PRESS=P13; SCLK=P11/SCLK, MOSI=P10/MOS, CS=P8/CE0, DC=P25, RST=P27, BL=P24.
* SPI communication: CPOL=0 and CPHA=0 correspond to SPI mode 0 (default).
* FBCP driver: open-source project using partial refresh and DMA, achieving up to 60 fps; requires a 32-bit Raspberry Pi system because FBCP is currently not compatible with 64-bit systems.
* For desktop display via FBCP, set hdmi_cvt=300 300 60 1 0 0 0, hdmi_group=2, hdmi_mode=87 in /boot/config.txt; on Pi 4B, comment out dtoverlay=vc4-fkms-v3d and max_framebuffers=2.
* Analog mouse: the joystick drives a virtual mouse via PyMouse/PyUserInput; the script must run under the graphical interface, not over SSH.

'''Commands and examples – verify before use:'''
<syntaxhighlight lang="text">
sudo raspi-config # then enable SPI under Interfacing Options
sudo reboot
sudo wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz && sudo tar zxvf bcm2835-1.71.tar.gz && cd bcm2835-1.71/ && sudo ./configure && sudo make && sudo make check && sudo make install
sudo apt-get install wiringpi
wget https://files.waveshare.com/wiki/common/wiringpi-latest.deb && sudo dpkg -i wiringpi-latest.deb
sudo git clone https://github.com/WiringPi/WiringPi && cd WiringPi && sudo ./build
wget https://github.com/joan2937/lg/archive/master.zip && unzip master.zip && cd lg-master && sudo make install
sudo apt-get install python3-pip && sudo apt-get install python3-pil && sudo apt-get install python3-numpy && sudo pip3 install spidev
sudo apt-get install p7zip-full -y && wget https://files.waveshare.com/upload/b/bd/1.3inch_LCD_HAT_code.7z && 7z x 1.3inch_LCD_HAT_code.7z -r -o./1.3inch_LCD_HAT_code && sudo chmod 777 -R 1.3inch_LCD_HAT_code
cd c && make clean && make && sudo ./main
cd python && sudo python main.py && sudo python key_demo.py
sudo nano /boot/config.txt # add: gpio=6,19,5,26,13,21,20,16=pu
sudo apt-get install cmake -y && wget https://files.waveshare.com/upload/f/f9/Waveshare_fbcp.7z && 7z x Waveshare_fbcp.7z -o./waveshare_fbcp && cd waveshare_fbcp && mkdir build && cd build && cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_1INCH3_LCD_HAT=ON -DBACKLIGHT_CONTROL=ON -DSTATISTICS=0 .. && make -j && sudo ./fbcp
sudo cp ~/waveshare_fbcp/build/fbcp /usr/local/bin/fbcp && sudo nano /etc/rc.local # add fbcp& before exit 0
sudo apt-get install python3-xlib && sudo pip3 install PyMouse && sudo pip3 install unix && sudo pip3 install PyUserInput && wget https://files.waveshare.com/upload/d/d3/Mouse.7z && 7z x Mouse.7z && sudo python3 mouse.py
</syntaxhighlight>

== Notes and version constraints ==
* The source contains placeholders such as {{{name2}}} and {{{userDefinedInfo}}}; these were ignored as they are not valid technical data.
* FBCP explicitly requires a 32-bit Raspberry Pi system; it does not work on 64-bit systems according to the source.
* On the Bookworm system, only the lgpio library is available; bcm2835 and wiringPi cannot be installed or used there.
* The FBCP resolution setting (hdmi_cvt=300 300 60 ...) should be slightly larger than the native LCD resolution but not too high, otherwise fonts become blurry; exact values depend on the desired scaling ratio and require manual adjustment.
* The mouse script runs only under the graphical interface, not over SSH; the path /home/pi/mouse.py assumes the script was placed there.
* Some commands refer to older system versions (pre-raspbian_lite-2019-06-20); on newer versions the configuration may differ.
* ESP32 compatibility (30-pin module) is mentioned, but the specific pin mappings (DIN→23, CLK→18, CS→5, DC→4, RST→0) apply only to that specific ESP32 model and should be verified before use.

== Source and revision record ==
* [https://www.waveshare.com/wiki/1.3inch_LCD_HAT 1.3inch LCD HAT - Waveshare Wiki]
* Source revision: 110855
* Captured: 2026-08-31T02:35:13+00:00
* SHA-256: <code>3b448df964e7edcd09ee80300f1b7467a92edb365a2c4be6f4a107f3d8b842e2</code>

WSAL14972 – 1.3inch LCD HAT/en - Versionsgeschichte

JWTechPublisher: Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex