This manual was written to make the start and the usage of the BSB-LAN hard- & software easier.
It is suggested to read the manual completely before starting the installation and usage of the adapter and the software.
The copyright belongs to the author of this manual: Ulf Dieckmann.
Jump straight to the TOC
Download the PDF version of this manual
Quick Start Guides for the installation and commissioning of the BSB-LAN setups are available here:
Quick Start Guide for Arduino Due
Quick Start Guide for ESP32 Boards
There is NO WARRANTY or GUARANTEE of any kind that this adapter will NOT damage your heating system!
Any implementation of the steps described here, any replica of the adapter and any use of the hardware and software described is at your own risk!
None of the contributors or authors can be held liable for any damages of any kind!
BSB-LPB-LAN - A Short Introduction
“BSB-LPB-LAN” is a community based hardware and software project, which allows access to the controllers of different heating systems from certain manufacturers via PC / laptop / tablet / smartphone.
The project consists of two specific components:
- the hardware, which basically is a logic level converter and which is called “BSB-LAN adapter” in the following and
- the BSB-LAN software, which has to be flashed onto a compatible microcontroller.
The BSB-LAN adapter converts the 12V bus signals from the heating system to a suitable 3,3V signal for the necessary microcontroller.
The adapter has to be connected to the compatible controller of the heating system and has to be used in conjunction with a compatible microcontroller (Arduino Due or ESP32).
The microcontroller itself then will be integrated in your home network (either via LAN oder WiFi, depending on the chosen microcontroller).
The controller of the heating system must be equipped with a “Boiler System Bus” (BSB), a “Local Process Bus” (LPB) or a “Point-to-Point Interface” (PPS). These are mostly heating systems in which a SIEMENS controller is used (or, depending on the heater manufacturer, usually a branded OEM version).
The BSB-LAN software then converts the logic levels to specific ‘bus telegrams’. It basically gives access to the controller of the heating system. It offers various functions like monitoring values and the state of parameters, logging and (if wanted) controlling and changing settings via a webinterface.
An optional integration into an existing SmartHome system is also possible. An integration in systems such as FHEM, openHAB, HomeMatic, ioBroker, Loxone, IP-Symcon, EDOMI, Home Assistant, SmartHomeNG or Node-RED can be done via HTTPMOD, JSON or MQTT.
In addition, the use of the adapter as a standalone logger without LAN/WiFi or internet connection when using a microSD card is also possible.
Furthermore, optional temperature and humidity sensors can be connected and their data can also be logged and evaluated.
You also have the ability to integrate your own code into the BSB-LAN software, which offers a wide range of expansion options.
As a first rough orientation, whether your own heating system is compatible or not, you can search for a connection option for optional room units in the operating instructions of your heater.
If room units of the QAA55 / QAA75 type are listed as compatible (Broetje also refers to these as “RGB Basic” and “RGT B Top”), then the adapter can be connected via BSB. This is the case with most oil fired, gas fired and heat pump systems of the last years.
If other room units are listed, see the chapter Room Units.
However, accurate information if the adapter could be connected only provides the actual controller name and the manual of the controller.
The following overview shows the most common used controllers of the different heating systems which will work with BSB-LAN.
As a basic rule we can say, that the controller types of the last years which are named with an S at the end (RVS and LMS) are compatible with BSB-LAN and offer (mostly) the full range of funtionality.
For further and more detailed informations about the different controllers and the connection see the corresponding chapters.
To see a detailed listing of the reported systems which are sucessfully used with BSB-LAN please follow the corresponding link:
Gas-fired heating systems controllers:
- LMU74/LMU75 and LMS14/LMS15 (latest models), connection via BSB, complete functionality
- LMU54/LMU64, connection via PPS, limited functionality
Oil-fired heating systems controllers / solarthermic controllers / zone controllers:
- RVS43/RVS63/RVS46, connection via BSB, full functionality
- RVA/RVP, connection via PPS (modelspecific sometimes LPB), limited functionality
Heat pump controllers:
- RVS21/RVS61, connection via BSB, full functionality
Weishaupt (model WTU):
- RVS23, connection via LPB, (nearly) full functionality
The software is available here.
Software, schematics v1, first documentation EN, support
up to v0.16:
Software, PCB schematics v1 & v2, first documentation EN, support
Frederik Holst (bsb [ät] code-it.de)
Debugging, manuals, translations, support
Ulf Dieckmann (adapter [ät] quantentunnel.de)
Based upon the code and the work of many other users and developers! Thanks!
Further to the TOC