> For the complete documentation index, see [llms.txt](https://documentation.nomos-system.com/nomos-system/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.nomos-system.com/nomos-system/integratore-it/competenze/knx/impostazioni-knx.md).

# Impostazioni KNX

Sotto **Impostazioni**, può inserire le impostazioni di rete KNX specifiche. Una configurazione corretta e fondamentale per il funzionamento del Suo sistema di domotica.

1. **Tipo di connessione:**
   * Scelga tra le seguenti modalità, in base alle condizioni e ai requisiti locali:
     * **Tunneling** — connessione punto-punto a un'interfaccia o a un router KNX/IP.
     * **Tunneling Secure** — come Tunneling, ma cifrato secondo KNX/IP Secure (AN161). Richiede un file di chiavi ETS (`.knxkeys`) oppure l'inserimento manuale della password utente e del codice di autenticazione del dispositivo.
     * **Routing** — connessione multicast senza stato nel backbone KNX, di default tramite `224.0.23.12`.
     * **Routing Secure** — multicast come Routing, ma cifrato con la chiave backbone (AN159). Un file di chiavi ETS è obbligatorio.
     * **Tunneling + bridge di routing** — connessione tunnel all'impianto con un ulteriore bridge multicast verso la rete locale (per app KNX e dispositivi IP che non possono raggiungere direttamente il router).
2. **IP del dispositivo:** (solo varianti Tunneling)
   * Campo di immissione: indirizzo IP dell'interfaccia o del router KNX/IP. Si assicuri che l'indirizzo sia raggiungibile e nella stessa sottorete del sistema.
3. **IP multicast:** (solo varianti Routing)
   * Campo di immissione: indirizzo multicast dell'impianto KNX. Il valore standard `224.0.23.12` è quello consueto; lo modifichi solo se indicato dall'integratore.
4. **Porta:**
   * Campo di immissione: La porta utilizzata per la comunicazione KNX (`3671`). Questa è la porta predefinita. Modifichi la porta solo se assolutamente necessario e solo se sa quale porta deve essere impostata.
5. **Indirizzo fisico:**
   * Campo di immissione: Inserisca qui l'indirizzo fisico dell'interfaccia KNX nella rete KNX.
6. **Formato indirizzo:**
   * Selezione: Il formato dell'indirizzo usato per visualizzare la comunicazione KNX (a due o tre livelli).
7. **KNX/IP Secure:** (solo Tunneling Secure e Routing Secure)
   * **ID utente tunnel** (solo Tunneling Secure): selezione dello slot di tunnel sull'interfaccia/router. Il valore predefinito è `2` — ETS assegna automaticamente questo slot al primo utente tunnel. Se l'impianto dispone di più slot di tunnel (ad esempio condivisi con altri client di terze parti), inserisca il numero di slot riservato a Nomos (1–127).
   * **Da file di chiavi:** Metodo consigliato. Carichi il file `.knxkeys` esportato da ETS e inserisca la password di esportazione. La password utente e il codice di autenticazione del dispositivo vengono recuperati automaticamente dal file di chiavi in base all'ID utente tunnel.
   * **Inserimento manuale:** Per impianti senza esportazione ETS. Oltre all'ID utente tunnel, inserisca la **password utente** e il **codice di autenticazione del dispositivo**. L'inserimento manuale non è disponibile per Routing Secure — la chiave backbone proviene esclusivamente dal file di chiavi.
8. **Strumenti:**
   * Qui può eliminare tutti gli indirizzi di gruppo non utilizzati. Questa funzione e pensata per pulire il sistema da dati non utilizzati e prevenire carico non necessario. Faccia attenzione, usi questa funzione solo quando l'integrazione del progetto e completa e tutti gli indirizzi/dispositivi/oggetti necessari sono stati configurati.

<figure><img src="/files/WUhia3XUIMhkRGvZvNLm" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.nomos-system.com/nomos-system/integratore-it/competenze/knx/impostazioni-knx.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
