node-red-contrib-huemagic 4.2.2 → 5.0.0

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

@@ -0,0 +1,64 @@
+<script type="text/markdown" data-help-name="hue-motion">
+O nó «Hue Movimento» pode registar e comunicar os movimentos detetados por 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.
+
+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 movimentos e, por conseguinte, deixa de os 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 regista um movimento, 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
+: motion (boolean): Indica se foi registado movimento
+: 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 `motion`)
+: 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-motion.json

@@ -0,0 +1,36 @@
+{
+	"hue-motion": {
+		"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 movimento…",
+			"none-found": "Nenhum sensor de movimento 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 Movimento",
+			"motion": "movimento detetado",
+			"no-motion": "sem movimento",
+			"input": "ativar / desativar / estado",
+			"output": "movimento detetado",
+			"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.",
+			"error-no-sensitivity": "Esta fonte de movimento não tem sensibilidade ajustável.",
+			"error-invalid-sensitivity": "Sensibilidade inválida. Apenas são permitidos valores de 0 a __max__."
+		}
+	}
+}

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

@@ -0,0 +1,69 @@
+<script type="text/markdown" data-help-name="hue-rules">
+O nó «Hue Regra» pode ativar ou desativar as regras guardadas no bridge e consultar as respetivas definições.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todas as regras disponíveis. Se já souber o ID da regra, também o pode introduzir aqui manualmente. Em alternativa, pode atribuir um novo nome ou manter o nome predefinido da regra. 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 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 nenhuma regra 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 regra específica, transmitindo o respetivo ID como cadeia de carateres em `msg.topic` juntamente com as suas definições.
+
+### Consultar propriedades e definições
+
+Emite as propriedades atuais da regra 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 regra
+
+### Ativar / desativar a regra
+
+A regra pode ser ativada e desativada sempre que necessário. Se a regra estiver desativada, deixa de ser executada no bridge até a reativar. Para tal, transmita um objeto com o seguinte conteúdo:
+
+: payload (boolean): `true` ativa a regra, `false` desativa-a
+
+### Mensagens de estado do nó
+
+Assim que o estado (ativada / desativada) de uma regra muda, o nó devolve a seguinte mensagem de estado:
+
+#### Objeto de estado em `msg.payload`
+
+: enabled (boolean): Indica se a regra está ativada ou desativada
+: triggered (string): Momento da última execução (ISO 8601)
+
+#### Informações sobre a regra em `msg.info`
+
+: id (string): O ID único da regra
+: created (string): Data de criação da regra (ISO 8601)
+: name (string): Nome da regra no bridge
+: timesTriggered (int): Número de vezes que a regra foi executada no bridge
+: owner (string): ID do proprietário desta regra
+: status (string): Estado da regra sob a forma de cadeia de carateres
+
+#### Condições da regra em `msg.conditions` (matriz)
+
+: address (string): Caminho para um atributo de um sensor
+: operator (string): Operador
+: value (string): O valor a verificar
+
+#### Ações da regra em `msg.actions` (matriz)
+
+: address (string): O endereço de destino do recurso
+: method (string): O método do pedido
+: body (object): A ação a executar
+
+#### 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 regra. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado da regra em `msg.lastState`
+
+Contém o objeto completo (ver os valores de saída acima) do último estado antes da última alteração registada da regra. 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-rules.json

@@ -0,0 +1,30 @@
+{
+	"hue-rules": {
+		"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",
+			"input-name": "Nome da regra",
+			"searching": "A procurar regras…",
+			"none-found": "Nenhuma regra encontrada!",
+			"rule": "Regra"
+		},
+		"node": {
+			"init": "a inicializar…",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Regra",
+			"no-rule": "nenhuma regra selecionada",
+			"enabled": "ativada",
+			"disabled": "desativada",
+			"output": "regra (executada)",
+			"input": "ativar / desativar",
+			"error-no-id": "Indique um ID de regra válido.",
+			"error-not-available": "A regra 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-scene.html

@@ -0,0 +1,43 @@
+<script type="text/markdown" data-help-name="hue-scene">
+O nó «Hue Cena» pode retomar cenas guardadas no bridge e aplicá-las a determinados grupos.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todas as cenas disponíveis. As cenas são ordenadas primeiro por divisão ou zona e depois pelo nome, para que as cenas da mesma divisão fiquem sempre juntas na lista. Se já souber o ID da cena, também o pode introduzir aqui manualmente. Em alternativa, pode atribuir internamente um nome à cena ou manter o nome predefinido.
+
+### Ativar uma cena
+
+Pode ativar uma cena predefinida transmitindo um objeto com o seguinte conteúdo:
+
+: payload (boolean): Ativa uma cena pré-configurada
+: transitionTime (float): Tempo de transição da cena em segundos. Se for transmitido `0`, a cena é aplicada de imediato. Se transmitir `3`, as luzes fazem a transição para a cena nos 3 segundos seguintes. O bridge aceita até 6000 segundos
+: brightness (float): Brilho de toda a cena em percentagem (`0` – `100`), para poder ativar a mesma cena mais clara ou mais suave consoante a hora do dia
+
+> [!NOTE]
+> Ambas as definições só estão disponíveis para cenas normais. Uma cena inteligente segue os horários que definiu para ela na aplicação Philips Hue.
+
+### Ativar uma cena no modo universal
+
+Se utilizar este nó no chamado «modo universal» e não tiver definido nenhuma cena na configuração do nó, também pode transmitir ao nó a cena pretendida como comando. Para tal, transmita um objeto `msg.payload` com o seguinte conteúdo:
+
+: scene (string): ID da cena a ativar no bridge
+
+### Ativar uma cena em determinados grupos
+
+Ligue a saída deste nó a um ou mais grupos para aplicar uma cena a grupos específicos. Em alternativa, pode fazê-lo «dinamicamente», transmitindo ao nó um objeto `msg.payload` com o seguinte conteúdo:
+
+: group (string | array [string,…]): ID do grupo ou uma matriz com os ID de vários grupos para limitar a cena a esses grupos
+
+### Mais informações sobre o nó
+
+Este nó não emite mensagens de estado.
+
+> [!IMPORTANT]
+> Só pode aplicar cenas a grupos se estes já estiverem associados à respetiva cena no bridge. Caso contrário, não será aplicado nada.
+
+### 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-scene.json

@@ -0,0 +1,32 @@
+{
+	"hue-scene": {
+		"config": {
+			"name": "Nome",
+			"input-name": "Nome da cena",
+			"skipevents-node": "Ignorar as mensagens do nó",
+			"sendinitevents-node": "Não suprimir o evento de inicialização",
+			"searching": "A procurar cenas…",
+			"none-found": "Nenhuma cena encontrada!",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"scene": "Cena",
+			"group": "Grupo",
+			"group-none-found": "Nenhum grupo encontrado!",
+			"group-searching": "A procurar grupos…",
+			"groups-all": "Todos os grupos / luzes",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Cena",
+			"not-configured": "não configurado",
+			"recalled": "cena ativada",
+			"recalled-on-group": "cena ativada no grupo",
+			"no-id": "Sem ID de cena.",
+			"input": "ativar cena",
+			"output": "grupo(s) de destino",
+			"command": "a executar comando…",
+			"statusmsg": "A ativar a cena…",
+			"error-not-available": "A cena 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."
+		}
+	}
+}

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

@@ -0,0 +1,80 @@
+<script type="text/markdown" data-help-name="hue-speaker">
+O nó «Hue Altifalante» pode reproduzir os sons de uma campainha Hue Secure e utilizá-la como sirene de interior.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todos os altifalantes disponíveis. Se já souber o ID do altifalante, também o pode introduzir aqui manualmente. Pode atribuir internamente um novo nome ao altifalante 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 altifalante 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 altifalante 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 altifalante 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 altifalante 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 altifalante
+
+### Reproduzir um som
+
+Um altifalante conhece três canais distintos. `chime` é o som da campainha, `alarm` é a sirene e `alert` é uma notificação curta. Os sons que um aparelho conhece efetivamente são listados em `msg.info.sounds`. Transmita os seguintes parâmetros num objeto `msg.payload`:
+
+: chime (string | object | boolean): Nome do som da campainha; `false` para-o novamente
+: alarm (string | object | boolean): Nome do som da sirene; `false` para-o novamente
+: alert (string | object | boolean): Nome do som de notificação; `false` para-o novamente
+: mute (boolean): `true` silencia o altifalante, `false` volta a ativar o som
+
+Em vez de um simples nome de som, também pode transmitir um objeto para controlar o volume e a duração:
+
+: sound (string): Nome do som, p. ex. `ding_dong_classic` ou `siren`
+: volume (int): Volume em percentagem (0-100)
+: duration (float): Tempo de reprodução em segundos
+
+### Mensagens de estado do nó
+
+Assim que o altifalante começa ou deixa de reproduzir, o nó devolve a seguinte mensagem de estado.
+
+> [!NOTE]
+> O bridge comunica o último som reproduzido e só o repõe bastante depois de terminada a reprodução, pelo que estes valores ficam ligeiramente atrasados em relação ao áudio.
+
+#### Objeto de estado em `msg.payload`
+
+: reachable (boolean | string): `true` se o altifalante 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
+: playing (boolean): `true` enquanto o altifalante estiver a reproduzir algum som
+: chime (string | boolean): Nome do som de campainha em reprodução ou `false`
+: alarm (string | boolean): Nome do som de sirene em reprodução ou `false`
+: alert (string | boolean): Nome do som de notificação em reprodução ou `false`
+: muted (boolean): Indica se o altifalante está silenciado
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre o altifalante em `msg.info`
+
+: id (string): Indica o novo ID do altifalante
+: idV1 (string | boolean): Indica o ID antigo do altifalante
+: uniqueId (string): O ID único do altifalante
+: deviceId (string): O ID único do dispositivo
+: name (string): O nome atualmente atribuído ao altifalante
+: type (string): O tipo do dispositivo (sempre `speaker`)
+: softwareVersion (string): O firmware atual do altifalante
+: battery (float | boolean): O nível atual da bateria do altifalante, `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
+: sounds (object): Contém os sons que este aparelho conhece em `chime`, `alarm` e `alert`
+: model (object): Contém as informações de modelo do altifalante 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 altifalante. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado do altifalante 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-speaker.json

@@ -0,0 +1,38 @@
+{
+	"hue-speaker": {
+		"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 altifalante",
+			"searching": "A procurar altifalantes…",
+			"none-found": "Nenhum altifalante encontrado!",
+			"speaker": "Altifalante"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"not-reachable": "inacessível",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Altifalante",
+			"silent": "silencioso",
+			"muted": "sem som",
+			"playing-alarm": "alarme (__sound__)",
+			"playing-chime": "campainha (__sound__)",
+			"playing-alert": "aviso (__sound__)",
+			"input": "reproduzir som / estado",
+			"output": "altifalante",
+			"error-no-id": "Indique um ID de altifalante válido.",
+			"error-not-available": "O altifalante 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-channel": "Este altifalante não tem qualquer som do tipo __channel__.",
+			"error-invalid-sound": "Som de __channel__ inválido. São permitidos: __sounds__",
+			"error-invalid-volume": "Definição de volume inválida. Apenas são permitidos valores de 0 a 100."
+		}
+	}
+}

package/huemagic/locales/pt/hue-syncbox-config.html

@@ -0,0 +1,19 @@
+<script type="text/markdown" data-help-name="hue-syncbox-config">
+Liga-se a uma Philips Hue Play HDMI Sync Box.
+
+### Nome
+
+Pode atribuir à sync box um nome interno alternativo ou manter o nome predefinido.
+
+### IP da Sync Box
+
+O endereço IP da sua sync box na rede local. Assim que o introduzir, o HueMagic tenta ler o nome do aparelho e preenche-o por si.
+
+### Token de acesso
+
+A sync box não faz parte do seu Hue Bridge e precisa do seu próprio token. Clique no botão junto ao campo e mantenha depois premido o botão da sync box até o LED piscar a verde. O HueMagic continua a interrogar o aparelho durante um minuto e guarda o token assim que este responder.
+
+### Atualização
+
+A sync box não envia o seu estado por iniciativa própria, por isso o HueMagic pergunta-lho regularmente. Esta definição determina quantos segundos decorrem entre dois pedidos. O valor predefinido de 10 segundos é um bom compromisso entre um estado reativo e o tráfego de rede — não o reduza mais do que realmente precisa.
+</script>

package/huemagic/locales/pt/hue-syncbox-config.json

@@ -0,0 +1,25 @@
+{
+	"hue-syncbox-config": {
+		"config": {
+			"name": "Nome",
+			"syncbox-ip": "IP da Sync Box",
+			"token": "Token de acesso",
+			"pollinterval": "Atualização (s)",
+			"missing-ip": "Falta o IP da Hue Sync Box…",
+			"connecting": "A ligar à sync box…",
+			"invalid": "Lamentamos. A Hue Sync Box selecionada não é válida: ",
+			"error-select-first": "Introduza o IP da sua Hue Sync Box antes de criar um novo token!",
+			"waiting": "à espera do botão…",
+			"new-user-press": "Mantenha premido o botão da sua Hue Sync Box até o LED piscar a verde!",
+			"retry": "Não foi detetada qualquer pressão do botão. Tente novamente…",
+			"success": "Token de acesso criado com sucesso!"
+		},
+		"node": {
+			"title": "Hue Sync Box",
+			"initializing": "A inicializar a sync box (__syncbox__)…",
+			"connected": "Ligado à sync box",
+			"request-error": "Erro ao pedir informações à sync box (__error__)",
+			"statusmsg": "Estado consultado com sucesso…"
+		}
+	}
+}

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

@@ -0,0 +1,86 @@
+<script type="text/markdown" data-help-name="hue-syncbox">
+O nó «Hue Sync Box» controla uma Philips Hue Play HDMI Sync Box e comunica o que esta está a fazer no momento.
+
+### Configuração
+
+A sync box não está ligada ao seu Hue Bridge, mas fala a sua própria API local, pelo que necessita de uma configuração própria. Introduza o endereço IP da sua sync box e clique no botão junto ao campo do token de acesso. Mantenha depois premido o botão da sync box até o LED piscar a verde — o HueMagic continua a interrogar o aparelho durante um minuto e guarda o token assim que este responder.
+
+Uma vez que a sync box não envia o seu estado por iniciativa própria, o HueMagic pergunta-lho regularmente. Pode definir a frequência na configuração; o valor predefinido é de 10 segundos. Opcionalmente, pode desativar todas as mensagens de estado automáticas deste nó através da definição «Ignorar as mensagens do nó». Em alternativa, pode escolher que a mensagem de inicialização do nó não seja suprimida no arranque do Node-RED. 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.
+
+### Consultar o estado
+
+Emite o estado atual da sync box 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 sync box
+
+### Ligar / desligar (modo simples)
+
+Para ligar ou desligar rapidamente a sync box, transmita ao nó um objeto com o seguinte conteúdo. Ao ligar, é retomado o último modo de sincronização utilizado.
+
+: payload (boolean): `true` inicia a sincronização, `false` coloca o aparelho em poupança de energia
+
+### Comandos da sync box (avançado)
+
+Transmita os seguintes parâmetros num objeto `msg.payload` para controlar a sync box de forma mais detalhada:
+
+: mode (string): Um de `powersave`, `passthrough`, `video`, `game`, `music` ou `ambient`
+: sync (boolean): `true` inicia a sincronização, `false` para-a
+: toggle (boolean | any): Alterna a sincronização consoante o estado anterior
+: passthrough (boolean): `true` encaminha a imagem para o seu televisor sem sincronizar
+: intensity (string): Com que intensidade as luzes seguem a imagem. Um de `subtle`, `moderate`, `high` ou `intense`
+: brightness (int): Valor percentual do brilho (0-100)
+: brightnessLevel (int): Valor numérico do brilho tal como o aparelho o conta (0-200, sendo 100 o valor de referência)
+: incrementBrightness (int | boolean): Indica em quantos pontos percentuais o brilho da sync box deve aumentar, ou `true` para passos de 10 %
+: decrementBrightness (int | boolean): Indica em quantos pontos percentuais o brilho da sync box deve diminuir, ou `true` para passos de 10 %
+: input (string | int): A entrada HDMI a apresentar, de `input1` a `input4` ou simplesmente de `1` a `4`
+: entertainmentArea (string): A área de entretenimento que o aparelho deve controlar, p. ex. `groups/13`
+
+### Mensagens de estado do nó
+
+Sempre que o estado da sync box muda, o nó devolve a seguinte mensagem de estado:
+
+#### Objeto de estado em `msg.payload`
+
+: on (boolean): `false` enquanto o aparelho estiver em poupança de energia
+: syncing (boolean): `true` enquanto as luzes seguirem a imagem
+: passthrough (boolean): `true` enquanto o aparelho encaminhar a imagem
+: mode (string): O modo atualmente ativo
+: lastSyncMode (string): O último modo de sincronização utilizado
+: intensity (string | boolean): Intensidade do modo atualmente ativo
+: brightness (int | boolean): Brilho em percentagem
+: brightnessLevel (int | boolean): Brilho tal como o aparelho o conta (0-200)
+: input (string | boolean): A entrada HDMI atualmente apresentada
+: inputs (object): As quatro entradas HDMI com o respetivo `name`, `type`, `status` (`unplugged`, `plugged`, `linked` ou `unknown`) e se estão `active`
+: entertainmentArea (string | boolean): A área de entretenimento controlada pelo aparelho
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre a sync box em `msg.info`
+
+: id (string | boolean): O ID único da sync box
+: name (string | boolean): O nome atualmente atribuído à sync box
+: type (string): O tipo do dispositivo (sempre `syncbox`)
+: ipAddress (string | boolean): O endereço IP que o aparelho indica para si próprio
+: softwareVersion (string | boolean): O firmware atual da sync box
+: apiLevel (int | boolean): O nível de API da sync box
+: ledMode (int | boolean): O modo de LED atualmente definido
+: wifi (object | boolean): Contém `ssid` e `strength` da ligação sem fios
+: model (object): Contém as informações de modelo da sync box em `id`, `manufacturer` e `name`
+
+#### 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 sync box. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado da sync box 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-syncbox.json

@@ -0,0 +1,30 @@
+{
+	"hue-syncbox": {
+		"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",
+			"input-name": "Nome da Sync Box",
+			"syncbox": "Sync Box"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Sync Box",
+			"connecting": "a ligar…",
+			"powersave": "desligada",
+			"passthrough": "passagem direta",
+			"syncing": "__mode__ (__intensity__)",
+			"input": "controlar a sync box",
+			"output": "sync box",
+			"error-not-available": "A sync box ainda não está disponível. Aguarde até que o HueMagic tenha estabelecido a ligação com ela.",
+			"error-invalid-mode": "Modo inválido. São permitidos: __modes__",
+			"error-invalid-intensity": "Intensidade inválida. São permitidas: __intensities__",
+			"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 200.",
+			"error-invalid-input": "Entrada HDMI inválida. Apenas são permitidas input1 a input4."
+		}
+	}
+}

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

@@ -0,0 +1,69 @@
+<script type="text/markdown" data-help-name="hue-temperature">
+O nó «Hue Temperatura» pode consultar e comunicar a temperatura ambiente 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.
+
+Os sensores de movimento são geralmente instalados num canto da divisão e medem muitas vezes um valor ligeiramente elevado devido à sua própria eletrónica. Com a definição «Correção» pode calibrar o sensor sem rodeios: o valor que introduzir aqui (p. ex. `-1.5`) é somado a cada valor medido antes de o nó o emitir. A correção aplica-se simultaneamente a todas as unidades de temperatura.
+
+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 temperatura 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 regista uma alteração de temperatura, 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
+: celsius (float): Indica a temperatura ambiente atual em °C (graus Celsius)
+: fahrenheit (float): Indica a temperatura ambiente atual em °F (graus Fahrenheit)
+: temperatureIs (string): Descreve a temperatura atual com os valores `very cold`, `cold`, `slightly cold`, `comfortable`, `slightly warm`, `warm`, `hot` ou `very hot`
+: deviceValue (float): O valor original da temperatura fornecido pelo sensor
+: 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 `temperature`)
+: 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>