Somfy TaHoma in Link’nX: declare the box and discover its devices

Declare a Somfy TaHoma or Connexoon box in Link’nX with its local IP address and its Developer-Mode token, then save the list of its discovered devices: shutters, blinds, sensors. These devices then become selectable in Somfy actions, Somfy triggers and the Somfy KNX gateway.

Intended for administrators and installers authorized to configure the gateway.

Before you start

• Note the box’s local IP address on the KNX gateway network and its port. Have them confirmed by the installer if needed.
• Generate the box’s Developer-Mode token. The help (question mark) of this field explains how to enable Developer Mode and generate the token in the TaHoma by Somfy app. This mode does not exist on first-generation (square) TaHoma/Somfy boxes or on the Connectivity Kit. A Somfy account password does not replace this token.
• Models, versions and vendor screens are not interchangeable: if the procedure is not known for your model and your app, ask support for it.
• The token is confidential: enter it only in the dedicated form and hide it in any screenshot.

Declare the box

1. Check the project and the gateway in the Link’nX header. In Devices, open Smart Home, then Somfy, or search for Somfy in Search a device…. On mobile, open the navigation first.
2. If a padlock or an activation message appears, check the context and the Somfy option. For missing access, contact your distributor or support.
3. Click Add to open Somfy box declaration.
4. Fill in Name, required, 64 characters maximum. “Living room box” is a fictitious example.
5. Fill in Box IP address, required, 128 characters maximum: the box’s local IP address. Enter the IP address rather than a host name: the gateway does not resolve .local names.
6. Box PIN is optional, 64 characters maximum, in the form XXXX-XXXX-XXXX. Its help explains where to read it in the TaHoma by Somfy app.
7. Check Port, required and set to 8443 by default. Fill in Developer-Mode token, required.
8. Click the round floppy disk at the bottom right and wait for Success!. The box appears in the list with its address and its port.

If the floppy disk is grayed out, a required field is empty: check Name, Box IP address, Port and Developer-Mode token.

Discover, then save the devices

1. On the row of the saved box, click the Edit pencil. The search starts on its own in Box devices. When creating a box that has not yet been saved, Discover devices is disabled: save the box, then reopen it.
2. Review the Name, Type, Sub-device URL and Status columns. Shutters, blinds or sensors are devices of this box, distinct from the declaration of the box itself.
3. To run the search again, click Refresh and wait for its result.
4. After a successful discovery, click the floppy disk to save the list. Wait for Updated!. A list merely displayed after discovery is not yet available to the other forms, and leaving the page does not prompt you to save it.
5. Then open an action, a trigger or the Somfy KNX gateway and select the box: its saved devices are offered in Device.

Check the result

In Box devices, Available and Offline describe the result of the last discovery, not a permanent status of the device. To confirm communication, test an actual command on a device. A discovery failure alone is not enough to conclude that the device is faulty.

Edit or delete the declaration

Open the Edit pencil, correct the parameters and save with the floppy disk; wait for Updated!. If a confirmation appears when you leave the form, review the unsaved changes.

Before deleting the box, check its actions, triggers and KNX associations. Click its Delete trash can and review the name in the browser confirmation. Cancel to keep the box, or confirm, then check that it disappears after Deleted!. No button restores the declaration.

Troubleshooting

Message shown after discovery	Cause	Action
The box did not respond.	No response from the box	Check that it is the right box and that it is online. Review the IP address, port and token in the declaration, then click Refresh.
The box returned no devices — the saved list is kept.	The box answered without any device	The previous list is kept. Check that the box is online, then refresh.
The box refused the token, followed by a code	Token refused by the box	Generate a new token in the TaHoma by Somfy app, paste it into the declaration, save, then reopen the box.
The box cannot be reached, followed by a code	Address, network or Developer Mode	Check the IP address or PIN, that the box is on the same network as the KNX gateway and that Developer Mode is enabled.
Discovery failed, followed by a code	Other failure	The saved list is kept. Click Refresh; if the code persists, note it for support.

After a failure, the Saved list badge replaces the device status: the list shown is the last saved one and does not confirm that the devices are currently available. Keep the existing associations: deleting them does not resolve this message.

If you know the exact URL of a sub-device, the action, trigger and gateway forms offer ✎ Enter the URL manually…. Use only a confirmed URL of a device of this box; the box’s IP address does not replace it. This entry does not restore an unavailable connection.

A shutter visible in the declaration but missing from Actions was not saved with the list: save the declaration after discovery, then reopen the action form and select the right box.

Contact support

If the problem persists, write to support@can-nx.com with Link’nX, the project and gateway concerned, the box model, the exact message with its code and the tests carried out. A screenshot of the list without the token or sensitive data can help. Never send the token.

French labels: 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….