Éditeur de profils

L'Éditeur de profils vous permet de créer vos propres profils d'appareils pour les add-ons ou d'adapter des profils existants. Un profil définit comment le nomos system Controller communique avec un appareil et ce qui en apparaît dans l'app, les automatisations et la Quick Config. La structure d'un profil est décrite sous Format de profil ; la connexion via TCP, UDP et HTTP est décrite sous CommandServer, et des exemples complets sous Exemples de profils.

INFO

L'Éditeur de profils est disponible lorsque votre licence le débloque. Sans ce déblocage, le crayon et le bouton Nouveau profil manquent dans la liste des profils. Sur smartphone, l'éditeur est masqué.

Ouvrir ou créer un profil

Tous les chemins commencent sous Compétences → Add-ons, dans l'onglet Profils :

• Nouveau profil (icône plus, raccourci N) : vous saisissez un Nom et choisissez Protocole, Catégorie et Type. Le protocole (CommandServer, KNX, Modbus, MQTT, Z-Wave, ZigBee) définit la structure de base, le type un modèle avec des actions, des retours et des modèles adaptés, par exemple pour une lumière, un variateur ou un onduleur. Créer ouvre l'éditeur.
• Bibliothèque en ligne : charge un profil prêt à l'emploi dans la liste. Pour le modifier, ouvrez-le ensuite avec le crayon.
• Téléchargement manuel : charge un fichier de profil (.json, 1 Mo au maximum) dans la liste. Les anciens fichiers de définition au format .csv sont alors convertis en profil JSON.
• Crayon dans une ligne de la liste des profils : ouvre le profil dans l'éditeur.

Si un profil du même nom existe déjà, l'import le remplace, et les appareils qui l'utilisent reprennent la nouvelle version (voir Mises à jour depuis la bibliothèque en ligne). Un point dans le nom de fichier devient alors _.

Le plus rapide est de partir d'un profil proche de votre appareil, par exemple du même fabricant ou pour le même protocole, et de l'enregistrer comme nouveau profil avec Enregistrer sous.

Disposition de l'éditeur

En haut se trouve la barre avec les boutons Enregistrer sous, Annuler et Enregistrer. À gauche de cette barre, vous choisissez la partie du profil à modifier : le profil principal ou l'un des sous-profils (voir plus bas). En dessous, l'éditeur affiche les résultats de la vérification, puis les zones Info et Paramètres, et enfin les onglets.

Vérification

L'éditeur vérifie le profil à chaque modification. L'en-tête compte les erreurs (rouge), les avertissements (jaune) et les remarques (bleu) ; sans résultat, il affiche Aucun problème. Chaque ligne indique la règle, l'endroit dans le profil et un message (en anglais), par exemple consistency.polling pour polling.Status.

La vérification n'empêche pas l'enregistrement. Corrigez quand même les erreurs avant la mise en service : elles signalent presque toujours un endroit où l'appareil ne réagira pas ou où des valeurs manqueront.

Info

Champ	Signification
Description	Nom du profil dans la liste des profils et proposition pour le nom de l'appareil
Fabricant, Modèle	Indications sur l'appareil
Plateforme	Origine de l'appareil, par ex. le nom du fabricant. Masqué et prédéfini pour KNX et Z-Wave
Version	Augmente automatiquement à chaque enregistrement (1.0 → 1.1), tant que vous ne la modifiez pas vous-même. La version détermine si les appareils existants reprennent une modification (voir Modifier un profil)
Auteur	Qui a créé le profil
URL du support	Adresse d'une page d'aide sur l'appareil. Elle apparaît sous forme de bouton d'information dans la liste des profils et sur la page de l'appareil

Paramètres

Champ	Signification
Catégorie, Type	Définissent l'icône et la représentation dans l'app, ainsi que l'apparition de l'appareil via le pont Matter. Choisissez le type selon la valeur la plus importante : un appareil qui signale surtout un mouvement est un détecteur de mouvement, même s'il fournit aussi la température
Type de moteur	Comment le contrôleur s'adresse à l'appareil : CommandServer (connexion propre via TCP, UDP, HTTP ou série), MQTT, KNX, ZWAVE ou BUS. Le type de moteur détermine les onglets disponibles
Nom de la classe	Uniquement pour CommandServer : nom interne de la connexion, uniquement des majuscules, des chiffres, _ et -. Si le champ reste vide, l'éditeur le forme à partir du fabricant et du modèle
Compatibilité	Dans quelle mesure le profil couvre l'appareil, en pourcentage
Certifié par nomos system	Verrouillé ; seuls les profils vérifiés par nomos system portent ici Oui
Tags	Marqueurs supplémentaires, séparés par une virgule ou un point-virgule
Afficher l'appareil dans les applications	Sans coche, l'appareil n'apparaît pas dans l'app
Utiliser l'appareil avec les assistants vocaux	Sans coche, l'appareil n'est pas transmis aux assistants vocaux ni au pont Matter

Les onglets

Onglet	Contenu	Type de moteur
Communication	Paramètres de connexion : adresse, port, protocole, délais, joignabilité	uniquement CommandServer
Actions	Ce qui peut être envoyé à l'appareil	tous
Feedback	Les valeurs que l'appareil signale	tous
Interrogations	Commandes envoyées régulièrement pour récupérer des valeurs	uniquement CommandServer
Caméras	Images de caméra fournies par l'appareil	tous
Webhooks	Valeurs que l'appareil peut envoyer lui-même au contrôleur par HTTP	tous

Dans chaque tableau, Ajouter ajoute une ligne, la croix rouge ✕ la supprime et un glisser-déposer modifie l'ordre. Les noms en double sont marqués en rouge.

Communication

Le tableau comporte les colonnes Nom, Valeur, Modifiable et Commentaire. Vous choisissez le nom parmi les paramètres connus ou saisissez votre propre nom sous Défini par l'utilisateur.... L'effet des paramètres est décrit sous CommandServer : Connexion.

• Modifiable : la valeur est demandée lors de Créer un appareil et pré-remplie avec la valeur saisie. Typique pour l'adresse IP de l'appareil, un port ou des identifiants.
• Commentaire : le paramètre reste dans le profil, mais n'a aucun effet. C'est pratique pour garder des valeurs que vous utilisez seulement comme espaces réservés dans les commandes (voir Espaces réservés).

Actions et Feedback

Les deux onglets sont construits de la même façon. La barre avec les repères Communication, Definition et Modèles vous permet de passer d'une section à l'autre.

Communication (uniquement CommandServer)

• Sous Actions se trouvent ici les commandes avec Nom, Séquence, Paramètre, Timeout, Espacement et Tag ; pour HTTP en plus Méthode et, pour POST, PUT, PATCH et DELETE, Type de contenu et Corps. \# dans la séquence est la place de la valeur que l'action envoie.
• Sous Feedback se trouvent ici les motifs pour les réponses de l'appareil avec Nom, Match, Action, Condition, sur le changement et Tag.

La signification de chaque colonne est expliquée sous CommandServer.

Definition

Ici, vous définissez ce que voient l'app et les automatisations. Chaque ligne comporte Nom, Commande (pour les actions) ou Feedback, Type de données et Unité.

• Nom : choisissez si possible l'un des noms standard proposés, comme state, level, position, setpoint ou temperature. L'app ne connaît que ces noms pour ses éléments de commande ; voir Noms standard.
• Commande ou Feedback : pour CommandServer, vous choisissez une commande ou un motif de la section Communication. Une commande qui commence par SET ou GET est lue comme une propriété : SETCURR écrit la propriété CURR. Pour KNX, le champ est prédéfini ; vous n'attribuez les adresses de groupe qu'à la création de l'appareil.
• Type de données : null (bouton sans valeur), string, bool, trigger, int ou float.
• Unité : pour les nombres. Sous Catégories figurent les unités que l'app convertit pour l'utilisateur (par ex. temperature), sous Unités de mesure des unités fixes comme W ou kWh.

Le crayon en fin de ligne ouvre la boîte de dialogue Détails :

Champ	Signification
Description	Libellé dans l'app et les automatisations
Groupe	Section sous laquelle l'app affiche la valeur, par exemple « Charge » pour une borne de recharge. Utile uniquement pour les appareils avec beaucoup de valeurs
Caché	La valeur n'apparaît pas comme ligne propre dans l'app, mais reste disponible pour les automatisations
Simuler le retour d'information	Uniquement pour les actions : le contrôleur signale aussitôt la valeur envoyée comme retour, pour les appareils sans retour propre
Longueur max.	Uniquement pour le texte
Appareil min/max, Min/max converti	Mise à l'échelle entre la plage de valeurs de l'appareil et celle de nomos, voir Échelle des valeurs
Unité de l'appareil, Kelvin chaud/froid	Uniquement pour color-temperature : si l'appareil utilise des mireds, des kelvins ou des pourcentages
Valeur du pas	Pas des curseurs
MQTT, Valeur MQTT, Unité MQTT, MQTT Payload	Uniquement MQTT, voir MQTT
Taille en bits	Pour KNX, la taille du point de données (1, 8, 16, 32 bits)
Filtre KNX DPT	Pour KNX : les types de points de données proposés lors de l'attribution de l'adresse de groupe
Liste de valeurs	Valeurs de choix avec texte, par ex. 0 = Arrêt, 1 = Vitesse 1
Valeur par défaut	Pour les actions, la valeur envoyée de façon fixe (par exemple 1 pour switchon), pour les retours la valeur initiale
Préfixe, Suffixe, Remplacement de classe	Uniquement pour les actions : texte avant ou après la valeur, envoi de la commande à une autre connexion
Fonction de traitement	Uniquement pour les retours : traitement ultérieur de la valeur, par exemple la conversion en prix, voir Traitement
Options de correspondance, Volatile, mRemote Join	Pour des cas particuliers ; à laisser vides dans vos propres profils

Modèles

Les modèles sont les entrées que proposent les automatisations et la Quick Config, par exemple « Allumer » ou « Luminosité ». Colonnes : ID, Nom (l'action ou le retour auquel le modèle se rapporte), Icône, Description, Valeur et, pour les actions, Espace réservé, ainsi que Configuration rapide.

• Valeur : une valeur fixe. L'automatisation n'affiche alors aucun champ de saisie, par ex. « Est allumé » avec la valeur 1.
• Espace réservé : pour les actions avec une valeur texte, un exemple, par exemple Bienvenue ou http://…. Il apparaît en gris dans le champ de saisie encore vide de l'action dans les automatisations. Si le modèle a une Valeur fixe, la colonne est verrouillée.
• Configuration rapide : une coche masque le modèle dans la Quick Config de l'appareil ; il reste disponible dans les automatisations.

WARNING

Dès qu'il existe un seul modèle, les automatisations ne proposent plus que les modèles, et non plus toutes les actions ou tous les retours. Créez donc un modèle pour chaque valeur nécessaire dans les automatisations, ou aucun modèle.

Interrogations

Chaque ligne comporte un Nom, une Commande et l'Intervalle d'interrogation (en secondes). Avec Modifiable, l'intervalle est demandé à la création de l'appareil. Un profil HTTP sans interrogation propre reçoit à l'enregistrement l'interrogation « Reachable Check », qui appelle / toutes les 30 secondes, afin que la joignabilité soit correcte.

Caméras

Chaque ligne comporte une URL et un Type d'URL : RTSP, Snapshot, MJPEG ou Autre HTTP. L'URL peut contenir des espaces réservés issus de la communication, par ex. http://%SERVERIP%/snapshot.jpg. À la création de l'appareil, une caméra est créée pour chaque ligne.

Webhooks

Ici, vous choisissez les retours dont l'appareil peut envoyer lui-même les valeurs au contrôleur, au lieu que le contrôleur les interroge. L'adresse et la façon dont l'appareil l'appelle sont décrites sous Webhooks.

Sous-profils

Un appareil composé de plusieurs parties indépendantes, par exemple un actionneur à quatre canaux, reçoit un sous-profil par partie. À la création de l'appareil, un appareil distinct est alors créé pour chaque sous-profil, nommé « Nom de l'appareil Nom du sous-profil », tous via la même connexion.

• Créer : dans la sélection à gauche de la barre, choisissez Ajouter..., saisissez un ID (minuscules, sans point ni espace) et, si vous le souhaitez, un Nom.
• Supprimer : Supprimer le sous-profil dans la zone Info du sous-profil. La suppression n'a lieu qu'à l'enregistrement.
• Un sous-profil n'a que les onglets Actions et Feedback. La connexion, les interrogations et les caméras appartiennent au profil principal.

Enregistrer

• Enregistrer réécrit le profil sous le même nom. C'est possible même si des appareils utilisent le profil ; ils reprennent immédiatement la modification (voir Modifier un profil). Le profil est ensuite considéré comme modifié dans l'Éditeur de profils.
• Enregistrer sous crée un nouveau profil ; l'ancien reste inchangé. Si le nom est déjà pris, _2, _3, etc. sont ajoutés.
• Annuler abandonne toutes les modifications sans confirmation. La touche Échap demande d'abord une confirmation. Ctrl+S ou ⌘S enregistre.

À l'enregistrement, l'éditeur complète lui-même certains éléments :

• La Version augmente d'un cran si vous ne l'avez pas modifiée vous-même.
• Un Nom de la classe vide est formé à partir du fabricant et du modèle.
• Un motif de retour qui ne capture aucune valeur reçoit =1 à la fin de son nom (voir Nom et valeur).
• Pour KNX et Z-Wave, la plateforme et le nom de la classe sont fixés et le retour reachable est supprimé.
• Un profil HTTP sans interrogation reçoit l'interrogation « Reachable Check ».
• Si vous passez du type de moteur CommandServer à un autre, tous les paramètres, commandes et motifs de la communication disparaissent à l'enregistrement.

Modifier un profil

Un profil modifié s'applique immédiatement aux nouveaux appareils. Pour les appareils qui utilisent déjà le profil :

• L'app et la configuration affichent immédiatement les nouveaux libellés, groupes, modèles et le nouveau formatage des valeurs.
• Les appareils existants reprennent les commandes, motifs, mises à l'échelle, interrogations et webhooks juste après l'enregistrement, si la Version du profil est supérieure à celle avec laquelle l'appareil a été créé. L'éditeur augmente lui-même la version à l'enregistrement ; si vous l'avez définie à la main, vous devez l'augmenter vous-même. Le contrôleur reconstruit pour cela les appareils : les pièces, les valeurs enregistrées, l'enregistrement des données et les automatisations sont conservés ; les appareils ne sont brièvement pas commandables pendant ce temps.
• Les appareils existants ne reprennent pas les caméras ni les sous-profils ajoutés ou supprimés. Recréez l'appareil pour cela.

WARNING

Ne renommez jamais l'ID d'un sous-profil et ne supprimez aucun sous-profil utilisé par des appareils : ces appareils affichent ensuite les valeurs du profil principal.

Mises à jour depuis la bibliothèque en ligne

Lorsqu'un profil que vous avez chargé depuis la bibliothèque en ligne y paraît dans une version plus récente, la liste des profils affiche Mise à jour … sous la version et, dans la ligne, un bouton Mettre à jour vers la version …. Un clic remplace le profil par la nouvelle version ; les appareils qui l'utilisent sont mis à jour juste après. Dans la Bibliothèque en ligne elle-même, les profils installés sont marqués Installé ou Mise à jour … ; un nouvel import à cet endroit remplace également le profil.

Si vous avez modifié le profil dans l'Éditeur de profils, le contrôleur demande d'abord une confirmation, car la nouvelle version ne contient pas vos modifications :

• Remplacer applique la nouvelle version, y compris aux appareils. Vos modifications sont perdues.
• En copie laisse votre profil et ses appareils inchangés et enregistre en plus la nouvelle version comme profil distinct.
• Annuler ne change rien.

Le Téléchargement manuel pose la même question lorsqu'il remplacerait un profil modifié dans l'Éditeur de profils.

Si la nouvelle version supprime des actions, des retours ou des modèles que le profil avait jusqu'ici, le contrôleur les énumère d'abord. Les automatisations, scènes et tuiles qui les utilisent ne fonctionnent plus après la mise à jour. Mettre à jour quand même remplace le profil, Annuler laisse tout en l'état. Adaptez ensuite les automatisations concernées.

Pour toute question sur les profils, écrivez à support@nomos-system.com.