node-red-contrib-huemagic 4.2.2 → 5.0.0

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

@@ -0,0 +1,30 @@
+{
+	"hue-syncbox": {
+		"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",
+			"input-name": "Nom de la Sync Box",
+			"syncbox": "Sync Box"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"command": "exécution de la commande…",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Sync Box",
+			"connecting": "connexion…",
+			"powersave": "éteinte",
+			"passthrough": "passage direct",
+			"syncing": "__mode__ (__intensity__)",
+			"input": "commander la sync box",
+			"output": "sync box",
+			"error-not-available": "La sync box n'est pas encore disponible. Veuillez attendre que HueMagic ait établi la connexion avec elle.",
+			"error-invalid-mode": "Mode non valide. Modes autorisés : __modes__",
+			"error-invalid-intensity": "Intensité non valide. Intensités autorisées : __intensities__",
+			"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 à 200 sont autorisées.",
+			"error-invalid-input": "Entrée HDMI non valide. Seules input1 à input4 sont autorisées."
+		}
+	}
+}

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

@@ -0,0 +1,69 @@
+<script type="text/markdown" data-help-name="hue-temperature">
+Le nœud « Hue Température » peut interroger et signaler la température ambiante actuelle 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.
+
+Les détecteurs de mouvement sont généralement installés dans un coin de la pièce et mesurent souvent une température un peu trop élevée à cause de leur propre électronique. Le réglage « Correction » vous permet d'étalonner le capteur sans détour : la valeur que vous saisissez ici (p. ex. `-1.5`) est ajoutée à chaque valeur mesurée avant que le nœud ne l'émette. La correction s'applique simultanément à toutes les unités de température.
+
+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 température 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 enregistre un changement de température, 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
+: celsius (float): Indique la température ambiante actuelle en °C (degrés Celsius)
+: fahrenheit (float): Indique la température ambiante actuelle en °F (degrés Fahrenheit)
+: temperatureIs (string): Décrit la température actuelle avec les valeurs `very cold`, `cold`, `slightly cold`, `comfortable`, `slightly warm`, `warm`, `hot` ou `very hot`
+: deviceValue (float): La valeur d'origine de la température fournie par le capteur
+: 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 `temperature`)
+: 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-temperature.json

@@ -0,0 +1,33 @@
+{
+	"hue-temperature": {
+		"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 température…",
+			"none-found": "Aucun capteur de température trouvé.",
+			"sensor": "Capteur",
+			"offset": "Correction"
+		},
+		"node": {
+			"not-configured": "non configuré",
+			"init": "initialisation…",
+			"not-reachable": "non joignable",
+			"universal": "mode universel",
+			"command": "exécution de la commande…",
+			"deactivated": "désactivé",
+			"statusmsg": "Statut interrogé avec succès…",
+			"title": "Hue Température",
+			"input": "interrogation du statut",
+			"output": "température (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/it/hue-automation.html

@@ -0,0 +1,59 @@
+<script type="text/markdown" data-help-name="hue-automation">
+Il nodo «Hue Automazione» può attivare e disattivare le automazioni create nell'app Philips Hue.
+
+### Configurazione
+
+Selezioni il Hue Bridge preconfigurato e faccia clic sul pulsante di ricerca per trovare tutte le automazioni disponibili. Se conosce già l'ID dell'automazione, può anche inserirlo qui manualmente. Può assegnare internamente un nuovo nome all'automazione oppure mantenere quello predefinito. Facoltativamente può disattivare tutti i messaggi di stato automatici di questo nodo tramite l'impostazione «Ignora i messaggi del nodo». Il nodo non emetterà più aggiornamenti. In alternativa può scegliere che il messaggio di inizializzazione del nodo non venga soppresso all'avvio di Node-RED. Attivando questa impostazione riceverà un messaggio di stato dell'automazione selezionata dopo ogni deploy. Se preferisce che il nodo resti in silenzio finché non gli invia qualcosa, attivi «Segnala solo dopo un comando». In tal caso ignorerà le modifiche provenienti dall'app o da un interruttore e risponderà solo ai suoi comandi.
+
+Se non seleziona alcuna automazione e utilizza così la configurazione del nodo, il nodo funziona nella cosiddetta «modalità universale». In questa modalità il nodo riceve ed emette tutti i messaggi di stato dello stesso tipo. Può anche applicare impostazioni in modalità universale a un'automazione specifica trasmettendo il relativo ID come stringa in `msg.topic` insieme alle sue impostazioni.
+
+### Attivare / disattivare l'automazione
+
+Un'automazione disattivata rimane sul bridge e può essere riattivata in qualsiasi momento. A tal fine, trasmetta un oggetto con il seguente contenuto:
+
+: payload (boolean): `true` attiva l'automazione, `false` la disattiva
+: enabled (boolean): Come sopra, se preferisce trasmettere un oggetto
+: toggle (boolean | any): Alterna tra attivata e disattivata, a seconda dello stato precedente
+
+### Messaggi di stato del nodo
+
+Non appena l'automazione cambia, il nodo restituisce il seguente messaggio di stato:
+
+#### Oggetto di stato in `msg.payload`
+
+: enabled (boolean): Indica se l'automazione è attivata
+: running (boolean): `true` mentre il bridge sta effettivamente eseguendo l'automazione
+: status (string | boolean): Lo stato attuale. Può contenere `initializing`, `running`, `disabled` o `errored` come valore
+: lastError (string | boolean): L'ultimo errore segnalato dal bridge o `false`
+: updated (string): Momento dell'ultimo aggiornamento della risorsa da parte di HueMagic (ISO 8601)
+
+#### Informazioni sull'automazione in `msg.info`
+
+: id (string): Indica l'ID dell'automazione
+: idV1 (string | boolean): Indica il vecchio ID dell'automazione
+: name (string | boolean): Il nome che ha assegnato all'automazione nell'app Philips Hue
+: type (string): Il tipo di risorsa (sempre `automation`)
+: script (string | boolean): L'ID dello script di comportamento alla base dell'automazione
+
+#### Configurazione in `msg.configuration`
+
+Contiene le impostazioni dell'automazione così come sono state salvate dall'app Philips Hue. La struttura dipende dal tipo di automazione e viene trasmessa senza modifiche.
+
+#### Variazioni di stato in `msg.updated`
+
+Elenca sotto forma di oggetto i singoli parametri modificati rispetto all'ultimo stato dell'automazione. Se non è stata registrata alcuna modifica, questo oggetto è vuoto.
+
+#### Ultimo stato dell'automazione in `msg.lastState`
+
+Contiene l'oggetto di stato completo (vedi i valori di uscita sopra) dell'ultimo stato prima dell'ultima modifica registrata. Se HueMagic non ha ancora registrato l'ultimo stato, viene emesso `false`.
+
+#### Ultimo comando in `msg.command` (facoltativo)
+
+Se lo stato del nodo è cambiato a seguito di un determinato comando, viene emesso anche l'intero comando eseguito. In caso contrario, il nodo non emette questo oggetto.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/it/hue-automation.json

@@ -0,0 +1,33 @@
+{
+	"hue-automation": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignora i messaggi del nodo",
+			"sendinitevents-node": "Non sopprimere l'evento di inizializzazione",
+			"onlycommands-node": "Segnala solo dopo un comando",
+			"unknown-error": "Qualcosa è andato storto. Riprovi.",
+			"bridge": "Bridge",
+			"universalevents": "Eventi universali",
+			"universalevents-node": "Riceve tutti i messaggi dagli altri nodi dello stesso tipo (solo in modalità universale)",
+			"input-name": "Nome dell'automazione",
+			"searching": "Ricerca di automazioni…",
+			"none-found": "Nessuna automazione trovata!",
+			"automation": "Automazione"
+		},
+		"node": {
+			"not-configured": "non configurato",
+			"init": "inizializzazione…",
+			"universal": "modalità universale",
+			"command": "esecuzione del comando…",
+			"statusmsg": "Stato interrogato correttamente…",
+			"title": "Hue Automazione",
+			"enabled": "attivata",
+			"disabled": "disattivata",
+			"errored": "errore",
+			"input": "attiva / disattiva",
+			"output": "automazione",
+			"error-no-id": "Indichi un ID automazione valido.",
+			"error-not-available": "L'automazione non è ancora disponibile. Attenda che HueMagic abbia stabilito la connessione con il bridge oppure verifichi se l'ID della risorsa indicato nella configurazione è valido."
+		}
+	}
+}

package/huemagic/locales/it/hue-bridge-config.html

@@ -0,0 +1,31 @@
+<script type="text/markdown" data-help-name="hue-bridge">
+Si collega a un Philips Hue Bridge.
+
+### Nome
+
+Può assegnare al bridge un nome interno alternativo oppure mantenere quello predefinito.
+
+### IP e porta del bridge
+
+Inserisca manualmente l'indirizzo IP del Hue Bridge oppure prema il pulsante per elencare tutti i bridge disponibili localmente (si consiglia una configurazione IP statica sul Hue Bridge). Facoltativamente può anche definire una porta alternativa per il bridge aggiungendo i due punti all'indirizzo IP.
+
+### Chiave API
+
+Inserisca manualmente la chiave API del Hue Bridge oppure prema il pulsante per creare una nuova chiave. Se desidera creare una nuova chiave, deve premere il pulsante fisico del bridge entro 20 secondi per completare la procedura.
+
+### Processi
+
+Il valore «Processi» determina quanti comandi paralleli HueMagic può inviare contemporaneamente al bridge. Secondo la documentazione ufficiale del Philips Hue Bridge non dovrebbero essere inviati più di 10 comandi al secondo, altrimenti si rischia che il bridge non riesca a elaborare le richieste con la stessa rapidità e restituisca errori.
+
+Se vengono inviati contemporaneamente più comandi del valore qui impostato, HueMagic li eseguirà in sequenza non appena sarà di nuovo possibile.
+
+Imposti questo valore sotto 10 (ad es. da 4 a 7) se invia comandi al bridge anche al di fuori di HueMagic, per rispettare il numero di comandi al secondo consigliato da Philips Hue.
+
+### Aggiornamenti automatici del firmware
+
+HueMagic verifica periodicamente la disponibilità di aggiornamenti del firmware Philips Hue e li installa automaticamente quando sono disponibili. Può disattivare questo comportamento facendo clic sulla relativa casella di controllo.
+
+### Disattivare le notifiche
+
+Attivando questa impostazione, tutti i nodi collegati a questo bridge non riceveranno più messaggi di stato automatici.
+</script>

package/huemagic/locales/it/hue-bridge-config.json

@@ -0,0 +1,40 @@
+{
+	"hue-bridge-config": {
+		"config": {
+			"name": "Nome",
+			"apikey": "Chiave API",
+			"missing-ip": "IP del Hue Bridge mancante…",
+			"disable-events": "Disattiva gli eventi",
+			"disable-events-info": "Disattiva gli eventi su tutti i nodi",
+			"searching": "Ricerca di Hue Bridge…",
+			"none-found": "Nessun Hue Bridge trovato!",
+			"unknown-error": "Qualcosa è andato storto. Riprovi.",
+			"invalid": "Spiacenti. Il Hue Bridge selezionato non è valido: ",
+			"error-select-first": "Selezioni il suo Hue Bridge prima di creare un nuovo utente!",
+			"waiting": "in attesa del pulsante di collegamento…",
+			"new-user-press": "Prema ora il pulsante del suo Hue Bridge per creare un nuovo utente!",
+			"retry": "Nessuna pressione rilevata. Riprovi…",
+			"success": "Utente creato correttamente!",
+			"connecting": "Connessione al bridge…",
+			"autoupdates": "Attiva gli aggiornamenti automatici del firmware",
+			"bridge-ip": "IP del bridge",
+			"worker": "Processi"
+		},
+		"node": {
+			"title": "Hue Bridge",
+			"statusmsg": "Stato interrogato correttamente…",
+			"initializing": "Inizializzazione del bridge (__bridge__)…",
+			"connected": "Connesso al bridge",
+			"processing": "Elaborazione delle risorse del bridge…",
+			"initial-emit": "Emissione iniziale degli stati delle risorse…",
+			"keep-updated": "Mantenimento dei nodi aggiornati…",
+			"subscribing": "Sottoscrizione agli eventi del bridge…",
+			"unsubscribing": "Annullamento della sottoscrizione agli eventi del bridge…",
+			"no-legacy-api": "Il bridge non risponde sulla vecchia API, si prosegue senza la sua configurazione…",
+			"request-error": "Errore durante la richiesta di informazioni al bridge (__error__)",
+			"connection-lost": "Connessione al bridge persa (__reason__). Nuovo tentativo tra __seconds__ secondi…",
+			"resources-changed": "Le risorse del bridge sono cambiate. Ricaricamento…",
+			"not-connected": "Il bridge non è connesso."
+		}
+	}
+}

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

@@ -0,0 +1,96 @@
+<script type="text/markdown" data-help-name="hue-bridge-node">
+Il nodo «Hue Bridge» è un nodo universale in grado di emettere tutte le impostazioni del bridge e i messaggi di stato degli altri nodi.
+
+### Configurazione
+
+Selezioni prima il Hue Bridge desiderato. Facoltativamente può disattivare tutti i messaggi di stato automatici di questo nodo tramite l'impostazione «Ignora gli aggiornamenti e i messaggi globali dei dispositivi su questo nodo». Il nodo non emetterà più aggiornamenti del dispositivo.
+
+In alternativa può scegliere che i messaggi di inizializzazione di tutti i nodi non vengano soppressi all'avvio di Node-RED. Attivando questa impostazione riceverà, dopo ogni deploy, un messaggio di stato da tutte le risorse collegate al bridge.
+
+### Richiedere impostazioni e stato
+
+Emette lo stato e le impostazioni attuali del bridge non appena al nodo viene inviato il seguente messaggio. In alternativa può anche premere il pulsante nell'interfaccia di Node-RED senza dover inviare prima un messaggio al nodo.
+
+: payload (boolean): Restituisce lo stato attuale del bridge
+
+### Avviare una scansione TouchLink
+
+Con una «scansione TouchLink» può abbinare al bridge dispositivi nuovi o vecchi (ad es. dopo un ripristino). A tal fine, trasmetta l'oggetto `msg.payload` con il seguente contenuto:
+
+: touchLink (boolean): Abbina dispositivi vecchi o nuovi al bridge
+
+### Richiedere tutti i dispositivi e le risorse
+
+Con il comando «fetch» può ottenere un elenco di determinati dispositivi attualmente collegati al bridge. A tal fine, trasmetta l'oggetto `msg.payload` con il seguente contenuto:
+
+: fetch (string | array [string, ...]): Accetta `light`, `group`, `button`, `motion`, `temperature`, `light_level` o `rule` come valore/i
+
+### Modificare le impostazioni del Hue Bridge
+
+Con il seguente comando può modificare determinate impostazioni sul bridge. Trasmetta al nodo l'oggetto `msg.payload.settings` con le seguenti opzioni:
+
+> [!WARNING]
+> La modifica delle impostazioni di rete richiede la riconfigurazione del bridge in HueMagic.
+
+: name (string): Modifica il nome del bridge e deve contenere da 4 a 16 caratteri
+: zigbeeChannel (int): Modifica il canale ZigBee attuale (`11`, `15`, `20`, `25` o `0`)
+: ipAddress (string): Modifica l'indirizzo IP nelle impostazioni di rete
+: dhcpEnabled (boolean): `true` attiva il DHCP nelle impostazioni di rete, `false` lo disattiva
+: netmask (string): Modifica la maschera di rete nelle impostazioni di rete
+: gateway (string): Definisce il gateway nelle impostazioni di rete
+: proxyAddress (string): Imposta un indirizzo proxy nelle impostazioni di rete
+: proxyPort (string | int): Definisce la porta del proxy nelle impostazioni di rete
+: timeZone (string): Modifica il fuso orario attualmente impostato sul bridge
+
+### Messaggi di stato del nodo
+
+I messaggi di stato del nodo «Hue Bridge» sono dinamici. Pur seguendo uno schema preciso, la loro uscita può variare a seconda dell'azione appena eseguita sul nodo.
+
+#### Oggetto di stato in `msg.payload`
+
+: id (string): ID univoco del Hue Bridge
+: name (string): Nome attualmente assegnato
+: factoryNew (boolean): Indica se il bridge è nuovo di fabbrica
+: replacesBridgeId (string | boolean): Restituisce il vecchio ID del bridge (se è stata effettuata una migrazione) oppure `false`
+: dataStoreVersion (string): Versione dell'archivio dati
+: starterKitId (string | boolean): Nome dello starter kit creato in fabbrica oppure `false`
+: softwareVersion (string): Versione software del bridge
+: apiVersion (string): Versione API del bridge
+: zigbeeChannel (int): Canale ZigBee attualmente utilizzato
+: macAddress (string): Indirizzo MAC del bridge
+: ipAddress (string): Indirizzo IP del bridge
+: dhcpEnabled (boolean): Indica se il DHCP è attivato
+: netmask (string): Maschera di rete del bridge
+: gateway (string): Gateway del bridge
+: proxyAddress (string | boolean): Indirizzo proxy attualmente utilizzato oppure `false`
+: proxyPort (string): Porta proxy attualmente utilizzata
+: utcTime (string): Ora UTC sul bridge
+: timeZone (string): Fuso orario attualmente impostato sul bridge
+: localTime (string): Fuso orario locale
+: portalServicesEnabled (boolean): Indica se i servizi del portale sono attivati
+: portalConnected (boolean): Indica se il bridge è collegato al portale
+: linkButtonEnabled (boolean): Indica se il pulsante di collegamento è attivo
+: touchlinkEnabled (boolean): Indica se TouchLink è attivo
+: autoUpdatesEnabled (boolean): Indica se HueMagic verificherà automaticamente la disponibilità di aggiornamenti
+: users (array [object, ...]): Elenco di tutti gli utenti sul bridge (array di oggetti)
+: updated (string): Momento dell'ultimo aggiornamento della risorsa da parte di HueMagic (ISO 8601)
+: model (object): Contiene le informazioni sul modello del bridge in `id`, `manufacturer` e `name`
+
+#### Risultati di «fetch» in `msg.results` (facoltativo)
+
+Se sul nodo è stato usato il comando «fetch», il bridge emette i relativi risultati nell'oggetto `msg.results`. L'oggetto contiene i gruppi di risorse interrogati, che a loro volta contengono tutte le risorse corrispondenti sotto forma di array.
+
+#### Messaggi di stato globali in `msg.updated` (facoltativo)
+
+Se non disattivato, il nodo emette un messaggio di stato aggiornato per ogni risorsa sul bridge. Il messaggio di stato in `msg.updated` segue lo schema della rispettiva risorsa e varia a seconda del tipo di dispositivo aggiornato per ultimo.
+
+#### Ultimo comando in `msg.command` (facoltativo)
+
+Se lo stato del nodo è cambiato a seguito di un determinato comando, viene emesso anche l'intero comando eseguito. In caso contrario, il nodo non emette questo oggetto.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,26 @@
+{
+	"hue-bridge": {
+		"config": {
+			"name": "Nome",
+			"input-name": "Nome del Hue Bridge",
+			"skipglobalevents-info": "Ignora gli aggiornamenti e i messaggi globali dei dispositivi su questo nodo",
+			"sendinitevents-node": "Non sopprimere l'evento di inizializzazione",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Bridge",
+			"not-configured": "non configurato",
+			"connecting": "connessione…",
+			"connected": "connesso",
+			"starting-tl": "avvio di TouchLink…",
+			"started-tl": "TouchLink avviato…",
+			"f-resources": "recupero delle risorse…",
+			"updating-settings": "aggiornamento delle impostazioni…",
+			"settings-updated": "impostazioni aggiornate",
+			"input": "impostazioni / recupero",
+			"output": "informazioni del bridge",
+			"statusmsg": "Stato interrogato correttamente…",
+			"error-not-available": "Il bridge non è ancora disponibile. Attenda che HueMagic abbia stabilito la connessione con il bridge."
+		}
+	}
+}

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

@@ -0,0 +1,70 @@
+<script type="text/markdown" data-help-name="hue-brightness">
+Il nodo «Hue Luminosità» può leggere il livello di luce attuale da un sensore adatto collegato al bridge.
+
+### Configurazione
+
+Selezioni il Hue Bridge preconfigurato e faccia clic sul pulsante di ricerca per trovare tutti i sensori disponibili. Se conosce già l'ID del sensore, può anche inserirlo qui manualmente. Può assegnare internamente un nuovo nome al sensore oppure mantenere quello predefinito. Facoltativamente può disattivare tutti i messaggi di stato automatici di questo nodo tramite l'impostazione «Ignora i messaggi del nodo». Il nodo non emetterà più aggiornamenti del dispositivo. In alternativa può scegliere che il messaggio di inizializzazione del nodo non venga soppresso all'avvio di Node-RED. Attivando questa impostazione riceverà un messaggio di stato del sensore selezionato dopo ogni deploy. Se preferisce che il nodo resti in silenzio finché non gli invia qualcosa, attivi «Segnala solo dopo un comando». In tal caso ignorerà le modifiche provenienti dall'app o da un interruttore e risponderà solo ai suoi comandi.
+
+L'impostazione «Buio sotto» determina a partire da quale livello di luce il nodo considera buia una stanza. Una stanza con una lampada luminosa richiede un valore completamente diverso rispetto a un corridoio senza finestre: inserisca semplicemente il numero di lux adatto al suo ambiente. I valori `dark` e `daylight` seguiranno quindi la sua impostazione anziché il valore predefinito di 90 lux.
+
+Se non seleziona alcun sensore e utilizza così la configurazione del nodo, il nodo funziona nella cosiddetta «modalità universale». In questa modalità il nodo riceve ed emette tutti i messaggi di stato dello stesso tipo. Può anche applicare impostazioni in modalità universale a un sensore specifico trasmettendo il relativo ID sensore come stringa in `msg.topic` insieme alle sue impostazioni.
+
+### Richiedere lo stato
+
+Emette lo stato attuale del sensore non appena al nodo viene trasmesso un oggetto `msg.payload` con il seguente contenuto. In alternativa può anche premere il pulsante nell'interfaccia di Node-RED senza dover inviare prima un messaggio al nodo.
+
+: status (boolean): Restituisce lo stato attuale del sensore
+
+### Accendere / spegnere il sensore
+
+Se necessario, il sensore può essere acceso e spento da remoto. Se il sensore è spento, non registra più alcuna variazione del livello di luce e di conseguenza non la emette. A tal fine, trasmetta un oggetto con il seguente contenuto:
+
+: payload (boolean): `true` accende il sensore, `false` lo spegne
+
+### Messaggi di stato del nodo
+
+Non appena il sensore rileva una variazione del livello di luce, viene restituito il seguente messaggio di stato:
+
+#### Oggetto di stato in `msg.payload`
+
+: active (boolean): Indica se il sensore è acceso o spento
+: reachable (boolean | string): `true` se il sensore è collegato al bridge, `unknown` se lo stato della connessione è diverso
+: connectionStatus (string): Lo stato attuale della connessione con il bridge sotto forma di stringa. Può contenere `connected`, `disconnected`, `connectivity_issue` o `unidirectional_incoming` come valore
+: lux (int): Indica il valore LUX reale del livello di luce
+: lightLevel (int): Indica l'intensità luminosa del sensore
+: dark (boolean): `true` se è stato rilevato buio
+: daylight (boolean): `true` se è stata rilevata luce diurna
+: darkThreshold (int): Il livello di luce in lux al di sotto del quale il nodo segnala il buio
+: updated (string): Momento dell'ultimo aggiornamento della risorsa da parte di HueMagic (ISO 8601)
+
+#### Informazioni sul sensore in `msg.info`
+
+: id (string): Indica il nuovo ID del sensore
+: idV1 (string | boolean): Indica il vecchio ID del sensore
+: uniqueId (string): L'ID univoco del sensore
+: deviceId (string): L'ID univoco del dispositivo
+: name (string): Il nome attualmente assegnato al sensore
+: type (string): Il tipo di sensore (sempre `light_level`)
+: softwareVersion (string): Il firmware attuale del sensore
+: battery (float): Il livello attuale della batteria del sensore
+: batteryState (string): Lo stato attuale del livello della batteria. Può contenere `normal`, `low` o `critical` come valore
+: model (object): Contiene le informazioni sul modello del sensore in `id`, `manufacturer`, `name`, `type` e `certified`
+
+#### Variazioni di stato in `msg.updated`
+
+Elenca sotto forma di oggetto i singoli parametri modificati rispetto all'ultimo stato del sensore. Se non è stata registrata alcuna modifica, questo oggetto è vuoto.
+
+#### Ultimo stato del sensore in `msg.lastState`
+
+Contiene l'oggetto di stato completo (vedi i valori di uscita sopra) dell'ultimo stato prima dell'ultima modifica registrata. Se HueMagic non ha ancora registrato l'ultimo stato, viene emesso `false`.
+
+#### Ultimo comando in `msg.command` (facoltativo)
+
+Se lo stato del nodo è cambiato a seguito di un determinato comando, viene emesso anche l'intero comando eseguito. In caso contrario, il nodo non emette questo oggetto.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,37 @@
+{
+	"hue-brightness": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignora i messaggi del nodo",
+			"sendinitevents-node": "Non sopprimere l'evento di inizializzazione",
+			"onlycommands-node": "Segnala solo dopo un comando",
+			"unknown-error": "Qualcosa è andato storto. Riprovi.",
+			"bridge": "Bridge",
+			"universalevents": "Eventi universali",
+			"universalevents-node": "Riceve tutti i messaggi dagli altri nodi dello stesso tipo (solo in modalità universale)",
+			"input-name": "Nome del sensore di luminosità",
+			"searching": "Ricerca di sensori…",
+			"none-found": "Nessun sensore di luminosità trovato!",
+			"sensor": "Sensore",
+			"all": "Tutti i gruppi / le luci",
+			"darkthreshold": "Buio sotto"
+		},
+		"node": {
+			"not-configured": "non configurato",
+			"deactivated": "disattivato",
+			"init": "inizializzazione…",
+			"not-reachable": "non raggiungibile",
+			"universal": "modalità universale",
+			"command": "esecuzione del comando…",
+			"statusmsg": "Stato interrogato correttamente…",
+			"title": "Hue Luminosità",
+			"lux": "__lux__ lux",
+			"lux-dark": "__lux__ lux (buio)",
+			"lux-daylight": "__lux__ lux (luce diurna)",
+			"input": "richiesta di stato",
+			"output": "luminosità (modificata)",
+			"error-no-id": "Indichi un ID sensore valido.",
+			"error-not-available": "Il sensore non è ancora disponibile. Attenda che HueMagic abbia stabilito la connessione con il bridge oppure verifichi se l'ID della risorsa indicato nella configurazione è valido."
+		}
+	}
+}

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

@@ -0,0 +1,59 @@
+<script type="text/markdown" data-help-name="hue-buttons">
+Il nodo «Hue Pulsanti» riceve gli eventi di commutazione dai dispositivi di input collegati al bridge.
+
+### Configurazione
+
+Selezioni il Hue Bridge preconfigurato e faccia clic sul pulsante di ricerca per trovare tutti gli interruttori e i pulsanti disponibili. Se conosce già l'ID dell'interruttore o del pulsante, può anche inserirlo qui manualmente. Può assegnare internamente un nuovo nome al dispositivo oppure mantenere quello predefinito. Facoltativamente può disattivare tutti i messaggi di stato automatici di questo nodo tramite l'impostazione «Ignora i messaggi del nodo». Il nodo non emetterà più eventi di commutazione. In alternativa può scegliere che il messaggio di inizializzazione del nodo non venga soppresso all'avvio di Node-RED. Attivando questa impostazione riceverà un messaggio di stato dell'interruttore o pulsante selezionato dopo ogni deploy. Se preferisce che il nodo resti in silenzio finché non gli invia qualcosa, attivi «Segnala solo dopo un comando». In tal caso ignorerà le modifiche provenienti dall'app o da un interruttore e risponderà solo ai suoi comandi.
+
+Se non seleziona alcun interruttore o pulsante e utilizza così la configurazione del nodo, il nodo funziona nella cosiddetta «modalità universale». In questa modalità il nodo riceve ed emette tutti i messaggi di stato dello stesso tipo.
+
+### Richiedere lo stato
+
+Emette lo stato attuale dell'interruttore o del pulsante non appena al nodo viene trasmesso un oggetto `msg.payload` con il seguente contenuto. In alternativa può anche premere il pulsante nell'interfaccia di Node-RED senza dover inviare prima un messaggio al nodo.
+
+: status (boolean): Restituisce lo stato attuale dell'interruttore o del pulsante
+
+### Messaggi di stato del nodo
+
+Non appena viene premuto un tasto, il nodo restituisce il seguente messaggio di stato:
+
+#### Oggetto di stato in `msg.payload`
+
+: reachable (boolean | string): `true` se l'interruttore o il pulsante è collegato al bridge, `unknown` se lo stato della connessione è diverso
+: connectionStatus (string): Lo stato attuale della connessione con il bridge sotto forma di stringa. Può contenere `connected`, `disconnected`, `connectivity_issue` o `unidirectional_incoming` come valore
+: button (int | boolean): ID numerico dell'ultimo tasto premuto o `false` se non è stato premuto alcun tasto
+: action (string | boolean): `false` se non è stato premuto alcun tasto, oppure `initial_press`, `repeat`, `short_release`, `long_press`, `long_release` o `double_short_release` sotto forma di stringa
+: rotation (object | boolean): `false` se il dispositivo non ha una rotella o non è stato ruotato; in caso contrario un oggetto con `action` (`start` o `repeat`), `direction` (`clock_wise` o `counter_clock_wise`), `clockwise` (booleano), `steps` (1000 passi corrispondono a un giro completo), `degrees` e `duration` in millisecondi
+: updated (string): Momento dell'ultimo aggiornamento della risorsa da parte di HueMagic (ISO 8601)
+
+#### Informazioni sull'interruttore o pulsante in `msg.info`
+
+: id (string): Indica il nuovo ID dell'interruttore o del pulsante
+: idV1 (string | boolean): Indica il vecchio ID dell'interruttore o del pulsante
+: uniqueId (string): L'ID univoco dell'interruttore o del pulsante
+: deviceId (string): L'ID univoco del dispositivo
+: name (string): Il nome attualmente assegnato all'interruttore o al pulsante
+: type (string): Il tipo dell'interruttore o del pulsante (sempre `button`)
+: softwareVersion (string): Il firmware attuale dell'interruttore o del pulsante
+: battery (float | boolean): Il livello attuale della batteria dell'interruttore o del pulsante, `false` se non è presente alcuna batteria
+: batteryState (string | boolean): Lo stato attuale del livello della batteria. Può contenere `normal`, `low` o `critical` come valore, `false` se non è presente alcuna batteria
+: model (object): Contiene le informazioni sul modello dell'interruttore o del pulsante in `id`, `manufacturer`, `name`, `type` e `certified`
+
+#### Variazioni di stato in `msg.updated`
+
+Elenca sotto forma di oggetto i singoli parametri modificati rispetto all'ultimo stato dell'interruttore o del pulsante. Se non è stata registrata alcuna modifica, questo oggetto è vuoto.
+
+#### Ultimo stato dell'interruttore o del pulsante in `msg.lastState`
+
+Contiene l'oggetto di stato completo (vedi i valori di uscita sopra) dell'ultimo stato prima dell'ultima modifica registrata. Se HueMagic non ha ancora registrato l'ultimo stato, viene emesso `false`.
+
+#### Ultimo comando in `msg.command` (facoltativo)
+
+Se lo stato del nodo è cambiato a seguito di un determinato comando, viene emesso anche l'intero comando eseguito. In caso contrario, il nodo non emette questo oggetto.
+
+### Esempi di HueMagic
+
+HueMagic mette a disposizione alcune configurazioni di esempio per questo nodo. Per importare un esempio completo nella sua interfaccia Node-RED, faccia clic sull'icona del menu di Node-RED, selezioni «Importa» e navighi fino a «Esempi» nella barra laterale della finestra. Selezioni quindi la cartella HueMagic e il nodo desiderato per importare un flusso di esempio.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>