HUE Controller

KNX-Ultimate video tutorials (YouTube playlist)

Tout depuis un seul nœud

Une expérience Controller cohérente

• Un sélecteur Hue orienté appareil avec autocomplétion et actualisation ; la fonction correspondante est déterminée automatiquement.
• Un clic ou le focus sur le champ de l’appareil ouvre toujours la liste Hue complète, même après une sélection ; la saisie la filtre.
• Mappages de lampe adaptés aux capacités : variation, blanc réglable, RGB/HSV et effets natifs suivent les propriétés live dimming, color_temperature, color et effects de la ressource lampe Hue API v2 sélectionnée.
• Attente de disponibilité limitée dans l’éditeur Lampe : un sablier animé apparaît pendant le chargement des ressources du Hue Bridge, avec une vérification toutes les 500 ms et une libération après environ 10 secondes accompagnée d’une erreur localisée. Enregistrer, fermer ou changer de fonction annule le minuteur.
• Les lignes KNX compactes conservent GA, DPT et Nom sur une seule ligne ; DPT et Nom utilisent des largeurs réduites, et Nom peut encore se contracter dans un éditeur étroit sans modifier la valeur enregistrée. Les valeurs DPT enregistrées sont conservées pendant le chargement asynchrone des options du sélecteur.
• Passerelle KNX facultative : utilisez les adresses de groupe ou noms ETS importés ; les datapoints compatibles proviennent de la passerelle sélectionnée.
• Ports Node-RED dynamiques pour les entrées Hue API v2 validées et les événements Hue, lorsqu’ils sont pris en charge.
• Lecture au démarrage, synchronisation d’état Hue→KNX et protection contre les boucles conservées dans chaque profil privé.
• Migration entièrement locale des quinze types obsolètes, suivie d’un brouillon d’e-mail modifiable, d’un bouton de soutien facultatif dans le message final, d’une vérification locale et d’un Deploy manuel.

Démarrer en quatre étapes

1. Configurez une fois le Bridge Hue.
2. Ajoutez HUE Controller, puis choisissez ou actualisez un Appareil Hue ; son Type d’appareil est renseigné automatiquement.
3. Sélectionnez une Passerelle KNX et mappez commandes/états, ou laissez none pour un usage réservé au flow.
4. Réglez le comportement et les ports propres à la fonction, déployez et vérifiez l’état live du nœud.

Aucune passerelle KNX ? Le Controller reste utilisable comme intégration Hue–Node-RED. Les champs KNX sont masqués et les options de flow prises en charge par la fonction restent disponibles.

Les sections suivantes constituent la référence complète par fonction, consolidée à partir des anciens nœuds dédiés.

Convertir les nœuds HUE legacy

Le bouton de migration apparaît uniquement lorsque l’éditeur Node-RED détecte au moins un nœud HUE legacy dans les flows actuels. Un lien vers la vidéo explicative de la migration sur YouTube apparaît juste avant le même bouton orange à contraste élevé avec texte blanc dans HUE Controller et chaque éditeur HUE legacy. L’avertissement confirme qu’aucune donnée de flow ou de nœud ne quitte le navigateur.

Cliquez sur Convertir les nœuds HUE legacy et confirmez. Le navigateur effectue toute la conversion localement et n’envoie aucune donnée de flow, de nœud, de hue-config, de knxUltimate-config, d’adresse de groupe, de câblage, d’identifiant, de nom, de position ou d’ID. Après la conversion, il ouvre uniquement un brouillon d’e-mail modifiable adressé à l’auteur sans quitter Node-RED. Le brouillon contient uniquement le nombre de nœuds convertis et un espace pour des notes facultatives ; vous décidez de l’envoyer et il ne part jamais automatiquement. Le message Node-RED final propose un bouton de soutien facultatif ; la page de don ne s’ouvre qu’après un clic sur ce bouton.

Avant de commencer, exportez une sauvegarde de vos flows. Le navigateur ferme l’éditeur du nœud actuel et transforme uniquement les nœuds HUE legacy détectés en instances HUE Controller. Les propriétés enregistrées, références de configuration, positions, groupes et connexions restent inchangés. L’espace de travail est marqué comme modifié, mais l’outil ne le déploie jamais automatiquement : vérifiez le résultat puis cliquez vous-même sur Deploy. Un nœud modifié, un flow verrouillé ou une erreur de conversion locale laisse l’espace de travail inchangé. Contrôle de sécurité : avant le Deploy, examinez chaque nœud HUE modifié et vérifiez sa fonction, ses références de configuration, ses ports d’entrée/sortie et son câblage. À la fin du processus, un message Node-RED fixe reste visible jusqu’à ce que vous cliquiez sur OK.

Les événements Hue restent des mises à jour d’état et ne deviennent pas de nouvelles commandes Hue. HUE Controller contient des profils privés pour le runtime, l’éditeur, les modèles et les traductions ; il ne dépend donc pas du chargement des types de nœuds obsolètes. Le nœud Hue Light d’origine reste inchangé. Les nœuds Hue dédiés restent enregistrés pour les flows existants, mais ils sont figés et ne reçoivent plus de nouvelles fonctions ni de mises à jour de maintenance. Node-RED masque leur catégorie spéciale deprecated dans la palette ; les instances existantes restent modifiables et déployables, utilisent une couleur plus claire que HUE Controller, sont marquées (deprecated) sur le canevas et affichent un avis de migration en haut de l’éditeur.

Fonction de l’appareil

• Lampe / groupe de lampes (light)
• Prise / sortie (plug)
• Bouton (button)
• Tap dial (relative_rotary)
• Mouvement (motion)
• Mouvement de zone (area_motion)
• Mouvement de caméra (camera_motion)
• Contact (contact)
• Niveau de lumière (light_level)
• Température (temperature)
• Humidité (humidity)
• Scène (scene)
• Batterie (device_power)
• Connectivité Zigbee (zigbee_connectivity)
• Mise à jour logicielle (device_software_update)

Lampe / groupe de lampes (light)

Ce nœud contrôle les lumières de Hue Philips (simple ou groupées) et mappe leurs commandes / états à KNX.

Général

Localiser l’appareil

Le bouton Locate (icône lecture) lance une session d’identification Hue pour la ressource sélectionnée. Lorsque la session est active, le bouton affiche l’icône stop et le pont fait clignoter la lampe — ou toutes les lampes du groupe — chaque seconde. Appuyez à nouveau pour l’arrêter immédiatement ; sinon la session s’arrête automatiquement au bout de 10 minutes.

Options

Ici, vous pouvez lier les adresses de groupe KNX aux commandes / états de Theaux disponibles.

Commencer à taper le champ GA (nom ou adresse de groupe); Les suggestions apparaissent pendant que vous tapez.

Changer

Faible

Blanc accordable

RGB / HSV

Pour contrôler le HSV “V” (luminosité), utilisez les contrôles standard sous l’onglet Dim .

Effets

NE-HUE BASIC EFFETS

Hue Effets natifs

Utilisez le tableau des effets natifs Hue pour cartographier vos valeurs KNX aux effets pris en charge par la lumière sélectionnée (par exemple «bougie», `foyer», «prisme»). Chaque ligne relie une valeur KNX (booléen, numérique ou textuelle, selon le point de données que vous choisissez) avec un effet de teinte. Du côté KNX, vous pouvez:

• Envoyez la valeur mappée pour activer cet effet;
• Fournir éventuellement une adresse de groupe d’état: le nœud émet la valeur mappée chaque fois que le pont de teinte rapporte un changement d’effet; Si aucun mappage n’existe, le nom de l’effet brut est envoyé (nécessite un DPT textuel tel que 16.xxx).

Comportement

| Propriété | Description | | —————————————– | ————————————————————————————————————————————————————————————————————————————————– ————————————————————————————————————————————————————————————————————————————————– | | Lire l’état au démarrage | Lisez l’état de la lumière de Hue au démarrage de Node-Red ou le déploiement complet de Node-Red, et envoyez ce statut au bus KNX | | Statut de luminosité KNX | Met à jour l’état de l’adresse du groupe de luminosité KNX, chaque fois que la lampe à teinte est allumée / désactivée. Les options sont lorsque Hue Light est éteint Envoyer 0%. Lorsque Hue On, restaurez la valeur précédente (comportement KNX par défaut) ** etLaissez tel quel (comportement de teinte par défaut) ** . Si vous avez un gradateur KNX avec un statut de luminosité, comme le MDT, l’option suggérée est lorsque la lumière de Hue est éteinte envoyez 0%. Lorsque Hue on, restaurez la valeur précédente (comportement KNX par défaut) _ | | Mettre à jour l’état Hue local en cache à partir des écritures du bus KNX | Option avancee, activee par defaut. Lorsqu’elle est activee, les ecritures recues depuis le bus KNX mettent aussi a jour immediatement l’etat Hue local en cache du noeud, sans attendre les retours/evenements du pont Hue. Cela apporte des reactions locales plus rapides et des reponses immediates de lecture KNX plus coherentes, surtout lorsque la lumiere ou le groupe est eteint. Desactivez-la si vous preferez que le cache suive uniquement les retours/evenements reels du pont Hue. | | Affoncher le comportement | Il définit le comportement de vos lumières lorsqu’il est allumé. Vous pouvez choisir parmi les différents comportements. Sélectionner la couleur: ** La lumière sera allumée avec la couleur de votre choix. Pour modifier la couleur, cliquez simplement sur le sélecteur de couleurs (sous le contrôle de couleur _Select). **Sélectionnez la température et la luminosité: ** La lumière sera allumée avec la température (Kelvin) et la luminosité (0-100) de votre choix. **Aucun: La lumière conservera son dernier statut. Dans le cas où vous permettez l’éclairage nocturne, après la fin de la nuit, la lampe reprendra l’état de couleur / température / luminosité réglé pendant le jour. | | Éclairage nocturne | Il permet de définir une couleur / luminosité claire particulière la nuit. Les options sont les mêmes que la journée. Vous pouvez sélectionner une température / une luminosité ou une couleur. Une température confortable de 2700 Kelvin, avec une luminosité de 10% ou 20%, est un bon choix pour la veilleuse de la salle de bain. | | Jour / nuit | Sélectionnez l’adresse de groupe utilisée pour définir le comportement de jour / nuit. La valeur d’adresse du groupe est _true si le jour, false si nocturne. | | Valeur de jour / nuit inversée | Inversez les valeurs de l’adresse du groupe day / night. La valeur par défaut est non contrôlée . | | Lire l’état au démarrage | Lisez l’état au démarrage et émettez l’événement dans le bus KNX au démarrage / reconnexion. (Par défaut “non”) | | Remplacez le mode nuit | Vous pouvez remplacer le mode nuit en changeant manuellement la lumière comme décrit ici: Passez au mode jour en changeant rapidement la ligth puis sur (cette lumière uniquement) ** fait ce qui décrit et n’agit que sur cette lumière.Passez au mode jour en changeant rapidement la ligth puis sur (appliquez tous vos nœuds légers)** agit sur tous les nœuds légers, en définissant l’adresse du groupe jour / nuit sur le mode jour. | | Pinons d’entrée / sortie de nœud | Masquer ou afficher les broches d’entrée / sortie. Les broches d’entrée / sortie permettent au nœud d’accepter l’entrée MSG de l’écoulement et d’envoyer une sortie MSG à l’écoulement. Le MSG d’entrée doit suivre les normes de l’API Hue V.2. Ceci est un exemple de msg, qui allume la lumière: msg.on = {"on": true} . Veuillez vous référer à la page officielle de l’API Hue |

Note

La fonction de gradation fonctionne en mode knx start et stop` ** . Pour commencer à tuer, envoyez un seul télégramme KNX “start”. Pour arrêter de tuer, envoyez un télégramme KNX “stop”. S’il vous plaîtN’oubliez pas cela** , lorsque vous définissez les propriétés de votre mur.

Prise / sortie (plug)

Plug / prise

Aperçu

Le nœud Hue Plug relie une fiche Smart Hue Philips (Service Plug) avec des adresses de groupe KNX afin que vous puissiez contrôler l’alimentation et suivre l’état directement à partir du bus.

• prend en charge Contrôle ON / OFF et Feedback d’état.
• mappage facultatif de la teinte power_state (on / standby).
• Peut exposer les broches d’entrée / sortie de Node-Red pour transmettre les événements de teinte aux flux ou envoyer des charges utiles API avancées.

Configuration ##

conseils de mappage KNX

• Utilisez un point de données booléen (par exemple DPT 1.001) pour la commande et l’état.
• Si vous exposez Power_State, mappez-le à un GA booléen (true = on, false = standby).
• Pour les demandes de lecture (GroupValue_Read), le nœud renvoie la dernière valeur de teinte en cache.

Intégration de flux

Lorsque Node E / S Pins sont activés:

• Entrée: Envoyer des charges utiles Hue V2 pour effectuer des actions avancées (par exemple msg.on = {on: true}).
• sortie: Recevoir un objet d’événement {Payé: Boolean, ON, Power_State, RawEvent} Chaque fois que Hue signale un changement.

Référence de l’API Hue

Le nœud utilise / ressource / plug / {id} sur https.Les modifications d’état sont fournies via le flux d’événements Hue et mises en cache pour les réponses KNX Read.

Bouton (button)

Le nœud du bouton Hue mappe les événements du bouton de teinte aux adresses du groupe KNX et expose les mêmes événements sur sa sortie de flux via Button.button_report.event .

Commencez à taper le champ GA (nom ou adresse de groupe) pour lier le KNX GA;Les appareils apparaissent pendant que vous tapez.

Général

Changer

Faible

Comportement

sorties

1. Sortie standard

   msg.payload transporte le booléen (ou objet DIM) envoyé à KNX;msg.event est la chaîne d’événements de teinte (par exemple short_release, repeat).

Détails

msg.event reflète bouton.button_report.event.L’événement Hue original est exposé dans «msg.rawevent».Utilisez l’état facultatif GA pour maintenir l’état de bascule en synchronisation avec les commutateurs muraux ou d’autres contrôleurs.

Tap dial (relative_rotary)

Le Node Hue Tap Dial Maps Le service rotatif du Tap Down Tap To KNX et transmet les événements de teinte brute à votre flux.Utilisez l’icône d’actualisation à côté du champ de périphérique après avoir associé un nouveau cadran sur le pont.

Onglets ###

• Mappage - Sélectionnez le KNX GA et le DPT utilisés pour les événements de rotation.Points de données pris en charge: DPT 3.007 (relative DIM), DPT 5.001 (niveau absolu 0-100%) et DPT 232.600 (contrôle des couleurs du fournisseur).
• comportement - afficher ou masquer la broche de sortie du nœud-rouge.Lorsqu’aucune passerelle KNX n’est configurée, la sortie est maintenue activée, les événements de teinte atteignent toujours le flux.

Paramètres généraux

Onglet de mappage ###

sorties

ℹ️ Les widgets spécifiques à KNX n’apparaissent qu’après avoir sélectionné une passerelle KNX;L’onglet de mappage reste caché jusqu’à la configuration du pont et de la passerelle.

Mouvement (motion)

Ce nœud écoute un capteur de mouvement de teinte et reflète les événements de KNX et / ou de votre flux rouge-rouge.

Commencez à taper le nom du périphérique KNX ou l’adresse de groupe dans le champ GA;Les suggestions apparaissent pendant que vous tapez.Appuyez sur le bouton d’actualisation à côté du “capteur Hue” pour recharger la liste des périphériques à partir du pont si vous ajoutez de nouveaux capteurs.

Général

Mappage

Comportement

ℹ️ Les widgets KNX restent cachés jusqu’à ce que vous sélectionniez une passerelle KNX, ce qui facilite l’utilisation du nœud purement comme une teinte → Écouteur rouge-rouge.

Sortir

1. Sortie standard - msg.payload (booléen)

   «True» sur le mouvement, «False» lorsque le mouvement se termine.

Mouvement de zone (area_motion)

Le nœud Hue Motion Area écoute les événements de mouvement agrégés d’une zone MotionAware (Hue Bridge Pro) et reflète l’état mouvement / pas de mouvement vers KNX ou votre flow Node-RED.

Commencez à saisir le nom ou l’adresse de groupe KNX dans le champ GA ; des suggestions apparaissent au fil de la saisie.

Général

Mappage

Comportement

Sortie

1. Sortie standard

   msg.payload (booléen) : true lorsque la zone est en mouvement, sinon false.

Détails

msg.payload contient le dernier état de mouvement agrégé fourni par le service MotionAware de la zone sélectionnée.

Mouvement de caméra (camera_motion)

Le nœud de mouvement de la caméra Hue écoute les services de mouvement de la caméra Hue Philips et reflète l’état détecté / non détecté à KNX.

Commencez à taper le champ GA (nom ou adresse de groupe) pour lier le KNX GA;Les appareils apparaissent pendant que vous tapez.

Général

Mappage

sorties

1. Sortie standard

   msg.payload (booléen):« true »lorsque le mouvement est détecté;Sinon, «faux»

Détails

msg.payload comporte le dernier état de mouvement rapporté par le service de caméra Hue.

Contact (contact)

Ce nœud transmet les événements d’un capteur de contact de teinte et les mappe aux adresses de groupe KNX.

Commencez à taper le champ GA, le nom ou l’adresse de groupe de votre appareil KNX, les périphériques AVAIable commencent à apparaître pendant que vous tapez.

Général

sorties

1. Sortie standard

   charge utile (booléen): la sortie standard de la commande.

Détails

msg.payload propose l’événement Raw Hue (boolean / objet).Utilisez-le pour une logique personnalisée si nécessaire.

Niveau de lumière (light_level)

Ce nœud lit les événements lux à partir d’un capteur de lumière de teinte et les mappe à Knx.

Il émet l’illuminance ambiante (lux) chaque fois qu’il change.Commencez à taper le champ GA (nom ou adresse de groupe) pour lier le KNX GA;Les appareils apparaissent pendant que vous tapez.

Général

Mappage

sorties

1. Sortie standard

   charge utile (numéro): valeur lux actuelle.

Détails

msg.payload comporte la valeur lux numérique.Utilisez-le pour une logique personnalisée si nécessaire.

Température (temperature)

Ce nœud lit la température (° C) à partir d’un capteur de température de teinte et le mappe à Knx.

Commencez à taper le champ GA (nom ou adresse de groupe) pour lier le KNX GA;Les appareils apparaissent pendant que vous tapez.

Général

Mappage

sorties

1. Sortie standard

   msg.payload (nombre): température du courant en ° C

Détails

msg.payload comporte la valeur de température numérique.

Humidité (humidity)

Ce nœud lit l’humidité relative (%) à partir d’un capteur d’humidité de teinte et le mappe à Knx.

Commencez à taper le champ GA (nom ou adresse de groupe) pour lier le KNX GA;Les appareils apparaissent pendant que vous tapez.

Général

Mappage

sorties

1. Sortie standard

   msg.payload (numéro): Humidité relative actuelle en%

Détails

msg.payload comporte la valeur d’humidité numérique (pourcentage).

Scène (scene)

Le nœud Hue Scene expose des scènes de teinLe champ de scène prend en charge la saisie semi-automatique;Utilisez l’icône d’actualisation après avoir ajouté des scènes sur le pont afin que la liste reste à jour.

Tabs en un coup d’œil

• Mapping - Lien des adresses de groupe KNX à la scène Hue sélectionnée.DPT 1.xxx effectue un rappel Boolean, tandis que DPT 18.xxx envoie un numéro de scène KNX.
• Multi Scene - Créez une liste de règles qui associe les numéros de scène KNX à différentes scènes de teintes et choisit si chaque scène est rappelée comme ACTIVE, DYMAMIC \ _PALETTE ou STATIC.
• comportement - basculer la broche de sortie du nœud-rouge.Lorsqu’aucune passerelle KNX n’est configurée, la broche reste activée afin que les événements de pont atteignent toujours l’écoulement.

Paramètres généraux

Onglet de mappage ###

Onglet ### Multi Scene

ℹ️ Les widgets spécifiques au KNX n’apparaissent qu’après la sélection d’une passerelle KNX.Les onglets de mappage restent masqués jusqu’à la configuration du pont et de la passerelle.

Batterie (device_power)

Ce nœud expose le niveau de batterie d’un dispositif de teinte à KNX et soulève un événement chaque fois que la valeur change.

Commencez à taper le nom du périphérique KNX ou l’adresse de groupe dans le champ GA;Les entrées correspondantes apparaissent pendant que vous tapez.Utilisez l’icône de rafraîchissement à côté de capteur de teinte pour recharger la liste à partir du pont de teinte après avoir ajouté de nouveaux appareils.

Général

Mappage

Comportement

ℹ️ Les widgets de mappage KNX restent cachés jusqu’à ce qu’une passerelle KNX soit sélectionnée.Cela maintient l’éditeur bien rangé lorsque le nœud est utilisé uniquement pour transmettre les événements de teinte dans Node-Red.

Connectivité Zigbee (zigbee_connectivity)

Ce nœud récupère l’état de connectivité ZigBee à partir d’un périphérique de teinte et l’expose à KNX.

Commencez à taper le nom du périphérique KNX ou l’adresse de groupe dans le champ GA;Les suggestions apparaissent pendant que vous tapez.

Général

Mappage

sorties

1. Sortie standard

   charge utile (booléen): état de connectivité.

Détails

msg.payload porte l’état booléen (true / false).
msg.status contient un statut textuel: l’un des connectés, déconnectés, connectivité \ _issue, unidirectional \ _incoming .

Mise à jour logicielle (device_software_update)

Ce nœud surveille si un périphérique Hue sélectionné a une mise à jour logicielle disponible et publie le statut de KNX.

Commencez à taper le nom ou l’adresse de groupe de votre appareil KNX dans le champ GA, les périphériques AVAIable commencent à apparaître pendant que vous tapez.

Général

Mappage

sorties

1. Sortie standard

   charge utile (booléen): mettent à jour le drapeau.

   Status (String): l’un de no \ _update, Update \ _Pending, Ready \ _To \ _install, installation .