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'. |
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.
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml
). - If you do not have a
custom_components
directory (folder) there, you need to create it. - In the
custom_components
directory (folder) create a new folder calledemu_m_bus_center
. - Download all the files from the
custom_components/emu_m_bus_center/
directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- 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
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.
- Go to the Web interface of your Meter and load the overview. There you go to "Meter configuration".
- The IDs will be listed in the leftmost column.
The integration has been tested on the following devices:
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.
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.
If you want to contribute to this please read the Contribution guidelines
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