Catégorie : HomeyScript

Ubiquiti Unifi : Comment intégrer UniFi Network et UniFi Protect dans Homey Pro ?

La force de Homey Pro réside dans sa capacité à fédérer différents écosystèmes domotiques au sein d’une seule interface. Si vous êtes utilisateur de la gamme UniFi de chez Ubiquiti, il est possible d’intégrer vos équipements réseau (routeurs, points d’accès, switchs…) mais aussi vos caméras et capteurs via UniFi Protect. Dans cet article, je vous propose un guide pratique pour connecter UniFi Network et UniFi Protect à Homey Pro.

Retrouvez les liens vers Homey & Homey Pro :

Homey & Homey Pro

Deux approches possibles

Il existe plusieurs manières de relier UniFi à Homey.

  • La première, un peu technique, consiste à utiliser des webhooks depuis l’interface UniFi. Cette méthode fonctionne (je l’ai testée avec succès) mais elle reste complexe et peu conviviale.
  • La seconde, beaucoup plus simple et fluide, consiste à passer par des applications dédiées disponibles dans le Homey App Store. C’est cette approche que je vous recommande.

Les deux applications disponibles dans le Homey Store

Dans le store officiel d’Homey, vous trouverez deux applications développées pour UniFi :

  1. Ubiquiti UniFi Network : permet de récupérer et suivre les appareils connectés à votre réseau UniFi (Wi-Fi et filaire).
  2. UniFi Protect : dédiée à la gestion des caméras, détecteurs de mouvement et capteurs de l’écosystème UniFi.

Commençons par l’intégration réseau.

Retrouvez tous les posts sur Ubiquiti UniFi :

Ubiquiti Unifi

Intégrer UniFi Network dans Homey Pro

Étape 1 – Installer l’application

Rendez-vous dans le Homey App Store et installez l’application Ubiquiti UniFi Network sur votre Homey Pro.

Étape 2 – Préparer un compte local dans UniFi

Pour des raisons de sécurité et de simplicité, je vous recommande de créer un compte uniquement dédié à Homey, avec un accès local. Cela vous évitera d’ouvrir inutilement votre plateforme UniFi sur Internet.

  1. Connectez-vous à votre console UniFi.
  2. Cliquez sur l’icône en bas à gauche “Admin & Users” (l’interface reste partiellement en anglais).
  3. En haut de la page, sélectionnez “Create new”.
  4. Donnez un nom au compte, par exemple “homeypro”.
  5. Définissez un mot de passe.

Une fois le compte créé, vous pouvez lui attribuer un rôle.

Étape 3 – Créer un rôle spécifique

Par défaut, vous pourriez être tenté d’attribuer le rôle de Super Admin, mais je vous le déconseille fortement. Lorsque vous interfacer deux systèmes, il est essentiel de limiter la capacité de nuisance de l’un vers l’autre.

Je vous recommande plutôt de créer un rôle personnalisé :

  1. Cliquez sur “Manage Role”.
  2. Créez un nouveau rôle, par exemple “View Only”.
  3. Paramétrez les droits comme suit :
    • Network : View Only
    • Administration : View Only

Cette configuration est suffisante pour que Homey récupère les informations nécessaires. Je vous confirme que cela fonctionne parfaitement.

Exemple de rôle configuré

Assignez ensuite ce rôle au compte homeypro. Pour information, j’ai appliqué la même logique en créant un compte séparé pour Home Assistant.

Voilà qui termine la partie configuration côté UniFi.

Étape 4 – Associer UniFi Network à Homey

Une fois l’application ouverte sur votre Homey Pro, cliquez sur les réglages. Vous devrez indiquer plusieurs informations :

  • Adresse IP de votre routeur UniFi
  • Port : par défaut 443
  • Compte et mot de passe que vous avez créés précédemment

Mais attention : il existe une petite astuce. Dans la section “Site”, n’essayez pas de placer le nom de votre site comme “Dream Router 7”. Cela ne fonctionnera pas. Vous devez entrer exactement ce texte :
default (Default), en respectant bien la majuscule.
C’est mentionné dans la documentation officielle, mais difficile à trouver.

Ensuite, cochez la case “Enable application flows”. Cela vous permettra d’utiliser les informations UniFi dans vos flows et Advanced Flows.

Cliquez enfin sur “Test Credentials”. Une fenêtre pop-up apparaît avec le message : “Credentials are valid”.

C’est bon signe : Homey Pro est désormais en mesure de récupérer les informations de votre infrastructure UniFi Network.

Comment ajouter un appareil dans Homey ?

Maintenant que la configuration fonctionne, vous pouvez ajouter un appareil réseau dans Homey.

  1. Rendez-vous dans la section “Appareils”.
  2. Sélectionnez Ubiquiti UniFi Network.
  3. Choisissez :
    • WiFi Client pour ajouter un appareil connecté en Wi-Fi,
    • Wired Client pour un appareil connecté en filaire.
  4. Passez l’écran Connecter, puis sélectionnez tous les éléments ou effectuez une sélection précise.

Informations disponibles dans la fiche d’un appareil réseau

Voici les données remontées par Homey pour chaque appareil ajouté :

InformationDescription
RSSIIndicateur de puissance du signal reçu (Received Signal Strength Indicator).
Signal StrengthIntensité globale du signal perçue par l’appareil.
Wi-Fi NameNom du réseau Wi-Fi (SSID) auquel l’appareil est connecté.
Access PointNom du point d’accès auquel l’appareil est relié.
Access Point MACAdresse MAC du point d’accès.
Radio ProtocolProtocole radio utilisé (ex. Wi-Fi 5, Wi-Fi 6…).
IP AddressAdresse IP attribuée à l’appareil.
TX BytesVolume de données transmises par l’appareil (en octets).

Ces données sont précieuses pour vos scénarios, par exemple surveiller la force du signal Wi-Fi ou détecter un changement de point d’accès.

Et pour UniFi Protect ?

Si vous avez ajouté le module UniFi Protect, la procédure est encore plus simple. Ici, le champ Site n’est pas demandé. Vous n’avez besoin que :

  • de l’adresse IP de votre appareil UniFi Protect (par exemple votre Dream Router ou NVR),
  • du port (par défaut 443),
  • d’un compte et mot de passe disposant du rôle créé précédemment.

UniFi Protect est disponible sur les appareils UniFi Dream comme le Dream Router 7. Dans ce cas, vous pouvez directement réutiliser le compte déjà créé.

En revanche, si UniFi Protect est déployé sur un autre appareil, comme un NVR, il faudra créer obligatoirement un compte spécifique sur cette machine, avec le même rôle de type View Only que précédemment.

Une fois configuré, cliquez sur “Test connection” : si le message Connected s’affiche, c’est que la liaison est bien en place. Vous pourrez alors exploiter :

  • vos flux vidéo,
  • les alertes de détection de mouvement,
  • et les différents capteurs associés.

Informations disponibles pour un capteur UniFi Protect (exemple UP Sense)

Lorsqu’un capteur comme l’UP Sense est ajouté via l’application UniFi Protect, Homey affiche plusieurs mesures utiles pour la domotique.

UP Sense : https://hdrapin.com/2025/09/10/ubiquiti-up%E2%80%91sense-un-capteur-domotique-prometteur-mais/

Voici le détail des informations visibles :

InformationDescription
Alarme mouvementIndique si un mouvement est détecté en temps réel (Oui/Non).
Last motion atDate et heure de la dernière détection de mouvement.
Last motion onHeure précise du dernier mouvement détecté.
HumiditéMesure du taux d’humidité ambiant (en %).
TempératureTempérature ambiante mesurée (en °C).
LuminanceNiveau de luminosité mesuré (en lux).
Alarme contactIndique l’état d’un capteur de contact (porte/fenêtre ouverte ou fermée).

Ces informations peuvent être intégrées dans vos scénarios Homey, par exemple :

  • allumer une lampe si un mouvement est détecté dans une pièce sombre,
  • déclencher une alerte si une fenêtre est ouverte alors que l’humidité extérieure est élevée,
  • surveiller la température et l’éclairage pour un meilleur confort intérieur.

Informations disponibles pour une caméra UniFi Protect (exemple G4 Instant)

Une caméra comme la G4 Instant expose également de nombreuses informations et paramètres accessibles depuis Homey :

G4 Instant : https://hdrapin.com/2025/09/05/camera-de-surveillance-ubiquiti-g4-instant-mon-choix-malin-et-efficace/

InformationDescription
Alarme mouvementIndique si un mouvement est détecté.
Recording statusStatut de l’enregistrement en cours (Oui/Non).
Night VisionÉtat de la vision nocturne (activée ou non).
Last motion scoreIndice de la dernière détection de mouvement.
Last motion at / onDate et heure du dernier mouvement détecté.
Recording modeMode d’enregistrement (Always, Motion-based, etc.).
Microphone statusIndique si le micro est activé.
ConnectedÉtat de la connexion de la caméra au réseau.
Last smart detectionDate et heure de la dernière détection intelligente (personne, véhicule…).

En complément, il est également possible d’accéder à une capture instantanée ou au flux de la caméra directement depuis Homey :

Ces informations rendent la caméra exploitable dans vos automatisations, par exemple :

  • déclencher une alarme si une détection a lieu en dehors des horaires prévus,
  • envoyer une notification avec capture d’image lorsqu’un mouvement est détecté,
  • activer ou désactiver automatiquement l’enregistrement en fonction de votre présence à domicile.

Conclusion

Grâce aux applications du Homey Store, l’intégration d’UniFi Network et UniFi Protect est à la fois simple, sécurisée et efficace. En quelques minutes, vous pouvez relier vos équipements réseau et vos caméras à Homey Pro, et ainsi les inclure dans vos automatisations.

C’est une manière élégante de tirer parti de la puissance d’UniFi tout en profitant de l’orchestration intelligente de Homey.

Dans un prochain post, je vous détaillerai tout ce qu’il est possible de réaliser en termes de domotique avec ces deux mondes : UniFi et Homey Pro.

Bonne domotique !

Vous avez une question, une idée ou une remarque ?
Je serai ravi de vous lire !

✉️ henrido@hdrapin.com

HDR

HomeKit : Maîtriser les Notifications de l’App Maison :

Ou Le Pouvoir du Contrôle Granulaire dans l’Univers HomeKit 😉

C’est en testant une mise à jour récente de Homey, la plateforme domotique néerlandaise, que j’ai été frappé par un détail : auparavant incapable d’envoyer des notifications critiques, elle en est désormais capable. Ce simple ajout souligne à quel point ces notifications dites « urgentes » sont devenues un standard incontournable dans la domotique moderne.

Que vous utilisiez Homey, HomeKit, ou une autre solution, ces alertes ont un rôle vital : vous avertir quoi qu’il arrive, même si votre iPhone est en mode avion ou en mode « Ne pas déranger ».

Dans ces lignes, je me concentre sur l’application Maison d’Apple, pilier de l’écosystème HomeKit. Son système de notifications est bien plus riche qu’on ne l’imagine. Saviez-vous, par exemple, que vous pouviez choisir non seulement la forme d’une notification, mais aussi son degré d’urgence ? Voici comment reprendre le contrôle total.

Accéder aux Réglages : Le Point de Départ

Sur macOS, rendez-vous dans les Réglages Système > Notifications :

Puis faites défiler la liste jusqu’à Maison (NOT-01). C’est ici que tout se joue.

Trois Types d’Affichage : Bannières, Alertes ou Silence Total

L’app Maison vous permet de choisir comment chaque alerte visuelle s’affiche, selon trois modes :

  • Aucune : Plus de notifications, ni visuelles ni sonores. À réserver aux utilisateurs aguerris qui préfèrent consulter manuellement l’état de leur maison.
  • Bannières : Apparaissent brièvement en haut de l’écran (iOS/iPadOS) ou dans le coin supérieur droit (macOS). Idéal pour des informations passives, comme un mouvement détecté lorsque vous êtes déjà chez vous.
  • Alertes : Plus intrusives, elles restent à l’écran jusqu’à action manuelle. Accompagnées d’un son, elles sont conçues pour capter votre attention immédiatement.

Le Cœur du Système : Classique, Critique, Urgente

Au-delà de la forme visuelle, ce qui fait vraiment la puissance du système HomeKit, c’est le type d’urgence associé à la notification :

Autoriser les Alertes Critiques

C’est l’option la plus puissante du système. Une alerte critique contourne tous les filtres : mode silencieux, concentration, ou « Ne pas déranger ». Si votre détecteur d’incendie HomeKit se déclenche à 3h du matin, cette alerte vous réveillera coûte que coûte. À n’activer que pour les événements graves : feu, gaz, intrusion…

Autoriser les Alertes Urgentes

Plus subtiles, ces alertes contournent certains réglages mais n’ont pas le même impact sonore. Parfaites pour des événements sérieux mais pas vitaux, comme une fuite d’eau. Vous devez agir vite, mais la vie de personne n’est en jeu.

Options Supplémentaires : Personnalisez à l’Extrême

Les réglages proposés par Apple vont encore plus loin :

  • Afficher sur l’écran verrouillé : Pour un coup d’œil instantané, sans déverrouiller.
  • Afficher dans le Centre de notifications : Utile si vous avez manqué une alerte.
  • Pastille sur l’icône d’app : Affiche le nombre d’alertes non lues.
  • Émettre un son : À activer pour les événements que vous ne devez jamais ignorer.
  • Afficher les aperçus : Choisissez entre Toujours, Jamais ou Par défaut. Pour l’app Maison, je recommande Toujours, pour éviter d’ouvrir l’app inutilement.
  • Grouper les notifications : Personnellement, je préfère désactiver le regroupement. En domotique, chaque événement a son importance, et je veux tout voir séparément.
  • Résumé des notifications : Fonction pratique pour regrouper les alertes non urgentes à des horaires précis. Je ne l’utilise pas pour Maison, car l’instantanéité est clé.

(Réglages de notifications sur macOS)

HomeKit vs Homey : Deux Philosophies, Deux Logiques

C’est ici que le bât blesse chez Apple : l’utilisateur ne peut pas décider si une notification est critique ou non. C’est le développeur de l’appareil ou du service HomeKit qui en a le contrôle. Problème : ce qui est critique pour moi (par exemple, les volets qui se ferment pendant mon absence) ne l’est peut-être pas pour Apple.

Homey, en revanche, fait les choses autrement. Vous créez vos propres scénarios, et vous choisissez vous-même le niveau d’urgence. Une logique bien plus souple : si une combinaison d’événements se produit (capteur de présence + porte ouverte), vous pouvez décider d’envoyer une notification critique. Cela n’est tout simplement pas possible dans HomeKit aujourd’hui.

(Notification critique depuis Homey)

(Liste des notificationsHomey flows)

Conclusion : Vers Une Domotique Vraiment Réactive

Apple a clairement progressé avec ses alertes critiques et urgentes, mais le manque de granularité côté utilisateur reste une faiblesse. Espérons qu’une future mise à jour d’iOS ou de l’app Maison permettra enfin à chacun de définir ses propres règles d’importance.

En attendant, prenez quelques minutes pour revoir vos réglages de notifications. Une alerte bien configurée peut faire toute la différence en cas d’incident.

Bonne notification à toutes et à tous.

HD Rapin

Homey : Tout Savoir les interfaces Homey Web et Homey Mobile !

Selon Athom, l’éditeur de Homey, seulement 10 % des utilisateurs exploitent la version Web, pourtant très puissante. Cela s’explique par le fait que cette interface est surtout conçue pour des utilisateurs avancés qui souhaitent aller plus loin dans la configuration et l’automatisation de leur maison connectée. La grande majorité des utilisateurs utilise exclusivement l’application mobile, qui reste plus accessible pour un usage quotidien. Voici les différences :

Fonctionnalités communes

Homey propose à la fois une interface Web (accessible via navigateur à l’adresse my.homey.app) et des applications mobiles iOS/Android officielles. Les deux interfaces permettent de contrôler les mêmes appareils connectés (lampes, capteurs, thermostats, etc.) et d’exécuter des scénarios d’automatisation (« Flows »). Par exemple, on peut piloter à distance l’allumage d’une lumière ou ajuster un thermostat depuis l’application Web ou mobile.

De même, la structure de la maison (zones/pièces) est gérée dans l’onglet « Devices » des deux versions. Les Insights (graphiques historiques de consommation, température, etc.) sont également accessibles sur les deux interfaces. En résumé, la Web App et l’app mobile partagent la plupart des fonctions de base : contrôle des appareils, exécution et édition de Flows « standards », gestion des utilisateurs et partages, et visualisation des données historiques via Homey Insights.

Fonctions spécifiques à l’application mobile

L’application mobile Homey est l’interface « classique » pour le grand public et inclut plusieurs fonctions exclusives ou optimisées pour smartphone :

  • Ajout/configuration initiale des appareils : la prise en charge des nouveaux dispositifs (appairage ZigBee/Z-Wave/Bluetooth, etc.) se fait uniquement via l’app mobile. On ouvre l’onglet Devices, on clique sur « New Device » et on suit les instructions. La version Web ne permet pas (pour l’instant) d’ajouter de nouveaux équipements.
  • Personnalisation de l’écran d’accueil (Homescreen) : l’app mobile permet d’ajouter des widgets et de créer un « dashboard » privé directement sur le téléphone. Par exemple, on peut faire glisser des tuiles de contrôle (lampes, capteurs, etc.) sur l’écran principal de l’app, chose impossible sur l’interface Web.
  • Homey Dashboards (tableaux de bord) : l’app mobile intègre le nouveau système de Dashboards (depuis la version 9.0.0). Sur smartphone et tablette, on peut créer des tableaux personnalisés constitués de widgets (mesures, boutons, graphiques) pour piloter la maison « d’un coup d’œil ». Ces Dashboards sont uniquement disponibles dans l’application Homey (iOS/Android).
  • Notifications push et assistants vocaux : seules les applications mobiles reçoivent les notifications push de Homey (alertes, détection de mouvement, rappels, etc.). De même, les raccourcis Siri iOS ou l’intégration avec les assistants mobiles passent par l’app. L’interface Web ne reçoit pas de notifications push et n’intègre pas de Siri Shortcut (iPhone).
  • Homey Energy (onglet Énergie) : l’app mobile récente intègre un onglet Énergie très complet (avec graphiques, coûts, top consommateurs). Cette nouvelle fonction est liée à l’application mobile (disponible à partir de Homey app v9.2.0) et n’est pas présente dans la Web App.
  • Installation et mise à jour des « Apps » Homey : l’ajout d’applications Homey (extensions officielles ou tierces pour piloter de nouvelles marques) s’effectue via le Mobile App Store intégré. On accède depuis l’app mobile à la section More → Apps, puis on recherche et installe des applications. Cette gestion des Apps n’existe que dans l’interface mobile (la Web App ne propose pas l’App Store intégré).
  • Fonctions mobiles additionnelles : la détection de présence (géolocalisation du smartphone), les commandes Siri/Android ou les widgets d’écran d’accueil système (Widgets iOS/Android pour lancer un Flow) sont naturellement liées à l’app mobile.

En résumé, toutes les tâches de configuration pratique – ajout d’appareils, réglages initiaux, gestion des Apps Homey, et création de dashboards personnels – se font sur l’application mobile. Cette dernière reste l’interface « quotidienne » pour l’utilisateur, avec accès aux nouvelles fonctions mobiles-first (Widgets/Homescreen, Dashboards, onglet Énergie, notifications, etc.). Par exemple, pour créer un dashboard sur mobile : “Ouvrez l’app Homey sur votre téléphone et allez dans More (…) → Dashboards, puis cliquez sur ‘+ New Dashboard’”.

Fonctions spécifiques à l’application Web

L’interface Web de Homey (accessible via navigateur) cible surtout les utilisateurs avancés et la configuration approfondie. Ses particularités sont :

  • Flows avancés : la Web App permet de créer et modifier les Flows Avancés (flux complexes avec Canvas infini). Ce mode avancé n’est pas implémenté dans l’application mobile. Comme l’indique la documentation, “les flows avancés ne peuvent être créés et édités que sur l’interface Web. Cette option n’est pas disponible dans l’app mobile”.
  • Interface desktop : sur grand écran (ordinateur), l’édition de Flows classiques et l’analyse des données (via Insights) sont plus confortables. L’interface Web reprend tous les éléments essentiels du Flow Builder (cartes, conditions) et offre un aperçu simultané plus large. Par exemple, on peut afficher plusieurs graphiques Insights côte à côte.
  • Accès aux scripts avancés : la Web App intègre HomeyScript (script JavaScript) et est un environnement plus ouvert pour les fonctions développeurs. L’application mobile ne permet pas l’écriture/exécution de scripts personnalisés.
  • Gestion des données et zones : depuis la Web App on peut aussi renommer des zones, modifier la structure de la maison ou réorganiser les pièces. Par exemple, on clique-droit sur une zone dans « Devices » pour la renommer sur le Web. Cette gestion des zones est commune aux deux interfaces.
  • Absence de fonctions mobiles : la version Web ne propose pas les Dashboards mobiles, ni les widgets Homescreen, ni l’accès aux fonctionnalités de présence ou de notification du smartphone. De même, l’ajout de nouveaux appareils (pairing) n’y est pas possible. Enfin, la Web App ne pousse pas de notifications sur le navigateur.

En somme, l’application Web complète l’écosystème Homey en proposant un environnement desktop pour les configurations lourdes et les flux avancés. Elle permet d’accéder à Homey Insights et aux données de la maison dans un navigateur (comme sur mobile). Par contre, elle se concentre sur l’administration et l’automatisation technique, sans les atouts « mobiles » (dashboards, notifications push, configurateur de device).

Utilisation combinée sur les Mac avec puce Apple (M1, M2, M3…)

Un avantage intéressant pour les utilisateurs de Mac équipés de puces Apple Silicon (M1, M2, M3…) est la possibilité d’installer et d’utiliser la version mobile de Homey (iOS) directement depuis le Mac via le Mac App Store. En effet, ces ordinateurs prennent en charge les applications iOS de manière native, ce qui permet de bénéficier à la fois de la version Web (via navigateur) et de la version mobile (en tant qu’app installée).

Cette double interface offre une expérience hybride particulièrement puissante : d’un côté, la Web App permet de créer des Flows Avancés et d’accéder à HomeyScript ; de l’autre, l’application mobile apporte les Dashboards, l’onglet Énergie, et les options de configuration rapide comme l’installation d’Apps Homey. Pour les utilisateurs avancés, cela représente le meilleur des deux mondes, avec une ergonomie desktop enrichie par les fonctions pratiques et mobiles de l’app iOS.

Tableau comparatif des fonctionnalités

Fonctionnalité / InterfaceHomey Web (bureau)Homey Mobile (iOS/Android)
Contrôle des appareilsDisponibleDisponible
Ajout/association de nouveaux appareilsNon disponibleDisponible
Gestion des pièces/zonesDisponibleDisponible
Édition Flows (standard)DisponibleDisponible
Édition Flows (Avancés)DisponibleNon disponible
Homey Insights (graphiques)DisponibleDisponible
Homey Energy (onglet Énergie)Non disponibleDisponible
Home Screen / Widgets d’accueil personnalisésNon disponibleDisponible
Tableaux de bord (Dashboards)Non disponibleDisponible
Notifications push (alerte smartphone)Non disponibleDisponible
Installation/mise à jour d’Apps HomeyNon disponibleDisponible
HomeyScript / Scripts personnalisésDisponibleNon disponible
Siri / raccourcis (iOS)Non disponibleDisponible
Visualisation caméras (flux, snapshots)Non disponibleDisponible

Chaque rangée indique si la fonctionnalité existe sur la version Web, sur la version Mobile, ou sur les deux. Par exemple, les Flows standards et Homey Insights sont gérés sur les deux interfaces, alors que la création de Flows avancés est réservée à la Web App et que les Dashboards ne sont disponibles que dans l’app mobile.

Bonne Domotique !

Henri Dominique Rapin

Homey Pro : Surveiller ses appareils avec HomeyScript : comprendre les « Capabilities »

Homey propose de puissants outils d’automatisation comme les Flows ou les Advanced Flows. Mais pour ceux qui veulent aller encore plus loin, HomeyScript ouvre un nouveau champ des possibles en permettant de contrôler, interroger et automatiser votre maison avec du code JavaScript.

Dans cet article, nous allons apprendre à :

  • Comprendre ce que sont les « Capabilities » dans Homey
  • Écrire un script HomeyScript qui surveille certains appareils et leurs états
  • Déclencher une alerte ou un log en fonction de leur disponibilité

📦 Les « Capabilities » dans Homey : c’est quoi ?

Chaque appareil connecté à Homey expose un ensemble de capabilités (Capacités en Français), c’est-à-dire les fonctions ou états qu’il peut gérer : allumer/éteindre, température mesurée, état de la batterie, contact ouvert/fermé, etc.

Par exemple :

  • Un capteur de température expose measure_temperature
  • Une ampoule connectée expose onoff, dim, light_hue, etc.
  • Un capteur de contact peut exposer alarm_contact ou alarm_motion

Ces capabilities sont accessibles et modifiables via HomeyScript, ce qui permet une surveillance avancée, au-delà des Flows classiques.

🔧 Script : surveiller la disponibilité de certains appareils

Voici un exemple de HomeyScript qui vérifie si une liste d’appareils sélectionnés est disponible (available = true) ou non, et affiche une alerte dans le journal si ce n’est pas le cas.

🧑‍💻 Code HomeyScript :

// Liste des noms d'appareils à surveiller
const monitoredDevices = ["Capteur Température Salon", "Prise NAS", "Détecteur Entrée"];

const allDevices = await Homey.devices.getDevices();

for (const deviceId in allDevices) {
  const device = allDevices[deviceId];
  
  if (monitoredDevices.includes(device.name)) {
    const isAvailable = device.available;
    if (!isAvailable) {
      console.log(`⚠️ L'appareil "${device.name}" est injoignable.`);
    } else {
      console.log(`✅ L'appareil "${device.name}" est OK.`);
    }
  }
}

🧠 Explication :

  • Homey.devices.getDevices() récupère tous les appareils.
  • On filtre ceux que l’on souhaite surveiller (monitoredDevices).
  • On vérifie l’état available (true/false).
  • On écrit dans le log une alerte si l’appareil est injoignable.

🧩 Aller plus loin : surveiller une capability spécifique

Tu veux surveiller un état précis comme la température ou l’ouverture d’un contact ? Tu peux modifier le script pour accéder aux capabilities comme ceci :

const device = allDevices[deviceId];

if (device.capabilitiesObj && device.capabilitiesObj["alarm_contact"]) {
  const alarmContact = device.capabilitiesObj["alarm_contact"].value;
  if (alarmContact) {
    console.log(`🚪 Contact ouvert sur : ${device.name}`);
  }
}

Ici, on accède à la capability alarm_contact (typiquement pour des portes ou fenêtres) et on déclenche une alerte si le contact est ouvert.

🚀 Utilisations possibles

  • 🔔 Être averti si un appareil n’est plus joignable
  • 🌡️ Créer une alerte si la température dépasse un certain seuil
  • 🚪 Suivre l’état de toutes les ouvertures d’un bâtiment
  • 🔌 Vérifier que certaines prises critiques (NAS, congélateur…) sont sous tension

🧠 Conclusion

HomeyScript est un levier ultra-puissant pour ceux qui veulent pousser leur domotique à un niveau expert. En maîtrisant les Capabilities, tu peux créer des scripts qui surveillent, alertent, et réagissent en temps réel aux changements d’état de tes appareils.

Avec quelques lignes de code, tu gagnes en visibilité et en fiabilité sur ton installation domotique.

Bonne domotique

HDR

HomeyScript : example-flowcard-run.js

Voici une analyse détaillée de ce script HomeyScript qui démontre comment exécuter des cartes de type « Et » (Flow Card Condition) et « Alors » (Flow Card Action).

But du Script

  • Vérifier si le jour actuel est un week-end en exécutant une carte « Et ».
  • Exécuter une action spécifique en fonction du résultat (allumer une animation de couleur verte si c’est un week-end, rouge sinon).

Structure et Fonctionnement

1. Exécution de la Carte « Et » (Condition)

const { result: isWeekend } = await Homey.flow.runFlowCardCondition({
  id: 'homey:manager:cron:day_equals',
  args: {
    day: 'weekend',
  },
});

log('Is Weekend:', isWeekend);
  • Homey.flow.runFlowCardCondition() :
  • Exécute une carte de condition (type « Et »).
  • Paramètres :
    • id : L’identifiant unique de la carte, ici homey:manager:cron:day_equals, qui vérifie si le jour actuel correspond à un certain critère.
    • args : Les arguments nécessaires pour la carte. Ici, l’argument est { day: 'weekend' }, indiquant que nous voulons vérifier si c’est un week-end.
  • Résultat :
  • La fonction renvoie un objet contenant le champ result, qui est assigné à la variable isWeekend.
  • Cette variable sera true si c’est un week-end, sinon false.
  • log() : Affiche dans la console le résultat (par exemple : Is Weekend: true).

2. Exécution de la Carte « Alors » (Action)

await Homey.flow.runFlowCardAction({
  id: 'homey:manager:ledring:animate_pulse',
  args: {
    animation: 'pulse',
    color: isWeekend
      ? '#00FF00'
      : '#FF0000',
  },
});
  • Homey.flow.runFlowCardAction() :
  • Exécute une carte d’action (type « Alors »).
  • Paramètres :
    • id : L’identifiant unique de la carte, ici homey:manager:ledring:animate_pulse, qui déclenche une animation LED sur Homey.
    • args : Les arguments nécessaires pour la carte :
    • animation: 'pulse' : Déclenche une animation de type pulsation.
    • color : Définit la couleur de l’animation :
      • #00FF00 (vert) si c’est un week-end (isWeekend === true).
      • #FF0000 (rouge) sinon.

Logique Globale

  1. Vérifie si le jour actuel est un week-end avec une carte « Et ».
  2. Exécute une animation de pulsation LED en fonction du résultat :
  • Vert pour un week-end.
  • Rouge pour un jour de semaine.

Exemple de Fonctionnement

Situation 1 : Jour de semaine (par ex. mercredi)

  1. Condition vérifiée :
  • isWeekend = false.
  1. Action exécutée :
  • Animation LED rouge (pulsation).

Situation 2 : Week-end (par ex. samedi)

  1. Condition vérifiée :
  • isWeekend = true.
  1. Action exécutée :
  • Animation LED verte (pulsation).

Utilisation et Application

  1. Automatisation Dynamique :
  • Peut être utilisé pour des scénarios où l’action dépend du jour actuel, par exemple, des routines spécifiques pour les week-ends.
  1. Personnalisation des Actions :
  • Les couleurs et animations peuvent être modifiées pour répondre à d’autres conditions ou préférences.

Avantages et Limites

Avantages :

  • Montre comment intégrer des cartes « Et » et « Alors » dans HomeyScript.
  • Fournit une logique conditionnelle simple mais efficace.
  • Facile à adapter pour d’autres scénarios (par exemple, vérifier des heures, des états de périphériques, etc.).

Limites :

  • Dépend de cartes spécifiques disponibles dans l’environnement Homey (par exemple, homey:manager:cron:day_equals et homey:manager:ledring:animate_pulse).
  • Ne fonctionne que si les arguments requis par les cartes sont corrects.

Extensions possibles

  1. Ajouter d’autres conditions :
  • Par exemple, vérifier si une lumière est allumée avant de lancer l’animation.
  1. Changer le type d’animation :
  • Adapter pour des animations différentes selon le contexte.
  1. Utilisation multi-cartes :
  • Enchaîner plusieurs cartes pour des scénarios plus complexes.

Quelles sources pour les applications pour Homey ou Homey pro ?

Pour étendre les capacités de la box Homey Bridge ou Homey Pro, vous devrez installer des applications sur l’appareil, un peu à l’image de ce qui se passe sur votre smartphone Android ou iOS. Il n’existe pas d’applications payantes sur la Homey, ce qui rend l’accès aux fonctionnalités supplémentaires plus accessible pour tous les utilisateurs.

Ceci dit, rien ne vous empêche de rémunérer le développeur indépendant, car la communauté autour de Homey est souvent composée de passionnés désirant améliorer constamment l’expérience utilisateur. Un bouton « remercier » est d’ailleurs disponible sur les applications communautaires, permettant aux utilisateurs de montrer leur appréciation pour le travail acharné et la créativité des développeurs.

Cela peut également encourager davantage de développeurs à créer des applications qui enrichissent l’écosystème Homey. En offrant un moyen de soutenir ces créateurs, vous contribuez à une communauté dynamique où l’innovation peut prospérer.

Voici les trois sources de provenance des applications sur Homey :

1. Applications Développées par Athom

Athom, le créateur de Homey, propose un ensemble d’applications officielles pour assurer une intégration fluide et fiable avec de nombreux appareils et services. Ces applications ont disponibles dans la version Homey / Homey bridge. Et bien sûr par Homey Pro.

2. Applications Développées par des Fabricants d’Appareils

Certains fabricants développent leurs propres applications pour garantir une compatibilité optimale avec leurs produits.

On note que parfois des fabricants qui développent pour Homey alors qu’ils sont absents de Homeassistant comme dernièrement EcoFlow ou Eufy. Néamoins, sur HomeAssistant on trouvera des intégrations communautaire pour ces deux produits.

  • Caractéristiques : Ces applications assurent une intégration directe et fiable avec les appareils du fabricant.
  • Exemples : Ecoflow pour les panneaux solaires et batteries, Sonos pour les accessoires domotiques.

3. Applications Développées par la Communauté

La communauté Homey est très active, et de nombreux développeurs passionnés et souvent géniaux créent des applications pour ajouter le support de nouveaux appareils ou pour offrir des fonctionnalités supplémentaires. Attention ces applications sont uniquement accessibles au travers d’Homey Pro.

  • Caractéristiques : La qualité et le support peuvent varier. Ces applications ajoutent souvent des fonctionnalités innovantes ou le support de périphériques de niche. Elles sont aussi validées par l »équipe d’Homey.
  • Exemples : Shelly pour les appareils de la marque éponyme, Home Assistant App pour l’intégration avec Home Assistant, etc…

Conseils pour Choisir et Utiliser les Applications Homey

  1. Vérifiez l’Origine : Privilégiez les applications développées par Athom ou les fabricants d’appareils. Pour les applications communautaires, consultez les avis et les notes.
  2. Compatibilité : Assurez-vous que l’application est compatible avec vos appareils et votre version de Homey. C’est indiqué sur la page de l’application.
  3. Sauvegarde : Effectuez une sauvegarde de votre configuration Homey avant d’installer de nouvelles applications, surtout celles de la communauté.

En suivant ces quelques consignes, vous assurerez une utilisation stable de Homey. La validation des applications par l’équipe de Homey garantit aussi que la communauté a effectué un excellent travail.

Et surtout ne pas hésiter à écrire au développeur si une capacité venait a manquer.

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.

Domotisez bien avec Homey !

HDR

HomeyScript : 1er exemple pour bien débuter

HomeyScript est un outil puissant qui permet d’aller plus loin dans l’automatisation de votre maison connectée. Avec JavaScript, il permet de créer des scripts personnalisés pour gérer des scénarios complexes, dépassant les automatisations classiques de l’application Homey. Cela vous donne la liberté de créer des interactions spécifiques et d’offrir des réponses précises, offrant un contrôle plus personnalisé de votre environnement.

Attention, rien ne vous oblige à l’utiliser, Homey fonctionne parfaitement avec les Flows et les Advanced flows, c’est une option supplémentaire qui peut dans certains cas bien précis rendre des services.

La documentation de l’Api est ici : https://api.developer.homey.app

En intégrant HomeyScript, vous accédez directement à l’API de Homey, permettant une manipulation précise de vos appareils. Vous pouvez exploiter des fonctions logiques avancées et coordonner des actions complexes, offrant un niveau de personnalisation adapté aux utilisateurs exigeants cherchant une maison véritablement « intelligente ».

N’oubliez pas d’installer l’application HomeyScript sur votre Homey Pro : https://homey.app/fr-fr/app/com.athom.homeyscript/HomeyScript/

Voici un premier exemple :

Dans cet exemple, trois éclairage ne sont pas accessibles, ce sont les trois lignes en bas de page.

Néanmoins le script retourne un cade d’exécution OK

Récupérer Plusieurs Appareils

Vous pouvez récupérer plusieurs appareils en même temps et appliquer des actions sur chacun d’eux. Par exemple, pour allumer toutes les lumières d’une pièce :

// Ce script recherche tous les appareils ayant la capacité onoff et les allume.

let devices = await Homey.devices.getDevices();

for (let device of Object.values(devices)) {
  if (device.capabilities.includes('onoff')) {
    try {
      await device.setCapabilityValue('onoff', true);
    } catch (error) {
      console.error(`Erreur lors de la tentative d'allumer l'appareil ${device.name}:`, error.message);
    }
  }
}

Ce script recherche tous les appareils ayant la capacité onoff et les allume.

Explications :

Bien sûr ! Voici une explication pas à pas du script :

  1. Récupération des appareils disponibles :
   let devices = await Homey.devices.getDevices();
  • Cette ligne utilise Homey.devices.getDevices() pour obtenir la liste de tous les appareils connectés à Homey.
  • await est utilisé car la fonction est asynchrone. Il faut attendre que la liste des appareils soit récupérée avant de continuer.
  • La variable devices contiendra un objet contenant tous les appareils connectés, identifiés par leurs identifiants.
  1. Parcours de tous les appareils :
   for (let device of Object.values(devices)) {
  • Cette ligne utilise une boucle for...of pour parcourir tous les appareils.
  • Object.values(devices) permet de récupérer un tableau contenant tous les objets appareils, à partir de l’objet initial qui les identifie par clé.
  • device est une variable qui représente chaque appareil lors de l’itération.
  1. Vérification de la capacité onoff :
   if (device.capabilities.includes('onoff')) {
  • Ici, on vérifie si l’appareil courant (device) possède la capacité onoff.
  • La capacité onoff est généralement associée à des appareils qui peuvent être allumés ou éteints, comme des lumières ou des prises intelligentes.
  • Si l’appareil possède cette capacité, le bloc de code à l’intérieur sera exécuté.
  1. Allumage de l’appareil :
   try {
     await device.setCapabilityValue('onoff', true);
  • try commence un bloc de code qui permet de gérer les erreurs en cas de problème lors de l’exécution.
  • device.setCapabilityValue('onoff', true) est appelé pour allumer l’appareil (en réglant la valeur de la capacité onoff à true).
  • await est utilisé car cette opération est asynchrone — cela signifie qu’il faut attendre que la commande d’allumage soit envoyée à l’appareil avant de continuer.
  1. Gestion des erreurs :
   } catch (error) {
     console.error(`Erreur lors de la tentative d'allumer l'appareil ${device.name}:`, error.message);
   }
  • Si une erreur survient lors de l’allumage de l’appareil, le bloc catch sera exécuté.
  • console.error est utilisé pour afficher un message d’erreur dans la console.
  • Le message indique le nom de l’appareil qui a causé l’erreur (device.name) et le message d’erreur (error.message) pour aider à identifier le problème.

Résumé :

  • Le script récupère tous les appareils connectés à Homey.
  • Ensuite, il parcourt chaque appareil pour vérifier s’il possède la capacité onoff.
  • Pour chaque appareil ayant cette capacité, il essaie de l’allumer.
  • Si une erreur se produit lors de cette tentative, un message d’erreur est affiché dans la console pour informer de l’échec et de son origine.

Ce script est utile pour automatiser l’allumage de tous les appareils qui peuvent être mis sous tension, tout en gérant les erreurs afin de ne pas interrompre le processus pour les autres appareils en cas de problème.

Bon scripting

HDR