node-red-contrib-huemagic 4.2.2 → 5.0.1

package/huemagic/locales/fr/hue-bridge.html

@@ -0,0 +1,96 @@
+<script type="text/markdown" data-help-name="hue-bridge-node">
+Le nœud « Hue Bridge » est un nœud universel capable d'émettre tous les réglages du bridge ainsi que les messages de statut des autres nœuds.
+
+### Configuration
+
+Sélectionnez d'abord le Hue Bridge souhaité. En option, vous pouvez désactiver tous les messages de statut automatiques de ce nœud à l'aide du réglage « Ignorer les mises à jour et messages globaux des appareils sur ce nœud ». Le nœud n'émettra alors plus de mises à jour d'appareil.
+
+Vous pouvez également choisir que les messages d'initialisation de tous les nœuds ne soient pas supprimés au démarrage de Node-RED. Si vous activez ce réglage, vous recevrez après chaque déploiement un message de statut de toutes les ressources reliées au bridge.
+
+### Interroger les réglages et le statut
+
+Émet le statut et les réglages actuels du bridge dès que le message suivant est envoyé au nœud. Vous pouvez également appuyer sur le bouton dans l'interface Node-RED sans avoir à transmettre au préalable un message au nœud.
+
+: payload (boolean): Renvoie le statut actuel du bridge
+
+### Lancer un scan TouchLink
+
+Un « scan TouchLink » vous permet de coupler au bridge des appareils neufs ou anciens (p. ex. après une réinitialisation). Pour cela, transmettez l'objet `msg.payload` avec le contenu suivant :
+
+: touchLink (boolean): Couple des appareils anciens ou neufs avec le bridge
+
+### Interroger tous les appareils et ressources
+
+La commande « fetch » vous permet d'obtenir la liste de certains appareils actuellement reliés au bridge. Pour cela, transmettez l'objet `msg.payload` avec le contenu suivant :
+
+: fetch (string | array [string, ...]): Accepte `light`, `group`, `button`, `motion`, `temperature`, `light_level` ou `rule` comme valeur(s)
+
+### Modifier les réglages du Hue Bridge
+
+La commande suivante vous permet de modifier certains réglages du bridge. Transmettez au nœud l'objet `msg.payload.settings` avec les options de réglage suivantes :
+
+> [!WARNING]
+> La modification des réglages réseau nécessite de reconfigurer le bridge dans HueMagic.
+
+: name (string): Modifie le nom du bridge et doit contenir entre 4 et 16 caractères
+: zigbeeChannel (int): Modifie le canal ZigBee actuel (`11`, `15`, `20`, `25` ou `0`)
+: ipAddress (string): Modifie l'adresse IP dans les réglages réseau
+: dhcpEnabled (boolean): `true` active le DHCP dans les réglages réseau, `false` le désactive
+: netmask (string): Modifie le masque de réseau dans les réglages réseau
+: gateway (string): Définit la passerelle dans les réglages réseau
+: proxyAddress (string): Définit une adresse de proxy dans les réglages réseau
+: proxyPort (string | int): Définit le port du proxy dans les réglages réseau
+: timeZone (string): Modifie le fuseau horaire actuellement défini sur le bridge
+
+### Messages de statut du nœud
+
+Les messages de statut du nœud « Hue Bridge » sont dynamiques. Bien qu'ils suivent un certain schéma, leur contenu peut varier selon l'action qui vient d'être exécutée sur le nœud.
+
+#### Objet de statut dans `msg.payload`
+
+: id (string): ID unique du Hue Bridge
+: name (string): Nom actuellement attribué
+: factoryNew (boolean): Indique si le bridge est entièrement neuf
+: replacesBridgeId (string | boolean): Renvoie l'ancien ID du bridge (si une migration a eu lieu) ou `false`
+: dataStoreVersion (string): Version du magasin de données
+: starterKitId (string | boolean): Nom du kit de démarrage créé en usine ou `false`
+: softwareVersion (string): Version logicielle du bridge
+: apiVersion (string): Version de l'API du bridge
+: zigbeeChannel (int): Canal ZigBee actuellement utilisé
+: macAddress (string): Adresse MAC du bridge
+: ipAddress (string): Adresse IP du bridge
+: dhcpEnabled (boolean): Indique si le DHCP est activé
+: netmask (string): Masque de réseau du bridge
+: gateway (string): Passerelle du bridge
+: proxyAddress (string | boolean): Adresse de proxy actuellement utilisée ou `false`
+: proxyPort (string): Port de proxy actuellement utilisé
+: utcTime (string): Heure UTC sur le bridge
+: timeZone (string): Fuseau horaire actuellement défini sur le bridge
+: localTime (string): Fuseau horaire local
+: portalServicesEnabled (boolean): Indique si les services du portail sont activés
+: portalConnected (boolean): Indique si le bridge est connecté au portail
+: linkButtonEnabled (boolean): Indique si le bouton de liaison est activé
+: touchlinkEnabled (boolean): Indique si le TouchLink est activé
+: autoUpdatesEnabled (boolean): Indique si HueMagic recherchera automatiquement les mises à jour
+: users (array [object, ...]): Liste de tous les utilisateurs du bridge (tableau d'objets)
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+: model (object): Contient les informations de modèle du bridge dans `id`, `manufacturer` et `name`
+
+#### Résultats de « fetch » dans `msg.results` (facultatif)
+
+Si la commande « fetch » a été utilisée sur le nœud, le bridge émet les résultats correspondants dans l'objet `msg.results`. Cet objet contient les groupes de ressources interrogés, qui contiennent à leur tour toutes les ressources correspondantes sous forme de tableau.
+
+#### Messages de statut globaux dans `msg.updated` (facultatif)
+
+Sauf désactivation, le nœud émet un message de statut actualisé pour chaque ressource du bridge. Le message de statut dans `msg.updated` suit le schéma de la ressource concernée et varie selon le type d'appareil mis à jour en dernier.
+
+#### Dernière commande dans `msg.command` (facultatif)
+
+Si le statut du nœud a changé suite à une commande particulière, la commande complète qui a été exécutée est également émise. Sinon, cet objet n'est pas émis par le nœud.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/fr/hue-bridge.json

@@ -0,0 +1,26 @@
+{
+	"hue-bridge": {
+		"config": {
+			"name": "Nom",
+			"input-name": "Nom du Hue Bridge",
+			"skipglobalevents-info": "Ignorer les mises à jour et messages globaux des appareils sur ce nœud",
+			"sendinitevents-node": "Ne pas supprimer l'événement d'initialisation",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Bridge",
+			"not-configured": "non configuré",
+			"connecting": "connexion…",
+			"connected": "connecté",
+			"starting-tl": "démarrage de TouchLink…",
+			"started-tl": "TouchLink démarré…",
+			"f-resources": "récupération des ressources…",
+			"updating-settings": "mise à jour des paramètres…",
+			"settings-updated": "paramètres mis à jour",
+			"input": "paramètres / récupération",
+			"output": "informations du bridge",
+			"statusmsg": "Statut interrogé avec succès…",
+			"error-not-available": "Le bridge n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec le bridge."
+		}
+	}
+}

package/huemagic/locales/fr/hue-brightness.html

@@ -0,0 +1,70 @@
+<script type="text/markdown" data-help-name="hue-brightness">
+Le nœud « Hue Luminosité » peut lire le niveau de luminosité actuel d'un capteur adapté relié au bridge.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver tous les capteurs disponibles. Si vous connaissez déjà l'ID du capteur, vous pouvez également le saisir ici manuellement. Vous pouvez attribuer en interne un nouveau nom au capteur ou conserver son nom prédéfini. En option, vous pouvez désactiver tous les messages de statut automatiques de ce nœud à l'aide du réglage « Ignorer les messages du nœud ». Le nœud n'émettra alors plus de mises à jour d'appareil. Vous pouvez également choisir que le message d'initialisation du nœud ne soit pas supprimé au démarrage de Node-RED. Si vous activez ce réglage, vous recevrez un message de statut du capteur sélectionné après chaque déploiement. Si vous préférez que le nœud reste silencieux jusqu'à ce que vous lui envoyiez quelque chose, activez « Signaler uniquement après une commande ». Il ignorera alors les changements provenant de l'application ou d'un interrupteur et ne répondra qu'à vos propres commandes.
+
+Le réglage « Sombre en dessous de » détermine à partir de quel niveau de luminosité le nœud considère qu'une pièce est sombre. Une pièce dotée d'une lampe puissante nécessite une valeur très différente d'un couloir sans fenêtre : saisissez donc simplement le nombre de lux qui convient à votre pièce. Les valeurs `dark` et `daylight` suivront alors votre réglage plutôt que la valeur par défaut de 90 lux.
+
+Si vous ne sélectionnez aucun capteur et utilisez la configuration du nœud de cette manière, le nœud fonctionne dans ce que l'on appelle le « mode universel ». Dans ce mode, le nœud reçoit et émet tous les messages de statut du même type. Vous pouvez également appliquer des réglages en mode universel à un capteur précis en transmettant l'ID du capteur correspondant sous forme de chaîne dans `msg.topic` avec vos réglages.
+
+### Interroger le statut
+
+Émet le statut actuel du capteur dès qu'un objet `msg.payload` ayant le contenu suivant est transmis au nœud. Vous pouvez également appuyer sur le bouton dans l'interface Node-RED sans avoir à transmettre au préalable un message au nœud.
+
+: status (boolean): Renvoie le statut actuel du capteur
+
+### Activer / désactiver le capteur
+
+Si nécessaire, le capteur peut être activé et désactivé à distance. Une fois désactivé, il n'enregistre plus aucun changement de luminosité et n'en émet donc plus. Pour cela, transmettez un objet ayant le contenu suivant :
+
+: payload (boolean): `true` active le capteur, `false` le désactive
+
+### Messages de statut du nœud
+
+Dès que le capteur détecte un changement de luminosité, le message de statut suivant est renvoyé :
+
+#### Objet de statut dans `msg.payload`
+
+: active (boolean): Indique si le capteur est activé ou désactivé
+: reachable (boolean | string): `true` si le capteur est connecté au bridge, `unknown` si le statut de connexion diverge
+: connectionStatus (string): Le statut de connexion actuel avec le bridge sous forme de chaîne. Peut contenir `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` comme valeur
+: lux (int): Indique la valeur LUX réelle du niveau de luminosité
+: lightLevel (int): Indique l'intensité lumineuse du capteur
+: dark (boolean): `true` si l'obscurité a été enregistrée
+: daylight (boolean): `true` si la lumière du jour a été enregistrée
+: darkThreshold (int): Le niveau de luminosité en lux en dessous duquel le nœud signale l'obscurité
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur le capteur dans `msg.info`
+
+: id (string): Indique le nouvel ID du capteur
+: idV1 (string | boolean): Indique l'ancien ID du capteur
+: uniqueId (string): L'ID unique du capteur
+: deviceId (string): L'ID unique de l'appareil
+: name (string): Le nom actuellement attribué au capteur
+: type (string): Le type du capteur (toujours `light_level`)
+: softwareVersion (string): Le micrologiciel actuel du capteur
+: battery (float): Le niveau de batterie actuel du capteur
+: batteryState (string): Le statut actuel du niveau de batterie. Peut contenir `normal`, `low` ou `critical` comme valeur
+: model (object): Contient les informations de modèle du capteur dans `id`, `manufacturer`, `name`, `type` et `certified`
+
+#### Changements d'état dans `msg.updated`
+
+Énumère sous forme d'objet les paramètres qui ont changé par rapport au dernier état du capteur. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état du capteur dans `msg.lastState`
+
+Contient l'objet de statut complet (voir les valeurs de sortie ci-dessus) du dernier état avant le dernier changement enregistré. Si HueMagic n'a pas encore enregistré le dernier état, `false` est émis.
+
+#### Dernière commande dans `msg.command` (facultatif)
+
+Si le statut du nœud a changé suite à une commande particulière, la commande complète qui a été exécutée est également émise. Sinon, cet objet n'est pas émis par le nœud.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/fr/hue-brightness.json

@@ -0,0 +1,37 @@
+{
+	"hue-brightness": {
+		"config": {
+			"name": "Nom",
+			"skipevents-node": "Ignorer les messages du nœud",
+			"sendinitevents-node": "Ne pas supprimer l'événement d'initialisation",
+			"onlycommands-node": "Signaler uniquement après une commande",
+			"unknown-error": "Une erreur est survenue. Veuillez réessayer.",
+			"bridge": "Bridge",
+			"universalevents": "Événements universels",
+			"universalevents-node": "Reçoit tous les messages des autres nœuds du même type (uniquement en mode universel)",
+			"input-name": "Nom du capteur de luminosité",
+			"searching": "Recherche de capteurs…",
+			"none-found": "Aucun capteur de luminosité trouvé !",
+			"sensor": "Capteur",
+			"all": "Tous les groupes / lumières",
+			"darkthreshold": "Sombre en dessous de"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"deactivated": "désactivé",
+			"init": "initialisation…",
+			"not-reachable": "non joignable",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Luminosité",
+			"lux": "__lux__ lux",
+			"lux-dark": "__lux__ lux (sombre)",
+			"lux-daylight": "__lux__ lux (lumière du jour)",
+			"input": "interrogation du statut",
+			"output": "luminosité (modifiée)",
+			"error-no-id": "Veuillez indiquer un ID de capteur valide.",
+			"error-not-available": "Le capteur n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec le bridge ou vérifiez si l'ID de ressource indiqué dans la configuration est valide."
+		}
+	}
+}

package/huemagic/locales/fr/hue-buttons.html

@@ -0,0 +1,61 @@
+<script type="text/markdown" data-help-name="hue-buttons">
+Le nœud « Hue Boutons » reçoit les événements de commutation des périphériques d'entrée reliés au bridge.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver tous les interrupteurs et boutons disponibles. Si vous connaissez déjà l'ID de l'interrupteur ou du bouton, vous pouvez également le saisir ici manuellement. Vous pouvez attribuer en interne un nouveau nom à l'appareil ou conserver son nom prédéfini. En option, vous pouvez désactiver tous les messages de statut automatiques de ce nœud à l'aide du réglage « Ignorer les messages du nœud ». Le nœud n'émettra alors plus d'événements de commutation. Vous pouvez également choisir que le message d'initialisation du nœud ne soit pas supprimé au démarrage de Node-RED. Si vous activez ce réglage, vous recevrez un message de statut de l'interrupteur ou du bouton sélectionné après chaque déploiement. Si vous préférez que le nœud reste silencieux jusqu'à ce que vous lui envoyiez quelque chose, activez « Signaler uniquement après une commande ». Il ignorera alors les changements provenant de l'application ou d'un interrupteur et ne répondra qu'à vos propres commandes.
+
+Si vous ne sélectionnez aucun interrupteur ou bouton et utilisez la configuration du nœud de cette manière, le nœud fonctionne dans ce que l'on appelle le « mode universel ». Dans ce mode, le nœud reçoit et émet tous les messages de statut du même type.
+
+Dans « Sorties supplémentaires », vous pouvez ajouter une sortie par plage de boutons, chacune déclenchée par une action précise (début de l'appui, fin d'un appui court, fin d'un appui long une fois qu'il a duré au moins la durée configurée, ou de façon répétée pendant qu'un appui long est en cours). La première sortie du nœud reçoit toujours chaque événement, comme auparavant ; les sorties supplémentaires ne reçoivent une copie du message que lorsque la plage de boutons et l'action correspondent toutes les deux.
+
+### Interroger le statut
+
+Émet le statut actuel de l'interrupteur ou du bouton dès qu'un objet `msg.payload` ayant le contenu suivant est transmis au nœud. Vous pouvez également appuyer sur le bouton dans l'interface Node-RED sans avoir à transmettre au préalable un message au nœud.
+
+: status (boolean): Renvoie le statut actuel de l'interrupteur ou du bouton
+
+### Messages de statut du nœud
+
+Dès qu'une touche est actionnée, le nœud renvoie le message de statut suivant :
+
+#### Objet de statut dans `msg.payload`
+
+: reachable (boolean | string): `true` si l'interrupteur ou le bouton est connecté au bridge, `unknown` si le statut de connexion diverge
+: connectionStatus (string): Le statut de connexion actuel avec le bridge sous forme de chaîne. Peut contenir `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` comme valeur
+: button (int | boolean): ID numérique de la touche actionnée en dernier ou `false` si aucune touche n'a été actionnée
+: action (string | boolean): `false` si aucune touche n'a été actionnée, ou `initial_press`, `repeat`, `short_release`, `long_press`, `long_release` ou `double_short_release` sous forme de chaîne
+: rotation (object | boolean): `false` si l'appareil n'a pas de molette ou n'a pas été tourné ; sinon un objet avec `action` (`start` ou `repeat`), `direction` (`clock_wise` ou `counter_clock_wise`), `clockwise` (booléen), `steps` (1000 pas correspondent à un tour complet), `degrees` et `duration` en millisecondes
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur l'interrupteur ou le bouton dans `msg.info`
+
+: id (string): Indique le nouvel ID de l'interrupteur ou du bouton
+: idV1 (string | boolean): Indique l'ancien ID de l'interrupteur ou du bouton
+: uniqueId (string): L'ID unique de l'interrupteur ou du bouton
+: deviceId (string): L'ID unique de l'appareil
+: name (string): Le nom actuellement attribué à l'interrupteur ou au bouton
+: type (string): Le type de l'interrupteur ou du bouton (toujours `button`)
+: softwareVersion (string): Le micrologiciel actuel de l'interrupteur ou du bouton
+: battery (float | boolean): Le niveau de batterie actuel de l'interrupteur ou du bouton, `false` s'il n'y a pas de batterie
+: batteryState (string | boolean): Le statut actuel du niveau de batterie. Peut contenir `normal`, `low` ou `critical` comme valeur, `false` s'il n'y a pas de batterie
+: model (object): Contient les informations de modèle de l'interrupteur ou du bouton dans `id`, `manufacturer`, `name`, `type` et `certified`
+
+#### Changements d'état dans `msg.updated`
+
+Énumère sous forme d'objet les paramètres qui ont changé par rapport au dernier état de l'interrupteur ou du bouton. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état de l'interrupteur ou du bouton dans `msg.lastState`
+
+Contient l'objet de statut complet (voir les valeurs de sortie ci-dessus) du dernier état avant le dernier changement enregistré. Si HueMagic n'a pas encore enregistré le dernier état, `false` est émis.
+
+#### Dernière commande dans `msg.command` (facultatif)
+
+Si le statut du nœud a changé suite à une commande particulière, la commande complète qui a été exécutée est également émise. Sinon, cet objet n'est pas émis par le nœud.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/fr/hue-buttons.json

@@ -0,0 +1,62 @@
+{
+	"hue-buttons": {
+		"config": {
+			"name": "Nom",
+			"skipevents-node": "Ignorer les messages du nœud",
+			"sendinitevents-node": "Ne pas supprimer l'événement d'initialisation",
+			"onlycommands-node": "Signaler uniquement après une commande",
+			"unknown-error": "Une erreur est survenue. Veuillez réessayer.",
+			"bridge": "Bridge",
+			"universalevents": "Événements universels",
+			"universalevents-node": "Reçoit tous les messages des autres nœuds du même type (uniquement en mode universel)",
+			"input-name": "Nom du bouton",
+			"searching": "Recherche de Hue Buttons…",
+			"none-found": "Aucun Hue Button trouvé !",
+			"button": "Bouton",
+			"add-outputs": "Sorties supplémentaires...",
+			"add-outputs-range": "Plage de boutons...",
+			"add-outputs-newflow": "Déclencher un nouveau flux sur...",
+			"add-outputs-nr": "Sortie n°",
+			"add-outputs-btn-from": "De...",
+			"add-outputs-btn-to": "À...",
+			"add-outputs-startpress": "Début de l'appui",
+			"add-outputs-shortpress": "Fin d'appui court",
+			"add-outputs-longpress": "Fin d'appui long quand >",
+			"add-outputs-longpresswhile": "Appui long (pendant le maintien)",
+			"add-outputs-btn-addnew": "ajouter une nouvelle plage de boutons",
+			"outputlabel-btn-from": "bouton #__from__",
+			"outputlabel-btn-from-to": "boutons #__from__ à #__to__",
+			"outputlabel-btn-on": "sur :",
+			"outputlabel-btn-startpress": "Début de l'appui",
+			"outputlabel-btn-shortpress": "Fin d'appui court",
+			"outputlabel-btn-longpress": "Appui long (>__duration__s)",
+			"outputlabel-btn-longpresswhile": "Appui long (pendant le maintien)"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Boutons",
+			"waiting": "en attente…",
+			"button-on": "On",
+			"action-pressed": "appuyé",
+			"action-holded": "maintenu",
+			"action-shortreleased": "relâché brièvement",
+			"action-longreleased": "relâché après maintien",
+			"action-repeated": "répété",
+			"action-doublepressed": "double appui",
+			"action-started": "début d'appui",
+			"dial-clockwise": "Molette ↻ __degrees__°",
+			"dial-counterclockwise": "Molette ↺ __degrees__°",
+			"button-status": "Bouton n° __button__ (__action__)",
+			"button-status-duration": "Bouton n° __button__ (__action__, __duration__s)",
+			"input": "interrogation du statut",
+			"output": "bouton appuyé",
+			"error-no-id": "Veuillez indiquer un ID de interrupteur valide.",
+			"error-not-available": "L'interrupteur n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec le bridge ou vérifiez si l'ID de ressource indiqué dans la configuration est valide.",
+			"error-no-switchmode": "Cet appareil n'a pas de mode d'interrupteur configurable.",
+			"error-invalid-switchmode": "Mode d'interrupteur non valide. Cet appareil prend en charge : __modes__"
+		}
+	}
+}

package/huemagic/locales/fr/hue-contact.html

@@ -0,0 +1,67 @@
+<script type="text/markdown" data-help-name="hue-contact">
+Le nœud « Hue Contact » indique si un capteur de contact (p. ex. Hue Secure) est actuellement ouvert ou fermé.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver tous les capteurs disponibles. Si vous connaissez déjà l'ID du capteur, vous pouvez également le saisir ici manuellement. Vous pouvez attribuer en interne un nouveau nom au capteur ou conserver son nom prédéfini. En option, vous pouvez désactiver tous les messages de statut automatiques de ce nœud à l'aide du réglage « Ignorer les messages du nœud ». Le nœud n'émettra alors plus de mises à jour d'appareil. Vous pouvez également choisir que le message d'initialisation du nœud ne soit pas supprimé au démarrage de Node-RED. Si vous activez ce réglage, vous recevrez un message de statut du capteur sélectionné après chaque déploiement. Si vous préférez que le nœud reste silencieux jusqu'à ce que vous lui envoyiez quelque chose, activez « Signaler uniquement après une commande ». Il ignorera alors les changements provenant de l'application ou d'un interrupteur et ne répondra qu'à vos propres commandes.
+
+Si vous ne sélectionnez aucun capteur et utilisez la configuration du nœud de cette manière, le nœud fonctionne dans ce que l'on appelle le « mode universel ». Dans ce mode, le nœud reçoit et émet tous les messages de statut du même type. Vous pouvez également appliquer des réglages en mode universel à un capteur précis en transmettant l'ID du capteur correspondant sous forme de chaîne dans `msg.topic` avec vos réglages.
+
+### Interroger le statut
+
+Émet le statut actuel du capteur dès qu'un objet `msg.payload` ayant le contenu suivant est transmis au nœud. Vous pouvez également appuyer sur le bouton dans l'interface Node-RED sans avoir à transmettre au préalable un message au nœud.
+
+: status (boolean): Renvoie le statut actuel du capteur
+
+### Activer / désactiver le capteur
+
+Si nécessaire, le capteur peut être activé et désactivé à distance. Une fois désactivé, il n'enregistre plus aucun changement de contact et n'en émet donc plus. Pour cela, transmettez un objet ayant le contenu suivant :
+
+: payload (boolean): `true` active le capteur, `false` le désactive
+
+### Messages de statut du nœud
+
+Dès que le contact change, le nœud renvoie le message de statut suivant :
+
+#### Objet de statut dans `msg.payload`
+
+: active (boolean): Indique si le capteur est activé ou désactivé
+: reachable (boolean | string): `true` si le capteur est connecté au bridge, `unknown` si le statut de connexion diverge
+: connectionStatus (string): Le statut de connexion actuel avec le bridge sous forme de chaîne. Peut contenir `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` comme valeur
+: contact (string | boolean): `contact` si le contact est fermé, `no_contact` s'il est ouvert ou `false` si le capteur n'a pas encore transmis de valeur
+: changed (string | boolean): Heure du dernier changement de contact (ISO 8601) ou `false` si le capteur n'a pas encore transmis de valeur
+: tampered (boolean): Disponible uniquement sur les capteurs dotés d'une détection de manipulation ; `true` si le capteur a été manipulé
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur le capteur dans `msg.info`
+
+: id (string): Indique le nouvel ID du capteur
+: idV1 (string | boolean): Indique l'ancien ID du capteur
+: uniqueId (string): L'ID unique du capteur
+: deviceId (string): L'ID unique de l'appareil
+: name (string): Le nom actuellement attribué au capteur
+: type (string): Le type du capteur (toujours `contact`)
+: softwareVersion (string): Le micrologiciel actuel du capteur
+: battery (float | boolean): Le niveau de batterie actuel du capteur, `false` s'il n'y a pas de batterie
+: batteryState (string | boolean): Le statut actuel du niveau de batterie. Peut contenir `normal`, `low` ou `critical` comme valeur, `false` s'il n'y a pas de batterie
+: model (object): Contient les informations de modèle du capteur dans `id`, `manufacturer`, `name`, `type` et `certified`
+
+#### Changements d'état dans `msg.updated`
+
+Énumère sous forme d'objet les paramètres qui ont changé par rapport au dernier état du capteur. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état du capteur dans `msg.lastState`
+
+Contient l'objet de statut complet (voir les valeurs de sortie ci-dessus) du dernier état avant le dernier changement enregistré. Si HueMagic n'a pas encore enregistré le dernier état, `false` est émis.
+
+#### Dernière commande dans `msg.command` (facultatif)
+
+Si le statut du nœud a changé suite à une commande particulière, la commande complète qui a été exécutée est également émise. Sinon, cet objet n'est pas émis par le nœud.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+
+</script>

package/huemagic/locales/fr/hue-contact.json

@@ -0,0 +1,35 @@
+{
+	"hue-contact": {
+		"config": {
+			"name": "Nom",
+			"skipevents-node": "Ignorer les messages du nœud",
+			"sendinitevents-node": "Ne pas supprimer l'événement d'initialisation",
+			"onlycommands-node": "Signaler uniquement après une commande",
+			"unknown-error": "Une erreur est survenue. Veuillez réessayer.",
+			"bridge": "Bridge",
+			"universalevents": "Événements universels",
+			"universalevents-node": "Reçoit tous les messages des autres nœuds du même type (uniquement en mode universel)",
+			"input-name": "Nom du capteur",
+			"searching": "Recherche de capteurs de contact…",
+			"none-found": "Aucun capteur de contact trouvé !",
+			"sensor": "Capteur"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"not-reachable": "non joignable",
+			"activated": "activé",
+			"deactivated": "désactivé",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Contact",
+			"contact": "contact",
+			"no-contact": "pas de contact",
+			"input": "activer / désactiver / statut",
+			"output": "contact",
+			"tampered": "manipulé",
+			"error-no-id": "Veuillez indiquer un ID de capteur valide.",
+			"error-not-available": "Le capteur n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec le bridge ou vérifiez si l'ID de ressource indiqué dans la configuration est valide."
+		}
+	}
+}

package/huemagic/locales/fr/hue-group.html

@@ -0,0 +1,87 @@
+<script type="text/markdown" data-help-name="hue-group">
+Le nœud « Hue Groupe » peut commander simultanément plusieurs lumières regroupées sur le bridge.
+
+### Configuration
+
+Sélectionnez le Hue Bridge préconfiguré et cliquez sur le bouton de recherche pour trouver tous les groupes disponibles. Si vous connaissez déjà l'ID d'un groupe, vous pouvez également le saisir ici manuellement. Vous pouvez attribuer en interne un nouveau nom au groupe ou conserver son nom prédéfini. En option, vous pouvez désactiver tous les messages de statut automatiques de ce nœud à l'aide du réglage « Ignorer les messages du nœud ». Le nœud n'émettra alors plus de mises à jour. Vous pouvez également choisir que le message d'initialisation du nœud ne soit pas supprimé au démarrage de Node-RED. Si vous activez ce réglage, vous recevrez un message de statut du groupe sélectionné après chaque déploiement. Si vous préférez que le nœud reste silencieux jusqu'à ce que vous lui envoyiez quelque chose, activez « Signaler uniquement après une commande ». Il ignorera alors les changements provenant de l'application ou d'un interrupteur et ne répondra qu'à vos propres commandes.
+
+Si vous ne sélectionnez aucun groupe et utilisez la configuration du nœud de cette manière, le nœud fonctionne dans ce que l'on appelle le « mode universel ». Dans ce mode, le nœud reçoit et émet tous les messages de statut du même type. Vous pouvez également appliquer des réglages en mode universel à un groupe précis en transmettant l'ID du groupe correspondant sous forme de chaîne dans `msg.topic` avec vos réglages.
+
+### Interroger le statut
+
+Émet le statut actuel du groupe dès qu'un objet `msg.payload` ayant le contenu suivant est transmis au nœud. Vous pouvez également appuyer sur le bouton dans l'interface Node-RED sans avoir à transmettre au préalable un message au nœud.
+
+: status (boolean): Renvoie le statut actuel du groupe
+
+### Allumer / éteindre (mode simple)
+
+Pour allumer ou éteindre rapidement tout un groupe en mode simple, transmettez au nœud un objet ayant le contenu suivant.
+
+: payload (boolean): `true` allume tout le groupe, `false` l'éteint
+
+### Commandes de groupe (étendu)
+
+Outre le simple allumage et extinction, de nombreuses autres options sont disponibles pour commander le groupe. Tous les nœuds de HueMagic peuvent être pilotés avec des commandes additives. Cela signifie que vous pouvez transmettre d'abord un réglage, puis un autre dans une commande ultérieure sans annuler le réglage précédent. Transmettez les paramètres suivants dans un objet `msg.payload` pour effectuer des réglages plus poussés sur le groupe :
+
+: on (boolean): `true` allume l'ensemble du groupe, `false` l'éteint
+: toggle (boolean | any): Bascule entre allumage et extinction, selon le statut précédent du groupe
+: brightness (int | string): Valeur en pourcentage de la luminosité (0-100) ou une chaîne contenant la valeur `auto` pour régler automatiquement la luminosité en fonction de l'heure actuelle
+: brightnessLevel (int): Valeur numérique de la luminosité (0-254)
+: incrementBrightness (int): Valeur en pourcentage d'une variation relative de luminosité. La plage valide va de -100 % à +100 %. Les valeurs positives augmentent la luminosité. La valeur par défaut est +10 %
+: decrementBrightness (int): Valeur en pourcentage d'une variation relative de luminosité. La plage valide va de -100 % à +100 %. Les valeurs positives diminuent la luminosité. La valeur par défaut est +10 %
+: color (string): `random` pour définir une couleur aléatoire ou un nom de couleur en anglais (p. ex. `red`)
+: hex (string): Valeur de couleur en hexadécimal sous forme de chaîne
+: rgb (array [0,0,0]): Valeur de couleur au format RGB sous forme de tableau
+: xyColor (object {x [float], y [float]}): Valeur de couleur au format XY sous forme d'objet
+: image (string): Chemin d'une image (locale ou sur le web) pour régler la couleur actuelle du groupe sur la couleur moyenne de l'image
+: colorTemp (int | string): Valeur comprise entre 153 et 500 pour régler la température de couleur du groupe, ou les valeurs `cold`, `normal`, `warm`, `hot` et `auto` — `auto` correspondant à la température de couleur basée sur l'heure actuelle
+: transitionTime (float): Temps de transition du réglage actuel en secondes. Si `0` est transmis, le groupe passe immédiatement au réglage souhaité. Si vous transmettez `3`, le groupe passe au réglage souhaité avec une légère transition sur les 3 secondes suivantes
+: colorloop (float): Joue une animation « colorloop » pendant la durée choisie en secondes, puis rétablit l'état d'origine du groupe
+: alert (float): Joue une animation « alert » pendant la durée choisie en secondes, puis rétablit l'état d'origine du groupe
+
+### Messages de statut du nœud
+
+Lorsqu'un changement est détecté dans le groupe, le nœud renvoie le message de statut suivant.
+
+> [!NOTE]
+> Le groupe n'émet des messages de statut que lorsque la dernière lumière est éteinte ou lorsque la première est allumée (si toutes étaient éteintes auparavant).
+
+Contrairement au nœud « Hue Lumière », vous disposez ici de beaucoup moins d'informations de statut, car un groupe peut contenir de nombreux types d'appareils différents avec des valeurs qui ne peuvent pas être combinées.
+
+#### Objet de statut dans `msg.payload`
+
+: on (boolean): État du groupe, où `true` signifie allumé et `false` éteint
+: brightness (float | boolean): Luminosité du groupe en pourcentage ou `false` si le groupe ne peut pas être variée
+: brightnessLevel (int | boolean): Luminosité du groupe sous forme de valeur numérique (0-254) ou `false` si le groupe ne peut pas être variée
+: rgb (array [0,0,0]): Couleur actuelle du groupe au format RGB (uniquement si disponible)
+: hex (string): Couleur actuelle du groupe au format hexadécimal (uniquement si disponible)
+: xyColor (object {x [float], y [float]}): Couleur actuelle du groupe au format XY (uniquement si disponible)
+: colorTemp (int): Température de couleur actuellement définie pour le groupe (uniquement si disponible)
+: updated (string): Heure de la dernière mise à jour de la ressource par HueMagic (ISO 8601)
+
+#### Informations sur le groupe dans `msg.info`
+
+: id (string): Indique le nouvel ID du groupe
+: idV1 (string | boolean): Indique l'ancien ID du groupe
+: name (string): Le nom actuellement attribué au groupe
+: resources (object) : Contient tous les appareils et ressources rattachés au groupe
+: type (string): Le type du groupe (toujours `group`)
+
+#### Changements d'état dans `msg.updated`
+
+Énumère sous forme d'objet les paramètres qui ont changé par rapport au dernier état du groupe. Si aucun changement n'a été enregistré, cet objet est vide.
+
+#### Dernier état de la lumière dans `msg.lastState`
+
+Contient l'objet de statut complet (voir les valeurs de sortie ci-dessus) du dernier état avant le dernier changement. Si HueMagic n'a pas encore enregistré le dernier état, `false` est émis.
+
+#### Dernière commande dans `msg.command` (facultatif)
+
+Si le statut du nœud a changé suite à une commande particulière, la commande complète qui a été exécutée est également émise. Sinon, cet objet n'est pas émis par le nœud.
+
+### Exemples de HueMagic
+
+HueMagic met à disposition quelques exemples de configuration pour ce nœud. Pour importer un exemple complet dans votre interface Node-RED, cliquez sur l'icône de menu de Node-RED, sélectionnez « Importer » puis naviguez vers « Exemples » dans la barre latérale de la fenêtre. Sélectionnez ensuite le dossier HueMagic et le nœud souhaité pour importer un flux d'exemple.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/fr/hue-group.json

@@ -0,0 +1,46 @@
+{
+	"hue-group": {
+		"config": {
+			"name": "Nom",
+			"skipevents-node": "Ignorer les messages du nœud",
+			"sendinitevents-node": "Ne pas supprimer l'événement d'initialisation",
+			"onlycommands-node": "Signaler uniquement après une commande",
+			"unknown-error": "Une erreur est survenue. Veuillez réessayer.",
+			"bridge": "Bridge",
+			"universalevents": "Événements universels",
+			"universalevents-node": "Reçoit tous les messages des autres nœuds du même type (uniquement en mode universel)",
+			"colornamer": "Colornamer",
+			"colornamer-info": "Activer la dénomination des couleurs",
+			"input-name": "Nom du groupe",
+			"searching": "Recherche de groupes…",
+			"none-found": "Aucun groupe trouvé !",
+			"group": "Groupe",
+			"all": "Tous les groupes / lumières"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"init": "initialisation…",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Groupe",
+			"brightness": " (__percent__ %)",
+			"all-on": "toutes les lumières allumées",
+			"all-off": "toutes les lumières éteintes",
+			"some-on": "certaines lumières allumées",
+			"turned-on": "allumé",
+			"error-input": "erreur de saisie",
+			"error-no-id": "Aucun ID de groupe indiqué.",
+			"error-invalid-sat": "Réglage de saturation non valide. Seules les valeurs de 0 à 254 sont autorisées.",
+			"error-invalid-temp": "Température de couleur non valide. Seules les valeurs de 153 à 500 sont autorisées.",
+			"input": "allumer / éteindre",
+			"output": "statut",
+			"error-not-available": "Le groupe n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec le bridge ou vérifiez si l'ID de ressource indiqué dans la configuration est valide.",
+			"error-invalid-brightness": "Réglage de luminosité non valide. Seules les valeurs de 0 à 100 pour cent sont autorisées.",
+			"error-invalid-brightness-level": "Réglage de luminosité non valide. Seules les valeurs de 0 à 254 sont autorisées.",
+			"error-invalid-increment": "Réglage incrementBrightness non valide. Seules les valeurs de -100 % à 100 % sont autorisées.",
+			"error-invalid-decrement": "Réglage decrementBrightness non valide. Seules les valeurs de -100 % à 100 % sont autorisées.",
+			"error-no-colorloop": "L'effet colorloop n'est pas disponible pour ce groupe."
+		}
+	}
+}