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).
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 table. Columns:
| Column | Source field |
|---|---|
| Name | devices.name |
| Manufacturer | devices.manufacturer |
| Model | devices.model |
| Address | devices.knxAddress |
| Type | devices.deviceType |
| Room | join to rooms.name |
Click a device row to open the device drawer on the right side of the screen. The drawer shows the full device record plus:
- Linked group addresses (see Group addresses).
- Catalog match — if the manufacturer/model combo was matched to the KNX Clarity Catalog, you'll see the datasheet, product image, and documentation link.
- Notes field — an editable plain-text field stored on the device record. Useful for commissioning notes that should not live in the ETS description.
Manual edits
Anyone with the admin or technician org member role can edit a
device's name, description, and notes directly from the
drawer. These edits are not overwritten on the next ETS upload
as long as the device's knxAddress does not change — we match by
address when reconciling, so a rename in ETS is a rename in KNX
Cloud but a rename in KNX Clarity stays a rename in KNX Clarity.
The manufacturer, model, and deviceType 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.