--- title: "Somfy TaHoma in Link’nX: Box anlegen und ihre Geräte erkennen" description: Legen Sie eine Somfy-Box TaHoma oder Connexoon mit IP-Adresse und Entwicklermodus-Token in Link’nX an und speichern Sie die erkannten Rollläden. canonical: https://wiki.can-nx.com/de/guides/link-somfy-devices/ language: de product: Link’nX audience: - administrateur - installateur context: "Link’nX Web: Smart-Home-Geräte, Somfy, Anlegen einer TaHoma- oder Connexoon-Box" --- # Somfy TaHoma in Link’nX: Box anlegen und ihre Geräte erkennen Kontext: Link’nX Web: Smart-Home-Geräte, Somfy, Anlegen einer TaHoma- oder Connexoon-Box 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](https://wiki.can-nx.com/de/guides/link-somfy-actions/), [Somfy-Auslösern](https://wiki.can-nx.com/de/guides/link-somfy-triggers/) und im [Somfy-KNX-Gateway](https://wiki.can-nx.com/de/guides/link-somfy-knx/) 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](https://wiki.can-nx.com/de/guides/link-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…**.