**Version:**

XSense Adapter for ioBroker

This ioBroker adapter allows the integration of XSense devices into the ioBroker smart home system.
It is designed to receive data from XSense smoke detectors, CO detectors, and other compatible devices, making them available in ioBroker for automation and monitoring.
The adapter communicates with the XSense cloud server and provides an easy way to integrate XSense devices into existing ioBroker setups.
An XSense Bridge SBS50 is required.

SBS50 alarm mode support

For SBS50 base stations the adapter now exposes the same core alarm state data that the X-Sense app uses:

safeMode – current station mode (Disarmed, Home, Away)
requestedSafeMode – last requested app mode
force_arm_pending – true when a confirmation is waiting because sensors are open
force_arm_mode – the pending mode to confirm
force_reason – notably reason text if the app sends it

The adapter also creates station-level commands for quick control:

disarm
arm_home
arm_away

These button states send the corresponding shadow request to the 2nd_appmode endpoint and keep the station state in sync.

❗ WARNING

The adapter is not intended for alarm purposes — it is primarily for monitoring the device battery status.

I accept no liability if the place burns down.

🔧 Supported Devices

Smoke detectors
Carbon monoxide detectors
Heat detectors
Water leak detectors
Hygrometers
Base stations (if supported)

⚠️ Requirements

An XSense account with registered devices
Internet connection for cloud communication
MQTT Server for messages

📦 Preparation

Since XSense does not allow simultaneous login from the app and third-party software, it is recommended to follow this procedure:

Create a second account in the XSense app
Log in with the new account, then log out
Log in again with your original account
Share the desired devices from the main account with the new account
Log back into the new account and accept the invitation
Finally, enter the new account credentials in the adapter settings

Alternatively: You can use only one account, with the drawback that you will constantly be logged out of the app.

❗ Troubleshooting

Error Message after install

[XSense] Cannot find package '@mongodb-js/zstd'

check your Node version. zstd has a problem wit Node 24

or if you have a VM on proxmox check your CPU settings grafik

Changelog

0.6.8 (2026-10-25)

(arteck) Dependencies have been updated
(arteck) add SBS50-Alarmstatus
(arteck) more MQTT messages from devices

0.6.7 (2026-10-20)

(arteck) Dependencies have been updated
(arteck) update new Devices
(arteck) add fire_drill_alarm for devices that support it
(arteck) add mute_alarm for devices that support it

0.6.6 (2026-09-30)

(arteck) Dependencies have been updated
(arteck) fix internal mqtt with node 24

0.6.5 (2026-08-27)

(arteck) async fix
(arteck) fix battery info
(arteck) fix orphaned states without house folder from MQTT messages for stations not yet known (startup race and newly added devices)

0.6.4 (2026-06-22)

(arteck) Dependencies have been updated

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.