wp2reg-luxws

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