# XBee

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

XBee ist ein auf dem ZigBee Funkstandard basierendes Modul. Es ermöglicht als Funkbrücke für eigentlich festverdrahtete Systeme zu dienen.

### Installation
Zur Verbindung mit IP-Symcon wird ein XBee-Coordinator(Gateway) benötigt, der via Seriell oder Seriell-USB angeschlossen ist.

### Einbindung in IP-Symcon
Das XBee-Gateway(Coordinator) wird via Serial Port an IP-Symcon eingebunden.
Zu jedem End-Gerät muss eine XBee Splitter Instanz erstellt werden. Diese beinhaltet lediglich die Geräte ID zur Kommunikation innerhalb von XBee.
Für die End-Geräte-Gateways dienen die XBee-Splitter Instanzen als Ersatz übergeordnete Instanz. (Siehe ["Beispiel Objektbaum"](xbee.md) )

### Beispiel

#### Datenfluss
Zum besseren Verständnis kann man hier die abstrakte Darstellung des Datenflusses sehen.

![Datenfluss von XBee](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/xbee/5a1764f5ea-1790424938/xbee-datenfluss.png)

#### Beispiel Objektbaum
In diesem Beispiel sind an einem Coordinator ein Z-Wave Gateway und eine Register Variable angeschlossen.
XBee kümmert sich mithilfe der GeräteID darum, dass sowohl die Daten von der Register Variable im dazugehörigen Skript als [Systemvariablen](../concepts/automations.md) zur Verfügung gestellt werden, als auch die Z-Wave Geräte Daten via Z-Wave Gateway (übergeordnete Instanz: XBee Splitter Z-Wave)aktualisiert werden.

![Beispiel Objektbaum](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/xbee/305b637fb5-1790424938/xbee-objektbaumbeispiel.png)

Daraus ergibt sich in diesem Beispiel folgende Topologie:

```php
Serial Port -> XBee Gateway -> XBee Splitter Z-Wave -> Z-Wave Gateway -> Z-Wave Dimmer
|
-> XBee Splitter RegVar -> Register Variable -> RegVarSkript (Systemvariable)
```

## XBee_SendBuffer

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/xbee/xbee-sendbuffer/

`bool XBee_SendBuffer(int $InstanzID, int $ZielGerät, string $Buffer)`

sendet einen Datenstring an ein bestimmtes Gerät

**Parameter**

- `$InstanzID` (int): ID des abzufragenden Geräts
- `$ZielGerät` (int): ID des ZielGeräts
- `$Buffer` (string): Datenbuffer der versendet werden soll

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

Datenbuffer der versendet werden soll

**Beispiel**

```php
XBee_SendBuffer(12345, 2, "Beliebiger DatenString");
```

## XBee_SendCommand

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

`bool XBee_SendCommand(int $InstanzID, string $Befehl)`

sendet einen Befehl an einen bestimmten XBee-Splitter

**Parameter**

- `$InstanzID` (int): ID des zu verändernden Geräts
- `$Befehl` (string): Befehl der gesendet werden soll

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

Befehl der gesendet werden soll

**Beispiel**

```php
XBee_SendCommand(12345, "Beliebiger CommandString");
```