App koppeln
Der letzte Schritt: App öffnen, einmal tippen, zuschauen.
1. App holen & anmelden
Die Franzl-App gibt es kostenlos im App Store und bei Google Play. Anmelden kannst du dich mit E-Mail, Google oder Apple.
2. Aktivieren: meistens ein einziger Tipp
Wichtig ist nur eines: Dein Handy hängt im selben WLAN wie dein Home Assistant. Dann tippst du in der App auf Franzl einrichten, und Franzl sucht sein Gateway von selbst. Du siehst dabei zu:
- „Suche Franzl im Heimnetz …“ — die App schaut sich um, ein paar Sekunden lang.
- Grüner Haken: „Franzl Gateway gefunden — Code automatisch übernommen“ — das Gateway hat der App seinen Aktivierungscode direkt übergeben. Das Feld ist schon ausgefüllt, du tippst nur noch auf Aktivieren. Das war's.
- „Gerade keine Franzl-Box im WLAN sichtbar“ — kein Fehler und kein Grund zur Sorge. Manche Netzwerke geben solche Suchen einfach nicht weiter. Dann nimmst du einen der beiden Wege unten, die immer funktionieren.
iPhone & iPad: Beim ersten Mal fragt iOS, ob Franzl Geräte im lokalen Netzwerk finden darf. Bitte auf Erlauben tippen. Ohne diese Erlaubnis kann die App dein Gateway im WLAN nicht sehen, und du gibst den Code von Hand ein. Schon versehentlich abgelehnt? Das lässt sich nachholen: iOS-Einstellungen → Franzl → Lokales Netzwerk einschalten.
Wenn der Code nicht von selbst kommt
Beide Wege sind gleichwertig, und beide funktionieren auch, wenn du gerade nicht zuhause bist:
- QR-Code scannen. In der App auf QR-Code scannen tippen und die Kamera auf den QR-Code im Franzl-Panel halten. Praktisch, wenn Home Assistant am Computer offen ist.
- Code eintippen. Im selben Panel steht ein 9-stelliger Code aus Großbuchstaben und Ziffern (z. B.
A1B2C3D4E). Du findest das Panel in Home Assistant unter Einstellungen → Apps → Franzl Gateway → Öffnen, oder als Eintrag Franzl in der Seitenleiste.
Der Code läuft ab, und das ist Absicht. Er gilt rund 15 Minuten und erneuert sich danach von selbst. Wenn zwischendurch Zeit vergangen ist: Panel neu laden — dort steht immer der aktuell gültige Code. Ein abgelaufener Code ist der häufigste Grund für „Code nicht gefunden“.
3. Was danach von selbst passiert
Nach dem Tippen auf Aktivieren dauert es meist ein bis zwei Minuten. In dieser Zeit legt Franzl dein Zuhause an, richtet den verschlüsselten Fernzugriff ein und verbindet sich mit dem Gateway. Die App zeigt den Fortschritt; du kannst sie dabei ruhig schließen, sie kommt an derselben Stelle wieder heraus.
Danach führt dich die App durch drei kurze Schritte:
- Geräte bestätigen. Franzl schaut sich in Home Assistant um und schlägt dir vor, was er gefunden hat: Wechselrichter, Batterie, Wallbox, Wärmepumpe, Zähler. Du bestätigst, was stimmt. Bei Zählern fragt er nach, was das Gerät misst — ob es der Netzzähler am Hausanschluss ist oder ein einzelner Wechselrichter. Diese eine Frage entscheidet, ob Franzl später Autarkie und Überschuss exakt rechnen kann.
- Solaranlage. Größe in kWp, Ausrichtung und Neigung. Daraus wird deine Solarprognose. Warum das genauer ist, als es klingt.
- Stromtarif. Fixpreis, HT/NT oder dynamisch (z. B. aWATTar). Bei dynamischen Tarifen rechnet Franzl mit den echten Börsenpreisen von morgen.
Alles davon kannst du später jederzeit ändern, nichts ist endgültig.
4. Familie mitnehmen (optional)
Im Mehr-Tab unter Haushalt lädst du weitere Personen ein. Sie brauchen kein eigenes Gateway und keinen Aktivierungscode: Sie installieren die App, öffnen deinen Einladungslink und sind drin. Beim Einladen vergibst du eine Rolle — Verwalter:in (darf alles einrichten), Mitglied (darf schauen und steuern) oder Gast (darf nur schauen). Du selbst bleibst Besitzer:in des Zuhauses.
Wenn etwas nicht klappt
| Was du siehst | Was zu tun ist |
|---|---|
| „Gerade keine Franzl-Box im WLAN sichtbar“ | Kein Fehler. Auf Erneut suchen tippen oder einfach den Code eingeben. |
| Die Suche findet nie etwas | Handy im Gäste-WLAN? Auf iPhone die Netzwerk-Erlaubnis verweigert? → Fehlersuche |
| „Code ungültig“ oder „nicht gefunden“ | Der Code ist abgelaufen. Panel neu laden, aktuellen Code nehmen. |
| „Zu viele Versuche“ | Ein paar Minuten warten, dann nochmal. |
| Aktivierung hängt bei „Warte auf Franzl“ | Bis zu 2 Minuten sind normal. Danach: Läuft das Gateway noch (grüner Status)? Hat Home Assistant Internet? |
| Das Gateway zeigt gar keinen Code | Gateway einmal neu starten; beim allerersten Start richtet es noch die Datenbank ein. |
Nichts dabei? Die geführte Fehlersuche geht die Ursachen in der Reihenfolge ihrer Häufigkeit durch.
Etwas hakt beim Verbinden?
Zur Fehlersuche