Configuration d'une fonction
Sélectionnez la carte d'une fonction et cliquez sur Settings dans sa barre d'outils, ou double-cliquez sur l'en-tête de la carte, pour ouvrir sa boîte de dialogue de configuration. Apply ferme la boîte de dialogue ; les modifications parviennent au serveur avec Save sur le canevas.
- Name — nommez les fonctions pour le résident qui les lira dans l'application (« Chauffage salon », et non « Thermostat 3 »). C'est le titre de la page de la fonction dans l'application.
- Description — facultative, une note pour l'installateur suivant. L'application ne l'affiche qu'à un seul endroit : sous la valeur d'une fonction de valeur calculée. Il n'y a pas d'icône à choisir.
- Enabled — une fonction désactivée conserve son câblage mais ne s'exécute pas. Une nouvelle fonction démarre désactivée.
- Sheet — l'endroit où elle est classée.
- Category et Room — choisir une Category est ce qui publie la fonction dans les applications (voir « Functions in the App ») ; la Room y devient un filtre. Laissez Internal — not in app pour les fonctions auxiliaires que les résidents ne doivent pas voir.
- Settings — les réglages typés du bloc, avec plages, pas, unités et visibilité conditionnelle (les réglages sans objet pour les choix en cours sont masqués). Un réglage remplacé par un port d'entrée lié s'affiche grisé — le fil l'emporte.
- Per-setting exposure — les réglages éligibles portent un commutateur App : activé, les résidents peuvent modifier ce réglage depuis la page de la fonction dans l'application ; désactivé, il reste réservé à l'administrateur. La liste des réglages éligibles est fixe pour chaque bloc : les réglages d'alarme vent d'un volet automatique et la protection hors-gel et chaleur d'un thermostat, par exemple, ne portent jamais ce commutateur.
- Exposing an input (App-set) — certaines valeurs que les résidents ajustent sont des entrées, et non des réglages : la Setpoint d'un thermostat, par exemple. Cliquez sur l'entrée sur la carte, ouvrez l'onglet App-set de sa boîte de dialogue Bind, saisissez la Starting value, activez Let app users change it et cliquez sur Make app-set. La fonction conserve alors elle-même la valeur et l'application affiche une commande pour celle-ci. Commutateur désactivé, la valeur est conservée par la fonction et n'est pas proposée dans l'application.
⚠️ Avertissement : la publication d'une fonction donne toujours aux résidents le commutateur Function active sur sa page dans l'application. Ils peuvent désactiver une fonction publiée, quoi que vous exposiez. Gardez une fonction interne si elle ne doit jamais être arrêtée.

Sorties
Cliquez sur un port de sortie pour configurer la destination de sa valeur. La boîte de dialogue de sortie comporte trois onglets — Devices, Actions et Make a widget — et une sortie sans rien dans aucun d'eux n'est pas défectueuse : elle reste interne et alimente d'autres fonctions par des fils, ce qui est le cas normal d'un comparateur.
Devices. Chaque objet d'appareil cible est écrit selon l'un de deux modes :
| Mode | Ce qu'il fait |
|---|---|
| Command | Actionne l'objet — comme si un utilisateur manipulait le widget. À utiliser pour piloter de vrais actionneurs. |
| Set state | Définit l'état de l'objet sans rien commander. À utiliser pour publier une mesure calculée — sur un objet virtuel, ou sur un objet sans adresse propre (les registres d'énergie d'un compteur de puissance seule, voir « Logic Block Reference »). |
Le sélecteur ne propose que les objets que le port peut écrire (de type compatible et accessibles en écriture) ; les objets de retour d'information en lecture seule sont masqués et la boîte de dialogue indique leur nombre. La plupart des objets ne peuvent honorer qu'un seul mode, qui est donc indiqué et non demandé ; lorsque les deux conviennent, vous choisissez.
Actions. Une sortie booléenne peut aussi faire autre chose qu'écrire une valeur — les mêmes choses que le THEN d'une automatisation :
| Action | Configuration |
|---|---|
| Trigger a scenario | Le scénario — il s'exécute exactement comme si on l'activait dans l'application. |
| Trigger an automation | L'automatisation — ses propres conditions sont toujours vérifiées et ses actions ne s'exécutent que si elles sont remplies. Le texte de la tuile indique qu'elle les contourne ; ce n'est pas le cas. Une automatisation désactivée n'est pas exécutée, quelle que soit la voie utilisée (le sélecteur indique « — disabled »). |
| Global command | What (Lights in a room, Shutters in a room, Lights in a category, Shutters in a category), To (On, Off, Up, Down, Stop), et une Room ou une Category. |
| Send a notification | Title, Message, Recipients (laissez vide pour notifier tout le monde). |
| Send an e-mail | Subject, Message, Recipients (laissez vide pour envoyer un e-mail à chaque utilisateur disposant d'une adresse). Nécessite le service e-mail (voir « Email Service »). |
Deux commandes transforment une valeur en événement, et toutes deux comptent :
- Trigger — When it turns on (par défaut), When it turns off ou Both ways. Une action se produit lors d'une transition de la sortie, jamais lors d'une répétition de celle-ci : un Direct link en mode every telegram réécrit ses cibles d'appareil à chaque télégramme, mais ne déclenche ses actions que lorsque la valeur change réellement. C'est le contrat valeur/événement : les cibles d'appareil portent une valeur, les actions sont des événements.
- Not again within — un délai de blocage en secondes (60 par défaut, 1 au minimum). Les scénarios et les commandes globales écrivent de nombreux objets, et chacun revient réévaluer les fonctions qui lui sont liées ; le délai de blocage empêche que cela devienne une boucle. Laissez-le généreux sans bonne raison de faire autrement. Une transition ignorée à cause du délai de blocage est consignée comme ignorée, et non écartée en silence.
L'onglet Actions est disponible sur les sorties booléennes, et sur les sorties de type « any type » (un Direct link) dont le fil transporte un booléen — le serveur vérifie ce que le port transporte réellement et signale toute incompatibilité dans le panneau de validation (voir « Logic Validation, Monitoring & Safety »). Un nombre n'offre rien à déclencher. Les actions apparaissent sur le canevas sous forme de pastilles sur la sortie. Dans l'historique d'exécution (History → All), une action déclenchée est une ligne marquée « action fired » avec son heure, et une action ignorée par le délai de blocage ou par un test est marquée « action dropped » ; la ligne ne donne aucun autre détail. Pour un e-mail, la ligne est écrite avant la vérification du service e-mail : consultez donc aussi la boîte de réception.
Dans l'onglet Actions, Add this action ajoute l'action que vous venez de remplir ; Done seul ne conserve pas un brouillon que vous n'avez pas ajouté.
Make a widget. Le troisième onglet crée un véritable appareil pour la valeur (matérialisation de la sortie) :
- Vérifiez Widget name, Room et Category. Ils arrivent préremplis depuis la fonction ; Room et Category sont vides lorsque la fonction n'en a pas, et vous devez les choisir.
- Pour une sortie numérique, choisissez la Presentation — Value (une simple lecture) ou Trend (une tuile qui trace son historique). Une sortie vrai/faux n'a pas de Presentation.
- Cliquez sur Create the widget. Les modifications en attente de cette fonction sont d'abord enregistrées, puis le widget est créé et relié à la sortie en mode Set state. La boîte de dialogue se ferme lorsque le serveur a répondu ; s'il refuse, la raison s'affiche dans le formulaire. Vous n'avez pas besoin de Save ensuite.
Le résultat est un widget virtuel normal — une Analog input pour un nombre, une Digital input pour une sortie vrai/faux. Il peut être placé sur des vues, relié à KNX par un pont (voir « KNX Bridge & Triggers ») et enregistré dans l'historique (voir « Object Settings, Logging & Notifications » ; l'enregistrement est désactivé par défaut — activez-le depuis la page Devices). L'unité et les décimales du bloc sont copiées. Aucune plage n'est définie sauf si la sortie en déclare une (un Thermostat setpoint en déclare une, une Calculated value non) : saisissez un minimum et un maximum sur la page Devices uniquement si vous voulez que la barre de niveau de la tuile se remplisse. Le widget survit à la fonction : supprimer la fonction plus tard demande ce qu'il faut en faire plutôt que de le supprimer silencieusement.
Exemple : matérialisez une Calculated value additionnant trois compteurs sous le nom « Total consumption », catégorie Energy. Elle apparaît dans l'application comme une mesure, et non comme un compteur, et sa première valeur arrive au prochain changement de la sortie.
