node-red-contrib-huemagic 4.2.2 → 5.0.1

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

@@ -0,0 +1,96 @@
+<script type="text/markdown" data-help-name="hue-bridge-node">
+O nó «Hue Bridge» é um nó universal que pode emitir todas as definições do bridge e as mensagens de estado dos restantes nós.
+
+### Configuração
+
+Selecione primeiro o Hue Bridge pretendido. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as atualizações e mensagens globais dos dispositivos neste nó». O nó deixará de emitir atualizações do dispositivo.
+
+Em alternativa, pode escolher que as mensagens de inicialização de todos os nós não sejam suprimidas no arranque do Node-RED. Se ativar esta definição, receberá após cada implementação uma mensagem de estado de todos os recursos ligados ao bridge.
+
+### Consultar definições e estado
+
+Emite o estado e as definições atuais do bridge assim que a seguinte mensagem for enviada ao nó. Em alternativa, também pode premir o botão na interface do Node-RED sem ter de enviar previamente uma mensagem ao nó.
+
+: payload (boolean): Devolve o estado atual do bridge
+
+### Iniciar uma análise TouchLink
+
+Com uma «análise TouchLink» pode emparelhar dispositivos novos ou antigos com o bridge (p. ex. após uma reposição). Para tal, transmita o objeto `msg.payload` com o seguinte conteúdo:
+
+: touchLink (boolean): Emparelha dispositivos antigos ou novos com o bridge
+
+### Consultar todos os dispositivos e recursos
+
+Com o comando «fetch» pode obter uma lista de determinados dispositivos atualmente ligados ao bridge. Para tal, transmita o objeto `msg.payload` com o seguinte conteúdo:
+
+: fetch (string | array [string, ...]): Aceita `light`, `group`, `button`, `motion`, `temperature`, `light_level` ou `rule` como valor(es)
+
+### Alterar as definições do Hue Bridge
+
+Com o comando seguinte pode alterar determinadas definições no bridge. Transmita ao nó o objeto `msg.payload.settings` com as seguintes opções de definição:
+
+> [!WARNING]
+> A alteração das definições de rede exige a reconfiguração do bridge no HueMagic.
+
+: name (string): Altera o nome do bridge e tem de conter entre 4 e 16 carateres
+: zigbeeChannel (int): Altera o canal ZigBee atual (`11`, `15`, `20`, `25` ou `0`)
+: ipAddress (string): Altera o endereço IP nas definições de rede
+: dhcpEnabled (boolean): `true` ativa o DHCP nas definições de rede, `false` desativa-o
+: netmask (string): Altera a máscara de rede nas definições de rede
+: gateway (string): Define o gateway nas definições de rede
+: proxyAddress (string): Define um endereço de proxy nas definições de rede
+: proxyPort (string | int): Define a porta do proxy nas definições de rede
+: timeZone (string): Altera o fuso horário atualmente definido no bridge
+
+### Mensagens de estado do nó
+
+As mensagens de estado do nó «Hue Bridge» são dinâmicas. Embora sigam um determinado padrão, a sua saída pode variar consoante a ação que acabou de ser executada no nó.
+
+#### Objeto de estado em `msg.payload`
+
+: id (string): ID único do Hue Bridge
+: name (string): Nome atualmente atribuído
+: factoryNew (boolean): Indica se o bridge é totalmente novo
+: replacesBridgeId (string | boolean): Devolve o ID do bridge antigo (se tiver sido efetuada uma migração) ou `false`
+: dataStoreVersion (string): Versão do repositório de dados
+: starterKitId (string | boolean): Nome do kit inicial criado na fábrica ou `false`
+: softwareVersion (string): Versão de software do bridge
+: apiVersion (string): Versão da API do bridge
+: zigbeeChannel (int): Canal ZigBee atualmente utilizado
+: macAddress (string): Endereço MAC do bridge
+: ipAddress (string): Endereço IP do bridge
+: dhcpEnabled (boolean): Indica se o DHCP está ativado
+: netmask (string): Máscara de rede do bridge
+: gateway (string): Gateway do bridge
+: proxyAddress (string | boolean): Endereço de proxy atualmente utilizado ou `false`
+: proxyPort (string): Porta de proxy atualmente utilizada
+: utcTime (string): Hora UTC no bridge
+: timeZone (string): Fuso horário atualmente definido no bridge
+: localTime (string): Fuso horário local
+: portalServicesEnabled (boolean): Indica se os serviços do portal estão ativados
+: portalConnected (boolean): Indica se o bridge está ligado ao portal
+: linkButtonEnabled (boolean): Indica se o botão de ligação está ativado
+: touchlinkEnabled (boolean): Indica se o TouchLink está ativado
+: autoUpdatesEnabled (boolean): Indica se o HueMagic procurará atualizações automaticamente
+: users (array [object, ...]): Lista de todos os utilizadores no bridge (matriz de objetos)
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+: model (object): Contém as informações de modelo do bridge em `id`, `manufacturer` e `name`
+
+#### Resultados de «fetch» em `msg.results` (opcional)
+
+Se o comando «fetch» tiver sido utilizado no nó, o bridge emite os resultados correspondentes no objeto `msg.results`. O objeto contém os grupos de recursos consultados, que por sua vez contêm todos os recursos correspondentes sob a forma de matriz.
+
+#### Mensagens de estado globais em `msg.updated` (opcional)
+
+Salvo se desativado, o nó emite uma mensagem de estado atualizada para cada recurso do bridge. A mensagem de estado em `msg.updated` segue o padrão do respetivo recurso e varia consoante o tipo de dispositivo que foi atualizado por último.
+
+#### Ú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-bridge.json

@@ -0,0 +1,26 @@
+{
+	"hue-bridge": {
+		"config": {
+			"name": "Nome",
+			"input-name": "Nome do Hue Bridge",
+			"skipglobalevents-info": "Ignorar as atualizações e mensagens globais dos dispositivos neste nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Bridge",
+			"not-configured": "não configurado",
+			"connecting": "a ligar…",
+			"connected": "ligado",
+			"starting-tl": "a iniciar o TouchLink…",
+			"started-tl": "TouchLink iniciado…",
+			"f-resources": "a obter recursos…",
+			"updating-settings": "a atualizar as definições…",
+			"settings-updated": "definições atualizadas",
+			"input": "definições / consulta",
+			"output": "informações do bridge",
+			"statusmsg": "Estado consultado com sucesso…",
+			"error-not-available": "O bridge ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com o bridge."
+		}
+	}
+}

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

@@ -0,0 +1,70 @@
+<script type="text/markdown" data-help-name="hue-brightness">
+O nó «Hue Luminosidade» pode ler o nível de luz atual de um sensor adequado ligado ao bridge.
+
+### 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.
+
+A definição «Escuro abaixo de» determina a partir de que nível de luz o nó considera que uma divisão está escura. Uma divisão com um candeeiro forte precisa de um valor completamente diferente de um corredor sem janela, por isso basta introduzir o número de lux adequado ao seu espaço. Os valores `dark` e `daylight` passam então a seguir a sua definição em vez do valor predefinido de 90 lux.
+
+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 do nível de luz 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 sensor deteta uma alteração do nível de luz, é devolvida 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
+: lux (int): Indica o valor LUX real do nível de luz
+: lightLevel (int): Indica a intensidade luminosa do sensor
+: dark (boolean): `true` se foi registada escuridão
+: daylight (boolean): `true` se foi registada luz do dia
+: darkThreshold (int): O nível de luz em lux abaixo do qual o nó comunica escuridão
+: 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 `light_level`)
+: softwareVersion (string): O firmware atual do sensor
+: battery (float): O nível atual da bateria do sensor
+: batteryState (string): O estado atual do nível da bateria. Pode conter `normal`, `low` ou `critical` como valor
+: 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-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,61 @@
+<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.
+
+Em «Saídas adicionais» pode adicionar uma saída por cada intervalo de botões, cada uma acionada por uma ação específica (início da pressão, fim de uma pressão curta, fim de uma pressão longa assim que esta tenha durado pelo menos a duração configurada, ou repetidamente enquanto uma pressão longa está em curso). A primeira saída do nó continua a receber sempre todos os eventos, tal como antes; as saídas adicionais só recebem uma cópia da mensagem quando o intervalo de botões e a ação correspondem.
+
+### 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,62 @@
+{
+	"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",
+			"add-outputs": "Saídas adicionais...",
+			"add-outputs-range": "Intervalo de botões...",
+			"add-outputs-newflow": "Acionar um novo fluxo em...",
+			"add-outputs-nr": "Saída n.º",
+			"add-outputs-btn-from": "De...",
+			"add-outputs-btn-to": "Até...",
+			"add-outputs-startpress": "Início da pressão",
+			"add-outputs-shortpress": "Fim de pressão curta",
+			"add-outputs-longpress": "Fim de pressão longa quando >",
+			"add-outputs-longpresswhile": "Pressão longa (enquanto premido)",
+			"add-outputs-btn-addnew": "adicionar novo intervalo de botões",
+			"outputlabel-btn-from": "botão #__from__",
+			"outputlabel-btn-from-to": "botões #__from__ a #__to__",
+			"outputlabel-btn-on": "em:",
+			"outputlabel-btn-startpress": "Início da pressão",
+			"outputlabel-btn-shortpress": "Fim de pressão curta",
+			"outputlabel-btn-longpress": "Pressão longa (>__duration__s)",
+			"outputlabel-btn-longpresswhile": "Pressão longa (enquanto premido)"
+		},
+		"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",
+			"action-started": "início da pressão",
+			"dial-clockwise": "Roda ↻ __degrees__°",
+			"dial-counterclockwise": "Roda ↺ __degrees__°",
+			"button-status": "Botão n.º __button__ (__action__)",
+			"button-status-duration": "Botão n.º __button__ (__action__, __duration__s)",
+			"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."
+		}
+	}
+}