# digitalSTROM > Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26 > Index: https://www.symcon.de/de/llms.txt Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ DigitalSTROM ist ein System, welches die Stromnetz-Verdrahtung nutzt. Eine Verbindung mit IP-Symcon wird via LAN(IP) mit dem digitalSTROM Server hergestellt. Desweiteren wird in dem zu bedienenden Gerät eine digitalSTROM-Klemme eingebaut, bzw. die herkömmliche Lüsterklemme ersetzt. Alle elektrischen Geräte, die via digitalSTROM-Klemme mit dem digitalSTROM-Server kompatibel sind, sind auch mit IP-Symcon kompatibel und können eingebunden werden. ### Video-Tutorial zur Einrichtung [Video](https://www.youtube.com/embed/mnR2ab6IMlQ?rel=0&cc_load_policy=1) ### Anschluss Bevor der digitalSTROM-Server mit dem PC verbunden wird, sollten alle zu steuernde elektrische Geräte, die mit dem PC bedient werden sollen, korrekt via digitalSTROM-Klemme mit diesem verbunden sein. Anschließend muss der digitalSTROM-Server durch ein Netzwerkkabel mit dem Netzwerk verbunden werden. ### Installation Wenn der digitalSTROM-Server korrekt angeschlossen ist und ein DHCP-Server verwendet wird, ist der digitalSTROM-Server nun mit dem lokalen Netzwerk verbunden. (Der DHCP-Server übernimmt automatisch die Adressvergabe für die Netzwerkteilnehmer.) Der digitalSTROM-Server erscheint in der Netzwerkumgebung unter „Andere Geräte“ als „dSS“. Durch "Doppelklicken" auf „dSS“ erscheint ein Fenster in dessen unteren Bereich die IP-Adresse des digitalSTROM-Servers befindet. Nachdem diese kopiert und in einen beliebigen Browser kopiert wurde, öffnet sich die digitalSTROM Konfigurations-Webpage. Es erscheint möglicherweise eine Sicherheitswarnung, welche mit "Ich kenne das Risiko" bestätigt werden muss. Beim ersten Login gilt: __"Name" = "dssadmin" und "Passwort" = "dssadmin"__. Das Passwort sollte nach dem ersten Login geändert werden. Groß- und Kleinschreibung ist zu beachten. Auf der Konfigurations-Webpage können einige Voreinstellungen vorgenommen werden. Es ist auch möglich, die IP-Adresse manuell zu vergeben. ### Einbindung in IP-Symcon Innerhalb der [Verwaltungskonsole](../components/management-console.md) kann über "Willkommenseite -> Konfiguratoren verwalten" ein "dS Konfigurator" erstellt werden. Über das Zahnrad im unteren Fensterbereich kann der "dS Splitter" konfiguriert werden. ![digitalSTROM 1](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/digitalstrom/7698e01fb1-1790424938/ds1.png) Es öffnet sich die Konfiguration des „dS Splitters“. Bei "IP-Adresse" muss die IP-Adresse des digitalSTROM-Servers eingetragen werden. Mit "Übernehmen" wird die Einstellung gespeichert. Nach einem Klick auf “Request Token” muss Name (Username) und Passwort (Password) der Konfigurations-Webpage eingetragen werden. Bei korrekter Eingabe erscheinen neben Token nun viele Zahlen und kleine Buchstaben. Die "dS Splitter" Konfiguration kann nun geschlossen werden. Im digitalSTROM Konfigurator kann jetzt die Suche via “Suchen” gestartet werden. Anschließend erscheinen alle an den digitalSTROM-Server per digitalSTROM-Klemmen angeschlossenen Geräte. ![digitalSTROM 2](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/digitalstrom/7ba412a7e8-1790424938/ds2.png) Bei der ID auf der linken Seite handelt es sich um die Identifikationsnummer, die auf der Rückseite der jeweiligen digitalSTROM-Klemme wiedergefunden werden kann. Im Falle einer großen Anzahl von installierten Geräten ist damit eine problemlose Zuordnung und Konfiguration gewährleistet. Bei der ID auf der rechten Seite handelt es sich um die von IP-Symcon zugeordnete InstanzID. Diese ist einmalig und unveränderbar. Jedes Gerät kann einzeln als Instanz erstellt werden. Dazu muss dieses ausgewählt werden und auf den Button "Erstellen" geklickt werden. Die erstellten Geräte sind nun bedienbar. Nach dem Ausgewählen eines digitalSTROM-Geräts und einem Klick auf “Konfigurieren”, kann die Funktion jedes einzelnen Gerätes getestet werden. ![digitalSTROM 3](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/digitalstrom/81da51aee2-1790424938/ds3.png) Die Konfigurationsseite kann auch über ein "Doppelklick" innerhalb des Objektbaums aufgerufen werden. (Diese Geräte sind im Objektbaum unter Splitter-Instanzen wiederzufinden.) ## DS_CallScene Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ds-callscene/ `bool DS_CallScene(int $InstanzID, int $Szene)` ruft eine Szene auf **Parameter** - `$InstanzID` (int): ID des zu schaltenden Geräts - `$Szene` (int): Szenen von 0 bis 127 **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. Szenen von 0 bis 127 **Beispiel** ```php DS_CallScene(12345, 42); ``` ## DS_DimSet Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ds-dimset/ `bool DS_DimSet(int $InstanzID, int $Intensität)` dimmt eine digitalSTROM Klemme auf einen bestimmten Wert **Parameter** - `$InstanzID` (int): ID des zu schaltenden Geräts - `$Intensität` (int): Wert von 0-255 **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. Wert von 0-255 **Beispiel** ```php DS_DimSet(12345, 128); //Auf 50% dimmen ``` ## DS_MakeRequest Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ds-makerequest/ `string DS_MakeRequest(int $InstanzID, string $Request, string $Data)` sendet einen digitalSTROM Befehl direkt an den dSS **Parameter** - `$InstanzID` (int): ID des zu schaltenden Geräts - `$Request` (string): Anfrage welche aufgerufen werden soll - `$Data` (string): Parameter für Anfrage **Rückgabewert** (string): JSON kodierter String Parameter für Anfrage **Beispiel** ```php // Anfrage nach Systemversion // Sendet den Request "system/version" an die Instanz mit der ID 12345 DS_MakeRequest(12345, "system/version", ""); // Ruft Szene 0 auf // Sendet den Request "apartment/callScene" mit den Daten "sceneNumber=0" an die Instanz mit der ID 12345 DS_MakeRequest(12345, "apartment/callScene", "sceneNumber=0"); ``` ## DS_RequestStatus Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ds-requeststatus/ `bool DS_RequestStatus(int $InstanzID)` _Benötigt Symcon >= 4.0_ ruft den Status ab **Parameter** - `$InstanzID` (int): ID des Geräts **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. ID des Geräts **Beispiel** ```php DS_RequestStatus(12345); ``` ## DS_ShutterMove Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ds-shuttermove/ `bool DS_ShutterMove(int $InstanzID, int $Position)` bewegt den Rollladen bis zu einer gewünschten Position/Stop **Parameter** - `$InstanzID` (int): ID des zu schaltenden Geräts - `$Position` (int): Position von 0-255 **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. Position von 0-255 **Beispiel** ```php DS_ShutterMove(12345, 128); //Auf 50% fahren ``` ## DS_ShutterMoveDown Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ds-shuttermovedown/ `bool DS_ShutterMoveDown(int $InstanzID)` bewegt den Rollladen nach unten bis zur Endposition/Stop **Parameter** - `$InstanzID` (int): ID des zu schaltenden Geräts **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. ID des zu schaltenden Geräts **Beispiel** ```php DS_ShutterMoveDown(12345); //Nach unten bewegen ``` ## DS_ShutterMoveUp Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ds-shuttermoveup/ `bool DS_ShutterMoveUp(int $InstanzID)` bewegt den Rollladen nach oben bis zur Endposition/Stop **Parameter** - `$InstanzID` (int): ID des zu schaltenden Geräts **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. ID des zu schaltenden Geräts **Beispiel** ```php DS_ShutterMoveUp(12345); //Nach oben bewegen ``` ## DS_ShutterStop Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ds-shutterstop/ `bool DS_ShutterStop(int $InstanzID)` stoppt einen Bewegungsvorgang **Parameter** - `$InstanzID` (int): ID des zu schaltenden Geräts **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. ID des zu schaltenden Geräts **Beispiel** ```php DS_ShutterStop(12345); //Anhalten ``` ## DS_SwitchMode Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/ds-switchmode/ `bool DS_SwitchMode(int $InstanzID, bool $Status)` schaltet eine digitalSTROM Klemme an/aus **Parameter** - `$InstanzID` (int): ID des zu schaltenden Geräts - `$Status` (bool): __TRUE__ für An, __FALSE__ für Aus **Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__. __TRUE__ für An, __FALSE__ für Aus **Beispiel** ```php DS_SwitchMode(12345, true); //Gerät einschalten ``` ## Geräteliste Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/digitalstrom/geraeteliste/ ### Unterstützte Gateways | Gateway | Beschreibung | | ------- | ------------------- | | dSS11 | digitalSTROM Server | | dSS20 | digitalSTROM Server | ### Unterstützte Komponenten #### Licht (Gelb) | Herstellerbezeichnung | Anschlussart | Beschreibung | | --------------------- | --------------- | ----------------------------------- | | GE-KL200 | Relaisklemme | Schalten 1400 W | | GE-KM200 | Lüsterklemme | Schalten/Dimmen 150 W | | GE-KM220 | Lüsterklemme | Sparen 150 W | | GE-SDM200 | Schnurdimmer | Dimmen 150 W | | GE-SDS200 | Schnurdimmer | Dimmen 150 W | | GE-SDS210 | Schnurdimmer | Sparen 150 W | | GE-TKM210 | Tasterklemme | mit Ausgang Bedienen + Dimmen 150 W | | GE-TKM220 | Tasterklemme | Bedienen 1-fach | | GE-TKM230 | Tasterklemme | Bedienen 2-fach | | GE-TUP200 | Taster | Bedienen 1-fach | | GE-TUP210 | Taster | Bedienen 2-fach | | GE-TUP220 | Taster+ | Bedienen 1-fach Plus | | GE-UMV200 | Schraubklemmen | 1-10V Universal Modul | | GE-ZWS210 | Zwischenstecker | Schalten 2300 W | | GE-ZWS200 | Zwischenstecker | Schalten 2300 W | #### Schatten (Grau) | Herstellerbezeichnung | Anschlussart | Beschreibung | | --------------------- | ------------ | -------------------- | | GR-HKL230 | Relaisklemme | Jalousie Schaltaktor | | GR-KL200 | Relaisklemme | Rollladen 700 VA | | GR-KL210 | Relaisklemme | Markise 700 VA | | GR-KL220 | Relaisklemme | Jalousie 700 VA | | GR-TKM200 | Tasterklemme | Bedienen 1-fach | | GR-TKM210 | Tasterklemme | Bedienen 2-fach | | GR-TUP200 | Taster | Bedienen 1-fach | | GR-TUP210 | Taster | Bedienen 2-fach | | GR-TUP220 | Taster | Bedienen 1-fach Plus | #### Heizung/Klima (Blau) | Herstellerbezeichnung | Anschlussart | Beschreibung | | --------------------- | ------------------ | ----------------------- | | BL-KL200 | Relaisklemme | Schalten 700 W | | BL-KM200 | Lüsterklemme | Schalten 150 W | | BL-SDS2001 | Sensor mit Ausgang | Schalten 150 W + Sensor | | BL-TUP2001 | Sensor | Klima-Sensor | #### Joker (schwarz) | Herstellerbezeichnung | Anschlussart | Beschreibung | | --------------------- | --------------- | ----------------------------------------- | | dS-iSens200 | Lüsterklemme | Raumfühler für Temperatur und Luftfeuchte | | dS-Alarm400 | Tasterklemme | 4 Sensoren anschließbar | | SW-AKM200 | Tasterklemme | 4 Sensoren anschließbar | | SW-AKM210 | Tasterklemme | 2 Sensoren anschließbar | | SW-SSL200 | Schnurdimmer | 1-fach Schalter | | SW-TKM200 | Tasterklemme | Bedienen 4-fach universell | | SW-TKM210 | Tasterklemme | Bedienen 2-fach universell | | SW-TUP200 | Taster | Bedienen 1-fach universell | | SW-UMR200 | Schraubklemmen | Relais Universal Modul | | SW-ZWS200 | Zwischenstecker | Schalten 2300 W | | SW-ZWS210 | Zwischenstecker | Schalten 2300 W | #### Zugang (Grün) Keine gesonderte Steuerung nötig. #### Sicherheit (rot) Keine gesonderte Steuerung nötig. #### Audio (Hellblau) Keine gesonderte Steuerung nötig.