# digitalSTROM

> 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/digitalstrom/

DigitalSTROM is a system that uses power grid wiring. A connection with IP-Symcon is established via LAN(IP) with the digitalSTROM server.
Furthermore, a digitalSTROM terminal block is installed in the device to be operated, or the conventional luster terminal is replaced.
All electrical devices that are compatible with the digitalSTROM server via digitalSTROM terminal block are also compatible with IP-Symcon and can be integrated.

### Setup video-tutorial

[Video](https://www.youtube.com/embed/mnR2ab6IMlQ?rel=0&cc_load_policy=1)

### Connection

Before the digitalSTROM Server is connected to the PC, all electrical devices to be controlled, which are to be operated with the PC, should be correctly connected to the PC via digitalSTROM terminal block. Then the digitalSTROM Server must be connected to the network with a network cable.

### Installation

If the digitalSTROM Server is correctly connected and a DHCP server is used, the digitalSTROM Server is now connected to the local network.
(The DHCP server automatically assigns addresses for the network participants.)

The digitalSTROM Server appears in the network environment under “Other devices” as “dSS”.
By "double-clicking" on "dSS", a window appears in the lower area of which the IP address of the digitalSTROM Server is located. After it has been copied and pasted into any browser, the digitalSTROM configuration webpage opens. A security warning may appear, which must be confirmed with "I know the risk".
The following applies to the first login: __"Name" = "dssadmin" and "Password" = "dssadmin"__.
The password should be changed after the first login. Note that it is case-sensitive.

Some pre-settings can be made on the configuration webpage.
It is also possible to assign the IP address manually.

### Integration in IP-Symcon

A "dS configurator" can be created within the [Management Console](../components/management-console.md) via "Welcome page -> Manage configurators". The "dS Splitter" can be configured using the gear wheel in the lower window area.

![digitalSTROM 1](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/digitalstrom/7698e01fb1-1790424938/ds1.png)

The configuration of the "dS Splitter" opens. The IP address of the digitalSTROM server must be entered for "IP address". The setting is saved with "Apply". After clicking on “Request Token”, the name (username) and password (password) of the configuration webpage must be entered. If the entry is correct, a lot of numbers and small letters will appear next to tokens. The "dS Splitter" configuration can now be closed. The search can now be started in the digitalSTROM Configurator via “Search”. Then all devices connected to the digitalSTROM server via digitalSTROM terminals appear.

![digitalSTROM 2](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/digitalstrom/7ba412a7e8-1790424938/ds2.png)

The ID on the left is the identification number that can be found on the back of the respective digitalSTROM terminal block. In the case of a large number of installed devices, this ensures problem-free assignment and configuration. The ID on the right is the InstanceID assigned by IP-Symcon. This is unique and unchangeable.

Each device can be created individually as an instance. To do this, it must be selected and the "Create" button clicked. The created devices can now be operated.

After selecting a digitalSTROM device and clicking on “Configure”, the function of each individual device can be tested.

![digitalSTROM 3](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/digitalstrom/81da51aee2-1790424938/ds3.png)

The configuration page can also be called up via a "double click" within the object tree. (These devices can be found in the object tree under splitter instances.)

## DS_CallScene

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/ds-callscene/

`bool DS_CallScene(int $InstanceID, int $Scene)`

calls up a scene

**Parameters**

- `$InstanceID` (int): ID of the device to be switched
- `$Scene` (int): Scenes from 0 to 127

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

Scenes from 0 to 127

**Example**

```php
DS_CallScene(12345, 42);
```

## DS_DimSet

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/ds-dimset/

`bool DS_DimSet(int $InstanceID, int $Intensity)`

dims a digitalSTROM terminal to a specific value

**Parameters**

- `$InstanceID` (int): ID of the device to be switched
- `$Intensity` (int): Value of 0-255

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

Value of 0-255

**Example**

```php
DS_DimSet(12345, 128); //Dim to 50%
```

## DS_MakeRequest

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/ds-makerequest/

`string DS_MakeRequest(int $InstanceID, string $Request, string $Data)`

sends a digitalSTROM command directly to the dSS

**Parameters**

- `$InstanceID` (int): ID of the device to be switched
- `$Request` (string): Request which should be called
- `$Data` (string): Parameters for request

**Returns** (string): JSON encoded string

Parameters for request

**Example**

```php
// Request for system version
// Sends the "system/version" request to the instance with ID 12345
DS_MakeRequest(12345, "system/version", "");

// Recalls scene 0
// Sends the request "apartment/callScene" with the data "sceneNumber = 0" to the instance with the ID 12345
DS_MakeRequest(12345, "apartment/callScene", "sceneNumber=0");
```

## DS_RequestStatus

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/ds-requeststatus/

`bool DS_RequestStatus(int $InstanceID)`

_Requires Symcon >= 4.0_

retrieves the status

**Parameters**

- `$InstanceID` (int): Device ID

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

Device ID

**Example**

```php
DS_RequestStatus(12345);
```

## DS_ShutterMove

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/ds-shuttermove/

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

moves the roller shutter to a desired position/stop

**Parameters**

- `$InstanceID` (int): ID of the device to be switched
- `$Position` (int): Position from 0-255

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

Position from 0-255

**Example**

```php
DS_ShutterMove(12345, 128); //Set to 50%
```

## DS_ShutterMoveDown

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/ds-shuttermovedown/

`bool DS_ShutterMoveDown(int $InstanceID)`

moves the roller shutter down to the end position/stop

**Parameters**

- `$InstanceID` (int): ID of the device to be switched

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

ID of the device to be switched

**Example**

```php
DS_ShutterMoveDown(12345); //Move down
```

## DS_ShutterMoveUp

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/ds-shuttermoveup/

`bool DS_ShutterMoveUp(int $InstanceID)`

moves the roller shutter up to the end position/stop

**Parameters**

- `$InstanceID` (int): ID of the device to be switched

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

ID of the device to be switched

**Example**

```php
DS_ShutterMoveUp(12345); //Move up
```

## DS_ShutterStop

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/ds-shutterstop/

`bool DS_ShutterStop(int $InstanceID)`

stops a motion

**Parameters**

- `$InstanceID` (int): ID of the device to be switched

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

ID of the device to be switched

**Example**

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

## DS_SwitchMode

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/ds-switchmode/

`bool DS_SwitchMode(int $InstanceID, bool $Status)`

switches a digitalSTROM terminal on/off

**Parameters**

- `$InstanceID` (int): ID of the device to be switched
- `$Status` (bool): __TRUE__ for on, __FALSE__ for off

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

__TRUE__ for on, __FALSE__ for off

**Example**

```php
DS_SwitchMode(12345, true); //Turn device on
```

## Device list

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/digitalstrom/device-list/

### Supported Gateways

| Gateway | Description         |
| ------- | ------------------- |
| dSS11   | digitalSTROM Server |
| dSS20   | digitalSTROM Server |

### Supported Components

#### Light (yellow)

| Manufacturer designation | Connection type      | Description                         |
| ------------------------ | -------------------- | ----------------------------------- |
| GE-KL200                 | Relay terminal       | Switching 1400 W                    |
| GE-KM200                 | Luster terminal      | Switching/dimming 150 W             |
| GE-KM220                 | Luster terminal      | Save 150 W                          |
| GE-SDM200                | Cord dimmer          | Dimming 150 W                       |
| GE-SDS200                | Cord dimmer          | Dimming 150 W                       |
| GE-SDS210                | Cord dimmer          | Save 150 W                          |
| GE-TKM210                | Push button terminal | with output control + dimming 150 W |
| GE-TKM220                | Push button terminal | Operate 1-way                       |
| GE-TKM230                | Push button terminal | Operate 2-way                       |
| GE-TUP200                | Button               | Operate 1-way                       |
| GE-TUP210                | Button               | Operate 2-way                       |
| GE-TUP220                | Button+              | Operate 1-way plus                  |
| GE-UMV200                | Screw terminals      | 1-10V universal module              |
| GE-ZWS210                | Adapter plug         | Switching 2300 W                    |
| GE-ZWS200                | Adapter plug         | Switching 2300 W                    |

#### Shadow (gray)

| Manufacturer designation | Connection type      | Description           |
| ------------------------ | -------------------- | --------------------- |
| GR-HKL230                | Relay terminal       | Blind switch actuator |
| GR-KL200                 | Relay terminal       | 700 VA roller shutter |
| GR-KL210                 | Relay terminal       | Awning 700 VA         |
| GR-KL220                 | Relay terminal       | Blind 700 VA          |
| GR-TKM200                | Push button terminal | Operate 1-way         |
| GR-TKM210                | Push button terminal | Operate 2-way         |
| GR-TUP200                | Button               | Operate 1-way         |
| GR-TUP210                | Button               | Operate 2-way         |
| GR-TUP220                | Button               | Operate 1-way plus    |

#### Heating/air conditioning (blue)

| Manufacturer designation | Connection type    | Description           |
| ------------------------ | ------------------ | --------------------- |
| BL-KL200                 | Relay terminal     | Switching 700 W       |
| BL-KM200                 | Luster terminal    | Switch 150 W          |
| BL-SDS2001               | Sensor with output | Switch 150 W + sensor |
| BL-TUP2001               | Sensor             | Climate sensor        |

#### Joker (black)

| Manufacturer designation | Connection type      | Description                              |
| ------------------------ | -------------------- | ---------------------------------------- |
| dS-iSens200              | Luster terminal      | Room sensor for temperature and humidity |
| dS-Alarm400              | Push button terminal | 4 sensors can be connected               |
| SW-AKM200                | Push button terminal | 4 sensors can be connected               |
| SW-AKM210                | Push button terminal | 2 sensors can be connected               |
| SW-SSL200                | Cord dimmer          | 1-way switch                             |
| SW-TKM200                | Push button terminal | 4-way universal operation                |
| SW-TKM210                | Push button terminal | 2-way universal operation                |
| SW-TUP200                | Button               | 1-way universal operation                |
| SW-UMR200                | Screw terminals      | Relay universal module                   |
| SW-ZWS200                | Adapter plug         | Switching 2300 W.                        |
| SW-ZWS210                | Adapter plug         | Switching 2300 W.                        |

#### Access (green)
No separate control required.

#### Security (red)
No separate control required.

#### Audio (light blue)
No separate control required.