--- title: Add KNX group addresses in bulk to a Boss’nX component description: Select up to 100 KNX group addresses from the project, for read or write, and create a Boss’nX component’s datapoints in one go before saving it. canonical: https://wiki.can-nx.com/en/guides/boss-import-knx/ language: en product: Boss’nX audience: - administrateur - installateur context: "Boss’nX on a computer: Bulk add points window of the component editor" --- # Add KNX group addresses in bulk to a Boss’nX component Context: Boss’nX on a computer: Bulk add points window of the component editor The **Bulk add points** window of the Boss’nX component editor creates datapoints in one go from the KNX group addresses already available in Boss, each one for read or write, up to 100 per addition. This path is for an administrator or installer, on a computer. It does not perform the initial import of a KNX project file, and it is separate from the [KNX bus scan in Network health](https://wiki.can-nx.com/en/guides/boss-health-scan/), which detects physical devices to monitor. ## Before you start - Your role has **Manage components** and you are working in the relevant supervision. - The KNX project addresses are available in Boss. Otherwise, start by [importing a KNX project file](https://wiki.can-nx.com/en/guides/boss-knx-project/). - The installer has confirmed the addresses to use and the **Gateway** intended for the component. ## Open the KNX bulk add 1. Open **Components** in your bar or through **Menu → Components**, then the **Edit component** pencil. For a new component, use **Add component** and fill in its general settings according to [the common form](https://wiki.can-nx.com/en/guides/boss-component-edit/). 2. Check the **Gateway** intended for the component. 3. Under the datapoints, click **Import**, or its small arrow on the right, then choose **KNX**. The **Bulk add points** window opens. ## Select addresses one by one 1. Expand the address groups with their chevron, for example `1/*` then `1/0/*`, fictitious examples. You can also use **Search by address (e.g., 1/2/3) or name...**: the search shows the results as a list. 2. On each address you want, check the name and the DPT. 3. Click **Read** or **Write** according to its use. The choice selects the address with this mode. In this window, an address is added with only one of these modes; the datapoint can then be completed in the editor. 4. Check the checked boxes and the counter. Clicking the mode already selected again removes the address from the selection; a checked box can also be unchecked. An address’s plain checkbox suggests **Read** when its read indication is present, otherwise **Write**. Choose the confirmed mode rather than automatically keeping this suggestion: the buttons are configuration choices and do not tell you whether the device accepts a command. **Already used** indicates that the address already appears in the component’s datapoints, for reading or command. In this KNX import, this indication **does not prevent you from selecting it**: check the existing use before creating another datapoint with the same address. ## Select a whole group - On a group’s header, **Read** or **Write** selects the addresses of this group in the chosen mode. The tooltips are **Select all as read** and **Select all as write**. Check the group’s scope and the counter before confirming. - The checkbox of an unselected group suggests read; if the group’s selection is complete or partial, it removes it. - A group’s small cross, **Deselect all**, removes the selections of that group. **Clear all** resets the entire selection. ## Respect the limit and link the datapoints - The maximum is **100 datapoints per addition**. If **Limit of 100 reached** appears, remove selections or proceed in several additions. - From two selections onward, **Link points together** offers to group how they are presented. This grouping does not send a common command to the datapoints. See [linking and unlinking datapoints](https://wiki.can-nx.com/en/guides/boss-component-copy-points/). ## Add the datapoints and save the component 1. Click **Add N point(s)**, where **N** is the number selected. The window closes and the new datapoints appear in the form. **The component is not saved yet.** 2. Review the labels, DPTs, addresses and **Cmd / Feedback**, then the gateway and any groups. To complete the status feedbacks or commands, see [KNX datapoints](https://wiki.can-nx.com/en/guides/boss-point-knx/) and [their presentation](https://wiki.can-nx.com/en/guides/boss-point-display/). 3. Leave the last field, then click **Create** or **Save**. To back out: **Cancel** or the cross at the top right closes the selection without adding its datapoints. After adding them to the form, remove a datapoint added by mistake with its trash can, then save. **Back** before saving discards the component’s pending changes; it does not cancel a previous save. ## Check the result - After returning to the original page, reopen the component and check the datapoints that were kept. - Then check reading and commands for these datapoints on the installation: their presence does not certify communication with the hardware. ## Troubleshooting | Situation | What to do | | --- | --- | | **KNX** choice grayed out with **No KNX address available** | Check the supervision and that the expected KNX project is present. Choosing a gateway does not by itself provide a list of addresses. To prepare the initial list, import the KNX project file. | | **No results** | Clear the search with its small cross, then try part of the name or a confirmed address. A search with no results does not indicate a KNX failure. | | The counter keeps datapoints after a search | Changing the search does not empty the selection. Review the total, clear the filter to see the addresses again, or use **Clear all** to start over. | | The **Add** button is grayed out | Select at least one address and wait for any operation in progress to finish. | | Error after **Create / Save** | Follow [the common form troubleshooting](https://wiki.can-nx.com/en/guides/boss-component-edit/), without immediately creating a duplicate. | ## Contact support If the confirmed project remains unavailable after its import, write to support@can-nx.com with the supervision, the component, the message and the tests already done. French labels: **Composants**, **Menu**, **Modifier le composant / Ajouter un composant**, **Import → KNX**, **Ajout multiple de points**, **Lecture / Écriture**, **Déjà utilisé**, **Lier les points ensemble**, **Tout effacer**, **Ajouter N point(s)**, **Annuler**, **Créer / Enregistrer / Retour**.