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

2026-09-05T22:40:41Z

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

Neue Seite

__NOINDEX__
'''Dokumentationshinweis:''' Diese technische Dokumentation wurde aus einer archivierten Lieferantenquelle neu formuliert. Technische Angaben und Befehle müssen vor der Verwendung mit der Produktversion und den Herstellerunterlagen abgeglichen werden.

== Zusammenfassung ==
Der Waveshare 1.3inch LCD HAT ist ein 240×240-Pixel-IPS-Display für den Raspberry Pi über SPI. Es nutzt den ST7789VM-Controller und wird über die GPIOs angeschlossen. Die Anleitung beschreibt Konfiguration von SPI, Treiberinstallation (bcm2835, wiringPi, lgpio), Python-Demos sowie den FBCP-Treiber für Framebuffer-Anzeige.

== Zugeordnete Produkte bei JW Tech ==
* [https://shop.jw-tech.eu/p/WSAL14972 WSAL14972 – 240x240, 1,3-Zoll-IPS-LCD-Display-HAT für Raspberry Pi]

== Technische Übersicht ==
* Auflösung: 240 (H) × 240 (V) Pixel; Anzeigegröße 23,4 mm × 23,4 mm; Pixeldichte ca. 0,0975 mm/Pixel.
* Schnittstelle: 4-Leiter-SPI (SCLK, MOSI, CS, DC, RST, BL).
* Betriebsspannung: 3,3 V.
* Controller: ST7789VM – Single-Chip-Treiber für grafische TFT-LCDs bis 262K Farben; unterstützt RGB444/RGB565/RGB666; Demo-Codes nutzen RGB565.
* Pinbelegung auf dem Raspberry Pi: 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-Kommunikation: CPOL=0 und CPHA=0 entsprechen SPI-Modus 0 (Standard).
* FBCP-Treiber: Open-Source-Projekt mit Teilaktualisierung und DMA, erreicht bis zu 60 fps; benötigt 32-Bit-Raspberry-Pi-System, da FBCP aktuell nicht mit 64-Bit-Systemen kompatibel ist.
* Für die Desktop-Anzeige über FBCP muss in /boot/config.txt hdmi_cvt=300 300 60 1 0 0 0, hdmi_group=2, hdmi_mode=87 gesetzt werden; bei Pi 4B müssen die Zeilen dtoverlay=vc4-fkms-v3d und max_framebuffers=2 kommentiert werden.
* Analoge Maus: Der Joystick steuert eine virtuelle Maus über PyMouse/PyUserInput; das Skript muss unter der grafischen Oberfläche laufen, nicht per SSH.

'''Befehle und Beispiele – vor Ausführung prüfen:'''
<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>

== Hinweise und Versionsgrenzen ==
* Die Quelle enthält Platzhalter wie {{{name2}}} und {{{userDefinedInfo}}}; diese wurden ignoriert, da sie keine gültigen technischen Angaben darstellen.
* FBCP erfordert explizit ein 32-Bit-Raspberry-Pi-System; auf 64-Bit-Systemen funktioniert es laut Quelle nicht.
* Bei Verwendung des Bookworm-Systems sind nur die lgpio-Bibliothek verfügbar; bcm2835 und wiringPi können dort nicht installiert oder verwendet werden.
* Die Auflösungseinstellung für FBCP (hdmi_cvt=300 300 60 ...) sollte etwas größer als die native LCD-Auflösung sein, aber nicht zu hoch, sonst werden Schriften unscharf; exakte Werte hängen vom gewünschten Skalierungsverhältnis ab und erfordern manuelle Anpassung.
* Das Maus-Skript läuft nur unter der grafischen Oberfläche, nicht per SSH; der genaue Pfad /home/pi/mouse.py setzt voraus, dass das Skript dort abgelegt wurde.
* Einige Befehle beziehen sich auf ältere Systemversionen (vor raspbian_lite-2019-06-20); bei neueren Versionen kann die Konfiguration anders aussehen.
* Die Kompatibilität mit ESP32 (30-Pin-Modul) wird erwähnt, aber die genauen Pinzuordnungen (DIN→23, CLK→18, CS→5, DC→4, RST→0) gelten nur für dieses spezifische ESP32-Modell und sollten vor der Verwendung verifiziert werden.

== Quelle und Revisionsnachweis ==
* [https://www.waveshare.com/wiki/1.3inch_LCD_HAT 1.3inch LCD HAT - Waveshare Wiki]
* Quellrevision: 110855
* Erfasst: 2026-08-31T02:35:13+00:00
* SHA-256: <code>3b448df964e7edcd09ee80300f1b7467a92edb365a2c4be6f4a107f3d8b842e2</code>

WSAL14972 – 1.3inch LCD HAT - Versionsgeschichte

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