# Shutter Control

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/shutter-control/

_Requires Symcon >= 5.0_

The "Shutter Control" offers the possibility to move a roller shutter/awning to a specific percentage position.
Furthermore, the position is updated when the shutter is controlled via function or manually.
In contrast to Shutter Control (legacy), the position can also be adjusted while in motion.

### Requirements

The IP-Symcon Shutter module needs a variable or an instance with a status variable that uses the ~ShutterMoveStop or ~ShutterMoveStep profile.
The travel times and start-up delay must also be entered in the module. The easiest way to do this is with a stopwatch.

> **Note:** By default, dS Shutter, EnOcean Shutter, KNX Shutter, LCN Shutter, xComfort Shutter and Z-Wave Shutter support these profiles. This means that when they are created, a variable with the required profile is available.

### Settings

| Option             | Position | Description                                                       |
| ------------------ | -------- | ----------------------------------------------------------------- |
| Type               | -------- | Shutter or awning                                                 |
| Delay              | -------- | Starting delay of the engine after switching                      |
| Target             | -------- | Actuator variable that is to be controlled                        |
| Move down (middle) | 50%      | Measured time from open to center.                                |
| Move down (bottom) | 99%      | (Shutter only) Measured time from open to down. (bars still open) |
| Move down (Closed) | 100%     | Measured time from open to end position reached. Slats closed.    |
| Move up (Bottom)   | 99%      | (Shutter only) Measured time from closed to bars open.            |
| Move up (middle)   | 50%      | Measured time from closed to mid reached.                         |
| Move Up (Open)     | 0%       | Measured time from closed to end position reached. Fully open.    |

### Add an individual device

If the device does not belong to one of the supported variants, an integer variable can be created by oneself.
This must have the ~ShutterMoveStop or ~ShutterMoveStep profile assigned.
Furthermore, the following action script must be stored.

```php
// Template for action script
switch($_IPS['VALUE']) {

    case 0:
        // Here is the open function
        break;

    case 1: // Only with ~ShutterMoveStep
        // Here is the step-open function
        break;

    case 2:
        // Here is the stop function
        break;

    case 3: // Only with ~ShutterMoveStep
        // Here is the step-close function
        break;

    case 4:
        // Here is the close function
        break;
}

SetValue($_IPS['VARIABLE'], $_IPS['VALUE']);
```

## SC_Move

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/shutter-control/sc-move/

`bool SC_Move(int $InstanceID, int $Position)`

moves the shutter to a specific position

**Parameters**

- `$InstanceID` (int): ID of Shutter Control Instance
- `$Position` (int): 0%-100%, 99% = Auf Spalt fahren

**Returns** (bool): If the command succeeds, it returns __TRUE__, otherwise __FALSE__.

0%-100%, 99% = Auf Spalt fahren

**Example**

```php
SC_Move(12345, 50); //Go to 50%
```

## SC_MoveDown

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/shutter-control/sc-movedown/

`bool SC_MoveDown(int $InstanceID, int $Duration)`

moves the shutter down to the end position

**Parameters**

- `$InstanceID` (int): ID of Shutter Control Instance
- `$Duration` (int): 0 = End position, >1 = Duration in ms

**Returns** (bool): If the command succeeds, it returns __TRUE__, otherwise __FALSE__.

0 = End position, >1 = Duration in ms

**Example**

```php
SC_MoveDown(12345, 0); //Go downwards
```

## SC_MoveUp

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/shutter-control/sc-moveup/

`bool SC_MoveUp(int $InstanceID, int $Duration)`

moves the shutter up to the end position

**Parameters**

- `$InstanceID` (int): ID of Shutter Control Instance
- `$Duration` (int): 0 = End position, >1 = Duration in ms

**Returns** (bool): If the command succeeds, it returns __TRUE__, otherwise __FALSE__.

0 = End position, >1 = Duration in ms

**Example**

```php
SC_MoveUp(12345, 0); //Go upwards
```

## SC_Stop

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/shutter-control/sc-stop/

`bool SC_Stop(int $InstanceID)`

stops a movement

**Parameters**

- `$InstanceID` (int): ID of Shutter Control Instance

**Returns** (bool): If the command succeeds, it returns __TRUE__, otherwise __FALSE__.

ID of Shutter Control Instance

**Example**

```php
SC_Stop(12345); //Stop
```