Skip to content

Reads Values from a Emu M-Bus Center and exposes them to Home Assistant

License

Notifications You must be signed in to change notification settings

redlukas/emu_mbus_center

Repository files navigation

Emu M-Bus Center

GitHub Release GitHub Activity License

pre-commit Black Validate with Hassfest

hacs Project Maintenance

Discord Community Forum

This component will set up the following platforms.

Platform Description
hub Each M-Bus Center is represented in HA as a Hub.
Each Hub will have zero or more Devices (each corresponding to one Meter you have connected to the M-Bus Center).
Each Device has some amount of Entities depending on the type of meter the Device represents. All of those entities are of type 'sensor'.

Overview

This Integration will help you pull data from an Emu M-Bus Center into Home Assistant. This Work is done independently and is in no way affiliated, endorsed or funded by EMU. I bought all my own hardware. Due to that, the Integration is currently only tested with the EMU M-Bus Center 250 with EMU Allrounder 3/75 Meters. If someone from EMU wants to get in touch with me, open an issue on this Repo with your info.

Installation

Automated (suggested):

Just click here: Open in HACS.

Manual:

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called emu_m_bus_center.
  4. Download all the files from the custom_components/emu_m_bus_center/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant

Using your HA configuration directory (folder) as a starting point you should now also have this:

custom_components/emu_m_bus_center/
├── config_flow.py
├── const.py
├── device_types
│   ├── devices.py
│   ├── emu_1_40_v4_15val.py
│   ├── emu_allrounder_v16_15val.py
│   ├── emu_allrounder_v16_17val.py
│   ├── emu_professional_v16_31val.py
│   ├── emu_professional_v16_32val.py
│   ├── gwf_water_2val.py
├── emu_client.py
├── __init__.py
├── manifest.json
├── sensor.py
└── translations
    ├── de.json
    ├── en.json
    └── sk.json

Configuration

No matter which way you installed the Integration, you need to restart Home Assistant before configuring the integration.

Go to the Settings -> Devices & Services -> Integrations tab of your Home Assistant instance. Click ADD INTEGRATION and search for "Emu M-Bus Center". The Configuration flow will start when you click install. It will ask you for the IP address and Name of your M-Bus Center. Then it will scan your Center for available Sensors and add them to Home Assistant. If you do not want the default names for the meters, go to Integrations one more time, look for the Integration you just installed and click on the "x Devices". You will find a list of the sensors that were found. If you click on a single sensor, you'll get a dialog with a pencil in the upper right corner. Click that pencil and enter the Name you desire in the popup. By default, the name will be in the format $SENSOR_NAME ($SITE_NAME). Use the Web interface of your M-Bus Center as described below to match sensor/site name to the M-Bus Address you set on the meter itself.

How to find the ID of your meter

  1. Go to the Web interface of your Meter and load the overview. There you go to "Meter configuration". overview
  2. The IDs will be listed in the leftmost column. meters

Tested devices

The integration has been tested on the following devices:

Centers

Manufacturer Product Firmware Version
EMU M-Bus Center 250 1.10.1.0.r0

EMU say that the EMU M-Center employs the same REST API as the M-Bus Center. I am therefore optimistic that this integration will work with the M-Center, but cannot confirm it.

Meters

Manufacturer Product Firmware Version
(as reported on meter's Display)
Firmware Version
(as reported by API)
Status
EMU Allrounder 3/75 M-Bus 1.4 16 Fully tested
EMU Professional 3/75 M-Bus 1.4 16 Somewhat tested
EMU Professional II 3/100 M-Bus 1.4 16 Experimental
EMU 1/40 ??? 4 Experimental
GWF MTK3coder MP ??? 60 Somewhat tested

If you use one of the Meters that are marked as "Experimental", please open an issue and let me know if it works for you.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

Credits

This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.

Code template was mainly taken from @Ludeeus's integration_blueprint template

For the config flow, the initialization and update of the sensors I looked at many existing repos, chief among them @CubicPill's China Southern Power Grid Statistics