Home Assistant custom integration for Theben LUXORliving KNX systems. Connects via the BAOS 777 IP1 gateway using a LXP project file for automatic entity discovery — lights, covers, climate, sensors, switches and binary sensors, all created without any manual YAML.
Requirements: Theben LUXORliving IP1 gateway · LXP project file · Home Assistant ≥ 2026.4.4
1. Install via HACS
Open HACS → Integrations → ⋮ → Custom repositories → add https://github.com/phismith91/luxorliving → Download → Restart HA.
2. Add the Integration
Settings → Devices & Services → Add Integration → LUXORliving → follow the config flow.
3. Done
Entities are discovered and created automatically from your LXP project file.
| Who are you? | Start here |
|---|---|
| 🏠 User — just want it working | User Guide |
| ⚙️ Advanced User — want to tune and extend | Advanced Guide |
| 🛠️ Contributor — want to develop or contribute | Developer Guide |
Reference: Full Options & Features Reference · Automations · Dashboard Examples
Technical: Architecture Overview · Architecture Decisions · Sensor Platform · Tests
Operations: Release Operations · Incident Response · Changelog
Current release: v1.1.13 — Security fix: push endpoint and health view now require authentication
Tested and confirmed working:
| Device | Function | HA platform |
|---|---|---|
| S 4 / S 8 / S 16 | Switching actuator | switch / light |
| D 2 / D 4 | Dimming actuator | light (with brightness) |
| J 4 / J 8 | Blind / shutter actuator | cover (position + tilt) |
| H 6 | Heating actuator | climate (setpoint + valve) |
| RTR 718 | Standalone room thermostat | climate (setpoint + current temp) |
| B 6 | Binary input module (6-channel) | binary_sensor |
| KNX weather station | Multi-sensor | sensor (temperature, wind, brightness) + binary_sensor (rain) |
| Motion detectors | Binary input | binary_sensor |
| Window / door contacts | Binary input | binary_sensor |
Not yet tested / known limitations:
| Device / feature | Status |
|---|---|
| Multi-gang switches with mixed functions | Not tested |
| Scene actuators | Not supported — no LXP role mapping |
| KNX-RF (wireless) devices | Not tested |
| Energy metering actuators | Not tested |
If your device works or doesn't work, please open an issue so we can update this list.
The integration is configured entirely via the UI config flow. Key parameters:
| Parameter | Where | Description |
|---|---|---|
| LXP project file | Setup | The .lxp file exported from LUXORplug. Upload via file picker. |
| Gateway host | Setup | IP address of the BAOS 777 IP1 gateway (e.g. 192.168.1.3). |
| Port | Setup | KNX/IP port — default 3671. |
| Username / Password | Setup | BAOS 777 REST API credentials — factory default is admin / admin. |
| Connection type | Setup | Tunneling (point-to-point, recommended) or Routing (multicast). |
| Push token | Options | Optional token for the /api/luxor_living/push webhook endpoint. |
| Push auth method | Options | none · token (X-LUXOR-PUSH-TOKEN header) · bearer · hmac (SHA-256). |
The gateway password is stored in HA's encrypted config-entry storage — it is never logged in plain text.
| Limitation | Notes |
|---|---|
| SSL certificate | The BAOS 777 uses a factory self-signed certificate. Certificate verification is intentionally disabled; a custom CA is not supported by the hardware. |
| Scene actuators | No LXP role mapping exists for scenes — entities are not created. |
| Multi-gang switches with mixed functions | Not tested; entity detection relies on datapoint heuristics which may misidentify channels. |
| KNX-RF wireless devices | Parsed, but RF-only devices without wired group addresses may not produce entities. |
| Energy metering actuators | Not tested. |
| LXP reload without HA restart | Use the Reload integration service action. Changing the LXP file requires a reconfigure flow (no entities are removed from the registry automatically). |
| No zeroconf auto-discovery | Gateway must be configured manually; IP address is not auto-discovered at setup time. |
- Go to Settings → Devices & Services → LUXORliving → ⋮ → Delete.
- HA removes all entities and the config entry automatically.
- To fully clean up, restart HA after deletion so lingering KNX group address listeners are released.
If installed via HACS: open HACS → Integrations → LUXORliving → Remove after deleting the config entry.
Found a bug? Open an issue · Security issue? See SECURITY.md
MIT · Built with xknx · Made for Theben LUXORliving
