node-red-contrib-huemagic 4.2.2 → 5.0.0

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

@@ -0,0 +1,37 @@
+{
+	"hue-brightness": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"onlycommands-node": "Comunicar apenas após um comando",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universais",
+			"universalevents-node": "Recebe todas as mensagens de outros nós do mesmo tipo (apenas no modo universal)",
+			"input-name": "Nome do sensor de luminosidade",
+			"searching": "A procurar sensores…",
+			"none-found": "Nenhum sensor de luminosidade encontrado!",
+			"sensor": "Sensor",
+			"all": "Todos os grupos / luzes",
+			"darkthreshold": "Escuro abaixo de"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"deactivated": "desativado",
+			"init": "a inicializar…",
+			"not-reachable": "inacessível",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Luminosidade",
+			"lux": "__lux__ lux",
+			"lux-dark": "__lux__ lux (escuro)",
+			"lux-daylight": "__lux__ lux (luz do dia)",
+			"input": "consulta de estado",
+			"output": "luminosidade (alterada)",
+			"error-no-id": "Indique um ID de sensor válido.",
+			"error-not-available": "O sensor ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido."
+		}
+	}
+}

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

@@ -0,0 +1,59 @@
+<script type="text/markdown" data-help-name="hue-buttons">
+O nó «Hue Botões» recebe os eventos de comutação dos dispositivos de entrada ligados ao bridge.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todos os interruptores e botões disponíveis. Se já souber o ID do interruptor ou botão, também o pode introduzir aqui manualmente. Pode atribuir internamente um novo nome ao dispositivo ou manter o nome predefinido. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as mensagens do nó». O nó deixará de emitir eventos de comutação. Em alternativa, pode escolher que a mensagem de inicialização do nó não seja suprimida no arranque do Node-RED. Se ativar esta definição, receberá uma mensagem de estado do interruptor ou botão selecionado após cada implementação. Se preferir que o nó permaneça em silêncio até lhe enviar algo, ative «Comunicar apenas após um comando». Nesse caso, ignora as alterações feitas na aplicação ou num interruptor e responde apenas aos seus próprios comandos.
+
+Se não selecionar nenhum interruptor ou botão e utilizar assim a configuração do nó, o nó funciona no chamado «modo universal». Neste modo, o nó recebe e emite todas as mensagens de estado do mesmo tipo.
+
+### Consultar o estado
+
+Emite o estado atual do interruptor ou botão assim que for transmitido ao nó um objeto `msg.payload` com o seguinte conteúdo. Em alternativa, também pode premir o botão na interface do Node-RED sem ter de enviar previamente uma mensagem ao nó.
+
+: status (boolean): Devolve o estado atual do interruptor ou botão
+
+### Mensagens de estado do nó
+
+Assim que uma tecla é premida, o nó devolve a seguinte mensagem de estado:
+
+#### Objeto de estado em `msg.payload`
+
+: reachable (boolean | string): `true` se o interruptor ou botão estiver ligado ao bridge, `unknown` se o estado da ligação divergir
+: connectionStatus (string): O estado atual da ligação com o bridge sob a forma de uma cadeia de carateres. Pode conter `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` como valor
+: button (int | boolean): ID numérico da última tecla premida ou `false` se nenhuma tecla foi premida
+: action (string | boolean): `false` se nenhuma tecla foi premida, ou `initial_press`, `repeat`, `short_release`, `long_press`, `long_release` ou `double_short_release` sob a forma de cadeia de carateres
+: rotation (object | boolean): `false` se o dispositivo não tiver roda ou não tiver sido rodado; caso contrário, um objeto com `action` (`start` ou `repeat`), `direction` (`clock_wise` ou `counter_clock_wise`), `clockwise` (booleano), `steps` (1000 passos correspondem a uma volta completa), `degrees` e `duration` em milissegundos
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre o interruptor ou botão em `msg.info`
+
+: id (string): Indica o novo ID do interruptor ou botão
+: idV1 (string | boolean): Indica o ID antigo do interruptor ou botão
+: uniqueId (string): O ID único do interruptor ou botão
+: deviceId (string): O ID único do dispositivo
+: name (string): O nome atualmente atribuído ao interruptor ou botão
+: type (string): O tipo do interruptor ou botão (sempre `button`)
+: softwareVersion (string): O firmware atual do interruptor ou botão
+: battery (float | boolean): O nível atual da bateria do interruptor ou botão, `false` quando não existe bateria
+: batteryState (string | boolean): O estado atual do nível da bateria. Pode conter `normal`, `low` ou `critical` como valor, ou `false` quando não existe bateria
+: model (object): Contém as informações de modelo do interruptor ou botão em `id`, `manufacturer`, `name`, `type` e `certified`
+
+#### Alterações de estado em `msg.updated`
+
+Enumera sob a forma de um objeto os parâmetros que foram alterados em relação ao último estado do interruptor ou botão. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado do interruptor ou botão em `msg.lastState`
+
+Contém o objeto de estado completo (ver os valores de saída acima) do último estado antes da última alteração registada. Se o HueMagic ainda não tiver registado o último estado, é emitido `false`.
+
+#### Último comando em `msg.command` (opcional)
+
+Se o estado do nó tiver sido alterado através de um determinado comando, é também emitido o comando completo que foi executado. Caso contrário, o nó não emite este objeto.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,42 @@
+{
+	"hue-buttons": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"onlycommands-node": "Comunicar apenas após um comando",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universais",
+			"universalevents-node": "Recebe todas as mensagens de outros nós do mesmo tipo (apenas no modo universal)",
+			"input-name": "Nome do botão",
+			"searching": "A procurar Hue Buttons…",
+			"none-found": "Nenhum Hue Button encontrado!",
+			"button": "Botão"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Botões",
+			"waiting": "a aguardar…",
+			"button-on": "On",
+			"action-pressed": "premido",
+			"action-holded": "mantido premido",
+			"action-shortreleased": "solto brevemente",
+			"action-longreleased": "solto após ser mantido",
+			"action-repeated": "repetido",
+			"action-doublepressed": "premido duas vezes",
+			"dial-clockwise": "Roda ↻ __degrees__°",
+			"dial-counterclockwise": "Roda ↺ __degrees__°",
+			"button-status": "Botão n.º __button__ (__action__)",
+			"input": "consulta de estado",
+			"output": "botão premido",
+			"error-no-id": "Indique um ID de interruptor válido.",
+			"error-not-available": "O interruptor ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido.",
+			"error-no-switchmode": "Este dispositivo não tem um modo de interruptor configurável.",
+			"error-invalid-switchmode": "Modo de interruptor inválido. Este dispositivo suporta: __modes__"
+		}
+	}
+}

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

@@ -0,0 +1,67 @@
+<script type="text/markdown" data-help-name="hue-contact">
+O nó «Hue Contacto» indica se um sensor de contacto (p. ex. Hue Secure) está atualmente aberto ou fechado.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todos os sensores disponíveis. Se já souber o ID do sensor, também o pode introduzir aqui manualmente. Pode atribuir internamente um novo nome ao sensor ou manter o nome predefinido. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as mensagens do nó». O nó deixará de emitir atualizações do dispositivo. Em alternativa, pode escolher que a mensagem de inicialização do nó não seja suprimida no arranque do Node-RED. Se ativar esta definição, receberá uma mensagem de estado do sensor selecionado após cada implementação. Se preferir que o nó permaneça em silêncio até lhe enviar algo, ative «Comunicar apenas após um comando». Nesse caso, ignora as alterações feitas na aplicação ou num interruptor e responde apenas aos seus próprios comandos.
+
+Se não selecionar nenhum sensor e utilizar assim a configuração do nó, o nó funciona no chamado «modo universal». Neste modo, o nó recebe e emite todas as mensagens de estado do mesmo tipo. Também pode aplicar definições no modo universal a um sensor específico, transmitindo o respetivo ID do sensor como cadeia de carateres em `msg.topic` juntamente com as suas definições.
+
+### Consultar o estado
+
+Emite o estado atual do sensor assim que for transmitido ao nó um objeto `msg.payload` com o seguinte conteúdo. Em alternativa, também pode premir o botão na interface do Node-RED sem ter de enviar previamente uma mensagem ao nó.
+
+: status (boolean): Devolve o estado atual do sensor
+
+### Ligar / desligar o sensor
+
+Se necessário, o sensor pode ser ligado e desligado remotamente. Se o sensor estiver desligado, deixa de registar alterações de contacto e, por conseguinte, deixa de as emitir. Para tal, transmita um objeto com o seguinte conteúdo:
+
+: payload (boolean): `true` liga o sensor, `false` desliga-o
+
+### Mensagens de estado do nó
+
+Assim que o contacto muda, o nó devolve a seguinte mensagem de estado:
+
+#### Objeto de estado em `msg.payload`
+
+: active (boolean): Indica se o sensor está ligado ou desligado
+: reachable (boolean | string): `true` se o sensor estiver ligado ao bridge, `unknown` se o estado da ligação divergir
+: connectionStatus (string): O estado atual da ligação com o bridge sob a forma de uma cadeia de carateres. Pode conter `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` como valor
+: contact (string | boolean): `contact` se o contacto estiver fechado, `no_contact` se estiver aberto ou `false` se o sensor ainda não tiver comunicado
+: changed (string | boolean): Momento da última alteração de contacto (ISO 8601) ou `false` se o sensor ainda não tiver comunicado
+: tampered (boolean): Apenas disponível em sensores com deteção de manipulação; `true` se o sensor tiver sido manipulado
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre o sensor em `msg.info`
+
+: id (string): Indica o novo ID do sensor
+: idV1 (string | boolean): Indica o ID antigo do sensor
+: uniqueId (string): O ID único do sensor
+: deviceId (string): O ID único do dispositivo
+: name (string): O nome atualmente atribuído ao sensor
+: type (string): O tipo do sensor (sempre `contact`)
+: softwareVersion (string): O firmware atual do sensor
+: battery (float | boolean): O nível atual da bateria do sensor, `false` quando não existe bateria
+: batteryState (string | boolean): O estado atual do nível da bateria. Pode conter `normal`, `low` ou `critical` como valor, ou `false` quando não existe bateria
+: model (object): Contém as informações de modelo do sensor em `id`, `manufacturer`, `name`, `type` e `certified`
+
+#### Alterações de estado em `msg.updated`
+
+Enumera sob a forma de um objeto os parâmetros que foram alterados em relação ao último estado do sensor. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado do sensor em `msg.lastState`
+
+Contém o objeto de estado completo (ver os valores de saída acima) do último estado antes da última alteração registada. Se o HueMagic ainda não tiver registado o último estado, é emitido `false`.
+
+#### Último comando em `msg.command` (opcional)
+
+Se o estado do nó tiver sido alterado através de um determinado comando, é também emitido o comando completo que foi executado. Caso contrário, o nó não emite este objeto.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+
+</script>

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

@@ -0,0 +1,35 @@
+{
+	"hue-contact": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"onlycommands-node": "Comunicar apenas após um comando",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universais",
+			"universalevents-node": "Recebe todas as mensagens de outros nós do mesmo tipo (apenas no modo universal)",
+			"input-name": "Nome do sensor",
+			"searching": "A procurar sensores de contacto…",
+			"none-found": "Nenhum sensor de contacto encontrado!",
+			"sensor": "Sensor"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"not-reachable": "inacessível",
+			"activated": "ativado",
+			"deactivated": "desativado",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Contacto",
+			"contact": "contacto",
+			"no-contact": "sem contacto",
+			"input": "ativar / desativar / estado",
+			"output": "contacto",
+			"tampered": "manipulado",
+			"error-no-id": "Indique um ID de sensor válido.",
+			"error-not-available": "O sensor ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido."
+		}
+	}
+}

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

@@ -0,0 +1,87 @@
+<script type="text/markdown" data-help-name="hue-group">
+O nó «Hue Grupo» pode controlar em simultâneo várias luzes agrupadas no bridge.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todos os grupos disponíveis. Se já souber o ID de um grupo, também o pode introduzir aqui manualmente. Pode atribuir internamente um novo nome ao grupo ou manter o nome predefinido. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as mensagens do nó». O nó deixará de emitir atualizações. Em alternativa, pode escolher que a mensagem de inicialização do nó não seja suprimida no arranque do Node-RED. Se ativar esta definição, receberá uma mensagem de estado do grupo selecionado após cada implementação. Se preferir que o nó permaneça em silêncio até lhe enviar algo, ative «Comunicar apenas após um comando». Nesse caso, ignora as alterações feitas na aplicação ou num interruptor e responde apenas aos seus próprios comandos.
+
+Se não selecionar nenhum grupo e utilizar assim a configuração do nó, o nó funciona no chamado «modo universal». Neste modo, o nó recebe e emite todas as mensagens de estado do mesmo tipo. Também pode aplicar definições no modo universal a um grupo específico, transmitindo o respetivo ID como cadeia de carateres em `msg.topic` juntamente com as suas definições.
+
+### Consultar o estado
+
+Emite o estado atual do grupo assim que for transmitido ao nó um objeto `msg.payload` com o seguinte conteúdo. Em alternativa, também pode premir o botão na interface do Node-RED sem ter de enviar previamente uma mensagem ao nó.
+
+: status (boolean): Devolve o estado atual do grupo
+
+### Ligar / desligar (modo simples)
+
+Para ligar ou desligar rapidamente um grupo inteiro no modo simples, transmita ao nó um objeto com o seguinte conteúdo.
+
+: payload (boolean): `true` liga todo o grupo, `false` desliga-o
+
+### Comandos de grupo (avançado)
+
+Para além de simplesmente ligar e desligar, existem muitas outras opções para controlar o grupo. Todos os nós do HueMagic podem ser controlados com comandos aditivos. Isto significa que pode transmitir primeiro uma definição e depois outra num comando posterior sem descartar a definição anterior. Transmita os seguintes parâmetros num objeto `msg.payload` para efetuar definições mais amplas no grupo:
+
+: on (boolean): `true` liga todo o grupo, `false` desliga-o
+: toggle (boolean | any): Alterna entre ligar e desligar, consoante o estado anterior do grupo
+: brightness (int | string): Valor percentual do brilho da luz (0-100) ou uma cadeia de carateres com o valor `auto` para definir automaticamente o brilho com base na hora atual
+: brightnessLevel (int): Valor numérico do brilho da luz (0-254)
+: incrementBrightness (int): Valor percentual de uma alteração relativa do brilho. O intervalo válido vai de -100 % a +100 %. Os valores positivos aumentam o brilho. O valor predefinido é +10 %
+: decrementBrightness (int): Valor percentual de uma alteração relativa do brilho. O intervalo válido vai de -100 % a +100 %. Os valores positivos diminuem o brilho. O valor predefinido é +10 %
+: color (string): `random` para definir uma cor aleatória ou um nome de cor em inglês (p. ex. `red`)
+: hex (string): Valor de cor em hexadecimal sob a forma de cadeia de carateres
+: rgb (array [0,0,0]): Valor de cor em formato RGB sob a forma de matriz
+: xyColor (object {x [float], y [float]}): Valor de cor no formato de cor XY sob a forma de objeto
+: image (string): Caminho de uma imagem (local ou na web) para definir a cor atual do grupo como a cor média da imagem
+: colorTemp (int | string): Valor entre 153 e 500 para definir a temperatura de cor do grupo, ou os valores `cold`, `normal`, `warm`, `hot` e `auto`, sendo que `auto` define a temperatura de cor com base na hora atual
+: transitionTime (float): Tempo de transição da definição atual em segundos. Se for transmitido `0`, o grupo muda de imediato para a definição pretendida. Se transmitir `3`, o grupo muda para a definição pretendida com uma ligeira transição nos 3 segundos seguintes
+: colorloop (float): Reproduz uma animação «colorloop» durante os segundos indicados e volta depois ao estado original do grupo
+: alert (float): Reproduz uma animação «alert» durante os segundos indicados e volta depois ao estado original do grupo
+
+### Mensagens de estado do nó
+
+Quando é detetada uma alteração no grupo, o nó devolve a seguinte mensagem de estado.
+
+> [!NOTE]
+> O grupo só emite mensagens de estado quando a última luz é desligada ou quando a primeira é ligada (se todas estivessem apagadas antes).
+
+Ao contrário do nó «Hue Luz», dispõe aqui de muito menos informação de estado, uma vez que um grupo pode conter muitos tipos de dispositivo diferentes com valores que não podem ser combinados.
+
+#### Objeto de estado em `msg.payload`
+
+: on (boolean): Estado do grupo, em que `true` significa ligado e `false` desligado
+: brightness (float | boolean): Brilho do grupo em percentagem ou `false` se o grupo não puder ser regulado
+: brightnessLevel (int | boolean): Brilho do grupo como valor numérico (0-254) ou `false` se o grupo não puder ser regulado
+: rgb (array [0,0,0]): Cor atual do grupo em formato RGB (apenas se disponível)
+: hex (string): Cor atual do grupo em formato hexadecimal (apenas se disponível)
+: xyColor (object {x [float], y [float]}): Cor atual do grupo no formato de cor XY (apenas se disponível)
+: colorTemp (int): Temperatura de cor atualmente definida para o grupo (apenas se disponível)
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre o grupo em `msg.info`
+
+: id (string): Indica o novo ID do grupo
+: idV1 (string | boolean): Indica o ID antigo do grupo
+: name (string): O nome atualmente atribuído ao grupo
+: resources (object) : Contém todos os dispositivos e recursos associados ao grupo
+: type (string): O tipo do grupo (sempre `group`)
+
+#### Alterações de estado em `msg.updated`
+
+Enumera sob a forma de um objeto os parâmetros que foram alterados em relação ao último estado do grupo. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado da luz em `msg.lastState`
+
+Contém o objeto de estado completo (ver os valores de saída acima) do último estado antes da última alteração. Se o HueMagic ainda não tiver registado o último estado, é emitido `false`.
+
+#### Último comando em `msg.command` (opcional)
+
+Se o estado do nó tiver sido alterado através de um determinado comando, é também emitido o comando completo que foi executado. Caso contrário, o nó não emite este objeto.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,46 @@
+{
+	"hue-group": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"onlycommands-node": "Comunicar apenas após um comando",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universais",
+			"universalevents-node": "Recebe todas as mensagens de outros nós do mesmo tipo (apenas no modo universal)",
+			"colornamer": "Colornamer",
+			"colornamer-info": "Ativar a denominação das cores",
+			"input-name": "Nome do grupo",
+			"searching": "A procurar grupos…",
+			"none-found": "Nenhum grupo encontrado!",
+			"group": "Grupo",
+			"all": "Todos os grupos / luzes"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"init": "a inicializar…",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Grupo",
+			"brightness": " (__percent__ %)",
+			"all-on": "todas as luzes acesas",
+			"all-off": "todas as luzes apagadas",
+			"some-on": "algumas luzes acesas",
+			"turned-on": "ligado",
+			"error-input": "erro de entrada",
+			"error-no-id": "Nenhum ID de grupo indicado.",
+			"error-invalid-sat": "Definição de saturação inválida. Apenas são permitidos valores de 0 a 254.",
+			"error-invalid-temp": "Temperatura de cor inválida. Apenas são permitidos valores de 153 a 500.",
+			"input": "ligar / desligar",
+			"output": "estado",
+			"error-not-available": "O grupo ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido.",
+			"error-invalid-brightness": "Definição de brilho inválida. Apenas são permitidos valores de 0 a 100 por cento.",
+			"error-invalid-brightness-level": "Definição de brilho inválida. Apenas são permitidos valores de 0 a 254.",
+			"error-invalid-increment": "Definição incrementBrightness inválida. Apenas são permitidos valores de -100 % a 100 %.",
+			"error-invalid-decrement": "Definição decrementBrightness inválida. Apenas são permitidos valores de -100 % a 100 %.",
+			"error-no-colorloop": "O efeito colorloop não está disponível para este grupo."
+		}
+	}
+}

package/huemagic/locales/pt/hue-light.html

@@ -0,0 +1,97 @@
+<script type="text/markdown" data-help-name="hue-light">
+O nó «Hue Luz» pode controlar as luzes ligadas ao bridge e receber as respetivas mensagens de estado.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todas as luzes disponíveis. Se já souber o ID de uma luz, também o pode introduzir aqui manualmente. Pode atribuir internamente um novo nome à luz ou manter o nome predefinido. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as mensagens do nó». O nó deixará de emitir atualizações do dispositivo. Em alternativa, pode escolher que a mensagem de inicialização do nó não seja suprimida no arranque do Node-RED. Se ativar esta definição, receberá uma mensagem de estado da luz selecionada após cada implementação. Se preferir que o nó permaneça em silêncio até lhe enviar algo, ative «Comunicar apenas após um comando». Nesse caso, ignora as alterações feitas na aplicação ou num interruptor e responde apenas aos seus próprios comandos.
+
+Se ativar a definição «Ativar a denominação das cores», o nó tentará descrever a cor de luz definida em cada mensagem de estado. Receberá então na saída um parâmetro adicional com a descrição em inglês da cor atual.
+
+Se não selecionar nenhuma luz e utilizar assim a configuração do nó, o nó funciona no chamado «modo universal». Neste modo, o nó recebe e emite todas as mensagens de estado do mesmo tipo. Também pode aplicar definições no modo universal a uma luz específica, transmitindo o respetivo ID como cadeia de carateres em `msg.topic` juntamente com as suas definições.
+
+### Consultar o estado
+
+Emite o estado atual da luz assim que for transmitido ao nó um objeto `msg.payload` com o seguinte conteúdo. Em alternativa, também pode premir o botão na interface do Node-RED sem ter de enviar previamente uma mensagem ao nó.
+
+: status (boolean): Devolve o estado atual da luz
+
+### Ligar / desligar a luz (modo simples)
+
+Para ligar ou desligar rapidamente uma luz no modo simples, transmita ao nó um objeto com o seguinte conteúdo:
+
+: payload (boolean): `true` liga a luz, `false` desliga-a
+
+### Comandos de luz (avançado)
+
+Para além de simplesmente ligar e desligar, existem muitas outras opções para controlar a luz. Todos os nós do HueMagic podem ser controlados com comandos aditivos. Isto significa que pode transmitir primeiro uma definição e depois outra num comando posterior sem descartar a definição anterior. Transmita os seguintes parâmetros num objeto `msg.payload` para efetuar definições mais amplas na luz:
+
+: on (boolean): `true` liga a luz, `false` desliga-a
+: toggle (boolean | any): Alterna entre ligar e desligar, consoante o estado anterior da luz
+: brightness (int | string): Valor percentual do brilho da luz (0-100) ou uma cadeia de carateres com o valor `auto` para definir automaticamente o brilho com base na hora atual
+: brightnessLevel (int): Valor numérico do brilho da luz (0-254)
+: incrementBrightness (int | boolean): Indica em quantos pontos percentuais a luz deve ficar mais clara, ou `true` para a aumentar em passos de 10 %
+: decrementBrightness (int | boolean): Indica em quantos pontos percentuais a luz deve ficar mais escura, ou `true` para a diminuir em passos de 10 %
+: color (string): `random` para definir uma cor aleatória ou um nome de cor em inglês (p. ex. `red`)
+: hex (string): Valor de cor em hexadecimal sob a forma de cadeia de carateres
+: rgb (array [0,0,0]): Valor de cor em formato RGB sob a forma de matriz
+: xyColor (object {x [float], y [float]}): Valor de cor no formato de cor XY sob a forma de objeto
+: gradient (object {hex […]}): Um objeto com um objeto de cor suportado (p. ex. `hex`, `rgb`, …) e várias cores para aplicar um gradiente às luzes compatíveis
+: mixColor (object): Uma cor a misturar com a cor de luz atual. Aceita objetos `color`, `hex`, `rgb` ou `xyColor` e, opcionalmente, `amount` (int) para indicar a proporção de mistura em percentagem
+: image (string): Caminho de uma imagem (local ou na web) para definir a cor atual da luz como a cor média da imagem
+: saturation (int): Percentagem da saturação da cor atual (beta)
+: colorTemp (int | string): Valor entre 153 e 500 para definir a temperatura de cor da luz, ou os valores `cold`, `normal`, `warm`, `hot` e `auto`, sendo que `auto` define a temperatura de cor com base na hora atual
+: incrementColorTemp (int | boolean): Valor que indica quanto a temperatura de cor deve ficar mais quente, ou `true` para a tornar mais quente em passos de 50
+: decrementColorTemp (int | boolean): Valor que indica quanto a temperatura de cor deve ficar mais fria, ou `true` para a tornar mais fria em passos de 50
+: transitionTime (float): Tempo de transição da definição atual em segundos. Se for indicado `0`, a luz muda de imediato para a definição pretendida. Se for indicado `3`, a luz muda para a definição pretendida com uma ligeira transição nos 3 segundos seguintes
+: colorloop (float): Reproduz uma animação «colorloop» durante os segundos indicados e volta depois ao estado original da luz
+: alert (float): Reproduz uma animação «alert» durante os segundos indicados e volta depois ao estado original da luz
+
+### Mensagens de estado do nó
+
+Assim que é detetada uma alteração nas definições da luz (quer através do Node-RED, quer externamente), o nó devolve a seguinte mensagem de estado:
+
+#### Objeto de estado em `msg.payload`
+
+: on (boolean): Estado da luz, em que `true` significa acesa e `false` apagada
+: brightness (int | boolean): Brilho atual em percentagem ou `false` se a luz não suportar definição de brilho
+: brightnessLevel (int | boolean): Brilho atual de 0 a 254 ou `false` se a luz não suportar definição de brilho
+: reachable (boolean | string): `true` se a luz estiver ligada ao bridge, `unknown` se o estado da ligação divergir
+: connectionStatus (string): O estado atual da ligação com o bridge sob a forma de uma cadeia de carateres. Pode conter `connected`, `disconnected`, `connectivity_issue` ou `unidirectional_incoming` como valor
+: rgb (array [int, int, int] | optional): Cor de luz atual sob a forma de valor RGB, se a luz conseguir apresentar cores
+: hex (string | optional): Cor de luz atual sob a forma de valor hexadecimal, se a luz conseguir apresentar cores
+: xyColor (object {x [float], y [float]} | optional): Cor de luz atual sob a forma de valor XY, se a luz conseguir apresentar cores
+: color (string | optional): Nome atual da cor em inglês, se a luz conseguir apresentar cores e a definição correspondente do nó estiver ativada
+: gradient (object | optional): Definição de gradiente atual com todas as unidades de cor disponíveis sob a forma de matriz, se a luz suportar gradientes, em que `colors` devolve as cores, `numColors` o número de cores definidas no gradiente e `totalColors` o número máximo de cores que o recurso consegue suportar no gradiente
+: colorTemp (int | boolean | optional): Temperatura de cor atual da luz, se a luz conseguir apresentar temperaturas de cor e tiver sido definida uma
+: colorTempName (string | optional): Temperatura de cor atual da luz sob a forma de cadeia descritiva com os valores `cold`, `normal`, `warm` ou `hot`, se a luz conseguir apresentar temperaturas de cor e tiver sido definida uma. Caso contrário, é emitido `unknown`
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre a luz em `msg.info`
+
+: id (string): Indica o novo ID da luz
+: idV1 (string | boolean): Indica o ID antigo da luz
+: uniqueId (string): O ID único da luz
+: deviceId (string): O ID único do dispositivo
+: name (string): O nome atualmente atribuído à luz
+: type (string): O tipo da luz (sempre `light`)
+: softwareVersion (string): O firmware atual da luz
+: model (object): Contém as informações de modelo da luz em `id`, `manufacturer`, `name`, `type`, `certified`, `friendsOfHue`, `colorGamut` e `colorGamutType`
+
+#### Alterações de estado em `msg.updated`
+
+Enumera sob a forma de um objeto os parâmetros que foram alterados em relação ao último estado da luz. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado da luz em `msg.lastState`
+
+Contém o objeto de estado completo (ver os valores de saída acima) do último estado antes da última alteração. Se o HueMagic ainda não tiver registado o último estado, é emitido `false`.
+
+#### Último comando em `msg.command` (opcional)
+
+Se o estado do nó tiver sido alterado através de um determinado comando, é também emitido o comando completo que foi executado. Caso contrário, o nó não emite este objeto.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/pt/hue-light.json

@@ -0,0 +1,44 @@
+{
+	"hue-light": {
+		"config": {
+			"name": "Nome",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"onlycommands-node": "Comunicar apenas após um comando",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"bridge": "Bridge",
+			"universalevents": "Eventos universais",
+			"universalevents-node": "Recebe todas as mensagens de outros nós do mesmo tipo (apenas no modo universal)",
+			"colornamer": "Colornamer",
+			"colornamer-info": "Ativar a denominação das cores",
+			"input-name": "Nome da luz",
+			"searching": "A procurar luzes…",
+			"none-found": "Nenhuma luz encontrada!",
+			"light": "Luz"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"init": "a inicializar…",
+			"not-reachable": "inacessível",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Luz",
+			"turned-on": "acesa",
+			"turned-on-percent": "acesa (__percent__ %)",
+			"turned-off": "apagada",
+			"error-no-id": "Nenhum ID de luz definido. Consulte a documentação.",
+			"error-input": "erro de entrada",
+			"error-invalid-temp": "Temperatura de cor inválida. Apenas são permitidos valores de 153 a 500.",
+			"input": "ligar / desligar",
+			"output": "estado",
+			"error-not-available": "A luz ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge ou verifique se o ID do recurso indicado na configuração é válido.",
+			"error-invalid-brightness": "Definição de brilho inválida. Apenas são permitidos valores de 0 a 100 por cento.",
+			"error-invalid-brightness-level": "Definição de brilho inválida. Apenas são permitidos valores de 0 a 254.",
+			"error-invalid-sat": "Definição de saturação inválida. Apenas são permitidos valores de 0 a 100.",
+			"error-no-colorloop": "O efeito colorloop não está disponível para esta luz.",
+			"error-invalid-effect": "Efeito inválido. Esta luz suporta: __effects__",
+			"error-invalid-powerup": "Definição de arranque inválida. As predefinições permitidas são: __presets__"
+		}
+	}
+}

package/huemagic/locales/pt/hue-magic.html

@@ -0,0 +1,68 @@
+<script type="text/markdown" data-help-name="hue-magic">
+O nó «Hue Magic» pode aplicar animações complexas e personalizadas a luzes e grupos.
+
+### Configuração
+
+Comece por dar um nome ao nó para poder identificar claramente a sua animação na interface do Node-RED. Depois pode escolher entre as opções «Repetição» e «Restaurar». Selecione a opção de repetição se quiser que a sua animação seja executada indefinidamente numa luz ou grupo até a parar manualmente. Se quiser restaurar o estado anterior do recurso de destino (luz / grupo) após o fim da animação, assinale a opção «Restaurar». Caso contrário, o último fotograma da animação permanece no respetivo recurso.
+
+Mais abaixo pode escolher entre as animações já preparadas do HueMagic. Clique na animação pretendida para a definir.
+
+### Iniciar / parar a animação
+
+Para reproduzir ou parar uma animação, transmita ao nó um objeto com o seguinte conteúdo:
+
+: payload (boolean): `true` inicia a animação, `false` para-a
+
+### Animações personalizadas
+
+Se transmitir a sua própria animação ao nó, a animação predefinida selecionada (se existir) é temporariamente substituída pela sua. As animações próprias do HueMagic são uma sequência de comandos agrupados numa matriz. Cada elemento da matriz constitui um passo, sendo que um passo também pode ser composto por vários fotogramas (efeitos de transição).
+
+Crie um `array` com os vários passos da animação sob a forma de objeto e transmita-o ao nó HueMagic em `msg.payload.steps`.
+
+: delay (int): Número de milissegundos a aguardar até este passo ser executado
+: animation (object): O objeto contém a ação ou ações a executar neste passo. Parâmetros idênticos aos dos nós «Hue Luz» e «Hue Grupo»
+
+### Exemplo de uma animação personalizada
+
+Este exemplo mostra o aspeto que uma animação simples pode ter. No primeiro passo aguarda-se o atraso de 500 milissegundos. Em seguida, a cor da luz muda lentamente para vermelho ao longo de um segundo. Assim que a luz fica completamente vermelha, é executado o segundo passo, que tem igualmente um atraso de 500 milissegundos. Por fim, a cor muda para azul.
+
+Se tiver definido a animação em repetição, este processo repete-se indefinidamente até parar a animação manualmente ou voltar a implementar o nó.
+
+Transmita o objeto seguinte em `msg.payload` para reproduzir a animação de exemplo.
+
+    {
+        "animate": true,
+        "steps": [
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#FF0000",
+                    "transitionTime": 1
+                }
+            },
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#0000FF",
+                    "transitionTime": 1
+                }
+            }
+        ]
+    }
+
+### Comandos especiais
+
+Por vezes faz sentido reproduzir uma animação de forma desordenada, p. ex. para imitar o fogo de maneira mais realista. Para reproduzir os vários passos aleatoriamente, pode transmitir o seguinte comando em `msg.payload.specials`:
+
+: randomOrder (boolean | any): `true` ativa a reprodução aleatória dos vários passos da animação
+
+### Dicas e indicações
+
+Este nó não emite mensagens de estado. Ligue a saída do nó a um grupo em vez de a luzes individuais se quiser animar várias luzes ao mesmo tempo com a mesma animação. As pré-visualizações das animações já preparadas são simulações e podem diferir ligeiramente (tempos, cores) da animação real num recurso.
+
+### Exemplos do HueMagic
+
+O HueMagic disponibiliza algumas configurações de exemplo para este nó. Para importar um exemplo completo na sua interface Node-RED, clique no ícone de menu do Node-RED, selecione «Importar» e navegue até «Exemplos» na barra lateral da janela. Em seguida, selecione a pasta HueMagic e o nó pretendido para importar um fluxo de exemplo.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/pt/hue-magic.json

@@ -0,0 +1,26 @@
+{
+	"hue-magic": {
+		"config": {
+			"name": "Nome",
+			"input-name": "Nome da animação",
+			"loop": "Repetição",
+			"loop-endless": "Repetir indefinidamente",
+			"restore": "Restaurar",
+			"restore-state": "Restaurar o estado anterior após parar",
+			"animation": "Animação",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"seconds": "s",
+			"minutes": "min"
+		},
+		"node": {
+			"title": "Hue Magic",
+			"no-animation": "nenhuma animação indicada",
+			"animating": "a animar…",
+			"stopped": "parada",
+			"input": "iniciar / parar a animação",
+			"output": "luz ou grupo",
+			"command": "a executar comando…",
+			"playmsg": "Animação iniciada…"
+		}
+	}
+}