Ambiances
Sommaire
Une ambiance est une liste d'actionneurs EIB qui sont adressés globalement par le HS/FS. Les états des actionneurs d'une ambiance peuvent être mémorisés, appelés/envoyés et modifiés par pas.
Six instructions sont disponibles à cet effet.

Le terme « Ambiance d'éclairage pouvant être apprise » est également utilisable, chaque type d'actionneur pouvant être affecté (p. ex. régulateur continu, store, etc.).
Attention
Lors de l'apprentissage de l'ambiance d'éclairage, le HS/FS ne lit pas les valeurs de l'EIB. Au contraire, il utilise toujours l'image de processus !
Lors de l'appel de l'ambiance, tous les actionneurs sont adressés sans pause dans l'ordre défini ici (les séquences d'instructions avec pauses sont désignées par le terme Séquences). Une ambiance peut aussi comprendre des actionneurs dont les valeurs ne sont pas mémorisées. Celles-ci sont alors mises à la valeur de consigne.

La liste des actionneurs est éditée à l'aide des boutons de commande situés à droite à côté de la liste :
Ajouter, Supprimer, Modifier/Editer

Les ambiances peuvent être importées et exportées via la Bibliothèque globale.

1.Registre

1.1.Données

Désignation

Désignation de l'ambiance dans le projet.
L'interface de point final permet de chercher des ambiances dont la désignation comprend un mot débutant par le mot de recherche utilisé.

1.2.Point final

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

Les jokers sont indiqués en MAJUSCULES.

1.2.1.Méthodes

MéthodeDescription/Appel
metaAppel des métadonnées de l'ambiance.
https://HS_IP/endpoints/call?key=SC@my_scene&method=meta&user=USER&pw=PWD
learnApprend l'ambiance une nouvelle fois.
https://HS_IP/endpoints/call?key=SC@my_scene&method=learn&user=USER&pw=PWD
callAppelle l'ambiance.
https://HS_IP/endpoints/call?key=SC@my_scene&method=call&user=USER&pw=PWD
get_itemsFournit tous les actionneurs contenus dans une ambiance.
https://HS_IP/endpoints/call?key=SC@my_scene&method=get_items&user=USER&pw=PWD
offset_plusAugmente pas à pas la valeur de tous les objets de communication de l'ambiance.
https://HS_IP/endpoints/call?key=SC@my_scene&method=offset_plus&user=USER&pw=PWD
offset_minusDiminue pas à pas la valeur de tous les objets de communication de l'ambiance.
https://HS_IP/endpoints/call?key=SC@my_scene&method=offset_minus&user=USER&pw=PWD
list_nextRègle tous les objets de communication de l'ambiance sur la valeur immédiatement supérieure de la liste.
https://HS_IP/endpoints/call?key=SC@my_scene&method=list_next&user=USER&pw=PWD
list_prevRègle tous les objets de communication de l'ambiance sur la valeur immédiatement inférieure de la liste.
https://HS_IP/endpoints/call?key=SC@my_scene&method=list_prev&user=USER&pw=PWD

1.2.2.Champs

ID
La valeur entrée ici compose, avec le préfixe prescrit 'SC' avec lequel l'ID est relié via un signe '@', 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'ambiance.
L'interface de point final permet de chercher des ambiances 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 ambiances dont la désignation comprend une balise correspondant 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 à cet objet de communication en lecture (colonne gauche) et/ou en écriture (colonne droite) via l'interface de points finaux.