Comprendre les Tags dans Homey

Dans l’univers de Homey, les tags sont l’un des outils les plus puissants que vous pouvez utiliser pour enrichir vos automatisations et rendre votre maison connectée encore plus intelligente.

Mais qu’est-ce qu’un tag exactement, et comment pouvez-vous les utiliser pour améliorer vos flux (Flows) Homey ? Plongeons ensemble dans ce concept !

Qu’est-ce qu’un Tag dans Homey ?

Les tags dans Homey sont des variables dynamiques qui permettent d’ajouter des informations contextuelles à vos automatisations. En termes simples, un tag peut contenir des données comme la température, l’heure actuelle, l’état d’un appareil, ou même une valeur précise transmise par un capteur.

Ces informations peuvent ensuite être utilisées dans vos automatisations (appelées Flows dans Homey) pour déclencher des actions particulières.

Par exemple, vous pouvez utiliser un tag qui contient la température extérieure afin de décider si vous devez activer ou désactiver le chauffage.

Les tags permettent donc une grande flexibilité dans la création de scénarios adaptatifs et personnalisés.

Les différents types de Tags

Homey propose différents types de tags, chacun adapté à des situations spécifiques :

• Tags Systèmes : Ce sont des tags fournis par Homey lui-même, comme l’heure, la date, le niveau de batterie d’un appareil, etc. Ils sont généraux et présents dans l’environnement Homey par défaut.
• Tags d’Appareil : Chaque appareil connecté à Homey peut avoir ses propres tags. Par exemple, une ampoule connectée peut avoir un tag indiquant si elle est allumée ou éteinte, ou encore une valeur de luminosité.
• Tags Personnalisés : Vous pouvez également créer vos propres tags au sein d’un Flow pour enregistrer une valeur particulière qui vous serait utile à réutiliser dans d’autres automatisations. Par exemple, enregistrer une température seuil qui déclencherait des actions spécifiques.

Actuellement, il n’est pas possible d’obtenir la liste des tags pour une carte, sauf en utilisant le HomeyScrip ci-après 😉

Comment Utiliser les Tags dans les Flows ?

L’utilisation d’un Tag est facilité dans Homey, par la petite icône en forme de signet, cliquez dessus et apparaitront tous les Tag disponibles.

la couleur des Tag varie en fonction du type d’information retournée :

• Bleu : Numérique
• Vert : Texte
• Rouge : (Boleen) Yes / No

Les tags sont utilisés principalement dans les trois étapes d’un Flow : Quand, Et, et Alors.

1. Quand : Les tags peuvent servir de déclencheurs. Par exemple, vous pouvez créer un Flow qui se déclenche quand une certaine valeur de tag est atteinte, comme une température précise.
2. Et : Dans cette étape, les tags sont très utiles pour ajouter des conditions. Vous pouvez, par exemple, déclencher un Flow seulement si un tag a une certaine valeur. Cela permet de rendre les automatisations beaucoup plus adaptées à votre contexte. Par exemple : allumer les lumières seulement si la luminosité intérieure est inférieure à une certaine valeur.
3. Alors : Les tags peuvent être utilisés pour définir les actions à effectuer. Par exemple, vous pouvez utiliser un tag pour envoyer une notification avec des informations précises, comme “La température actuelle est de 22°C”.

Exemples Concrets d’Utilisation des Tags

• Régulation Thermique : Si la température extérieure (récupérée par un capteur et stockée dans un tag) est inférieure à 18°C, et que personne n’est à la maison, vous pouvez créer un Flow qui abaisse automatiquement le chauffage pour réaliser des économies d’énergie.
• Alertes Personnalisées : Utilisez un tag pour envoyer des alertes sur mesure, comme une notification push indiquant que la machine à laver a terminé son cycle lorsque le tag indiquant la consommation électrique tombe en dessous d’un certain seuil.
• Suivi de Présence : En utilisant des tags liés à des capteurs de présence, vous pouvez créer des scénarios où certaines actions ne sont effectuées que si un membre précis de la famille est présent à la maison.

Un script pour récupérer les Tags :

Voici un script HomeyScript qui retourne tous les « tags » potentiels de tous les appareils connectés a votre Homey Pro :

// Ce script HomeyScript permet de lister tous les tags disponibles pour chaque accessoire connecté à Homey
// Fonction principale pour lister les tags
async function listTags() {
  let devices = await Homey.devices.getDevices();
  let result = '';
  for (let deviceId in devices) {
    let device = devices[deviceId];
    result += `Appareil: ${device.name}\n`;
    // Lister les tags de l'appareil
    if (device.capabilities) {
      for (let capability of device.capabilities) {
        let tagValue = device.capabilitiesObj[capability]?.value;
        result += `  - Tag: ${capability}, Valeur: ${tagValue}\n`;
      }
    }
    result += '\n';
  }
  return result;
}
// Exécuter la fonction et afficher les résultats
listTags().then(result => console.log(result)).catch(error => console.error('Erreur:', error));

Voici un exemple de retour :

Appareil: Module Palier
  - Tag: measure_temperature, Valeur: 19.6
  - Tag: measure_humidity, Valeur: 64
  - Tag: measure_co2, Valeur: 632
  - Tag: measure_battery, Valeur: 61

Appareil: bloom 1
  - Tag: onoff, Valeur: false
  - Tag: dim, Valeur: 0.6
  - Tag: light_hue, Valeur: 0.09
  - Tag: light_saturation, Valeur: 0.78
  - Tag: light_temperature, Valeur: 1
  - Tag: light_mode, Valeur: temperature

Appareil: LG webOS TV
  - Tag: onoff, Valeur: false
  - Tag: volume_set, Valeur: 0.09
  - Tag: volume_mute, Valeur: false
  - Tag: speaker_next, Valeur: null
  - Tag: speaker_playing, Valeur: null
  - Tag: speaker_prev, Valeur: null

Appareil: SNZB-06P
  - Tag: alarm_motion, Valeur: true
  - Tag: sonoff_illuminance, Valeur: bright

(Copie d’écran de l’éditeur de scripts de Homey Script)

Dans le jargon Homey, les Tags sont en fait des « Capacités », sauf que ces capacités portent des informations.

Les tags sont une fonctionnalité essentielle pour transformer des automatisations basiques en scénarios avancés et hautement personnalisés.

Ils vous permettent de rendre vos Flows beaucoup plus réactifs et adaptatifs, en utilisant des informations contextuelles en temps réel.

Pour vraiment profiter de l’univers Homey, intégrer les tags dans vos Flows est un excellent moyen de maximiser l’efficacité et l’intelligence de votre maison connectée.

Pour en savoir plus sur Homey et découvrir toutes ses fonctionnalités, cliquez ici : Homey. Vous y trouverez des informations détaillées et des conseils pratiques pour tirer le meilleur parti de cet écosystème intelligent.

Bonne automatisation.

HDR