Overview X-Sense detector

The function block connects a smoke, CO, heat or combination detector from X-Sense that is paired with the SBS50 base station. The base station sends the state of its detectors to the controller via MQTT, without going through a cloud. One block is created for each detector.

The connection is read-only: the block reports alarm and state, but cannot trigger or silence the detectors.

Important: The block is for overview purposes only. Its messages may fail to arrive, arrive late or be wrong, for example if the base station has no Wi-Fi connection or no power, has lost its connection to the controller or cannot reach a detector. The block must therefore not be used for safety-related functions and does not replace a fire alarm system. The detectors warn over their own radio link, independently of the controller.

The test button on the detector does not trigger a message on the block, so the alarm outputs cannot be tested with it.

Setup

  1. In the X-Sense app, open the base station and under Connect to Home Assistant enter the IP address of the controller and port 1883. Host names are not accepted, so the controller needs a fixed IP address. The app asks for a user and password; the controller does not check them, any text will do.
  2. Enable the MQTT connection and save. The function requires a current app and base station firmware.
  3. Determine the ID of the detector, most easily in the MQTT diagnostics of the controller. Every five minutes the base station sends topics of this form for each detector: homeassistant/binary_sensor/SBS50XXXXXXXX_0000000D/.... The ID is the part SBS50XXXXXXXX_0000000D. Names from the app are not transmitted.
  4. Enter the ID in the ID parameter.

Outputs

AL Alarm 1 while the detector reports smoke, CO or heat. Collective output of RA, CO and HI.
RA Smoke alarm 1 while the detector reports smoke.
CO CO alarm 1 while the detector reports carbon monoxide. Stays 0 on detectors without a CO sensor.
HI Heat alarm 1 while the detector reports heat. Stays 0 on detectors without a heat sensor.
ST Fault 1 while the detector reports a fault in one of its sensors.
BA Battery low 1 while the detector reports a low battery.
LE End of life 1 as soon as the detector reports the end of its service life. The detector must then be replaced.
ON Online 1 while the base station reports the detector as reachable. Also becomes 0 on a timeout.
TO Timeout 1 if no message for this detector arrived within the monitoring time. The alarm outputs keep their last value, because missing messages are not an all-clear. The next message sets the output to 0.

Parameters


ID ID of the detector as it appears in the MQTT topic, for example SBS50XXXXXXXX_0000000D. The ID is case-sensitive.

Monitoring time Time in seconds after which the TO output is set if no message arrives. The default is 900 seconds, which corresponds to three send cycles of the base station. 0 disables monitoring.
After the controller starts, all outputs are 0 until the first message from the detector has arrived. This can take up to five minutes. If no messages arrive after that either, switch the MQTT connection in the X-Sense app off and on again.

The base station does not send X-Sense water detectors and thermo-hygrometers via MQTT, so they cannot be connected with this block.

See also MQTT devices - General.
See also general parameters of all function blocks.