Upload per ZIP-Tool (1/3)

2026-10-25 10:59:40 +01:00
1 parent 14a4880a09
commit 9e7561b040
@@ -0,0 +1,83 @@
+# LabelPi – Installationsanleitung (Raspberry Pi + Brother QL)
+
+Kurzfassung und Funktionsübersicht: [README](../README.md). Beispiel hier: Raspberry Pi 2 B + QL-500.
+
+## 0. Was du brauchst
+- Raspberry Pi 2 B, Netzteil (5 V / 2 A), microSD (8 GB+)
+- **USB-WLAN-Stick** (der Pi 2 B hat kein WLAN eingebaut; am besten ein 2,4-GHz-Stick, der unter Raspberry Pi OS ohne Zusatztreiber läuft, z. B. mit Realtek-/MediaTek-Chip)
+- Brother QL-500 per USB, 62-mm-Rolle eingelegt
+
+## 1. SD-Karte vorbereiten
+1. **Raspberry Pi Imager** starten → Gerät: *Raspberry Pi 2* → OS: *Raspberry Pi OS (other) → Raspberry Pi OS Lite (32-bit)*.
+2. Zahnrad / „Einstellungen bearbeiten“:
+   - Hostname: `labelpi`
+   - Benutzer + Passwort festlegen
+   - WLAN: SSID und Passwort deines **Hotspots** (ggf. zusätzlich dein Heim-WLAN), Land `DE`
+   - SSH aktivieren (Passwort oder Schlüssel)
+   - Zeitzone `Europe/Berlin`
+3. Schreiben, SD in den Pi, WLAN-Stick einstecken, Strom an. Erster Start dauert 1–2 Minuten.
+
+> Hotspot-Tipp (iPhone): *Einstellungen → Persönlicher Hotspot → „Kompatibilität maximieren“* einschalten, damit er 2,4 GHz nutzt. Der Hotspot muss beim Einschalten des Pi bereits aktiv sein.
+
+## 2. Per SSH verbinden
+```
+ssh DEIN_BENUTZER@labelpi.local
+```
+Klappt `.local` nicht, die IP in den Geräteinfos des Hotspots nachsehen.
+
+## 3. Dateien auf den Pi bringen
+**Variante A (ein Befehl, empfohlen):** direkt auf dem Pi
+```
+curl -fsSL https://raw.githubusercontent.com/DEIN-USER/labelpi/main/install.sh | bash
+```
+Damit sind Schritt 3 und 4 erledigt, weiter mit Schritt 5.
+
+**Variante B (manuell):**
+Vom PC aus (Ordner `labelpi` aus dem ZIP entpackt):
+```
+scp -r labelpi DEIN_BENUTZER@labelpi.local:~
+```
+
+## 4. Installieren
+```
+cd ~/labelpi
+bash install.sh
+```
+Das Skript installiert Python-Pakete in einer venv, legt die USB-Rechte für Brother-Drucker an und richtet den Dienst `labelpi` ein (startet automatisch beim Booten, Port 80). Die Installation dauert auf dem Pi 2 einige Minuten.
+
+## 5. Drucker prüfen
+QL-500 einschalten, dann:
+```
+lsusb | grep 04f9      # sollte "Brother Industries" zeigen
+sudo systemctl status labelpi
+```
+Falls der Drucker nicht erkannt wird: einmal aus- und wieder einschalten bzw. `sudo reboot`.
+
+## 6. Benutzen
+Im Browser (PC, iPad, iPhone, gleiches Netz/Hotspot): **http://labelpi.local**
+- Grüner Punkt oben = Drucker gefunden.
+- iPhone/iPad: Teilen → „Zum Home-Bildschirm“ für ein App-Symbol.
+- Modelle mit Autoschnitt zeigen oben die Option „Autoschnitt“. Der QL-500 schneidet **nicht** automatisch: nach dem Druck Etikett am Cutter manuell abtrennen. Bei mehreren Kopien kommen die Etiketten hintereinander raus.
+- Die Schrift wird auf dem jeweiligen Gerät gerendert (WYSIWYG: gedruckt wird, was du siehst). Auf iPad/PC können Schriftarten leicht abweichen.
+
+Oben rechts gibt es Buttons zum **Neustarten** und **Herunterfahren** des Pi. Nach dem Herunterfahren erst Strom trennen, wenn die grüne LED nicht mehr blinkt.
+
+## 7. Wartung
+- Logs: `journalctl -u labelpi -f`
+- Neustart: `sudo systemctl restart labelpi`
+- **Backup:** Vorlagen und Verlauf liegen in `~/labelpi/labels.db` (einfach kopieren).
+- Weiteres WLAN hinzufügen: `sudo nmcli device wifi connect "SSID" password "PASSWORT"`
+- Update: neue Dateien drüberkopieren, dann `sudo systemctl restart labelpi`.
+
+## 8. Fehlerbehebung
+| Problem | Lösung |
+|---|---|
+| `ImportError: libopenjp2.so.7` (Dienst startet nicht) | `bash install.sh` erneut ausführen (installiert die fehlenden Bibliotheken), Prüfen mit `journalctl -u labelpi -n 30` |
+| „Drucker nicht gefunden“ | Strom/USB prüfen, `lsusb`, Dienst neu starten |
+| „Resource busy“ / „Access denied“ | `echo 'blacklist usblp' \| sudo tee /etc/modprobe.d/blacklist-usblp.conf`, dann `sudo reboot` |
+| Fehler zur Rollen-/Etikettengröße | Im Designer dieselbe Rolle wählen wie im Drucker eingelegt (QL-500 erkennt sie nicht selbst) |
+| WLAN-Stick verbindet nicht mit Hotspot | `nmcli device wifi list` (sieht der Stick das Netz?), WLAN-Land `DE` setzen (`sudo raspi-config`), Hotspot auf **2,4 GHz** und **WPA2** stellen (viele Sticks können kein 5 GHz/WPA3) |
+| Seite nicht erreichbar | Hotspot aktiv? Gleiches Netz? Alternativ per IP statt `labelpi.local` |
+
+## 9. Sicherheit
+Optional: Passwortschutz unter *Einstellungen*. Ohne Passwort gibt es **keinen Login**. Nutze die Seite nur im eigenen Hotspot/Heimnetz mit starkem WLAN-Passwort, nicht im Firmen-WLAN.