Zum Inhalt springen

WSAL14972 – 1.3inch LCD HAT

Aus JW Tech Wiki
Version vom 6. September 2026, 00:40 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)

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

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:  

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

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

  • 1.3inch LCD HAT - Waveshare Wiki
  • Quellrevision: 110855
  • Erfasst: 2026-08-31T02:35:13+00:00
  • SHA-256: 3b448df964e7edcd09ee80300f1b7467a92edb365a2c4be6f4a107f3d8b842e2
Abgerufen von „https://wiki.jw-tech.eu/index.php?title=WSAL14972_–_1.3inch_LCD_HAT&oldid=1989“