---
title: "Somfy KNX integration with Link’nX: shutters and blinds"
description: "Control Somfy shutters and blinds from KNX with Link’nX: box declaration, device discovery, scenario actions, state triggers and DPT mappings."
canonical: https://wiki.can-nx.com/en/integrations/somfy/
language: en
---

# Somfy KNX integration with Link’nX: shutters and blinds

With Link’nX, the devices of a Somfy box, such as shutters, blinds or sensors, can be controlled from the KNX bus and used in the installation’s scenarios: open, close, stop, “my” position, closure, deployment or orientation setpoints. Their states can also start a scenario or be mapped to KNX group addresses. This page sums up what the integration does and the commissioning order.

## What the Somfy integration does

| Need | Where to configure it | Guide |
| --- | --- | --- |
| Declare the box and save its discovered devices | **Devices → Smart Home → Somfy** | [Declare a Somfy box](https://wiki.can-nx.com/en/guides/link-somfy-devices/) |
| Open, close or position a shutter from a KNX button | The box’s **Gateway mode configuration** | [Map Somfy commands and states to KNX](https://wiki.can-nx.com/en/guides/link-somfy-knx/) |
| Map the closure, movement or open / closed state to a KNX address | Same table, **States** group | [Map Somfy commands and states to KNX](https://wiki.can-nx.com/en/guides/link-somfy-knx/) |
| Control a shutter or blind in a scenario | **Somfy** actions | [Control a Somfy device](https://wiki.can-nx.com/en/guides/link-somfy-actions/) |
| Start a scenario on a Somfy state | **Somfy** triggers | [Trigger a scenario on a Somfy state](https://wiki.can-nx.com/en/guides/link-somfy-triggers/) |

## Step-by-step commissioning

1. [Declare the box](https://wiki.can-nx.com/en/guides/link-somfy-devices/) with its local IP address, its port and its **Developer-Mode token**.
2. Reopen the box with **Edit** to start discovery, then save the device list with the floppy disk: without this save, the devices are not offered in the other forms.
3. [Map the commands and states to KNX group addresses](https://wiki.can-nx.com/en/guides/link-somfy-knx/), checking the proposed DPT for each row.
4. Prepare the [Somfy actions](https://wiki.can-nx.com/en/guides/link-somfy-actions/) and the [triggers on a state](https://wiki.can-nx.com/en/guides/link-somfy-triggers/), then [add them to the scenario concerned](https://wiki.can-nx.com/en/guides/link-compose-scenario/).
5. Test each command on the installation with the installer: a save does not prove a movement.

## Good to know

- The port proposed for the box is **8443**. The token is required and confidential; a Somfy account password does not replace it.
- **Open**, **Close**, **Stop** and **My position** use DPT 1.001 and only react to the value 1. For a standard KNX shutter push button, use **Up / down (KNX button)** in DPT 1.008 (0 opens, 1 closes) and **Stop (KNX step/stop button)** in DPT 1.007, offered only in the gateway table. Closure, deployment and orientation setpoints use DPT 5.001, as a percentage from 0 to 100, including orientation, which is not expressed in degrees.
- A position setpoint of 0 remains a setpoint: it does not replace the **Stop** command.
- The states **Closure**, **Deployment**, **Target closure** and **Slat orientation** are proposed in DPT 5.001, **Open / closed** in DPT 1.009, **Moving** in DPT 1.001 and **Status** in DPT 1.002.
- Commands and states share a single table, without separate tabs. The functions offered depend on the known capabilities of the discovered device.

For other shutters, relays and lights controlled from KNX, see [Lighting, blinds and shutters](https://wiki.can-nx.com/en/usages/eclairage-ouvrants/).

## All Somfy guides

### Devices and integrations

- [Somfy action in Link’nX: open, close or position a shutter](https://wiki.can-nx.com/en/guides/link-somfy-actions/)
- [Somfy TaHoma in Link’nX: declare the box and discover its devices](https://wiki.can-nx.com/en/guides/link-somfy-devices/)
- [Somfy trigger: start a Link’nX scenario from a shutter status](https://wiki.can-nx.com/en/guides/link-somfy-triggers/)

### Protocols, imports and monitoring

- [Somfy and KNX: map commands and statuses to group addresses](https://wiki.can-nx.com/en/guides/link-somfy-knx/)