4. BSB-LAN: The Webinterface
By accessing the adapters IP (http://<IP-address>), the starting page of the webinterface “BSB-LAN Web” is displayed.
If you’re using the passkey function (http://<IP-address>/<passkey>/) or additional security options, of course the URL has to be specifically expanded.
Within the webinterface there are some buttons at the top for an easy and direct access to certain functions:
- Heater functions
- Sensors
- Display log file
- Device-specific parameter list
- Settings
- URL commands
- Manual
- FAQ
The button “Display log file” will be displayed in black letters, if the logging function isn’t active (like shown in the screenshot above). If logging ist activated, the button is named “Plot log file”.
Underneath the header area the installed version of BSB-LAN is shown.
BSB-LAN can check if a newer version is available. If there is a newer version, the link leads to the ZIP file of the repo, so that you can save it directly from within the webinterface.
| Note |
|---|
| If you want to use this function, you need to activate it. Please see chapter 2.2. |
Heater functions (URL command: /K):
The button “heater functions” displays a list of all categories within the supported controllers (therefore also categories which aren’t supported by certain controller types):
A click on the category name queries all supported parameters and displays them in the webinterface. Parameters which aren’t supported/available within that specific type of controller will be displayed in grey letters and the note “(parameter not supported)”:
| Note |
|---|
| If you don’t want these parameters to be shown, you can deactivate the output (see chap. 2.2). However, they will still be queried though if a whole category is queried. |
Sensors:
If optional sensors are connected and configured correctly, the sensors will be listed after clicking this button.
The following screenshot shows the output of a connected BME280 and five DS18B20 sensors.
Display/Plot log file (URL command: /D and /DG):
If the logging function to the microSD card is set and active, the belonging button is named “Plot log file”. Once you click on it, the logfile (file datalog.txt) will be graphically displayed. If the logging function is deaktivated, the button is named “Display log file” and is shown in black letters.
Mouseover, click and mouse wheel actions within the graphical display provide various control options:
- better legibility for value numbers with plot lines close to each other (mouseover on plot)
- user can interactively highlight plot lines for improved overview (mouseover on legend entries)
- user can interactively disable plot lines for improved overview and vertical scaling (click on legend entries)
- added zoom (mousewheel/pinch on plot) and pan capability (drag zoomed-in plot)
| Note |
|---|
| To display the logfile graphically it’s neccessary to allow the JavaScriptFramework from cdn.jsdelivr.net and d3js.org to work, so please don’t use adblockers on that, if you want to use this function. |
Device-specific parameter list (URL command: /Q):
After clicking on “Download” at the end of the displayed text, this function queries all parameters of the connected controller and creates the belonging textfile with the specific output. This file must be sent to Frederik (bsb(ät)code-it.de) in order to have the belonging file BSB_LAN_custom_defs.h created for your type of controller. After you received that file from Frederik, you the have to replace the existent file with this version and flash BSB-LAN again to gain full access to your controller. For further informations please see chap. 3.3.
Settings (URL command: /C):
It shows the webinterface for configuration and an overview of certain functions that have been set.
You get a quick overview of (e.g.) the used version of BSB-LAN, the uptime, the used bus type, the address, the readonly or read/write state of the adapter, about parameters that are set to log, protected GPIO pins and so on.
URL commands:
The button leads to the chapter URL Commands of this manual, where the URL commands are listed in a short overview. Internetaccess needed.
Manual:
The button leads to the table of content of this manual. Internetaccess needed.
FAQ:
The button leads to the chapter FAQ of this manual. Internetaccess needed.
