Voltronic Inverters Binding [4.3; 6.0)

This binding add-on integrates Voltronic inverters, known also as Axpert, Effecta, Kodak, MPP Solar, Voltacon or just No name.

KAR file: https://github.com/dilyanpalauzov/voltronic-openhab/releases/download/20261006/be.bapha.openhab.binding.voltronic-4.3.0-20261006.kar
JAR file: https://github.com/dilyanpalauzov/voltronic-openhab/releases/download/20261006/be.bapha.openhab.binding.voltronic-4.3.0-20261006.jar
Git repository: https://github.com/dilyanpalauzov/voltronic-openhab/
README: https://github.com/dilyanpalauzov/voltronic-openhab/blob/4.3/README.md

The releases page Release Change build process to create .kar file · dilyanpalauzov/voltronic-openhab · GitHub contains jar and kar files for openHAB 4.3 and 5.0 (created from the 5.0 branch). Both work with any later version. The difference is that in version 5.0 the thing has as semantic tag “Inverter”. openHAB 4.3. does not accept semantic tags in thing-types.xml.

The .kar file can be installed from here (Market Place), or from Json 3rd Party Add-on Service https://ohaddons.bapha.be/. It starts the openhab-transport-serial feature implicitly. The .kar file cannot be placed in the share/openhab/addons/ directory. The .jar file can be put in the share/openhab/addons/ directory, and it requires under to enable Settings → Add-On Management → USB Suggestion Finder.

The only known problem at runtime is that sometimes the input (PV) watts are read from the inverter, and sometimes are calculated by multiplying the input amperes with the input volts, leading to different number compared to the display. This is a bug in this software. A work-around is to unplug and plug the connecting cable.

No further releases are planned, the author of the add-on does not use the hardware anymore.

Changes

  • 2026 October 6
    • Change the build system to create .jar and .kar files.
  • 2026 September 12
    • Set Connection type: local for the binding
  • 2026 January 25
    • Parsing floats uses decimal dot, irrespective of the current locale.
  • 2026 January 06:
    • Channels qpiri#batteryType, qpiri#inputVoltageRange and qpiri#pvPowerBalance are writable
    • Moved to a separate git repository, containing only this add-on.

Installing the add-on is a matter of putting the jar file under openhab/addons/ directory, replacing /usr/share/openhab/runtime/system/com/neuronrobotics/nrjavaserial/5.2.1.OH1/nrjavaserial-5.2.1.OH1.jar with https://github.com/dilyanpalauzov/nrjavaserial/releases/download/5.2.1-hidraw/nrjavaserial-5.2.1.jar and cleaning the OH cache. It is tested with openHAB 4.3 and 5.1.

As can be seen in the Readme file the only tried communication is by using USB cable, plugging the USB-B end in the inverter and the USB-A end on the openHAB-side. The Readme file describes also how to replace the nrjavaserial jar file from the openHAB distribution to make the communication work.

Comments can be made here or at https://github.com/dilyanpalauzov/voltronic-openhab/issues .

I hope this binding will be useful for all openHAB users with such hardware. I created this binding, as I wanted to transfer data from the inverter to openHAB in short polling cycles on low powered devices.

Updates of the add-on might change the channels structure and this would require writing transition files for things created over the UI. I do not plan to write such transition files, so either create the thing as a file in the openhab/things/ directory, or delete the thing from the UI before installing new version of this add-on.

If you create an entry in the marketplace users will be able to install this from the Add-on store same as an official add-on.