# UDP Socket

> 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/io/udpsocket/

_Benötigt Symcon >= 3.3_

Der UDP Socket öffnet eine Schnittstelle, welche oftmals für die Kommunikation zwischen Gateway/Splitter Instanz und dem angeschlossenen Gerät genutzt wird. Es verwendet das UDP Protokoll.

### Einbindung in IP-Symcon

Über "+" im Objektbaum kann eine neue UDP Socket Instanz erstellt werden.
Auf der Konfigurationsseite können folgende Einstellungen vorgenommen werden.

| Option                  | Beschreibung                                                                                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Socket öffnen           | Ob der Socket geöffnet oder geschlossen sein soll.                                                                                                                 |
| Sende-Host              | Auf welche IP-Adresse die Daten gesendet werden sollen.                                                                                                            |
| Sende-Port              | Auf welchen Port die Daten gesendet werden sollen.                                                                                                                 |
| Empf.-Host              | Auf welchem TCP-Interface auf die Daten gelauscht werden soll.                                                                                                     |
| Empf.-Port              | Auf welchem Port auf die Daten gelauscht werden soll.                                                                                                              |
| Aktiviere Broadcast     | Bei Aktivierung schickt der UDP Socket an die Broadcast-Adresse des ausgewählten Empf.-Host Interfaces. Die eingetragene Sende-Host Adresse ist dabei unerheblich. |
| Aktiviere Reuse Address | Erlaubt es anderen Programmen bei ebenfalls aktivierten "Reuse address" auf dem Empf.-Port zu lauschen.                                                            |
Erst ein Klick auf "Übernehmen" speichert die Einstellungen und anschließend wird versucht die Verbindung aufzubauen.

![Konfigurationsseite](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/io/udpsocket/e2dc6ba8b9-1790424939/io-udpsocket.png)

## USCK_SendPacket

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/io/udpsocket/usck-sendpacket/

`bool USCK_SendPacket(int $InstanzID, string $Text, string $ClientIP, int $ClientPort)`

_Benötigt Symcon >= 5.0_

sendet einen String auf den I/O

**Parameter**

- `$InstanzID` (int): ID des zu aktualisierenden UDP Sockets
- `$Text` (string): der zusendene String
- `$ClientIP` (string): IP des Empfängers
- `$ClientPort` (int): Port des Empfängers

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

Port des Empfängers

**Beispiel**

```php
//Sendet das Packet mit dem Datensatz "Beliebiger Datensatz" auf dem Server Socket mit der ID 12345 an die IP:Port 192.168.1.123:1234
USCK_SendPacket(12345, "Beliebiger Datensatz", "192.168.1.123", 1234);
```

## USCK_SendText

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/io/udpsocket/usck-sendtext/

`bool USCK_SendText(int $InstanzID, string $Text)`

_Benötigt Symcon >= 3.3_

sendet einen String auf den I/O

**Parameter**

- `$InstanzID` (int): ID des zu aktualisierenden UDP Sockets
- `$Text` (string): der zusendene String

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

der zusendene String

**Beispiel**

```php
USCK_SendText(12345, "Beliebiger Datensatz"); //Sendet einen den Text "Beliebiger Datensatz" auf dem UDP Socket mit der ID 12345
```