BSB LAN Versions Save

LAN/WiFi interface for Boiler-System-Bus (BSB) and Local Process Bus (LPB) and Punkt-zu-Punkt Schnittstelle (PPS) with a Siemens(TM) controller used by Elco Thision, Brötje and similar heating systems

v3.3

2 months ago
  • ATTENTION: New configuration options in BSB_LAN_config.h - please update your existing configuration files!
  • ESP32: Support for receiving date and time via NTP instead of taking it from the heater.
  • MQTT broker setting now accepts domain names as well as IP addresses. An optional port can be added after a trailing colon, e.g. broker.my-domain.com:1884. Otherwise defaults to 1883.
  • ESP32 NodeMCU: Support for optional additional SD card adapter. SPI pins can be configured in BSB_LAN_config.h, defaulting to standard SPI pins 5, 18, 19 and 23.
  • ESP32: Switching between log storage device (SD card / internal flash) can now be done in the web interface.
  • ESP32: Create temporary WiFi AP in case Ethernet connection fails
  • ESP32 NodeMCU: EEPROM clear pin has changed from 18 to 21 in order not to collide with SPI SD card adapters.
  • This release has been supported by the following GitHub sponsors: jsimon3

v3.2

6 months ago
  • ATTENTION: In BSB_LAN_config.h, new layout of log_parameters, avg_parameters and ipwe_parameters now written in curly brackets and different size (40 instead of 80) and type ("parameter" instead of "float"). Please update your BSB_LAN_config.h accordingly to prevent errors!
  • Added configuration file versioning checks to prevent the use of outdated configuration files with newer software versions.
  • Variable esp32_save_energy now defaults to false because it only seems to make sense when using LAN connection or if you use WiFi and can live with the performance impact.
  • Added folder "custom_functions" where code examples for useful functions will be collected which are nevertheless too specific to be added to BSB-LAN's core code.
  • Added custom function example for mapping DS18B20 sensors to fixed custom floats parameters
  • This release has been supported by the following GitHub Sponsors: BraweProg, fdobrovolny, Harald

v2.2.1

9 months ago

v3.1

11 months ago
  • ATTENTION: For ESP32 devices using internal flash for log storage: Filesystem was switched from SPIFFS to LittleFS. Download important log data before updating!
  • ATTENTION: In BSB_LAN_config.h, the structure of log_parameters, avg_parameters and ipwe_parameters has changed and now includes the destination device on the bus!
  • ATTENTION: New EEPROM schema may result in lost web-configuration settings when updating. Note your settings prior to updating!
  • ATTENTION: New variable esp32_save_energy in BSB_LAN_config.h - update before compiling new version.
  • ATTENTION: New variable bssid in BSB_LAN_config.h - defines a fixed BSSID address to connect to when using WiFi on ESP32.
  • Parameters can now be queried from other devices on the bus using the ! notation also when logging (including MQTT) or using average or IPWE parameters
  • Enable/disable power saving on ESP32. Saves 20% of energy, but can have impact on WiFi range and downloading speed of log files when using WiFi (LAN not affected)
  • Improved performance and flash memory usage on ESP32 devices using internal flash for logging due to switch from SPIFFS to LittleFS
  • To improve handling of large datalogs: date range selection in /DG, new url commands /Da,b /DA /DB /Dn /DI /DKn
  • This release has been supported by the following GitHub Sponsors: lapixo, nrobadey

v3.0

1 year ago
  • ATTENTION: BSB_LAN_custom_defs.h.default needs to be renamed to BSB_LAN_custom_defs.h and only contains a very limited set of parameters by default. See the manual for getting device-specific parameter lists.
  • Add new '/LN' URL command to force logging irrespective of current interval.
  • Improved library checks: No need for ESP32 users to remove ArduinoMDNS and WiFiSpi folders anymore.
  • New SdFat version 2 for Arduino Due
  • New data type VT_BINARY_ENUM
  • This release has been supported by the following GitHub Sponsors: Alex, DE-cr

v2.2

1 year ago
  • ATTENTION: Several variables in BSB_LAN_config.h.default have changed their variable type, it's probably best to re-create your BSB_LAN_config.h from scratch.
  • Parameter numbers are now floating point (i.e. XXXX.Y) because some parameters contain two different kinds of information. These are now shown in decimal increments of 0.1. You can still qurey the "main" parameter via XXXX (without .Y)
  • Lots of bugfixes and new data types
  • Device-specific parameter lists supported

v2.1

1 year ago
  • Many new parameters for LMU64
  • ATTENTION: New categories for LMU64 and RVD/RVP controllers due to their different numbering schemes. Will be filled over time. PPS and sensor categories have moved up by two.
  • ESP32: OTA now uses system-wide HTTP AUTH authentication credentials
  • Improved built-in chart display (/DG), new configuration definement #define USE_ADVANCED_PLOT_LOG_FILE - thanks to Christian Ramharter
  • Lots of bugfixes

v2.0

2 years ago
  • ATTENTION: LOTS of new functionalities, some of which break compatibility with previous versions, so be careful and read all the docs if you make the upgrade!
  • ATTENTION: Added and reorganized PPS parameters, almost all parameter numbers have changed!
  • ATTENTION: Change of EEPROM layout will lead to loading of default values from BSB_LAN_config.h! You need to write settings to EEPROM in configuration menu again!
  • ATTENTION: Folder locations and filenames have been adjusted for easier installation! If you update your installation, please take note that the configuration is now in BSB_LAN_config.h (LAN in caps), and no longer in BSB_lan_config.h (lower-caps "lan")
  • ATTENTION: HTTP-Authentication configuration has changed and now uses plain text instead of Base64 encoded strings!
  • Thanks to GitHub user do13, this code now also compiles on a ESP32, tested on NodeMCU-ESP32, Olimex ESP32-POE and Olimex ESP32-EVB boards. ESP32 code uses SDK version 2.0.2, please take note when configuring Arduino IDE!
  • OTA Updates now possible for ESP32-based devices
  • Support for special PPS devices (based on DC225/Honeywell MCBA) added
  • Webinterface allows for configuration of most settings without the need to re-flash, also split into basic and extended configuration
  • Added better WiFi option for Arduinos through Jiri Bilek's WiFiSpi library, using an ESP8266-based microcontroller like Wemos D1 mini or LoLin NodeMCU. Older WiFi-via-Serial approach no longer supported.
  • Added MDNS_SUPPORT definement in config so that BSB-LAN can be discovered through mDNS
  • If BSB-LAN cannot connect to WiFi on ESP32, it will set up its own access point "BSB-LAN" with password "BSB-LPB-PPS-LAN" for 30 minutes. After that, it will reboot and try to connect again.
  • New MQTT functions, including allowing any parameter to be set by an MQTT message and actively query any parameter once by sending an MQTT message
  • Added support for BME280 sensors
  • Setting a temporary destination address for querying parameters by adding !x (where x is the destination id), e.g. /6224!10 to query the identification of the display unit
  • URL commands /A, /B, /T and /JA have been removed as all sensors can now be accessed via parameter numbers 20000 and above as well as (currently) under new category K49.
  • New categories added, subsequent categories have been shifted up
  • HTTP Authentification now uses clear text username and password in configuration
  • PPS users can now send time and day of week to heater
  • Lots of new parameters added
  • URL command /JR allows for querying the standard (reset) value of a parameter in JSON format
  • URL command /JB allows for backing up parameters to JSON file
  • New library for DHT22 should provide more reliable results
  • Consolidated data and value types: New data types VT_YEAR, VT_DAYMONTH, VT_TIME as subsets of VT_DATETIME for parameters 1-3, replacing VT_SUMMERPERIOD and adjusting VT_VACATIONPROG. New value types DT_THMS for time consisting of hour:minutes:seconds
  • MQTT: Use MQTTDeviceID as a client ID for the broker, still defaults to BSB-LAN. ATTENTION: Check your config if you're broker relies on the client ID in any way for authorization etc.

v1.1

3 years ago

ATTENTION: The next release will contain several fundamental changes which will break some of the configurations, so that an update WILL require you to adjust your settings! If the current Master branch version is not working for you, try this one here. Also, Mega2560 users should still be able to run this version if not all modules are activated:

  • ATTENTION: DHW Push ("Trinkwasser Push") parameter had to be moved from 1601 to 1603 because 1601 has a different "official" meaning on some heaters. Please check and change your configuration if necessary
  • ATTENTION: New categories added, most category numbers (using /K) will be shifted up by a few numbers.
  • /JA URL command outputs average values
  • Many new parameters decoded
  • New parameters for device families 25, 44, 51, 59, 68, 85, 88, 90, 96, 97, 108, 134, 162, 163, 170, 195, 209, 211
  • Improved mobile display of webinterface
  • Added definement "BtSerial" for diverting serial output to Serial2 where a Bluetooth adapter can be connected (5V->5V, GND->GND, RX->TX2, TX->RX2). Adapter has to be in slave mode and configured to 115200 bps, 8N1.
  • Lots of added Polish translations
  • New data types VT_BYTE10, VT_SPF
  • Bugfix for PPS bus regarding display of heating time programs
  • Bugfix for MQTT

v1.0

3 years ago

ATTENTION: Next release will include new categories (and therefore a shift in category numbers) and also move the DHW Push parameter from 1601 to 1603. If you are installing BSB-LAN for the first time, please get the most recent code from the master repository to avoid making these changes with your next update.

  • /JI URL command outputs configuration in JSON structure
  • /JC URL command gets list of possible values from user-defined list of functions. Example: /JC=505,700,701,702,711,1600,1602
  • Logging telegrams (log parameter 30000) now writes to separate file (journal.txt). It can be reset with /D0 (same time with datalog.txt) command and dumped with /DJ command.
  • removed WIFI configuration as it is no longer applicable for the Due
  • lots of new parameters for various device families
  • Code optimization and restructuring, general increase of speed
  • new schemativs for board layout V3
  • lots of bugfixes