Configuration of heating and water meters (MBus)

Nicolas Vodoz Updated by Nicolas Vodoz

1. Reading a meter with its secondary address

Unlike electricity meters and other Modbus devices for which the gateway reads one specific data register at a time, MBus meters systematically return all their registers in a single packet called a telegram.

This telegram must then be parsed to keep only the values of interest, namely the meter index (the energy or volume register visible on the meter dial).

The secondary address corresponds to the reversed serial number in pairs followed by 8 consecutive "F" characters.

For the heating meter below, the serial number is 94158192, which corresponds to the secondary address 92811594FFFFFFFF

To obtain the telegram, read the meter via the Configuration Gateway webserver under Meters > MBus > Read MBus Meter

The baudrate is 2400 by default.

If the meter is correctly connected to the Gateway, the raw telegram is received after a few seconds.

Telegram analysis and register retrieval

On the first blue line: the meter serial number

In red, the meter index with desc:ENERGY and function:INST_VAL, value in Wh.

In yellow, other useful registers for heating meters.

In the example above, the meter index (in red) has the following DIB and VIB values:

DIB: 04

VIB: 06

2. Configuring the meter on the online portal

The meter is then configured in the online portal to enter its secondary address and the position of the registers.

Log in to the Climkit online portal (app.climkit.io), select the corresponding site. Under EQUIPMENT > Meters > Heat (or Cold Water or Hot Water), create the meters one by one by clicking on the "+".

Edit the meter with the following parameters:

  • Name: name according to type, serial number, and assignment. For example: "CH - 94158192 - Apartment 203"
  • Address: leave empty
  • Gateway: Select the gateway to which the meters are connected. See under EQUIPEMENT > Communication.
  • Model: generic_mbus
  • Protocol: mbus
  • Baudrate: 2400
  • Mode: consumption

Under additional parameters, insert the "key-value" pairs:

secondary_ad for the secondary address: 92811594FFFFFFFF

reg for registers: [{'unit': 'heat_energy_kwh', 'factor': 0.001, 'dib': '04', 'vib': '06'}]

For a cooling meter, use cold_energy_kwh, and for a water meter vol_m3.

For a hot water meter, use hot_water.

For a cold water meter, use cold_water.

For the heating meter, here are the complete registers in yellow in the above telegram:

[
    {'unit': 'heat_energy_kwh', 'factor': 0.001, 'dib': '04', 'vib': '06'},
    {'unit': 'vol_m3', 'dib': '04', 'vib': '13'},
    {'unit': 'power_kw', 'dib': '04', 'vib': '2B'}, 
    {'unit': 'vol_flow_m3_h', 'dib': '04', 'vib': '3B'},
    {'unit': 'flow_temp', 'dib': '02', 'vib': '5B'},
    {'unit': 'return_temp', 'dib': '02', 'vib': '5F'},
    {'unit': 'diff_temp', 'dib': '02', 'vib': '61'} 
]

3. Configuration and reading verification

Once the meter has been created and saved on the portal and associated with the correct gateway, it appears on the gateway under Meters > Configured Meters.

Click on READ to test the register reading and values.

The registers can then be reused for creating meters of the same model on the site.

How Did We Do?

Charging station configuration

Installation of Shelly relay meters

Contact