Skip to main content

Rooms & devices

The Rooms & devices tab on a project detail shows the physical structure of the building as KNX sees it — a tree of rooms, each containing one or more devices. The structure is populated by parsing the latest uploaded ETS file (see ETS files).

Rooms and devices view with a collapsible tree on the left (floors and rooms) and a device list on the right showing device name, manufacturer, model, KNX address, and type.

Left pane — room tree​

The tree is grouped by floor and then by room name. Rooms with no floor land under "Unassigned". Selecting a room filters the right-pane device list to just that room.

Each room card shows:

  • Room name
  • Floor label (if any)
  • Device count

Right pane — device list​

The device list is a sortable, filterable list of device cards. Each card shows the device name, manufacturer, model, KNX address, device type, and the room it's assigned to. Filter by room from the left tree, or use the search box at the top of the list to narrow by name / manufacturer / address.

Click a card to expand it. The expanded card shows the full record plus:

  • Linked group addresses (see Group addresses).
  • Catalog match — if the manufacturer/model combo was matched to the KNX Clarity Catalog, click "Datenblatt anzeigen" / "Show datasheet" to reveal the datasheet, product image, and documentation link inline.
  • Notes field — an editable plain-text field stored on the device. Useful for commissioning notes that should not live in the ETS description.
The project's Devices tab: a list of device cards, each showing device name, manufacturer, model, KNX address, type, and assigned room. Catalog-matched devices reveal their datasheet inline.

Manual edits​

Anyone with the admin or technician org member role can edit a device's name, description, and notes directly on the card via the inline pencil icon. These edits are not overwritten on the next ETS upload as long as the device's KNX address does not change — we match by address when reconciling, so a rename in ETS is a rename in KNX Clarity but a rename in KNX Clarity stays a rename in KNX Clarity.

Edits that ETS will overwrite

The manufacturer, model, and device-type fields come straight from ETS and are re-synced on every upload. Don't rely on them to store anything other than what ETS said. Put free-form notes in the Notes field instead.

Why a device might be missing​

  • The device was added in ETS but the ETS file hasn't been re-uploaded yet. Upload the latest version.
  • The parser silently dropped a malformed device. Open the version on the ETS files tab; parser errors are logged to the comment field on the version row.
  • The device exists in an earlier ETS version but was deleted in the latest one. KNX Clarity does not retain "deleted" devices — it reflects whatever the most recent export contains.