Multical 21 custom component for Home Assistant.
To use this custom component, you'll need an optical eye and connect your machine running Home Assistant directly with the optical eye to the Kamstrup multical 21 meter.
The optical eye looks like this:
I ordered it from here
You can also 3d Print this mount
This component can easily be installed in your Home Assistant by adding this repository in HACS.
- 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_componentsdirectory (folder) there, you need to create it. - In the
custom_componentsdirectory (folder) create a new folder calledmultical_21. - Download all the files from the
custom_components/multical_21/directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Multical 21"
Using your HA configuration directory (folder) as a starting point you should now also have these files:
custom_components/multical_21/translations/en.json
custom_components/multical_21/translations/nl.json
custom_components/multical_21/__init__.py
custom_components/multical_21/config_flow.py
custom_components/multical_21/const.py
custom_components/multical_21/kamstrup.py
custom_components/multical_21/manifest.json
custom_components/multical_21/sensor.py
It's recommended to use devices as /dev/serial/by-id and not /dev/ttyUSB1 as the port. This is because the first example is a stable identifier, while the second can change when USB devices are added or removed, or even when you perform a system reboot.
The port should look like this: /dev/serial/by-id/usb-FTDI_FT230X_Basic_UART_D307PBVY-if00-port0.
Some meters contain a battery, and communicating with the meter does impact battery life. By default, this component updates every 3600 seconds (1 hour). This is configurable. Also, since version 2.0.1 you can also configure the serial timeout. The default value is 1.0 seconds, if you get the error Finished update, No readings from the meter. Please check the IR connection you can try to increase this value. Fractional numbers are allowed (eg. 0.5).
You can do this by pressing configure on the Integrations page:
When you want to report an issue, please add logs from this component. You can enable logging for this component by configuring the logger in Home Assistant as follows:
logger:
default: warn
logs:
custom_components.multical_21: debugMore info can be found on the Home Assistant logger integration page