Timer universali
Indice
In questa maschera vengono gestiti i timer universali.

Per avviare comandi o sequenze di comandi a orari specifici, o fermarli allo scadere di un determinato lasso di tempo, è possibile utilizzare i timer universali nell'HS/FS. È possibile assegnare a un timer universale fino a 100 funzioni e a ogni funzione è possibile assegnare più comandi.
L'utente assegna i vari momenti di esecuzione alle funzioni con l'HS/FS in funzione. Crea una cosiddetta Azione derivante dalla funzione e dal momento in cui verrà eseguita.

Per ulteriori informazioni sull'applicazione vedere qui.

Inoltre è possibile sincronizzare il timer nell'HS/FS via Internet, con una normale di tempo - il cosiddetto Time-Server - oppure tramite EIB. Le impostazioni vengono eseguite alla voce Dati principali\Progetto\Allineamento temporale.

È possibile regolare il timer universale tramite una delle interfacce di comando solo con l'HS/FS in funzione. I timer universali vengono memorizzati in HS/FS in modo permanente.

I timer universali possono essere importati ed esportati tramite la libreria globale.

1.Schede

1.1.Dati

Nome

Con questo termine si intende il timer universale nel client HS/FS Expert.
Tramite l'interfaccia del punto finale è possibile ricercare timer universale nei quali una parola del nome inizia con la parola di ricerca utilizzata.

Unità di comando: accensione/spegnimento mediante oggetto di c.

Il timer può essere attivato o disattivato mediante il seguente oggetto di comunicazione. Questo stato viene contemporaneamente visualizzato dall'utente sull'interfaccia di comando. L'utente è quindi in grado di modificare lo stato. Un cambiamento a livello di interfaccia di comando modifica anche il valore dell'oggetto di comunicazione. Se quest'ultimo ha come valore 1, il timer universale è attivato. Se quest'ultimo ha come valore 0, il timer universale è disattivato.
L'oggetto di comunicazione non è indispensabile per il funzionamento del timer universale. Se non viene assegnato alcun oggetto di comunicazione, il timer può essere attivato/disattivato esclusivamente mediante l'interfaccia di comando.

1.1.1.Funzioni

Queste funzioni relative al timer universale vengono mostrate all'utente nel menu di comando dell'HS/FS. Nella seguente maschera vengono impostati i comandi per ogni funzione.
Testo azione
Questo testo definisce una composizione di comandi e viene visualizzato nel menu di comando quando l'HS/FS è in funzione. I comandi vengono inseriti nell'elenco che segue.
Avvertenza
Disponibile solo se si crea/elabora una funzione.

1.2.Punto finale

È possibile accedere ai timer universali tramite l'interfaccia dei punti finali dell'HS/FS.
Qui è presente una descrizione dei parametri di richiamo.
Avvertenza
Invece del timer universale impiegato nella seguente tabella in tutti gli esempi di richiamo, è possibile ovviamente utilizzare un altro timer universale qualsiasi.

I segnaposto sono indicati in MAIUSCOLO.

1.2.1.Metodi

MetodoDescrizione/richiamo
metaRichiama i metadati del timer universale.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=meta&user=USER&pw=PWD
get_stateRichiama lo stato attuale (attivo/inattivo).
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=get_state&user=USER&pw=PWD
set_activeAttiva il timer universale.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=set_active&user=USER&pw=PWD
set_inactiveDisattiva il timer universale.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=set_inactive&user=USER&pw=PWD
get_eventsRichiama l'elenco di tutti gli eventi definiti.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=get_events&user=USER&pw=PWD
add_eventAggiunge un evento al timer universale. A seconda del tipo di evento devono essere inseriti diversi parametri.

Giorni della settimana e ora: (di martedì e di giovedì, ore 17:30, ogni giorno, ID azione da richiamo 'method=meta')
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=add_event&date_type=1&weekdays=1,3&time_type=1&time=1730&filter=0&action=123&user=USER&pw=PWD
set_eventModifica un evento esistente. A seconda del tipo di evento devono essere inseriti diversi parametri.

Modifica l'esempio da 'add_event': aggiungi 'Mercoledì'. (event_id da richiamo 'method=meta')
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=set_event&event_id=789&weekdays=1,2,3&user=USER&pw=PWD
del_eventCancella un evento esistente. (event_id da richiamo 'method=meta')
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=del_event&event_id=789&user=USER&pw=PWD
simulateIndica i momenti temporali nell'intervallo di tempo indicato (indicazione in giorni, max. 28) nei quali vengono attivati gli eventi.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=simulate&days=5&user=USER&pw=PWD

1.2.2.Evento

Descrizione della struttura di un evento.
  • event_id - ID dell'evento.
  • date_type - Determina il tipo di indicazione della data
    • 1 => Giorni della settimana
    • 2 => Periodo
    • 3 => Data singola
  • Solo se date_type = 1:
    • weekdays - Elenco con i giorni della settimana attivati (0 = lunedì, 6 = domenica).
  • Solo se date_type = 2:
    • date1 - Primo giorno in cui deve essere attivato l'evento (immissione della data in formato "yymmdd").
    • date2 - Ultimo giorno in cui deve essere attivato l'evento (immissione della data in formato "yymmdd").
  • Solo se date_type = 3:
    • day - Giorno (1-31) nel quale deve essere attivato l'evento. Se questo campo non viene impostato, l'evento viene attivato ogni giorno nel quale corrispondono mese e anno.
    • month - Mese (1-12) nel quale deve essere attivato l'evento. Se questo campo non viene impostato, l'evento viene attivato ogni mese nel quale corrispondono giorno e anno.
    • year - Anno (0-99 per 2000 - 2099) nel quale deve essere attivato l'evento. Se questo campo non viene impostato, l'evento viene attivato nell'anno nel quale corrispondono giorno e mese.
  • time_type - Determina il tipo di indicazione dell'ora
    • 1 => Ora
    • 2 => Alba
    • 3 => Tramonto
  • Solo se time_type = 1:
    • time - Ora in formato "hhmm".
  • Solo se time_type = 2 o 3:
    • offset - Numero di minuti prima (valore negativo) o dopo (valore positivo) l'alba o il tramonto per l'attivazione dell'evento.
  • random - (opzionale) Numero massimo di minuti che vengono aggiunti o sottratti al momento di attivazione.
  • filter - Determina se viene eseguita un'azione
    • 0 => Sempre
    • 1 => Giorni normali (non giorni festivi o vacanze)
    • 2 => Giorno festivo
    • 3 => Vacanza
    • 4 => Mai
  • action - ID dell'azione da attivare. Tutte le azioni definite nel timer universale vengono comunicate quando vengono richiamati i metadati.

1.2.3.Campi

ID
Il valore qui inserito costituisce insieme al prefisso preassegnato "TI", al quale è collegato l'ID separato dal carattere '@', la chiave dell'oggetto univoca del punto finale.
Caratteri consentiti: A-Z, a-z, 0-9, trattino ("-") e underscore ("_")!
Descrizione
Descrizione significativa del timer universale.
Tramite l'interfaccia del punto finale è possibile ricercare timer universale nei quali una parola della descrizione inizia con la parola di ricerca utilizzata.
Tag
Elenco di concetti separati da virgole (",").
Tramite l'interfaccia del punto finale è possibile ricercare timer universali nei quali un singolo tag corrisponde completamente alla parola di ricerca impiegata.
Caratteri consentiti: A-Z, a-z, 0-9, trattino ("-") e underscore ("_")!
Gruppi utenti
Attenzione
Questo punto è disponibile solo se i gruppi di utenti sono stati attivati!
I gruppi utenti possono essere autorizzati ad accedere a questo timer universale per la lettura (colonna sinistra) tramite l'interfaccia del punto finale e/o per la scrittura (colonna destra).