Create components from the KNX project structure in Boss’nX

The Structure step of the Boss’nX KNX commissioning turns the group addresses classified by the dictionary into components ready to create, each with its type, its location and its command and feedback datapoints. There you review the proposals, adjust names and destinations, then create the components in a single operation.

Intended for administrators and installers with Manage topology and Manage components. To update components already created from a new file, follow the KNX project reimport.

Before you start

• You work on a computer, in the building supervision. From hypervision, first enter the relevant supervision.
• The KNX file is imported and its dictionary saved with a classification available: see the project import and the dictionary.
• The Master Gateway (optional) has been checked in the Import step. Do this before preparing your final selection: going back and forth between steps may force you to redo the review adjustments.

Open and read the structure

1. Open Menu → KNX commissioning, then the Structure step.
2. In KNX structure and grouped addresses, each row prepares a component with its Type, its Location and its Points. A detected row is not yet a saved component.
3. Click the row or its chevron on the right, Expand datapoints of …. Check the names, addresses and DPTs under Command and Feedback. Opening another row collapses the previous one.
4. The Points pill distinguishes groups, commands and feedbacks; its tooltip gives the details. Also check the addresses themselves, especially the command/feedback pairings.
5. If Already imported, To merge, Conflict or Ambiguous badges appear, read rerunning an import on existing components before starting the operation.

Show non-importable items (N) reveals Unknown or Excluded items, which are hidden by default. Their checkboxes stay disabled: to make them importable, first correct the relevant rules in Dictionary, then check the new classification. Do not create a component whose addresses or DPT remain uncertain.

Search and filter the rows

• Search a component… searches component names, detected paths and categories. To search for a KNX address, use Group addresses in Dictionary instead.
• The Location and Type tabs change how the list is grouped.
• The Location button with a chevron opens a space filter; it does not change a component’s destination. Check a space to show its content and its descendants. Included via parent indicates that a child is already covered by the checked parent: remove that parent to choose only certain children. Reset, next to this filter, removes the space filter.
• Filter opens the type chips. Click the types you want; Reset tags removes these filters. These chips filter the list without selecting the components.

Select the components to create

1. Check Include, to the left of each row to create. Clicking the rest of the row opens its details.
2. Select all adds the importable rows matching the current filters and search. A header’s checkbox selects the importable rows of that group in the filtered view.
3. Clear selection clears the entire selection, including hidden rows. You can then rebuild a precise selection.
4. Before continuing, clear the search and the filters to review all your selections.

Hiding a row does not deselect it. The number on the Create N components button also counts selections that are currently hidden.

Rename a component

Hover over the name of the future component and click the Rename component pencil. Enter the Component name, then confirm with the Confirm name check mark, the Enter key or by leaving the field. The Cancel rename cross discards the entry.

In the details of a datapoint group, the Label field lets you prepare the datapoint’s label; confirm with Enter or by leaving the field.

Choose the destination floor or zone

The destination is set in the cell of the Location column, on the relevant row:

1. Open this cell. It can show Auto, a path, Set location… or Unassigned.
2. In Choose a location, choose a Floor or a Zone. Search a space… narrows the search; also check the parent path to distinguish similar names. The existing badge indicates a space that is already saved; the other suggestions come from the detected spaces.
3. Auto (detected) restores the destination deduced from the imported project. Unassigned prepares this single component without a floor or zone. Clear the menu search to find these two choices again.
4. Review the path shown in the cell.

Components are assigned to a floor or a zone: the menu does not offer a building part alone as a destination. If a space is missing from a long list, narrow the search. The Location filter and grouping in the toolbar follow the detected spaces: they do not move the row according to your new destination.

Create the components

1. In Structure, finish entering the last field, then review the selection, names, destinations, addresses and DPTs.
2. Click Create N components. This button starts the operation: do not systematically expect an additional confirmation. The spaces needed by the new components can be created with them. Components that are already matched can be updated according to the reimport procedure.
3. Wait for Creating… to finish and read all the messages. A success accompanied by errors is a partial result.

Import without assignment, below the main button, imports the selection without creating spaces and without assigning the components to a floor or zone. Reserve this choice for new components that you will then place in their form. To update existing components, follow the reimport procedure with the main button: this link is not equivalent to a merge.

Preparing the review does not save the components. Once a creation or an update has started, leaving the step or clicking Cancel in another window does not undo operations that have already succeeded.

Check the result

1. In Components, find and open the saved components.
2. Check their name, gateway, floor, zone and datapoints.
3. To complete a configuration, use the component form and the KNX datapoints.

A component’s presence in the list concerns its configuration: communication with the hardware is checked separately.

Troubleshooting

• Empty list, greyed-out checkboxes, number to create different from the list, missing or uncertain destination: follow the structure troubleshooting guide.
• Partial or unknown result: check what was saved before resuming, as described in that same guide.

If the problem persists, contact support@can-nx.com.

French labels: Menu → Mise en service KNX → Structure, Structure KNX et adresses groupées, Inclure, Tout cocher, Tout décocher, Filtrer, Réinitialiser les tags, Localisation, Choisir une localisation, Auto (détecté), Non localisé, Créer N composants.