> 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/dispositivi/generale.md). # Generale La scheda **"Generale"** mostra i dati principali del dispositivo e offre le principali funzioni di gestione. ## Intestazione del dispositivo La sezione superiore mostra l'icona e il nome del dispositivo: * **Icona** – Fai clic sull'icona per modificarla. Si apre una finestra di selezione con tutti i simboli disponibili. Scegli un simbolo che rappresenti al meglio il dispositivo. Per alcuni dispositivi (ad es. OpenWeather) l'icona è fissa e non può essere modificata. * **Nome** – Fai clic sul nome per modificarlo. Il nome è utilizzato in tutte le liste, nell'app e nelle automazioni. * **Ultimo aggiornamento / Creato** – Indica quando il dispositivo ha modificato l'ultimo valore e quando è stato creato. ## Informazioni sul dispositivo A seconda del tipo di dispositivo, vengono mostrati i seguenti campi: * **Zona** – Indica la zona (piano) a cui appartiene il dispositivo tramite la sua stanza. * **Stanza** – Usa la lista di selezione per assegnare il dispositivo a un'altra stanza. Le stanze sono raggruppate per zone. I dispositivi senza stanza finiscono nella **Stanza predefinita**. * **Controller** – Nelle configurazioni di management, indica su quale controller è registrato il dispositivo. * **Piattaforma** – La piattaforma del skill sottostante (ad es. KNX, ZigBee, Z-Wave, Matter, MQTT). * **Categoria / Tipo** – La categoria del dispositivo (Illuminazione, Termostati, ...) e il tipo specifico. Per alcuni dispositivi (ad es. Interruttore ↔ Lampadina) puoi cambiare il tipo tramite la lista di selezione. * **Direzione** – Solo per coperture finestre: definisce se la copertura funziona in orizzontale o verticale. * **Produttore / Modello / Numero di serie / Versione / Firmware** – Informazioni hardware, se fornite dal skill. * **Qualità del collegamento** – Per dispositivi wireless (ZigBee, Z-Wave), la qualità di connessione attuale in percentuale. * **Batteria** – Per dispositivi a batteria, il livello di carica attuale. * **Stato** – Mostra **OK**, **"Dispositivo non raggiungibile"** o **"Connessione scarsa"**. Per dispositivi non raggiungibili viene mostrato anche l'orario dell'ultima comunicazione riuscita. * **Compatibilità / Certificato da nomos system** – Mostrato per dispositivi dalla libreria online. ## Azioni I pulsanti alla fine della sezione informazioni: * **Apri nell'app nomos system** – Apre il dispositivo direttamente nella vista integrata dell'app. * **Registro** – Salta al log di sistema filtrando per questo dispositivo. * **Aiuto / Supporto** – Apre (se disponibile) la pagina di aiuto specifica del produttore o del skill. * **Modifica / Configurazione** – Per dispositivi KNX, Z-Wave, ZigBee e Wiser: apre la pagina di configurazione specifica del skill. * **Elimina dispositivo** – Rimuove il dispositivo dal sistema. Le dipendenze esistenti (automazioni, scene) vengono mostrate in anticipo. ## Configurazione (solo per Addon) Se il dispositivo è stato aggiunto tramite un **Skill Addon**, appare qui un blocco con i parametri specifici dell'addon (ad es. IP del server, porta, nome utente, password, Attivo, Debug). Applica le modifiche con **"Salva"**. ## Webhook (solo per dispositivi supportati) Alcuni dispositivi possono essere aggiornati da sistemi esterni tramite richiesta HTTP. Questa sezione mostra gli URL webhook (HTTP e HTTPS) da inserire nel sistema esterno. Le proprietà supportate sono elencate sotto. L'icona appunti copia gli URL. ## Impostazioni A seconda del tipo di dispositivo, qui possono essere abilitate opzioni aggiuntive: * **Dispositivo abilitato nelle funzioni centrali** – Solo per Illuminazione, Coperture finestre, Termostati e Music Player. Determina se il dispositivo risponde alle funzioni centrali. * **Condividi con Management** – Se il sistema fa parte di una configurazione di management, il dispositivo può essere passato al management. ## Associazioni Mostra tutti gli oggetti nel sistema che usano questo dispositivo: * **Dispositivi** – Altri dispositivi collegati a questo. * **Quick Config** – Quick Config che usano questo dispositivo come trigger o azione. * **Automazioni** – Regole di automazione che usano questo dispositivo. * **Scene** – Scene in cui il dispositivo compare. * **Pianificazioni** – Pianificazioni che controllano questo dispositivo. * **Telecamere** – Telecamere collegate a questo dispositivo. I link navigano direttamente all'oggetto corrispondente. Controlla questa lista prima di eliminare un dispositivo per evitare di rompere accidentalmente automazioni o scene. --- # 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/dispositivi/generale.md?ask=&goal= ``` `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.