# XBee

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

XBee is a module based on the ZigBee radio standard. It allows to serve as a radio bridge for hardwired systems.

### Installation
To connect to IP-Symcon, an XBee coordinator (gateway) is required, which is connected via serial or serial USB.

### Integration in IP-Symcon
The XBee gateway (coordinator) is integrated into IP-Symcon via serial port.
An XBee Splitter instance must be created for each end device. This only contains the device ID for communication within XBee.
For the end-device gateways, the XBee splitter instances serve as a replacement parent instance. (See ["Example object tree"](xbee.md) )

### Example

#### Data Flow
For a better understanding the abstract representation of the data flow can be seen here.

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

#### Example object tree
In this example, a Z-Wave gateway and a register variable are connected to a coordinator.
XBee uses the DeviceID to ensure that the data from the register variable is made available in the associated script as [System variables](../concepts/automations.md), as well as that the Z-Wave device data via the Z-Wave Gateway (parent instance: XBee Splitter Z-Wave) is updated.

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

In the contemporary example, this results in the following topology:

```php
Serial Port -> XBee Gateway -> XBee Splitter Z-Wave -> Z-Wave Gateway -> Z-Wave Dimmer
|
-> XBee Splitter RegVar -> Register Variable -> RegVarScript (System variable)
```

## XBee_SendBuffer

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/xbee/xbee-sendbuffer/

`bool XBee_SendBuffer(int $InstanceID, int $TargetDevice, string $Buffer)`

sends a data string to a specific device

**Parameters**

- `$InstanceID` (int): ID of the device to query
- `$TargetDevice` (int): ID of the target device
- `$Buffer` (string): Data buffer to be sent

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

Data buffer to be sent

**Example**

```php
XBee_SendBuffer(12345, 2, "Any DataString");
```

## XBee_SendCommand

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/xbee/xbee-sendcommand/

`bool XBee_SendCommand(int $InstanceID, string $Command)`

sends a command to a specific XBee-Splitter

**Parameters**

- `$InstanceID` (int): ID of the device to be modified
- `$Command` (string): Command to be sent

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

Command to be sent

**Example**

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