Vai al contenuto
Sito
🧱 CCC 238Domotica KNX: topologia, indirizzamento e parametrizzazioneCapitolo 10 su 10 della sezione

Consegnare le chiavi del bus: file di progetto, formazione e subentro di terzi

Questo capitolo illustra in dettaglio le regole tecniche e contrattuali per concludere l'integrazione KNX: la restituzione del progetto software completo e aggiornato, la redazione del promemoria di gestione per il committente, i punti chiave della trasmissione per garantire un subentro sereno da parte di un collega e la formulazione contrattuale della proprietà intellettuale della parametrizzazione.

Punti chiave

  • Il file di progetto ETS costituisce un elemento contrattuale dovuto al committente.
  • La mancata consegna della parametrizzazione blocca la manutenzione e danneggia gravemente la reputazione dell'installatore.
  • Un sintetico promemoria d'uso evita chiamate inopportune e assicura l'autonomia degli utenti finali.
  • Un'architettura di gruppo documentata consente il subentro nell'installazione da parte di un altro telematico.

Trasmettere il file di progetto ETS e chiarire la proprietà intellettuale

Alcuni integratori considerano a torto il database ETS come un segreto industriale o uno strumento di vincolo commerciale per costringere il gestore a commissionare interventi successivi. Questa pratica è controproducente. Nel diritto svizzero della costruzione, secondo l'Art. 363 CO che definisce il contratto d'appalto, l'artigiano si impegna a consegnare un'opera compiuta e utilizzabile. In un impianto di automazione degli edifici o di domotica residenziale, l'opera non comprende solo i moduli montati su guida DIN e gli accoppiatori di linea: include indissolubilmente l'intelligenza integrata in questi apparecchi, materializzata dalla parametrizzazione delle funzioni logiche, dagli indirizzi di gruppo e dalle associazioni degli oggetti di comunicazione.

Trattenere l'archivio software espone l'azienda a contestazioni formali e distrugge il rapporto di fiducia con il cliente o la direzione lavori. Se un terzo deve intervenire per riparare un micromodulo difettoso o riconfigurare un comando di illuminazione senza il file sorgente, il reverse engineering tramite l'ascolto dei telegrammi sul bus o la ricostruzione manuale comporta costi aggiuntivi ingenti che il cliente cercherà legittimamente di addebitare al primo installatore. Al collaudo dell'opera, la documentazione dell'opera eseguita deve quindi integrare l'esportazione del progetto ETS, idealmente nel formato di archivio standard (.knxproj), protetto e ripulito.

Componenti dell'archivio software e documentale da consegnare al gestore
Elemento della documentazioneFormato previstoFinalità per il gestore e il subentrante
Archivio del progetto ETSFile .knxproj non protettoRiprogrammazione, sostituzione di apparecchi, ampliamento funzionale.
Rapporto di progetto ETSDocumento PDF sinteticoInventario degli indirizzi fisici, topologie di linea e accoppiatori.
Tabella degli indirizzi di gruppoEsportazione CSV o foglio di calcoloComprensione della struttura a 3 livelli (funzione / locale / azione).
Chiavi di sicurezza KNX SecureFile di certificato del ringAccesso agli apparecchi sicuri in caso di ampliamento successivo.

La menzione contrattuale della proprietà della parametrizzazione deve essere chiarita fin dall'offerta iniziale. Il testo del contratto d'appalto deve precisare che il cliente acquisisce la piena fruizione della parametrizzazione integrata nel suo edificio una volta saldata la fattura finale, mentre l'integratore conserva il proprio know-how generico o i propri blocchi logici preconfigurati sotto forma di licenza d'uso non esclusiva. Questa clausola previene qualsiasi controversia di natura intellettuale confermando al contempo il trasferimento dei dati operativi dell'opera.

Organizzare la formazione del gestore e preparare il subentro di terzi

Un'installazione domotica consegnata senza supporto umano genera sistematicamente richieste improprie e frustrazioni d'uso. La consegna delle chiavi del bus impone una sessione di formazione dedicata, di durata adeguata alla complessità del sito: circa un'ora per una villa unifamiliare, mezza giornata per un edificio terziario o amministrativo. Questo avviamento si svolge sul cantiere, in condizioni reali di esercizio, alla presenza degli utenti principali, dei custodi o del responsabile tecnico degli impianti.

  1. Dimostrazione dei comandi localiPresentare il funzionamento dei pulsanti a parete, le pressioni brevi e prolungate per la dimmerazione, il richiamo degli scenari e il funzionamento dei termostati ambiente integrati.
  2. Spiegazione degli automatismi e delle sicurezzeDescrivere in dettaglio i comportamenti autonomi del sistema: rientro automatico delle lamelle/tende in caso di vento forte tramite stazione meteo, forzatura delle luci di emergenza, deroghe manuali e temporizzazioni.
  3. Apprendimento delle interfacce di supervisioneGuidare il gestore sullo schermo touch centrale o sulle applicazioni mobili dedicate: gestione dei profili orari, modifica delle temperature nominali e tacitazione delle anomalie tecniche.
  4. Consegna del promemoria d'uso sinteticoFornire un documento plastificato da due a quattro pagine, conservato vicino al quadro di comando o al server locale, che riepiloghi le operazioni correnti e la procedura da seguire in caso di anomalia.

Il promemoria d'uso non sostituisce il manuale d'uso completo, ma sintetizza le informazioni essenziali. Deve riportare il piano di indirizzamento IP dei gateway e dei server di visualizzazione, le credenziali di accesso amministratore e utente, nonché la procedura di riavvio corretto di un'interfaccia in caso di blocco della rete. Deve precisare esplicitamente la separazione delle responsabilità tra il comando KNX e gli organi terminali.

La garanzia per i difetti si applica secondo le regole del Codice delle obbligazioni (CO). L'Art. 368 CO riserva al committente i suoi diritti in caso di difetti riguardanti le prestazioni pattuite. Tuttavia, dal momento in cui un terzo interviene sul bus e scarica una nuova programmazione senza previo accordo, la responsabilità dell'integratore originario decade sui componenti modificati. Per prevenire contestazioni incrociate, l'azienda consegna l'archivio ETS su supporto fisico (chiavetta USB) sigillata alla firma del verbale di collaudo, conservando una copia speculare con marcatura temporale nei propri archivi tecnici aziendali.

La mancata cessione del progetto knxproj: illusione commerciale e rischi tecnici

Alcuni integratori considerano ancora il file di progetto nel formato standardizzato di esportazione come una proprietà riservata, concepita per garantire un monopolio sulle successive operazioni di manutenzione o riparazione. Nella prassi delle finiture, questo trattenimento delle informazioni costituisce una strategia sistematicamente perdente. Degrada il rapporto di fiducia con il committente, blocca gli interventi urgenti ed espone l'installatore a contestazioni durante il collaudo dell'opera secondo la norma SIA 118.

Sul piano tecnico, un bus il cui database viene sequestrato diventa un sistema opaco per il gestore. A differenza dei PLC industriali il cui codice sorgente può talvolta essere protetto da licenza proprietaria, l'infrastruttura di un edificio terziario o residenziale complesso deve rimanere durevole, indipendentemente dalla continuità commerciale dell'azienda di installazione iniziale. Bloccare il file costringe un terzo a ricostruire la topologia tramite reverse engineering in caso di guasto hardware, con conseguenti costi di ingegneria sproporzionati.

Contenuto del fascicolo tecnico consegnato al gestore durante il collaudo
Documento o elemento dovutoFormato tecnicoFinalità per il gestore o il subentrante
Archivio completo del progettoFile di archivio software (.knxproj)Subentro integrale nella parametrizzazione, aggiunta di apparecchi e diagnosi degli indirizzi di gruppo.
Rapporto di progetto e topologiaDocumento stampabile o PDFVisualizzazione della struttura ad albero delle linee, degli accoppiatori e degli indirizzi individuali senza software di programmazione.
Elenco degli indirizzi di gruppoTabella strutturata o foglio di calcoloCorrispondenza univoca tra funzioni di comando, stati di ritorno e oggetti di comunicazione.
Set di chiavi di sicurezzaFile di chiavi protette (.knxkeys)Accesso indispensabile agli apparecchi che utilizzano il protocollo KNX Data Secure o KNX IP Secure.
Backup dei gatewayFile immagine o configurazioni di sistemaRipristino rapido dei moduli di supervisione, dei server di visualizzazione e dei gateway verso protocolli terzi.

Tutela contrattuale, promemoria d'uso e passaggio di consegne tecnico

La trasmissione della parametrizzazione deve essere chiarita fin dall'assegnazione dell'ordine. Nell'ambito di un contratto d'appalto ai sensi dell'Art. 363 CO, il lavoro intellettuale di indirizzamento, collegamento degli oggetti di comunicazione e parametrizzazione degli apparecchi è parte integrante dell'opera commissionata e retribuita dal committente. L'Art. 364 CO impone all'appaltatore un'esecuzione fedele e diligente, il che implica fornire al gestore i mezzi concreti per gestire la manutenzione del proprio impianto.

Per evitare qualsiasi controversia, le condizioni particolari del preventivo o dell'offerta di gara devono indicare esplicitamente lo status dei dati. Una formulazione rigorosa precisa che l'integratore cede l'uso esclusivo della parametrizzazione applicata al sito sin dal pagamento integrale delle prestazioni, consegnando un archivio sbloccato su supporto rimovibile all'interno dell'armadio principale di permutazione o di distribuzione.

Il passaggio di consegne non si limita alla cessione dei file grezzi. L'installatore dedica una sessione formale alla formazione del responsabile tecnico del sito o del proprietario. Questa sessione si basa su un promemoria d'uso sintetico: procedura di sezionamento e riarmo dell'alimentatore bus con bobina di blocco, interpretazione dei LED di stato degli accoppiatori di linea, localizzazione dei backup hardware e modalità di accesso locale alle interfacce di amministrazione senza dipendere da un portale remoto.

Consegnando un fascicolo impeccabile, l'azienda valorizza il proprio rigore professionale. L'esperienza dimostra che un cliente in possesso di tutti i propri accessi e database ricontatta spontaneamente il tecnico originario per i futuri ampliamenti, mentre la mancata consegna illegittima porta invariabilmente a rescissioni contrattuali e notifiche di difetto dell'opera.

Gestione delle controversie, blocchi e subentro forzato in un'installazione orfana

Quando un integratore rifiuta di cedere l'archivio `.knxproj` o il fascicolo tecnico va perso a seguito del fallimento di un fornitore, il gestore si ritrova vincolato a un sistema bloccato. Sul piano contrattuale svizzero, il database parametrizzato costituisce una componente indissociabile dell'opera consegnata, allo stesso titolo degli schemi elettrici o dei verbali di controllo. In assenza di questo file nativo contenente le associazioni e i parametri applicativi, qualsiasi modifica dell'indirizzo di gruppo o qualsiasi sostituzione di un attuatore diventa impossibile senza sovrascrivere la programmazione esistente. Il committente subisce quindi un danno diretto all'esercizio. Secondo l'Art. 368 CO, il committente può far valere i propri diritti in caso di difetti dell'opera, esigendo l'eliminazione dei difetti o il risarcimento dei danni qualora manchino i documenti contrattuali dovuti.

  1. Audit passivo e ascolto del busCollegare un'interfaccia di comunicazione IP o USB al bus, attivare il monitor di gruppo ETS per diverse ore di esercizio per mappare i telegrammi scambiati e registrare gli indirizzi di gruppo attivi.
  2. Scansione fisica e riscontro con il quadroAvviare una scansione di linea per identificare ogni singolo indirizzo fisico presente, quindi confrontare questi indirizzi con lo schema unifilare a corrente debole presente nell'armadio.
  3. Ricostruzione in un nuovo progetto ETSReimportare i programmi applicativi certificati dei produttori, ricreare la struttura dei locali e sovrascrivere la parametrizzazione apparecchio per apparecchio per risanare l'impianto.

Prima di qualsiasi azione giudiziaria, una diffida scritta basata sulle norme contrattuali e sulla norma SIA 118 è generalmente sufficiente a sbloccare l'esportazione del file di progetto a fronte del pagamento del saldo pattuito. Se il passaggio di consegne bonario fallisce definitivamente, il nuovo integratore redige una constatazione dello stato di fatto in contraddittorio prima di inviare qualsiasi comando sul bus, delimitando così rigorosamente la propria garanzia rispetto alle programmazioni originali. Questo verbale iniziale registra le funzionalità verificate, i difetti riscontrati e gli apparecchi inaccessibili, garantendo la sicurezza giuridica del nuovo operatore.

Domande frequenti

Cosa fare se la password del progetto ETS o dell'accesso KNX Secure è andata smarrita?

Senza le chiavi di sicurezza KNX Secure (FDSK o certificato di progetto), i dispositivi protetti non possono più essere modificati tramite il bus. L'integratore deve resettare ogni apparecchio alle impostazioni di fabbrica tramite il pulsante di programmazione o una procedura hardware specifica del produttore. Ciò cancella la parametrizzazione residente, imponendo di riscaricare l'intera applicazione da un progetto ETS ricostruito, con conseguente notevole perdita di tempo sul cantiere.

Il gestore può esigere il file ETS se l'importo totale dei lavori non è stato interamente saldato?

Il rifiuto di trasmettere la documentazione tecnica costituisce frequentemente un diritto di ritenzione utilizzato dall'installatore a fronte di un mancato pagamento. Tuttavia, l'Art. 372 CO stabilisce che la mercede è pagabile all'atto della consegna dell'opera. Se il committente trattiene un importo sproporzionato per una controversia minore, entrambe le parti rimangono bloccate. La soluzione abituale consiste nel depositare il saldo controverso su un conto vincolato per svincolare l'obbligo di consegna del file .knxproj.

Quale supporto fisico o digitale privilegiare per archiviare il file di progetto in loco?

Si raccomanda di conservare una chiavetta USB industriale contenente il file .knxproj esportato, gli schemi elettrici e il promemoria d'uso direttamente in una tasca portadocumenti fissata all'interno del quadro domotico. Inoltre, un'esportazione cifrata deve essere trasmessa tramite posta elettronica protetta o salvata sul server locale dell'edificio. Questa ridondanza garantisce che un tecnico intervenuto d'urgenza disponga dei dati senza dover contattare l'azienda che ha eseguito l'installazione iniziale.

Quali precauzioni contrattuali adottare prima di rilevare la manutenzione di un impianto eseguito da terzi?

L'integratore subentrante deve far firmare un verbale di presa in consegna che lo esoneri da responsabilità per qualsiasi vizio pregresso. Inizia richiedendo il progetto ETS originale e ne verifica la rigorosa corrispondenza con l'impianto tramite la funzione di confronto di ETS. In caso di discrepanze o di assenza del progetto, le ore dedicate alla mappatura o alla riprogrammazione del bus non rientrano nel forfait di manutenzione, ma devono essere oggetto di un preventivo preventivo a regia tecnica.

Testi e norme citati

  • SIA 118norme generali per l'esecuzione dei lavori di costruzione
  • CO art. 368diritti del committente in caso di difetti dell'opera: recesso, riduzione del prezzo, eliminazione dei difetti, risarcimento dei danni
  • CO art. 372la mercede è pagabile all'atto della consegna dell'opera

Nella stessa sezione