Editor profilo

Con l'Editor profilo crea profili di dispositivo propri per gli add-on o adatta profili esistenti. Un profilo stabilisce come il nomos system Controller comunica con un dispositivo e che cosa ne compare nell'app, nelle automazioni e nella Quick Config. La struttura di un profilo è descritta in Formato del profilo; la connessione tramite TCP, UDP e HTTP è descritta in CommandServer, esempi pronti in Profili di esempio.

INFO

L'Editor profilo è disponibile se la Sua licenza lo abilita. Senza abilitazione, nell'elenco dei profili mancano la matita e il pulsante Nuovo profilo. Sullo smartphone l'editor è nascosto.

Aprire o creare un profilo

Tutte le strade partono da Competenze → Add-on, nella scheda Profili:

• Nuovo profilo (simbolo più, scorciatoia N): inserisca un Nome e scelga Protocollo, Categoria e Tipo. Il protocollo (CommandServer, KNX, Modbus, MQTT, Z-Wave, ZigBee) determina la struttura di base. Il tipo aggiunge azioni, feedback e modelli adatti, ad esempio per una luce, un dimmer o un inverter. Con Crea si apre l'editor.
• Libreria online: carica un profilo pronto nell'elenco. Per modificarlo, lo apra poi con la matita.
• Caricamento manuale: carica un file di profilo (.json, al massimo 1 MB) nell'elenco. I vecchi file di definizione in formato .csv vengono convertiti in un profilo JSON.
• Matita in una riga dell'elenco dei profili: apre il profilo nell'editor.

Se esiste già un profilo con lo stesso nome, l'importazione lo sostituisce e i dispositivi che lo usano adottano la nuova versione (vedi Aggiornamenti dalla libreria online). Un punto nel nome del file diventa _.

Il modo più rapido è partire da un profilo simile al Suo dispositivo, ad esempio dello stesso produttore o con lo stesso protocollo, e salvarlo come nuovo profilo con Salva con nome.

Struttura dell'editor

In alto c'è la barra con i pulsanti Salva con nome, Annulla e Salva. A sinistra nella barra sceglie quale parte del profilo modificare: il profilo principale o uno dei sottoprofili (vedi sotto). Sotto, l'editor mostra i risultati della verifica, poi le sezioni Informazioni e Impostazioni e sotto ancora le schede.

Verifica

L'editor verifica il profilo a ogni modifica. L'intestazione conta errori (rosso), avvisi (giallo) e note (blu). Se non c'è nulla da segnalare, compare Nessun problema. Ogni riga indica la regola, il punto del profilo e un messaggio (in inglese), ad esempio consistency.polling per polling.Status.

La verifica non impedisce il salvataggio. Corregga comunque gli errori prima dell'uso: indicano quasi sempre un punto in cui il dispositivo in seguito non reagisce o mancano valori.

Informazioni

Campo	Significato
Descrizione	Nome del profilo nell'elenco dei profili e proposta per il nome del dispositivo
Produttore, Modello	Dati del dispositivo
Piattaforma	Origine del dispositivo, ad es. il nome del produttore. Con KNX e Z-Wave è nascosta e predefinita
Versione	Aumenta automaticamente a ogni salvataggio (1.0 → 1.1), finché non la modifica Lei. La versione decide se i dispositivi esistenti adottano una modifica (vedi Modificare un profilo)
Autore	Chi ha creato il profilo
URL di supporto	Indirizzo di una pagina di aiuto sul dispositivo. Compare come pulsante info nell'elenco dei profili e nella pagina del dispositivo

Impostazioni

Campo	Significato
Categoria, Tipo	Determinano il simbolo e la visualizzazione nell'app e se il dispositivo compare tramite il bridge Matter. Scelga il tipo in base al valore più importante: un dispositivo che segnala soprattutto movimento è un rilevatore di movimento, anche se fornisce in più la temperatura
Tipo di motore	Come il Controller comunica con il dispositivo: CommandServer (connessione propria tramite TCP, UDP, HTTP o seriale), MQTT, KNX, ZWAVE o BUS. Il tipo di motore determina quali schede ci sono
Nome classe	Solo con CommandServer: nome interno della connessione, solo lettere maiuscole, cifre, _ e -. Se il campo resta vuoto, l'editor lo forma da produttore e modello
Compatibilità	Quanto completamente il profilo copre il dispositivo, in percentuale
Certificato da nomos system	Bloccato; solo i profili verificati da nomos system riportano qui Sì
Tags	Contrassegni aggiuntivi, separati da virgola o punto e virgola
Visualizzare il dispositivo nelle app	Senza spunta il dispositivo non compare nell'app
Utilizzare il dispositivo con gli assistenti vocali	Senza spunta il dispositivo non viene trasmesso agli assistenti vocali e al bridge Matter

Le schede

Scheda	Contenuto	Tipo di motore
Comunicazione	Impostazioni di connessione: indirizzo, porta, protocollo, tempi limite, raggiungibilità	solo CommandServer
Azioni	Che cosa si può inviare al dispositivo	tutti
Feedback	Quali valori segnala il dispositivo	tutti
Interrogazioni	Comandi inviati regolarmente per leggere valori	solo CommandServer
Telecamere	Immagini delle telecamere fornite dal dispositivo	tutti
Webhooks	Valori che il dispositivo può inviare da sé al Controller tramite HTTP	tutti

In ogni tabella aggiunge una riga con Aggiungi, la elimina con la ✕ rossa e cambia l'ordine trascinandola. I nomi doppi vengono segnati in rosso.

Comunicazione

La tabella ha le colonne Nome, Valore, Modificabile e Commento. Il nome lo sceglie tra le impostazioni note oppure ne inserisce uno proprio con Definito dall’utente.... Che cosa fanno le impostazioni è descritto in CommandServer: Connessione.

• Modificabile: il valore viene richiesto in Crea dispositivo ed è precompilato con il valore inserito. Tipico per l'indirizzo IP del dispositivo, una porta o i dati di accesso.
• Commento: l'impostazione resta nel profilo, ma non ha effetto. È utile per tenere pronti valori che usa solo come segnaposto nei comandi (vedi Segnaposto).

Azioni e Feedback

Le due schede hanno la stessa struttura. Con la barra dei rimandi Comunicazione, Definition e Modelli passa da una sezione all'altra.

Comunicazione (solo CommandServer)

• In Azioni ci sono qui i comandi con Nome, Sequenza, Parametro, Timeout, Spaziatura e Tag; con HTTP anche Metodo e, per POST, PUT, PATCH e DELETE, Tipo di contenuto e Corpo. \# nella sequenza è il posto per il valore che l'azione invia.
• In Feedback ci sono qui i pattern per le risposte del dispositivo con Nome, Match, Azione, Condizione, al cambiamento e Tag.

Il significato di ogni colonna è spiegato in CommandServer.

Definition

Qui stabilisce che cosa vedono l'app e le automazioni. Ogni riga ha Nome, Comando (per le azioni) o Feedback, Tipo di dati e Unità.

• Nome: scelga se possibile uno dei nomi standard proposti, come state, level, position, setpoint o temperature. Solo questi nomi sono noti all'app per i suoi elementi di comando; vedi Nomi standard.
• Comando o Feedback: con CommandServer sceglie un comando o un pattern della sezione Comunicazione. Un comando che inizia con SET o GET viene letto come proprietà: SETCURR scrive la proprietà CURR. Con KNX il campo è predefinito; gli indirizzi di gruppo li assegna solo alla creazione del dispositivo.
• Tipo di dati: null (pulsante senza valore), string, bool, trigger, int o float.
• Unità: per i numeri. In Categorie ci sono unità che l'app converte per l'utente (ad es. temperature), in Unità di misura unità fisse come W o kWh.

La matita a fine riga apre la finestra Dettagli:

Campo	Significato
Descrizione	Etichetta nell'app e nelle automazioni
Gruppo	Sezione in cui l'app mostra il valore, ad esempio «Ricarica» per una wallbox. Utile solo per dispositivi con molti valori
Nascosto	Il valore non compare come riga propria nell'app, ma resta disponibile per le automazioni
Simulare il feedback	Solo azioni: il Controller segnala subito il valore inviato come feedback, per dispositivi senza feedback proprio
Lunghezza max	Solo testo
Min/max dispositivo, Min/max mappato	Scalatura tra il campo di valori del dispositivo e quello in nomos, vedi Scalatura
Unità dispositivo, Kelvin caldo/freddo	Solo per color-temperature: se il dispositivo usa Mired, Kelvin o percentuale
Valore passo	Passo dei cursori
MQTT, Valore MQTT, Unità MQTT, MQTT Payload	Solo MQTT, vedi MQTT
Dimensione in bit	Con KNX la dimensione del punto dati (1, 8, 16, 32 bit)
Filtro KNX DPT	Con KNX: quali tipi di punto dati vengono proposti quando si assegna l'indirizzo di gruppo
Elenco valori	Valori di selezione con testo, ad es. 0 = Spento, 1 = Livello 1
Valore predefinito	Per le azioni il valore inviato in modo fisso (ad esempio 1 per switchon), per i feedback il valore iniziale
Prefisso, Suffisso, Sovrascrittura classe	Solo azioni: testo prima o dopo il valore, invio del comando a un'altra connessione
Funzione di elaborazione	Solo feedback: elaborazione successiva del valore, ad esempio la conversione in un prezzo, vedi Elaborazione
Opzioni di corrispondenza, Volatile, mRemote Join	Per casi particolari; nei profili propri li lasci vuoti

Modelli

I modelli sono le voci che offrono le automazioni e la Quick Config, ad esempio «Accendi» o «Luminosità». Colonne: ID, Nome (l'azione o il feedback a cui si riferisce il modello), Icon, Descrizione, Valore e, per le azioni, Segnaposto, inoltre Configurazione rapida.

• Valore: un valore fisso. L'automazione non mostra allora alcun campo di immissione, ad es. «Acceso» con il valore 1.
• Segnaposto: per le azioni con un valore di testo, un esempio, ad esempio Benvenuto o http://…. Appare in grigio nel campo di immissione ancora vuoto dell'azione nelle automazioni. Se il modello ha un Valore fisso, la colonna è bloccata.
• Configurazione rapida: una spunta nasconde il modello nella Quick Config del dispositivo; nelle automazioni resta selezionabile.

WARNING

Non appena esiste un solo modello, le automazioni offrono solo i modelli e non più tutte le azioni o tutti i feedback. Crei quindi un modello per ogni valore necessario nelle automazioni, oppure nessun modello.

Interrogazioni

Per ogni riga un Nome, un Comando e l'Intervallo di polling (in secondi). Con Modificabile l'intervallo viene richiesto alla creazione del dispositivo. Un profilo HTTP senza interrogazione propria riceve al salvataggio l'interrogazione «Reachable Check», che ogni 30 secondi richiama /, così la raggiungibilità è corretta.

Telecamere

Per ogni riga un URL e un Tipo URL: RTSP, Snapshot, MJPEG o Altri HTTP. Nell'URL possono comparire segnaposto della comunicazione, ad es. http://%SERVERIP%/snapshot.jpg. Alla creazione del dispositivo nasce una telecamera per ogni riga.

Webhooks

Qui sceglie i feedback i cui valori il dispositivo può inviare da sé al Controller, invece di essere interrogato dal Controller. L'indirizzo e come il dispositivo lo richiama sono descritti in Webhooks.

Sottoprofili

Un dispositivo con più parti indipendenti, ad esempio un attuatore a quattro canali, riceve un sottoprofilo per ogni parte. Alla creazione del dispositivo nasce allora per ogni sottoprofilo un dispositivo proprio chiamato «Nome dispositivo Nome sottoprofilo», tutti sulla stessa connessione.

• Creare: nella selezione a sinistra nella barra scelga Aggiungi..., inserisca un ID (lettere minuscole, senza punto né spazi) e, se vuole, un Nome.
• Eliminare: Elimina sottoprofilo nelle informazioni del sottoprofilo. L'eliminazione avviene solo al salvataggio.
• Un sottoprofilo ha solo le schede Azioni e Feedback. Connessione, interrogazioni e telecamere appartengono al profilo principale.

Salvataggio

• Salva riscrive il profilo con lo stesso nome. Funziona anche se ci sono dispositivi che usano il profilo; questi adottano subito la modifica (vedi Modificare un profilo). Il profilo risulta poi modificato nell'Editor profilo.
• Salva con nome crea un nuovo profilo; quello precedente resta invariato. Se il nome è già occupato, viene aggiunto _2, _3 e così via.
• Annulla scarta tutte le modifiche senza chiedere conferma. Il tasto Esc chiede prima conferma. Ctrl+S o ⌘S salva.

Al salvataggio l'editor completa da sé alcune cose:

• La Versione aumenta di uno, se non l'ha modificata Lei.
• Un Nome classe vuoto viene formato da produttore e modello.
• Un pattern nel feedback che non cattura alcun valore riceve =1 dopo il nome (vedi Nome e valore).
• Con KNX e Z-Wave piattaforma e nome classe vengono impostati in modo fisso e il feedback reachable viene rimosso.
• Un profilo HTTP senza interrogazione riceve l'interrogazione «Reachable Check».
• Se cambia il tipo di motore da CommandServer a un altro, al salvataggio si perdono tutte le impostazioni, i comandi e i pattern della comunicazione.

Modificare un profilo

Un profilo modificato vale subito per i nuovi dispositivi. Per i dispositivi che usano già il profilo vale:

• Etichette, gruppi, modelli e la formattazione dei valori vengono mostrati subito aggiornati nell'app e nella configurazione.
• Comandi, pattern, scalatura, interrogazioni e webhook vengono adottati dai dispositivi esistenti subito dopo il salvataggio, se la Versione del profilo è più alta di quella con cui il dispositivo è stato creato. L'editor aumenta da sé la versione al salvataggio; chi l'ha impostata a mano deve aumentarla da sé. Per questo il Controller ricostruisce i dispositivi: stanze, valori salvati, registrazione dei dati e automazioni restano conservati, nel frattempo i dispositivi non sono comandabili per breve tempo.
• Telecamere e sottoprofili aggiunti o rimossi non vengono adottati dai dispositivi esistenti. Per questo crei di nuovo il dispositivo.

WARNING

Non rinomini mai l'ID di un sottoprofilo e non elimini un sottoprofilo usato da dispositivi: questi dispositivi mostrano poi i valori del profilo principale.

Aggiornamenti dalla libreria online

Se un profilo che ha caricato dalla libreria online vi compare in una versione più recente, l'elenco dei profili mostra sotto la versione Aggiorna a … e nella riga un pulsante Aggiorna alla versione …. Un clic sostituisce il profilo con la nuova versione; i dispositivi che lo usano vengono aggiornati subito dopo. Nella Libreria online stessa i profili installati sono contrassegnati con Installato o Aggiorna a …; anche lì una nuova importazione sostituisce il profilo.

Se ha modificato il profilo nell'Editor profilo, il Controller chiede prima conferma, perché la nuova versione non contiene le Sue modifiche:

• Sostituisci applica la nuova versione, anche ai dispositivi. Le Sue modifiche vanno perse.
• Come copia lascia invariati il Suo profilo e i suoi dispositivi e salva in aggiunta la nuova versione come profilo a sé.
• Annulla non cambia nulla.

La stessa domanda la pone il Caricamento manuale, se sostituirebbe un profilo modificato nell'Editor profilo.

Se la nuova versione omette azioni, feedback o modelli che il profilo aveva finora, il Controller li elenca prima. Automazioni, scene e riquadri che li usano non funzionano più dopo l'aggiornamento. Aggiorna comunque sostituisce il profilo, Annulla lascia tutto com'è. Adegui poi le automazioni interessate.

Per domande sui profili scriva a support@nomos-system.com.