# LCN

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

LCN (Local Control Network) ist ein kabelgebundenes Bussystem.

> **Hinweis:** Folgende Geräte werden von IP-Symcon unterstützt:
>
> [Unterstützte Geräte](lcn.md)

> **Hinweis:** Die neuen Module mit 12 Variablen (ab Firmware 160B13) werden ab IP-Symcon 3.0 unterstützt.

### Installation

Um einen LCN-Bus an IP-Symcon anschließen zu können, wird ein Bus-Koppler ([LCN-PKU](https://www.lcn.eu/?wpdmdl=8100) ) mit Koppelprogramm [PCHK](https://www.lcn.eu/?wpdmdl=8106)  oder ein Ethernet-Koppler ([LCN-VISU](https://www.lcn.eu/?wpdmdl=8100) ) benötigt.

### Video-Tutorial zur Einrichtung
[Video](https://www.youtube.com/embed/tZMETUfw-_M?rel=0&cc_load_policy=1)

### Einbindung in IP-Symcon

Über die Verwaltungskonsole kann ein Konfigurator für das LCN System erstellt werden.
Nachdem ein Konfigurator erstellt wurde, kann unter Umständen eine rote Meldung erscheinen. Diese weist auf eine fehlerhafte oder unvollständige Konfiguration hin. Um den Fehler zu beheben muss in der übergeordneten Instanz der Benutzername und das Passwort angegeben werden. Mit einem Klick auf "Übernehmen" wird die Änderung gespeichert.

![LCN: Eingeloggt](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/lcn/0b04a5e3b3-1790424938/lcn-eingeloggt.png)

Falls nach dem Übernehmen kein Einloggen möglich ist, muss die Netzwerkkonfiguration innerhalb Schnittstelle überprüft werden. Auch kann im Gateway der Ausgabemodus zwischen 50 und 200 Schritten ausgewählt werden.

Nach dem erfolgreichen Einloggen, kann im Konfigurator auf dem Bus nach Modulen gesucht, diese in IP-Symcon erstellt und die einzelnen Module als IP-Symcon Splitter-Instanzen anlegt werden.

![LCN: Konfiguration](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/lcn/2d9e4bc6a2-1790424938/lcn-konfiguration.png)

### Module konfigurieren

Sobald im Konfigurator ein Modul erstellt und auf die Konfigurationstaste gedrückt wurde, öffnet sich ein neuer Dialog.

![LCN: Modul-Konfiguration](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/lcn/eabe442b11-1790424938/lcn-modul-konfiguration.png)

Um die einzelnen Instanzen zu erstellen, müssen die gewünschten Relais, Ein-/Ausgänge, etc ausgewählt und auf "Erstellen" geklickt werden.

Neue Geräte werden im Objektbaum in der Kategorie erstellt und einsortiert, welches namentlich zum Modul passt. Diese erstellten Instanzen können dann entsprechend umbenannt und an anderer Stelle einsortiert werden. Auch besteht die Möglichkeit via "Konfigurieren" die jeweilige Instanzkonfiguration aufzurufen.

![LCN: Instanz-Konfiguration](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/lcn/8bfa8c4a6d-1790424938/lcn-instanz.png)

## Geräteliste

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/geraeteliste/

### Unterstützte Gateways

| Gateway                 | Beschreibung                                               |
| ----------------------- | ---------------------------------------------------------- |
| LCN-PK (über LCN PCHK)  | Serieller Anschluss, Kommunikation über PCHK mit IP-Symcon |
| LCN-PKU (über LCN PCHK) | USB Anschluss, Kommunikation über PCHK mit IP-Symcon       |
| LCN-PKE                 | Ethernet Anschluss, Kommunikation direkt mit IP-Symcon     |
| LCN-VISU                | Ethernet Anschluss, Kommunikation direkt mit IP-Symcon     |
### Unterstützte Komponenten

IP-Symcon unterstützt alle Komponenten.

> **Hinweis:** Beim LCN-HL4 wird ausschließlich das RGB Farbmodell (Schalterstellung 2) unterstützt

## LCN_AddGroup

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-addgroup/

`bool LCN_AddGroup(int $InstanzID, int $Gruppe)`

fügt ein Gerät zu einer Gruppe hinzu

**Parameter**

- `$InstanzID` (int): ID der Instanz; die ID der Splitter-Instanz, nicht der Geräte-Instanz
- `$Gruppe` (int): Gruppennummer (1..255)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Gruppennummer (1..255)

**Beispiel**

```php
//Das Gerät mit der ID 12345 wird der Gruppe 123 hinzugefügt
LCN_AddGroup(12345, 123);
```

## LCN_AddIntensity

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-addintensity/

`bool LCN_AddIntensity(int $InstanzID, int $Intensität)`

erhöht die Leuchtintensität ein Gerät

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Intensität` (int): 0-100%

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

0-100%

**Beispiel**

```php
LCN_AddIntensity(12345, 50); //Gerät um 50 Prozentpunkte heller dimmen
```

## LCN_AddThresholdCurrent

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-addthresholdcurrent/

`bool LCN_AddThresholdCurrent(int $InstanzID, int $Register, int $Schwellwert, float $Wert)`

addiert Schwellwert zu aktuellen Wert

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Register` (int): Register des zu schaltenden Schwellwerts (1x5
- `$Schwellwert` (int): zu setzender Schwellwert (1x5
- `$Wert` (float): Wert des Schwellwerts (0..1000)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Wert des Schwellwerts (0..1000)

**Beispiel**

```php
// 1x5 Schwellwert
// Addiert den Wert 2,5 zu dem Schwellwert 2 der Instanz mit der ID 12345
LCN_AddThresholdCurrent(12345, 0, 2, 2.5);

// 4x4 Schwellwert
// Addiert den Wert 2,5 zu dem Schwellwert 2 im Register 3 der Instanz mit der ID 12345
LCN_AddThresholdCurrent(12345, 3, 2, 2.5);
```

## LCN_AddThresholdDefined

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-addthresholddefined/

`bool LCN_AddThresholdDefined(int $InstanzID, int $Register, int $Schwellwert, float $Wert)`

addiert Schwellwert zu vordefinierten Wert

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Register` (int): Register des zu schaltenden Schwellwerts (1x5
- `$Schwellwert` (int): zu setzender Schwellwert (1x5
- `$Wert` (float): Wert des Schwellwerts

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Wert des Schwellwerts

**Beispiel**

```php
// 1x5 Schwellwert
// Addiert den Wert 2,5 relativ zum programmierten Wert in den Schwellwert 2 der Instanz mit der ID 12345
LCN_AddThresholdDefined(12345, 0, 2, 2.5);

// 4x4 Schwellwert
// Addiert den Wert 2,5 relativ zum programmierten Wert in den Schwellwert 2 im Register 3 der Instanz mit der ID 12345
LCN_AddThresholdDefined(12345, 3, 2, 2.5);
```

## LCN_Beep

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-beep/

`bool LCN_Beep(int $InstanzID, bool $SonderTon, int $Anzahl)`

lässt ein Gerät piepen

**Parameter**

- `$InstanzID` (int): ID der Instanz; die ID der Splitter-Instanz, nicht der Geräte-Instanz
- `$SonderTon` (bool): __TRUE__ für An, __FALSE__ für Aus
- `$Anzahl` (int): Anzahl zwischen 1..15

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Anzahl zwischen 1..15

**Beispiel**

```php
LCN_Beep(12345, true, 1); //Ein Mal piepen (Sonderton)
```

## LCN_DeductIntensity

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-deductintensity/

`bool LCN_DeductIntensity(int $InstanzID, int $Intensität)`

veringert die Leuchtintensität ein Gerät

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Intensität` (int): 0-100%

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

0-100%

**Beispiel**

```php
LCN_DeductIntensity(12345, 10); //Gerät um 10 Prozentpunkte dunkler dimmen
```

## LCN_DeductThresholdCurrent

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-deductthresholdcurrent/

`bool LCN_DeductThresholdCurrent(int $InstanzID, int $Register, int $Schwellwert, float $Wert)`

subtrahiert Schwellwert zu aktuellen Wert

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Register` (int): Register des zu schaltenden Schwellwerts (1x5
- `$Schwellwert` (int): zu setzender Schwellwert (1x5
- `$Wert` (float): Wert des Schwellwerts (0..1000)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Wert des Schwellwerts (0..1000)

**Beispiel**

```php
// 1x5 Schwellwert
// Subtrahiert den Wert 2,5 zu dem Schwellwert 2 der Instanz mit der ID 12345
LCN_DeductThresholdCurrent(12345, 0, 2, 2.5);

// 4x4 Schwellwert
// Subtrahiert den Wert 2,5 zu dem Schwellwert 2 im Register 3 der Instanz mit der ID 12345
LCN_DeductThresholdCurrent(12345, 3, 2, 2.5);
```

## LCN_DeductThresholdDefined

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-deductthresholddefined/

`bool LCN_DeductThresholdDefined(int $InstanzID, int $Register, int $Schwellwert, float $Wert)`

subtrahiert Schwellwert zu vordefinierten Wert

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Register` (int): Register des zu schaltenden Schwellwerts (1x5
- `$Schwellwert` (int): zu setzender Schwellwert (1x5
- `$Wert` (float): Wert des Schwellwerts

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Wert des Schwellwerts

**Beispiel**

```php
// 1x5 Schwellwert
// Subtrahiert den Wert 2,5 relativ zum programmierten Wert in den Schwellwert 2 der Instanz mit der ID 12345
LCN_AddThresholdDefined(12345, 0, 2, 2.5);

// 4x4 Schwellwert
// Subtrahiert den Wert 2,5 relativ zum programmierten Wert in den Schwellwert 2 im Register 3 der Instanz mit der ID 12345
LCN_AddThresholdDefined(12345, 3, 2, 2.5);
```

## LCN_FadeOut

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-fadeout/

`bool LCN_FadeOut(int $InstanzID, int $Intensität, int $Rampe)`

setzt ein Gerät auf eine feste Intensität und dimmt dann auf 0%

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Intensität` (int): 0-100%
- `$Rampe` (int): 0-200 Sekunde

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

0-200 Sekunde

**Beispiel**

```php
LCN_FadeOut(12345, 100, 5); //Gerät von 100% in 5 sekunden runterdimmen auf 0%
```

## LCN_FlipRelay

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-fliprelay/

`bool LCN_FlipRelay(int $InstanzID)`

schaltet ein Relais um

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Relais

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des zu schaltenden Relais

**Beispiel**

```php
LCN_FlipRelay(12345); //Relais umschalten
```

## LCN_LimitOutput

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-limitoutput/

`bool LCN_LimitOutput(int $InstanzID, int $Wert, int $Zeit, string $ZeitTyp)`

begrenzt einen Ausgang für einen bestimmten Zeitraum

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Ausgangs
- `$Wert` (int): Prozentualer Wert auf den begrenzt werden soll (0..100)
- `$Zeit` (int): Zeitraum wielange der Ausgang begrenzt werden soll
- `$ZeitTyp` (string): Gibt an ob die Begrenzung für Sekunden, Minuten, Stunden oder Tage gelten soll

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Gibt an ob die Begrenzung für Sekunden, Minuten, Stunden oder Tage gelten soll

**Beispiel**

```php
//Begrenzt den Ausgang mit der ID 12345 für 8 Stunden auf 36%
LCN_LimitOutput(12345, 36, 8, 'H');
```

## LCN_LoadScene

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-loadscene/

`bool LCN_LoadScene(int $InstanzID, int $Szene)`

ruft eine Szene für einen Ausgang auf

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Ausgangs
- `$Szene` (int): Welche Szene geladen werden soll (0..9, 15)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Welche Szene geladen werden soll (0..9, 15)

**Beispiel**

```php
// Ruft die Szene 5 des Ausgangs mit der ID 12345 auf
LCN_LoadScene(12345, 5);
```

## LCN_LockTargetValue

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-locktargetvalue/

`bool LCN_LockTargetValue(int $InstanzID, int $Ziel)`

sperrt einen Regler des Geräts

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Ziel` (int): Welcher Regler gesperrt werden soll (0,1,2,3)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Welcher Regler gesperrt werden soll (0,1,2,3)

**Beispiel**

```php
//Sperrt den Regler 0 des Geräts 12345
LCN_LockTargetValue(12345, 0);
```

## LCN_RampStop

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-rampstop/

`bool LCN_RampStop(int $InstanzID)`

stoppt einen Dimmvorgang

**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
LCN_RampStop(12345);
```

## LCN_ReleaseTargetValue

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-releasetargetvalue/

`bool LCN_ReleaseTargetValue(int $InstanzID, int $Ziel)`

entsperrt einen Regler des Geräts

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Ziel` (int): Welcher Regler entsperrt werden soll (0,1,2,3)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Welcher Regler entsperrt werden soll (0,1,2,3)

**Beispiel**

```php
// Entsperrt den Regler 0 des Geräts 12345
LCN_ReleaseTargetValue(12345, 0);
```

## LCN_RemoveGroup

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-removegroup/

`bool LCN_RemoveGroup(int $InstanzID, int $Gruppe)`

entfernt ein Gerät aus einer Gruppe

**Parameter**

- `$InstanzID` (int): ID der Instanz; die ID der Splitter-Instanz, nicht der Geräte-Instanz
- `$Gruppe` (int): Gruppennummer (0..255)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Gruppennummer (0..255)

**Beispiel**

```php
//Das Gerät mit der ID 12345 wird aus der Gruppe 123 entfernt
LCN_RemoveGroup(12345, 123);
```

## LCN_RequestLights

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-requestlights/

`bool LCN_RequestLights(int $InstanzID)`

fragt die LEDs des Tableaus ab

**Parameter**

- `$InstanzID` (int): ID des abzufragenden Tableaus

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des abzufragenden Tableaus

**Beispiel**

```php
//Die LEDs des Tableau mit der ID 12345 werden abgefragt
LCN_RequestLights(12345);
```

## LCN_RequestRead

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-requestread/

`bool LCN_RequestRead(int $InstanzID)`

fragt die Werte ab

**Parameter**

- `$InstanzID` (int): ID des abzufragenden Geräts

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des abzufragenden Geräts

**Beispiel**

```php
//Das Gerät mit der ID 12345 abfragen
LCN_RequestRead(12345);
```

## LCN_RequestStatus

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-requeststatus/

`bool LCN_RequestStatus(int $InstanzID)`

fragt alle Status des Moduls ab

**Parameter**

- `$InstanzID` (int): ID des abzufragenden Moduls

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des abzufragenden Moduls

**Beispiel**

```php
// Abfragen aller Status des Moduls mit der ID 12345 ab
LCN_RequestStatus(12345);
```

## LCN_RequestThresholds

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-requestthresholds/

`bool LCN_RequestThresholds(int $InstanzID)`

fragt Schwellenwerte und Hysterese ab

**Parameter**

- `$InstanzID` (int): ID des abzufragenden Thresholds

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des abzufragenden Thresholds

**Beispiel**

```php
//Die Schwellenwerte und Hysterese des Thresholds 12345 abfragen
LCN_RequestThresholds(12345);
```

## LCN_SaveScene

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-savescene/

`bool LCN_SaveScene(int $InstanzID, int $Szene)`

speichert eine Szene für einen Ausgang

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Ausgangs
- `$Szene` (int): In welcher Szene gespeichert werden soll (0..9, 15)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

In welcher Szene gespeichert werden soll (0..9, 15)

**Beispiel**

```php
// Speichert die Szene 5 des Ausgangs mit der ID 12345
LCN_SaveScene(12345, 5);
```

## LCN_SelectSceneRegister

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-selectsceneregister/

`bool LCN_SelectSceneRegister(int $InstanzID, int $Register)`

wählt ein Register aus

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Register` (int): welches Register ausgewählt werden soll (0..9)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

welches Register ausgewählt werden soll (0..9)

**Beispiel**

```php
// Wählt das Register 2 des Geräts mit der ID 12345
LCN_SelectSceneRegister(12345, 2);
```

## LCN_SendCommand

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-sendcommand/

`bool LCN_SendCommand(int $InstanzID, string $Funktion, string $Daten)`

**Parameter**

- `$InstanzID` (int): ID der Instanz; die ID der Splitter-Instanz, nicht der Geräte-Instanz
- `$Funktion` (string): Die ersten beiden (2) Zeichen des PCHK Befehls (z.B. A1)
- `$Daten` (string): Die restlichen Zeichen des PCHK Befehls (z.B. DI000000). Eventuelle Zahlen müssen in der dezimalen Darstellung (3 Zeichen) gesendet werden.

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Die restlichen Zeichen des PCHK Befehls (z.B. DI000000). Eventuelle Zahlen müssen in der dezimalen Darstellung (3 Zeichen) gesendet werden.

**Beispiel**

```php
LCN_SendCommand(12345, "A1", "DI000000"); //Ausgang 1 sofort auf 0% dimmen.
```

## LCN_SetDisplayText

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-setdisplaytext/

`bool LCN_SetDisplayText(int $InstanzID, int $Zeile, string $Text)`

Zeigt einen Text auf einer Zeile des Displays an

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Zeile` (int): Displayzeile zwischen 1..4
- `$Text` (string): Text mit maximal 60 Zeichen

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Text mit maximal 60 Zeichen

**Beispiel**

```php
//Zeigt auf Zeile 1 des Displays, mit der InstanzID 12345, "Hallo Welt" an.
LCN_SetDisplayText(12345, 1, "Hallo Welt");
```

## LCN_SetDisplayTime

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-setdisplaytime/

`bool LCN_SetDisplayTime(int $InstanzID, int $Zeile, int $Anzeigedauer)`

setzt die Anzeigedauer einer Zeile im Display

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Zeile` (int): Displayzeile zwischen 1..4
- `$Anzeigedauer` (int): Zeiteinheiten zwischen 1..30

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Zeiteinheiten zwischen 1..30

**Beispiel**

```php
//Konfiguriert die Zeile 1 der Displayinstanz 12345 auf 30 Zeiteinheiten
LCN_SetDisplayTime(12345, 1, 30);
```

## LCN_SetIntensity

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-setintensity/

`bool LCN_SetIntensity(int $InstanzID, int $Intensität, int $Rampe)`

dimmt ein Gerät in einer bestimmten Zeit

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Intensität` (int): 0-100%
- `$Rampe` (int): 0 = Sofort; n = Sekunden

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

0 = Sofort; n = Sekunden

**Beispiel**

```php
LCN_SetIntensity(12345, 100, 0); //Gerät auf 100% sofort dimmen
```

## LCN_SetLamp

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-setlamp/

`bool LCN_SetLamp(int $InstanzID, int $Lampe, string $Aktion)`

schalten einer LED

**Parameter**

- `$InstanzID` (int): ID der Instanz; die ID der Splitter-Instanz, nicht der Geräte-Instanz
- `$Lampe` (int): Auswahl der zu schaltenden Tableau-Lämpchen (1..12)
- `$Aktion` (string): Welche Aktion ausgeführt werden soll.

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Welche Aktion ausgeführt werden soll.

**Beispiel**

```php
// Das Tableau-Lämpchen 2 des Moduls mit der ID 12345 blinken lassen.
LCN_SetLamp(12345, 2, 'B');
```

## LCN_SetRelay

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-setrelay/

`bool LCN_SetRelay(int $InstanzID, string $Wert)`

setzt alle Relais in einem Modul (8Bit)

**Parameter**

- `$InstanzID` (int): ID der Instanz; die ID der Splitter-Instanz, nicht der Geräte-Instanz
- `$Wert` (string): 8fache Zeichenkombination der folgenden Werte

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

8fache Zeichenkombination der folgenden Werte

**Beispiel**

```php
LCN_SetRelay(12345, "--1100UU");
```

## LCN_SetRGBW

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-setrgbw/

`bool LCN_SetRGBW(int $InstanzID, int $Rot, int $Grün, int $Blau, int $Weiß)`

setzt eine Instanz auf einen RGBW Farbwert

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Rot` (int): Intensität zwischen 1..100
- `$Grün` (int): Intensität zwischen 1..100
- `$Blau` (int): Intensität zwischen 1..100
- `$Weiß` (int): Intensität zwischen 1..100

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Intensität zwischen 1..100

**Beispiel**

```php
//Setz die Instanz 12345 auf Rot mit voller Intensität.
LCN_SetRGBW(12345, 100, 0, 0, 100);
```

## LCN_SetTargetValue

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-settargetvalue/

`bool LCN_SetTargetValue(int $InstanzID, int $Ziel, float $Wert)`

setzt einen Regler auf einen bestimmten Wert

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$Ziel` (int): 0 = Regler R1; 1 = Regler R2; 2 = Regler S1; 3 = Regler S2
- `$Wert` (float): Wert

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Wert

**Beispiel**

```php
LCN_SetTargetValue(12345, 2, 24.3); //Regler S1 auf 24.3°C setzen
```

## LCN_ShiftTargetValue

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-shifttargetvalue/

`bool LCN_ShiftTargetValue(int $InstanzID, int $Ziel, float $RelativerWert)`

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Ziel` (int): Welcher Regler geshiftet werden soll (0,1,2,3)
- `$RelativerWert` (float): Wert um den geshiftet werden soll

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Wert um den geshiftet werden soll

**Beispiel**

```php
// Shiftet den Sollwert des Reglers 1 um -1,7°C
LCN_ShiftTargetValue(12345, 1, -1.7);
```

## LCN_ShutterMove

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-shuttermove/

`bool LCN_ShutterMove(int $InstanzID, int $Position)`

startet eine Rollladenbewegung auf prozentuale Position

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Position` (int): Prozentuale Position des Rollladen (0-100%)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Prozentuale Position des Rollladen (0-100%)

**Beispiel**

```php
//Rollladenbewegung auf 80% (zu 20% geschlossen)
LCN_ShutterMove(12345, 80);
```

## LCN_ShutterMoveDown

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-shuttermovedown/

`bool LCN_ShutterMoveDown(int $InstanzID)`

startet eine Rollladenbewegung nach unten

**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
//Rollladenbewegung nach unten starten
LCN_ShutterMoveDown(12345);
```

## LCN_ShutterMoveUp

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-shuttermoveup/

`bool LCN_ShutterMoveUp(int $InstanzID)`

startet eine Rollladenbewegung nach oben

**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
//Rollladenbewegung nach oben starten
LCN_ShutterMoveUp(12345);
```

## LCN_ShutterStop

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-shutterstop/

`bool LCN_ShutterStop(int $InstanzID)`

stoppt eine Rollladenbewegung

**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
//Rollladen stoppen
LCN_ShutterStop(12345);
```

## LCN_StartFlicker

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-startflicker/

`bool LCN_StartFlicker(int $InstanzID, string $FlackerTiefe, string $Geschwindigkeit, int $AnzahlFlackerhübe)`

ein Gerät flackern lassen

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$FlackerTiefe` (string): G = Gering; M = Mittel; S = Start
- `$Geschwindigkeit` (string): L = Langsam (ca. 0,5x / Sek); M = Mittel (ca. 1x / Sek); S = Schnell (ca. 2x / Sek)
- `$AnzahlFlackerhübe` (int): Anzahl zwischen 1..15

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Anzahl zwischen 1..15

**Beispiel**

```php
LCN_StartFlicker(12345, "G", "L", 5);
```

## LCN_StopFlicker

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-stopflicker/

`bool LCN_StopFlicker(int $InstanzID)`

stoppt das Flackern eines Geräts

**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
LCN_StopFlicker(12345);
```

## LCN_SwitchDurationMin

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-switchdurationmin/

`bool LCN_SwitchDurationMin(int $InstanzID, int $Minuten, string $Abdimmzeit, bool $Erhaltend)`

nach wievielen Minuten abgedimmt werden soll

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Minuten` (int): Nach wievielen Minuten Abgedimmt werden soll
- `$Abdimmzeit` (string): Wie schnell abgedimmt werden soll
- `$Erhaltend` (bool): Das Gerät wird nach Ablauf der Zeit nur ausgeschaltet, wenn vorher noch nicht an war

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Das Gerät wird nach Ablauf der Zeit nur ausgeschaltet, wenn vorher noch nicht an war

**Beispiel**

```php
// Das Gerät 12345 langsam nach 10 Minuten dimmen
LCN_SwitchDurationMin(12345, 10, 'L', false);
```

## LCN_SwitchDurationSec

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-switchdurationsec/

`bool LCN_SwitchDurationSec(int $InstanzID, int $Sekunden, string $Abdimmzeit, bool $Erhaltend)`

nach wie vielen Sekunden abgedimmt werden soll

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Sekunden` (int): Nach wie vielen Sekunden Abgedimmt werden soll
- `$Abdimmzeit` (string): Wie schnell abgedimmt werden soll
- `$Erhaltend` (bool): Das Gerät wird nach Ablauf der Zeit nur ausgeschaltet, wenn vorher noch nicht an war

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Das Gerät wird nach Ablauf der Zeit nur ausgeschaltet, wenn vorher noch nicht an war

**Beispiel**

```php
// Das Gerät 12345 schnell nach 5 Sekunden dimmen
LCN_SwitchDurationSec(12345, 5, 'K', false);
```

## LCN_SwitchMemory

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-switchmemory/

`bool LCN_SwitchMemory(int $InstanzID, int $Rampe)`

setzt das Gerät auf einen gespeicherten Wert

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Rampe` (int): Anzahl Sekunden, 0 = Sofort

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Anzahl Sekunden, 0 = Sofort

**Beispiel**

```php
LCN_SwitchMemory(12345, 0); //Gerät sofort schalten
```

## LCN_SwitchMode

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-switchmode/

`bool LCN_SwitchMode(int $InstanzID, int $Rampe)`

schaltet ein Gerät an/aus

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Rampe` (int): Anzahl Sekunden, 0 = Sofort

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Anzahl Sekunden, 0 = Sofort

**Beispiel**

```php
LCN_SwitchMode(12345, 0); //Gerät sofort umschalten
```

## LCN_SwitchRelay

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-switchrelay/

`bool LCN_SwitchRelay(int $InstanzID, bool $Status)`

schaltet ein Relais 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
LCN_SwitchRelay(12345, true); //Relais einschalten
```

## LCN_SwitchRelayTimer

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/lcn/lcn-switchrelaytimer/

`bool LCN_SwitchRelayTimer(int $InstanzID, int $Zeitfaktor)`

schaltet ein Relais auf einen Zeitfaktor

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Zeitfaktor` (int): Zeitfaktor zwischen 1..255

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Zeitfaktor zwischen 1..255

**Beispiel**

```php
//Relais Zeitfaktor auf 255 stellen.
LCN_SwitchRelayTimer(12345, 255);
```