Skip to content

Go code and Prometheus exporter for working with heat pump controllers from Alpha Innotec and other manufacturers.

License

Notifications You must be signed in to change notification settings

hlinden/wp2reg-luxws

 
 

Repository files navigation

wp2reg-luxws

Latest release Release workflow CI workflow Go reference

A collection of Go packages for working with the Lux_WS protocol used for remote control in Luxtronik 2.x heat pump controllers manufactured and/or deployed by the following companies:

  • Alpha Innotec
  • NIBE
  • Novelan
  • possibly other companies and/or brands

The websocket-based protocol was introduced in firmware version 3.81. The code was developed and tested using wp2reg version 3.85.6.

Prometheus exporter

The primary purpose of this code is to export all informational values for consumption by Prometheus. See the luxws-exporter directory for details.

Installation

Pre-built binaries are provided for all releases:

  • Binary archives for Linux, Windows and Mac OS (.tar.gz, .zip)
  • Debian/Ubuntu (.deb)
  • RHEL/Fedora (.rpm)

Installation from the source code

It's also possible to produce custom builds directly using Go or GoReleaser.

With Go 1.16 or later the following command installs luxws-exporter system-wide into /usr/local/bin/:

go build -o luxws-exporter/luxws-exporter ./luxws-exporter && \
  sudo install -t /usr/local/bin -m 0755 luxws-exporter/luxws-exporter

About

Go code and Prometheus exporter for working with heat pump controllers from Alpha Innotec and other manufacturers.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 100.0%