Horloges programmables universelles
Sommaire
Ce masque sert à gérer les horloges programmables universelles.

Afin de démarrer des instructions ou des séquences d'instructions à des moments déterminés ou de les arrêter à l'expiration d'une période déterminée, vous pouvez utiliser des horloges programmables universelles dans le HS/FS. Il est possible d'affecter jusqu'à 100 fonctions à une horloge programmable universelle, et plusieurs instructions à chaque fonction.
L'utilisateur affecte les moments d'exécution aux fonctions dans le HS/FS en fonctionnement. Il forme ce qu'on appelle une action constitué d'une fonction et d'un moment d'exécution.

Des informations complémentaires concernant l'utilisation se trouvent ici.

Par ailleurs, l'horloge dans le HS/FS peut être synchronisée via internet avec une normale de temps - appelé Time Server - ou via l'EIB. Les réglages sont effectués dans Données de base\Projet\Calibrage de temps.

Le réglage de l'horloge programmable universelle est possible via l'interface de commande uniquement lorsque le HS/FS est en service. Les horloges programmables universelles sont mémorisées de manière permanente dans le HS/FS.

Il est possible d'importer et d'exporter des horloges programmables universelles via la Bibliothèque globale.

1.Registre

1.1.Données

Désignation

Ce terme désigne l'horloge programmable dans l'Expert HS/FS.
L'interface de point final permet de chercher des horloges programmables universelles dont la désignation comprend un mot débutant par le mot de recherche utilisé.

Commande : mise en service/hors service via un objet de communication

L'horloge peut être activée ou désactivée via l'objet de communication suivant. Cet état est simultanément signalé à l'utilisateur dans l'interface de commande. L'utilisateur peut commuter l'état ici. Une commutation au sein de l'interface de commande modifie aussi la valeur de l'objet de communication. Lorsque l'objet de communication a la valeur 1, l'horloge programmable universelle est activée. Lorsque l'objet de communication a la valeur 0, l'horloge programmable universelle est désactivée.
L'objet de communication n'est pas absolument nécessaire pour le fonctionnement de l'horloge programmable universelle. Lorsqu'un objet de communication est affecté, l'horloge peut être activée/désactivée uniquement via l'interface de commande.

1.1.1.Fonctions

Ces fonctions sont affichées à l'utilisateur dans le menu de commande du HS/FS pour cette horloge programmable universelle. Le masque suivant permet de créer les instructions correspondant à chaque fonction.
Texte d'action
Ce texte désigne un regroupement d'instructions et est affiché dans le menu de commande lorsque le HS/FS est en fonctionnement. Les instructions sont créées dans la liste suivante.
Remarque
Disponible uniquement lors de la création/l'édition d'une fonction.

1.2.Point final

L'interface de point final du HS/FS permet d'accéder aux horloges programmables universelles.
Une description des paramètres d'appel se trouve ici.
Remarque
Au lieu de l'horloge programmable universelle utilisée dans tous les exemples d'appel du tableau suivant, vous pouvez utiliser n'importe quelle horloge programmable universelle.

Les jokers sont indiqués en MAJUSCULES.

1.2.1.Méthodes

MéthodeDescription/Appel
metaAppel des métadonnées de l'horloge programmable universelle.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=meta&user=USER&pw=PWD
get_stateAppel de l'état actuel (actif ou inactif).
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=get_state&user=USER&pw=PWD
set_activeActive l'horloge programmable universelle.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=set_active&user=USER&pw=PWD
set_inactiveDésactive l'horloge programmable universelle.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=set_inactive&user=USER&pw=PWD
get_eventsAppelle une liste de tous les événements définis.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=get_events&user=USER&pw=PWD
add_eventAjoute un événement à l'horloge programmable universelle. Selon le type d'événement concerné, différents paramètres doivent également être indiqués.

Jours de la semaine et heure : (Le mardi et le jeudi, A 17h30, Chaque jour, ID d'action de l'appel '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_eventModifie un événement existant. Selon le type d'événement concerné, différents paramètres doivent également être indiqués.

Modification de l'exemple de 'add_event' : Ajoute 'Mercredi'. (event_id de l'appel '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_eventSupprime un événement existant. (event_id de l'appel 'method=meta')
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=del_event&event_id=789&user=USER&pw=PWD
simulateDonne les moments compris dans la période indiquée auxquels des Evénements sont déclenchés.
https://HS_IP/endpoints/call?key=TI@my_uzsu&method=simulate&days=5&user=USER&pw=PWD

1.2.2.Evénement

Description de la structure d'un événement.
  • event_id - ID de l'événement.
  • date_type - Détermine le type d'indication de la date
    • 1 => jours de la semaine
    • 2 => période
    • 3 => date isolée
  • Uniquement lorsque date_type = 1 :
    • weekdays - Liste des jours de la semaine activés (0=lundi, 6=dimanche).
  • Uniquement lorsque date_type = 2 :
    • date1 - Premier jour prévu pour le déclenchement de l'événement (indication de la date au format « yymmdd »).
    • date2 - Dernier jour prévu pour le déclenchement de l'événement (indication de la date au format « yymmdd »).
  • Uniquement lorsque date_type = 3 :
    • day - Jour (1-31) prévu pour le déclenchement de l'événement. Si le champ n'est pas défini, le déclenchement aura lieu chaque jour où le mois et l'année coïncident.
    • month - Mois (1-12) prévu pour le déclenchement de l'événement. Si le champ n'est pas défini, le déclenchement aura lieu chaque lundi où le jour et l'année coïncident.
    • year - Année (0-99 pour 2000 à 2099) prévue pour le déclenchement de l'événement. Si le champ n'est pas défini, le déclenchement aura lieu chaque année où le jour et le mois coïncident.
  • time_type - Détermine le type d'indication de l'heure
    • 1 => Heure
    • 2 => Lever du soleil
    • 3 => Coucher du soleil
  • Uniquement lorsque time_type = 1:
    • time - Heure au format « hhmm ».
  • Uniquement lorsque time_type = 2 ou 3 :
    • offset - Nombre de minutes avant (valeur négative) ou après le lever du soleil/coucher du soleil pendant lequel l'événement doit être déclenché.
  • random - Nombre max. de minutes ajoutées ou soustraites de manière aléatoire au point de déclenchement.
  • filter - Détermine si une action est exécutée
    • 0 => Toujours
    • 1 => Jours normaux uniquement (sans jours fériés ni jours de vacances)
    • 2 => Jour férié
    • 3 => Jour de congé
    • 4 => Jamais
  • action - ID de l'action à déclencher. Toutes les actions définies dans l'horloge programmable sont transmises à l'appel des métadonnées.

1.2.3.Champs

ID
Combinée avec le préfixe pré-défini « TI », avec lequel l'ID est connecté via un signe '@', la valeur indiquée ici compose la clé d'objet univoque du point final.
Les caractères autorisés sont : A-Z, a-z, 0-9, trait d'union ('-') et tiret bas ('_').
Description
Une description parlante de l'horloge programmable universelle.
L'interface de point final permet de chercher des horloges programmables universelles dont la description comprend un mot débutant par le mot de recherche utilisé.
Balises
Une liste de termes séparés par des virgules (',').
L'interface de point final permet de chercher des horloges programmables universelles dont la désignation comprend une balise qui correspond parfaitement au mot de recherche utilisé.
Les caractères autorisés sont : A-Z, a-z, 0-9, trait d'union ('-') et tiret bas ('_').
Groupes d'utilisateurs
Attention
Ce point est disponible uniquement lorsque des groupes d'utilisateurs ont été activés.
Il est possible d'autoriser des groupes d'utilisateurs à accéder à cette horloge programmable universelle en lecture (colonne gauche) et/ou en écriture (colonne droite) via l'interface de point final.