# M-Bus

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

M-Bus is a standardized protocol and bus system for recording consumption data. A LAN, serial or USB gateway is required to connect to IP-Symcon.

> **Note:** The following devices are supported by IP-Symcon:
>
> [Supported Devices](mbus.md)

### Installation
The __M-Bus LAN Gateway__ is connected to the PC via LAN. By default, DHCP and port 5000 are set up. If an individual IP address is required, the IP-Symcon "Network Configuration Tool" is required. This is available for [download](https://support.symcon.de/lan-gct) . A simple [description of how to configure the gateway](https://www.symcon.de/assets/files/service/NetworkConfigurationTool.pdf)  is available. The gateway can then be reached via the configured IP address and port.

### Integration in IP-Symcon
The LAN gateway can be integrated via the [Device Search](../components/management-console.md). To do this, "M-Bus Discovery" must be selected as the system. The discovery instance then offers to create an M-Bus [Configurator](../concepts.md). After the configurator has been created, devices can be searched for and integrated there.

### Configurator
Default settings for newly created devices can be defined in the configurator:

| Property           | Description                                                                                                                                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Default Addressing | Selection of whether devices are to be addressed via the primary address or secondary address. With "Automatic", the secondary address is used if the primary address is 0, otherwise the secondary address is used |
| Default Interval   | At what intervals the values should be queried (in minutes)                                                                                                                                                         |

The default settings are only applied when creating new [Instances](../concepts.md). A change does not affect already existing [Instances](../concepts.md).

After defining the standard settings, the search for M-Bus devices can be started by clicking on the "Search for devices" button. The search may take a few minutes.

After the search, the devices found appear as instances that can be created in the configurator. To do this, a device must be selected from the list and "Create" must be clicked on.

![M-Bus configurator](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/mbus/19fc32acb3-1790424938/mbus-konfigurator.png)

New instances are created in the object tree in the main category. These created instances can then be renamed accordingly and sorted elsewhere. It is also possible to call up the respective instance configuration via "Configure" in the configurator.

### Configuration
Various properties can be set on the configuration page of the device.

| Property         | Description                                                                                          |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| Addressing       | Selection of whether the device should be addressed via the primary address or the secondary address |
| Address          | Address or ID of the device                                                                          |
| Refresh Interval | At what intervals the values should be queried in minutes                                            |
| Limitation       | Limitation of packets on the bus (0 = unlimited)                                                     |

![Configuration](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/mbus/b6959debdb-1790424938/mbus-konfiguration.png)

## Device list

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/mbus/device-list/

### Supported Gateways

In general, all M-Bus Gateways are supported.

Explicitly tested gateways:

| Manufacturer                                                                      | Description              |
| --------------------------------------------------------------------------------- | ------------------------ |
| SymBox with M-Bus extension [Order now](https://www.symcon.de/en/shop/symbox/bundle-symbox) | Serial integrated module |
| Symcon M-Bus LAN Gateway <br> [order now](https://www.symcon.de/en/shop/gateways/lan-m-bus) | IP Gateway               |
| PiiGAB                                                                            | M-Bus 800                |
| Relay                                                                             | M-Bus Micro-Master       |
| Relay                                                                             | Level converter PW3      |
| Relay                                                                             | Level converter PW20     |
| Relay                                                                             | Level converter PW60     |
| Relay                                                                             | RelAir R2M HOME          |
| Relay                                                                             | RelAir R2M Pro           |

### Supported Components

IP-Symcon supports all devices that use the M-Bus protocol.

## MBUS_UpdateValues

Source: https://www.symcon.de/en/service/documentation/module-reference/devices/mbus/mbus-updatevalues/

`bool MBUS_UpdateValues(int $InstanceID)`

updates all device-specific values

**Parameters**

- `$InstanceID` (int): ID of the device to update

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

ID of the device to update

**Example**

```php
MBUS_UpdateValues(12345);
```