homebridge-eos-sbm-app

Homebridge platform plugin for EOS SBM-App / WEB@Sauna modules using the local HTTP API.

Example configuration

{
  "platform": "EOSSBMApp",
  "name": "EOS Sauna",
  "host": "10.0.0.186",
  "pollInterval": 5,

  "enableLight": true,
  "lightAsDimmer": false,
  "lightName": "Sauna Licht",

  "enableSaunaSwitch": false,
  "saunaSwitchName": "Sauna Heizung",
  "saunaSwitchStatusSource": "auto",

  "enableFinnishSaunaSwitch": true,
  "finnishSaunaSwitchName": "Sauna Finnisch",
  "enableBioSaunaSwitch": true,
  "bioSaunaSwitchName": "Bio Sauna",

  "enableAuxSwitch": true,
  "auxSwitchName": "Lüftung",
  "auxStatusField": "Cxd",
  "auxCommandField": "Cxc",

  "enableAllOffSwitch": true,
  "allOffSwitchName": "Sauna Alles Aus",
  "allOffAfterBurnerCommandField": "AHxc",

  "enableThermostat": true,
  "thermostatName": "Sauna Solltemperatur",
  "temperatureSensorName": "Sauna Temperatur",
  "enableHumiditySensor": true,
  "humiditySensorName": "Sauna Luftfeuchte",

  "forceHomeKitUpdates": true,
  "debug": false
}

Mode switches

Version 0.1.11 adds two optional mode switches:

• Sauna Finnisch: ON sends Vxc=0 then Sxc=1. OFF sends Vxc=0 then Sxc=0.
• Bio Sauna: ON sends Sxc=1 then Vxc=1. OFF sends Vxc=0 then Sxc=0.

The status is derived from the EOS fields:

• Finnish mode: sauna active and Vxd=0 / EOS status is not BIO.
• BIO mode: sauna active and Vxd=1 or EOS status S=2.

For a clearer Apple Home UI, you can disable the generic sauna switch with:

"enableSaunaSwitch": false

and use only the two mode switches.

Lüftung

The additional output is exposed as Lüftung by using status field Cxd and command field Cxc.

Complete off switch

The optional momentary complete-off switch sends:

• Sxc=0 sauna/heater off
• Vxc=0 vaporizer off
• Lxc=0 light off
• configured Lüftung command, normally Cxc=0
• configured after-burner command, normally AHxc=0

The switch automatically returns to off in HomeKit after the sequence.

Force HomeKit updates

forceHomeKitUpdates defaults to true. During each polling cycle, the plugin actively publishes current EOS values to HomeKit to improve Apple Home updates after changes made in the native EOS SPA app.

Version 0.1.12 - Thermostat Heat/Off behavior

thermostatModeControl controls what Apple Home thermostat Heat/Off writes do:

• none: thermostat only sets target temperature; Heat/Off writes are ignored silently.
• finnish: Heat starts Finnish sauna mode (Vxc=0, then Sxc=1); Off sends Vxc=0, then Sxc=0.
• bio: Heat starts BIO sauna mode (Sxc=1, then Vxc=1); Off sends Vxc=0, then Sxc=0.
• generic: Heat/Off controls Sxc only.

Recommended with separate mode switches: thermostatModeControl: "finnish" or "none".

0.1.13

• Thermostat Heat/Off commands now update sibling HomeKit switches immediately via optimistic state publishing.
• When Thermostat HEAT starts Finnish or BIO mode, the corresponding Sauna Finnisch / Bio Sauna switch is updated immediately instead of waiting for Apple Home to reopen the accessory.

Version 0.1.14

Adds after-burner aware ventilation behavior for the auxiliary output named "Lüftung".

When the EOS controller reports After Burner Mode (S=3) or the observed after-run field AHxd=1, the HomeKit Lüftung switch is shown as ON even if Cxd=0.

If the user tries to turn Lüftung OFF during after-burner mode, the plugin keeps it ON by sending the configured aux ON command again. To end after-burner / after-run, use the complete off switch (Sauna Alles Aus), which sends the configured after-burner off command (AHxc=0).

Optional config fields:

"auxOnDuringAfterBurner": true,
"afterBurnerStatusField": "AHxd"

BIO humidity control behavior

Version 0.1.18 makes the BIO humidity control display-only outside BIO sauna mode by default. The service still shows the current humidity (H) and target humidity (Hd), but writes to the target humidity (Hc) are accepted only while BIO sauna mode is active (Vxd=1 or status S=2).

Recommended settings:

"enableBioHumidityControl": true,
"bioHumidityControlName": "Bio Sauna Luftfeuchte",
"bioDefaultHumidity": 40,
"bioHumidityMin": 0,
"bioHumidityMax": 100,
"bioHumidityStep": 5,
"bioHumidityOnlyWhenBioSauna": true

When Bio Sauna is switched on, the plugin starts BIO mode and sends Hc with the configured default humidity, e.g. 40 %. In Finnish sauna or inactive mode, changing the humidity slider in Apple Home is ignored and the previous EOS target value is restored in HomeKit.

Separate switch accessories

Version 0.1.18 adds an optional layout mode for Apple Home:

"separateSwitchAccessories": true

When enabled, the main climate/sensor accessory remains available, while the important controls such as Sauna Finnisch, Bio Sauna, Lüftung, Licht and Sauna Alles Aus are created as separate HomeKit accessories. This can make Apple Home show them as individual room tiles instead of grouping all services into one large Klima tile.

After enabling or disabling this option, remove old EOS/Sauna cached accessories in Homebridge UI and restart Homebridge so Apple Home receives the new structure cleanly.

Version 0.1.18

Fix for separateSwitchAccessories: separate switch accessories now use explicit HomeKit categories and a refreshed UUID namespace so Apple Home can display the controls as individual switch/light tiles instead of only inside the climate tile. After upgrading, remove old cached EOS/Sauna accessories in Homebridge and restart.

Version 0.1.19

• Adds separateRegulatorAccessories so the thermostat and Bio Sauna humidity control can appear as separate Apple Home accessories instead of being hidden inside the grouped climate tile.
• When separateSwitchAccessories is true, regulator accessories are separated by default unless separateRegulatorAccessories is explicitly set to false.