Somfy TaHoma in Link’nX: Box anlegen und ihre Geräte erkennen

Legen Sie eine Somfy-Box TaHoma oder Connexoon in Link’nX mit ihrer lokalen IP-Adresse und ihrem Developer-Mode token (Token des Entwicklermodus) an und speichern Sie dann die Liste ihrer erkannten Geräte: Rollläden, Jalousien, Sensoren. Diese Geräte lassen sich anschließend in Somfy-Aktionen, Somfy-Auslösern und im Somfy-KNX-Gateway auswählen.

Für Administratoren und Installateure, die zur Konfiguration des Gateways berechtigt sind.

Bevor Sie beginnen

• Notieren Sie die lokale IP-Adresse der Box im Netzwerk des KNX-Gateways und ihren Port. Lassen Sie sie bei Bedarf vom Installateur bestätigen.
• Erzeugen Sie das Developer-Mode token der Box. Die Hilfe (Fragezeichen) dieses Felds erklärt, wie Sie den Entwicklermodus aktivieren und das Token in der App TaHoma by Somfy erzeugen. Diesen Modus gibt es weder bei TaHoma/Somfy-Boxen der ersten Generation (quadratisch) noch beim Connectivity Kit. Ein Passwort eines Somfy-Kontos ersetzt dieses Token nicht.
• Modelle, Versionen und Herstelleroberflächen sind nicht austauschbar: Ist das Verfahren für Ihr Modell und Ihre App nicht bekannt, fragen Sie den Support danach.
• Das Token ist vertraulich: Geben Sie es nur in das dafür vorgesehene Formular ein und schwärzen Sie es in jedem Screenshot.

Die Box anlegen

1. Prüfen Sie Projekt und Gateway in der Kopfzeile von Link’nX. Öffnen Sie unter Devices (Geräte) den Bereich Smart Home und dann Somfy, oder suchen Sie Somfy über Search a device… (Gerät suchen …). Auf dem Mobilgerät öffnen Sie zuerst die Navigation.
2. Erscheint ein Vorhängeschloss oder eine Aktivierungsmeldung, prüfen Sie den Kontext und die Somfy-Option. Bei fehlendem Zugriff wenden Sie sich an Ihren Distributor oder an den Support.
3. Klicken Sie auf Add (Hinzufügen), um Somfy box declaration (Anlegen einer Somfy-Box) zu öffnen.
4. Füllen Sie das Pflichtfeld Name mit höchstens 64 Zeichen aus. „Box Wohnzimmer“ ist ein fiktives Beispiel.
5. Füllen Sie das Pflichtfeld Box IP address (IP-Adresse der Box) mit höchstens 128 Zeichen aus: die lokale IP-Adresse der Box. Geben Sie die IP-Adresse statt eines Hostnamens ein: Das Gateway löst keine .local-Namen auf.
6. Box PIN (PIN der Box) ist optional, höchstens 64 Zeichen, im Format XXXX-XXXX-XXXX. Seine Hilfe zeigt, wo Sie die PIN in der App TaHoma by Somfy finden.
7. Prüfen Sie das Pflichtfeld Port, das mit 8443 vorbelegt ist. Füllen Sie das Pflichtfeld Developer-Mode token aus.
8. Klicken Sie auf das runde Diskettensymbol unten rechts und warten Sie auf Success! (Erfolg!). Die Box erscheint mit ihrer Adresse und ihrem Port in der Liste.

Ist das Diskettensymbol ausgegraut, ist ein Pflichtfeld leer: Prüfen Sie Name, Box IP address, Port und Developer-Mode token.

Die Geräte erkennen und dann speichern

1. Klicken Sie in der Zeile der gespeicherten Box auf das Stiftsymbol Edit (Bearbeiten). Unter Box devices (Geräte der Box) startet die Suche von selbst. Beim Erstellen einer noch nicht gespeicherten Box ist Discover devices (Geräte erkennen) deaktiviert: Speichern Sie die Box und öffnen Sie sie dann erneut.
2. Prüfen Sie die Spalten Name, Type (Typ), Sub-device URL (URL des Untergeräts) und Status. Rollläden, Jalousien oder Sensoren sind Geräte dieser Box und vom Eintrag der Box selbst zu unterscheiden.
3. Um die Suche erneut zu starten, klicken Sie auf Refresh (Aktualisieren) und warten Sie auf das Ergebnis.
4. Klicken Sie nach einer erfolgreichen Erkennung auf das Diskettensymbol, um die Liste zu speichern. Warten Sie auf Updated! (Aktualisiert!). Eine nach der Erkennung lediglich angezeigte Liste steht den anderen Formularen noch nicht zur Verfügung, und beim Verlassen der Seite werden Sie nicht zum Speichern aufgefordert.
5. Öffnen Sie anschließend eine Aktion, einen Auslöser oder das Somfy-KNX-Gateway und wählen Sie die Box: Ihre gespeicherten Geräte werden unter Device (Gerät) angeboten.

Ergebnis prüfen

Unter Box devices beschreiben Available (Verfügbar) und Offline das Ergebnis der letzten Erkennung, keinen dauerhaften Zustand des Geräts. Um die Kommunikation zu bestätigen, testen Sie einen echten Befehl an einem Gerät. Eine fehlgeschlagene Erkennung allein reicht nicht aus, um auf einen Gerätefehler zu schließen.

Den Eintrag bearbeiten oder löschen

Öffnen Sie das Stiftsymbol Edit, korrigieren Sie die Parameter und speichern Sie mit dem Diskettensymbol; warten Sie auf Updated!. Erscheint beim Verlassen des Formulars eine Bestätigung, prüfen Sie die nicht gespeicherten Änderungen.

Prüfen Sie vor dem Löschen der Box ihre Aktionen, Auslöser und KNX-Zuordnungen. Klicken Sie auf ihr Papierkorbsymbol Delete (Löschen) und prüfen Sie den Namen in der Bestätigung des Browsers. Brechen Sie ab, um die Box zu behalten, oder bestätigen Sie und prüfen Sie nach Deleted! (Gelöscht!), dass sie verschwunden ist. Keine Schaltfläche stellt den Eintrag wieder her.

Fehlerbehebung

Meldung nach der Erkennung	Ursache	Maßnahme
The box did not respond. (Die Box hat nicht geantwortet.)	Keine Antwort der Box	Prüfen Sie, ob es die richtige Box ist und ob sie online ist. Prüfen Sie IP-Adresse, Port und Token im Eintrag und klicken Sie dann auf Refresh.
The box returned no devices — the saved list is kept. (Die Box hat keine Geräte zurückgegeben — die gespeicherte Liste bleibt erhalten.)	Die Box hat ohne Gerät geantwortet	Die vorherige Liste bleibt erhalten. Prüfen Sie, ob die Box online ist, und aktualisieren Sie dann.
The box refused the token (Die Box hat das Token abgelehnt), gefolgt von einem Code	Token von der Box abgelehnt	Erzeugen Sie in der App TaHoma by Somfy ein neues Token, fügen Sie es in den Eintrag ein, speichern Sie und öffnen Sie die Box erneut.
The box cannot be reached (Die Box ist nicht erreichbar), gefolgt von einem Code	Adresse, Netzwerk oder Entwicklermodus	Prüfen Sie IP-Adresse oder PIN, ob die Box im selben Netzwerk wie das KNX-Gateway ist und ob der Entwicklermodus aktiviert ist.
Discovery failed (Erkennung fehlgeschlagen), gefolgt von einem Code	Anderer Fehler	Die gespeicherte Liste bleibt erhalten. Klicken Sie auf Refresh; bleibt der Code bestehen, notieren Sie ihn für den Support.

Nach einem Fehler ersetzt das Badge Saved list (Gespeicherte Liste) den Gerätestatus: Die angezeigte Liste ist die zuletzt gespeicherte und bestätigt nicht, dass die Geräte derzeit verfügbar sind. Behalten Sie die bestehenden Zuordnungen: Ihr Löschen behebt diese Meldung nicht.

Wenn Sie die genaue URL eines Untergeräts kennen, bieten die Formulare für Aktion, Auslöser und Gateway ✎ Enter the URL manually… (URL manuell eingeben …) an. Verwenden Sie nur eine bestätigte URL eines Geräts dieser Box; die IP-Adresse der Box ersetzt sie nicht. Diese Eingabe stellt keine nicht verfügbare Verbindung wieder her.

Ein Rollladen, der im Eintrag sichtbar ist, aber unter Actions (Aktionen) fehlt, wurde nicht mit der Liste gespeichert: Speichern Sie den Eintrag nach der Erkennung, öffnen Sie dann das Aktionsformular erneut und wählen Sie die richtige Box.

Support kontaktieren

Besteht das Problem weiter, schreiben Sie an support@can-nx.com und nennen Sie Link’nX, das betroffene Projekt und Gateway, das Modell der Box, die genaue Meldung mit ihrem Code und die durchgeführten Tests. Ein Screenshot der Liste ohne Token und ohne vertrauliche Daten kann helfen. Senden Sie niemals das Token.

Französische Bezeichnungen: Déclaration d’une box Somfy, Adresse IP de la box, PIN de la box, Jeton Mode Développeur, Équipements de la box, Actualiser, Liste enregistrée, Équipement, URL du sous-équipement, ✎ Saisie manuelle de l’URL….