node-red-contrib-huemagic 4.2.2 → 5.0.0

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

@@ -0,0 +1,19 @@
+<script type="text/markdown" data-help-name="hue-syncbox-config">
+Łączy się z urządzeniem Philips Hue Play HDMI Sync Box.
+
+### Nazwa
+
+Możesz nadać sync box własną nazwę wewnętrzną albo zachować nazwę domyślną.
+
+### Adres IP Sync Box
+
+Adres IP Twojego sync box w sieci lokalnej. Po jego wpisaniu HueMagic spróbuje odczytać nazwę urządzenia i wstawi ją za Ciebie.
+
+### Token dostępu
+
+Sync box nie należy do Twojego Hue Bridge i wymaga własnego tokenu. Kliknij przycisk obok pola, a następnie przytrzymaj przycisk na sync box, aż dioda zamiga na zielono. HueMagic przez minutę odpytuje urządzenie i zapisuje token, gdy tylko ono odpowie.
+
+### Odświeżanie
+
+Sync box nie wysyła swojego stanu samodzielnie, dlatego HueMagic regularnie o niego pyta. To ustawienie określa, ile sekund mija między dwoma zapytaniami. Domyślne 10 sekund to dobry kompromis między szybką reakcją stanu a ruchem sieciowym — nie ustawiaj mniej, niż faktycznie potrzebujesz.
+</script>

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

@@ -0,0 +1,25 @@
+{
+	"hue-syncbox-config": {
+		"config": {
+			"name": "Nazwa",
+			"syncbox-ip": "Adres IP Sync Box",
+			"token": "Token dostępu",
+			"pollinterval": "Odświeżanie (s)",
+			"missing-ip": "Brak adresu IP Hue Sync Box…",
+			"connecting": "Łączenie z sync box…",
+			"invalid": "Niestety. Wybrany Hue Sync Box jest nieprawidłowy: ",
+			"error-select-first": "Podaj adres IP swojego Hue Sync Box, zanim utworzysz nowy token!",
+			"waiting": "oczekiwanie na przycisk…",
+			"new-user-press": "Przytrzymaj przycisk na swoim Hue Sync Box, aż dioda zamiga na zielono!",
+			"retry": "Nie wykryto naciśnięcia przycisku. Spróbuj ponownie…",
+			"success": "Token dostępu został utworzony!"
+		},
+		"node": {
+			"title": "Hue Sync Box",
+			"initializing": "Inicjalizacja sync box (__syncbox__)…",
+			"connected": "Połączono z sync box",
+			"request-error": "Błąd podczas pobierania informacji z sync box (__error__)",
+			"statusmsg": "Stan odczytany pomyślnie…"
+		}
+	}
+}

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

@@ -0,0 +1,86 @@
+<script type="text/markdown" data-help-name="hue-syncbox">
+Węzeł „Hue Sync Box” steruje urządzeniem Philips Hue Play HDMI Sync Box i informuje, co ono aktualnie robi.
+
+### Konfiguracja
+
+Sync box nie jest połączony z Twoim Hue Bridge, lecz korzysta z własnego lokalnego API, dlatego wymaga osobnej konfiguracji. Wpisz adres IP swojego sync box i kliknij przycisk obok pola tokenu dostępu. Następnie przytrzymaj przycisk na sync box, aż dioda zamiga na zielono — HueMagic przez minutę odpytuje urządzenie i zapisuje token, gdy tylko ono odpowie.
+
+Ponieważ sync box nie wysyła swojego stanu samodzielnie, HueMagic regularnie o niego pyta. Częstotliwość ustawisz w konfiguracji; domyślnie jest to co 10 sekund. Opcjonalnie możesz wyłączyć wszystkie automatyczne komunikaty stanu tego węzła ustawieniem „Pomijaj komunikaty węzła”. Możesz też zdecydować, aby komunikat inicjalizacji węzła nie był pomijany przy starcie Node-RED. Jeśli wolisz, aby węzeł milczał, dopóki czegoś do niego nie wyślesz, włącz „Zgłaszaj tylko po poleceniu”. Węzeł zignoruje wtedy zmiany z aplikacji lub z przełącznika i odpowie wyłącznie na Twoje polecenia.
+
+### Odczyt stanu
+
+Zwraca bieżący stan sync box, gdy tylko do węzła zostanie przekazany obiekt `msg.payload` o następującej zawartości. Możesz też nacisnąć przycisk w interfejsie Node-RED, bez wcześniejszego wysyłania komunikatu do węzła.
+
+: status (boolean): Zwraca bieżący stan sync box
+
+### Włączanie / wyłączanie (tryb prosty)
+
+Aby szybko włączyć lub wyłączyć sync box, przekaż do węzła obiekt o następującej zawartości. Po włączeniu przywracany jest ostatnio używany tryb synchronizacji.
+
+: payload (boolean): `true` uruchamia synchronizację, `false` przełącza urządzenie w tryb oszczędzania energii
+
+### Polecenia sync box (rozszerzone)
+
+Przekaż w obiekcie `msg.payload` następujące parametry, aby dokładniej sterować sync box:
+
+: mode (string): Jedna z wartości: `powersave`, `passthrough`, `video`, `game`, `music` lub `ambient`
+: sync (boolean): `true` uruchamia synchronizację, `false` ją zatrzymuje
+: toggle (boolean | any): Przełącza synchronizację zależnie od poprzedniego stanu
+: passthrough (boolean): `true` przekazuje obraz do telewizora bez synchronizacji
+: intensity (string): Jak mocno światła podążają za obrazem. Jedna z wartości: `subtle`, `moderate`, `high` lub `intense`
+: brightness (int): Procentowa wartość jasności (0-100)
+: brightnessLevel (int): Liczbowa wartość jasności w skali urządzenia (0-200, gdzie 100 to wartość bazowa)
+: incrementBrightness (int | boolean): Określa, o ile procent zwiększyć jasność sync box, albo `true` dla kroków co 10 %
+: decrementBrightness (int | boolean): Określa, o ile procent zmniejszyć jasność sync box, albo `true` dla kroków co 10 %
+: input (string | int): Wejście HDMI, które ma być pokazane: `input1` do `input4` albo po prostu `1` do `4`
+: entertainmentArea (string): Strefa rozrywki, którą ma sterować urządzenie, np. `groups/13`
+
+### Komunikaty stanu węzła
+
+Za każdym razem, gdy zmieni się stan sync box, węzeł zwraca następujący komunikat stanu:
+
+#### Obiekt stanu w `msg.payload`
+
+: on (boolean): `false`, gdy urządzenie jest w trybie oszczędzania energii
+: syncing (boolean): `true`, gdy światła podążają za obrazem
+: passthrough (boolean): `true`, gdy urządzenie przekazuje obraz dalej
+: mode (string): Aktualnie aktywny tryb
+: lastSyncMode (string): Ostatnio używany tryb synchronizacji
+: intensity (string | boolean): Intensywność aktualnie aktywnego trybu
+: brightness (int | boolean): Jasność w procentach
+: brightnessLevel (int | boolean): Jasność w skali urządzenia (0-200)
+: input (string | boolean): Aktualnie pokazywane wejście HDMI
+: inputs (object): Wszystkie cztery wejścia HDMI wraz z polami `name`, `type`, `status` (`unplugged`, `plugged`, `linked` lub `unknown`) oraz informacją, czy są `active`
+: entertainmentArea (string | boolean): Strefa rozrywki sterowana przez urządzenie
+: updated (string): Czas ostatniej aktualizacji zasobu przez HueMagic (ISO 8601)
+
+#### Informacje o sync box w `msg.info`
+
+: id (string | boolean): Unikatowy identyfikator sync box
+: name (string | boolean): Aktualnie ustawiona nazwa sync box
+: type (string): Typ urządzenia (zawsze `syncbox`)
+: ipAddress (string | boolean): Adres IP, który urządzenie podaje dla siebie
+: softwareVersion (string | boolean): Bieżące oprogramowanie układowe sync box
+: apiLevel (int | boolean): Poziom API sync box
+: ledMode (int | boolean): Aktualnie ustawiony tryb diody LED
+: wifi (object | boolean): Zawiera `ssid` i `strength` połączenia bezprzewodowego
+: model (object): Zawiera informacje o modelu sync box w polach `id`, `manufacturer` i `name`
+
+#### Zmiany stanu w `msg.updated`
+
+Wymienia w postaci obiektu poszczególne parametry, które zmieniły się względem poprzedniego stanu sync box. Jeśli nie zarejestrowano żadnych zmian, obiekt jest pusty.
+
+#### Poprzedni stan sync box w `msg.lastState`
+
+Zawiera pełny obiekt stanu (patrz wartości wyjściowe powyżej) sprzed ostatniej zarejestrowanej zmiany. Jeśli HueMagic nie zarejestrował jeszcze poprzedniego stanu, zwracane jest `false`.
+
+#### Ostatnie polecenie w `msg.command` (opcjonalnie)
+
+Jeśli stan węzła zmienił się w wyniku określonego polecenia, wysyłane jest również całe wykonane polecenie. W przeciwnym razie węzeł nie wysyła tego obiektu.
+
+### Przykłady z HueMagic
+
+HueMagic udostępnia kilka przykładowych konfiguracji dla tego węzła. Aby zaimportować gotowy przykład do interfejsu Node-RED, kliknij ikonę menu Node-RED, wybierz „Import”, a następnie przejdź do „Examples” na pasku bocznym okna. Wybierz katalog HueMagic i żądany węzeł, aby zaimportować przykładowy przepływ.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

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

@@ -0,0 +1,30 @@
+{
+	"hue-syncbox": {
+		"config": {
+			"name": "Nazwa",
+			"skipevents-node": "Pomijaj komunikaty węzła",
+			"sendinitevents-node": "Nie pomijaj komunikatu inicjalizacji",
+			"onlycommands-node": "Zgłaszaj tylko po poleceniu",
+			"input-name": "Nazwa Sync Box",
+			"syncbox": "Sync Box"
+		},
+		"node": {
+			"not-configured": "nieskonfigurowany",
+			"command": "wykonywanie polecenia…",
+			"statusmsg": "Stan odczytany pomyślnie…",
+			"title": "Hue Sync Box",
+			"connecting": "łączenie…",
+			"powersave": "wyłączony",
+			"passthrough": "przekazywanie obrazu",
+			"syncing": "__mode__ (__intensity__)",
+			"input": "sterowanie sync box",
+			"output": "sync box",
+			"error-not-available": "Sync box nie jest jeszcze dostępny. Poczekaj, aż HueMagic nawiąże z nim połączenie.",
+			"error-invalid-mode": "Nieprawidłowy tryb. Dozwolone są: __modes__",
+			"error-invalid-intensity": "Nieprawidłowa intensywność. Dozwolone są: __intensities__",
+			"error-invalid-brightness": "Nieprawidłowe ustawienie jasności. Dozwolone są tylko wartości od 0 do 100 procent.",
+			"error-invalid-brightness-level": "Nieprawidłowe ustawienie jasności. Dozwolone są tylko wartości od 0 do 200.",
+			"error-invalid-input": "Nieprawidłowe wejście HDMI. Dozwolone są tylko input1 do input4."
+		}
+	}
+}

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

@@ -0,0 +1,69 @@
+<script type="text/markdown" data-help-name="hue-temperature">
+Węzeł „Hue Temperatura” odczytuje i zgłasza bieżącą temperaturę otoczenia z odpowiedniego czujnika podłączonego do bridge.
+
+### Konfiguracja
+
+Wybierz skonfigurowany Hue Bridge i kliknij przycisk wyszukiwania, aby znaleźć wszystkie dostępne czujniki. Jeśli znasz już identyfikator czujnika, możesz go też wpisać ręcznie. Możesz nadać czujnikowi własną nazwę wewnętrzną albo zachować nazwę domyślną. Opcjonalnie możesz wyłączyć wszystkie automatyczne komunikaty stanu tego węzła ustawieniem „Pomijaj komunikaty węzła”. Węzeł przestanie wtedy wysyłać aktualizacje urządzenia. Możesz też zdecydować, aby komunikat inicjalizacji węzła nie był pomijany przy starcie Node-RED. Po włączeniu tego ustawienia po każdym wdrożeniu otrzymasz komunikat stanu wybranego czujnika. Jeśli wolisz, aby węzeł milczał, dopóki czegoś do niego nie wyślesz, włącz „Zgłaszaj tylko po poleceniu”. Węzeł zignoruje wtedy zmiany z aplikacji lub z przełącznika i odpowie wyłącznie na Twoje polecenia.
+
+Czujniki ruchu montuje się zwykle w rogu pomieszczenia i przez własną elektronikę często mierzą nieco za wysoką temperaturę. Ustawieniem „Korekta” możesz skalibrować czujnik bez okrężnych dróg: wpisana tu wartość (np. `-1.5`) jest dodawana do każdego pomiaru, zanim węzeł go zwróci. Korekta obowiązuje jednocześnie dla wszystkich jednostek temperatury.
+
+Jeśli nie wybierzesz czujnika i użyjesz konfiguracji węzła w ten sposób, węzeł działa w tzw. „trybie uniwersalnym”. W tym trybie węzeł odbiera i wysyła wszystkie komunikaty stanu tego samego typu. Ustawienia w trybie uniwersalnym możesz też zastosować do konkretnego czujnika, przekazując jego identyfikator jako ciąg znaków w `msg.topic` razem z ustawieniami.
+
+### Odczyt stanu
+
+Zwraca bieżący stan czujnika, gdy tylko do węzła zostanie przekazany obiekt `msg.payload` o następującej zawartości. Możesz też nacisnąć przycisk w interfejsie Node-RED, bez wcześniejszego wysyłania komunikatu do węzła.
+
+: status (boolean): Zwraca bieżący stan czujnika
+
+### Włączanie / wyłączanie czujnika
+
+W razie potrzeby czujnik można włączać i wyłączać zdalnie. Wyłączony czujnik nie rejestruje już zmian temperatury i w związku z tym ich nie zgłasza. Przekaż w tym celu obiekt o następującej zawartości:
+
+: payload (boolean): `true` włącza czujnik, `false` go wyłącza
+
+### Komunikaty stanu węzła
+
+Gdy tylko czujnik zarejestruje zmianę temperatury, węzeł zwraca następujący komunikat stanu:
+
+#### Obiekt stanu w `msg.payload`
+
+: active (boolean): Wskazuje, czy czujnik jest włączony, czy wyłączony
+: reachable (boolean | string): `true`, jeśli czujnik jest połączony z bridge, `unknown`, jeśli stan połączenia jest inny
+: connectionStatus (string): Bieżący stan połączenia z bridge w postaci ciągu znaków. Może przyjmować wartości `connected`, `disconnected`, `connectivity_issue` lub `unidirectional_incoming`
+: celsius (float): Wskazuje bieżącą temperaturę otoczenia w °C (stopnie Celsjusza)
+: fahrenheit (float): Wskazuje bieżącą temperaturę otoczenia w °F (stopnie Fahrenheita)
+: temperatureIs (string): Opisuje bieżącą temperaturę wartościami `very cold`, `cold`, `slightly cold`, `comfortable`, `slightly warm`, `warm`, `hot` lub `very hot`
+: deviceValue (float): Pierwotna wartość temperatury z czujnika
+: updated (string): Czas ostatniej aktualizacji zasobu przez HueMagic (ISO 8601)
+
+#### Informacje o czujniku w `msg.info`
+
+: id (string): Wskazuje nowy identyfikator czujnika
+: idV1 (string | boolean): Wskazuje stary identyfikator czujnika
+: uniqueId (string): Unikatowy identyfikator czujnika
+: deviceId (string): Unikatowy identyfikator urządzenia
+: name (string): Aktualnie ustawiona nazwa czujnika
+: type (string): Typ czujnika (zawsze `temperature`)
+: softwareVersion (string): Bieżące oprogramowanie układowe czujnika
+: battery (float): Bieżący poziom naładowania baterii czujnika
+: batteryState (string): Bieżący stan poziomu baterii. Może przyjmować wartości `normal`, `low` lub `critical`
+: model (object): Zawiera informacje o modelu czujnika w polach `id`, `manufacturer`, `name`, `type` i `certified`
+
+#### Zmiany stanu w `msg.updated`
+
+Wymienia w postaci obiektu poszczególne parametry, które zmieniły się względem poprzedniego stanu czujnika. Jeśli nie zarejestrowano żadnych zmian, obiekt jest pusty.
+
+#### Poprzedni stan czujnika w `msg.lastState`
+
+Zawiera pełny obiekt stanu (patrz wartości wyjściowe powyżej) sprzed ostatniej zarejestrowanej zmiany. Jeśli HueMagic nie zarejestrował jeszcze poprzedniego stanu, zwracane jest `false`.
+
+#### Ostatnie polecenie w `msg.command` (opcjonalnie)
+
+Jeśli stan węzła zmienił się w wyniku określonego polecenia, wysyłane jest również całe wykonane polecenie. W przeciwnym razie węzeł nie wysyła tego obiektu.
+
+### Przykłady z HueMagic
+
+HueMagic udostępnia kilka przykładowych konfiguracji dla tego węzła. Aby zaimportować gotowy przykład do interfejsu Node-RED, kliknij ikonę menu Node-RED, wybierz „Import”, a następnie przejdź do „Examples” na pasku bocznym okna. Wybierz katalog HueMagic i żądany węzeł, aby zaimportować przykładowy przepływ.
+
+![examples](hue/assets/huemagic-examples.gif)
+</script>

package/huemagic/locales/pl/hue-temperature.json

@@ -0,0 +1,33 @@
+{
+	"hue-temperature": {
+		"config": {
+			"name": "Nazwa",
+			"skipevents-node": "Pomijaj komunikaty węzła",
+			"sendinitevents-node": "Nie pomijaj komunikatu inicjalizacji",
+			"onlycommands-node": "Zgłaszaj tylko po poleceniu",
+			"unknown-error": "Coś poszło nie tak. Spróbuj ponownie.",
+			"bridge": "Bridge",
+			"universalevents": "Zdarzenia uniwersalne",
+			"universalevents-node": "Odbiera wszystkie komunikaty innych węzłów tego samego typu (tylko w trybie uniwersalnym)",
+			"input-name": "Nazwa czujnika",
+			"searching": "wyszukiwanie czujników temperatury…",
+			"none-found": "Nie znaleziono żadnego czujnika temperatury.",
+			"sensor": "Czujnik",
+			"offset": "Korekta"
+		},
+		"node": {
+			"not-configured": "nieskonfigurowany",
+			"init": "inicjalizacja…",
+			"not-reachable": "nieosiągalny",
+			"universal": "tryb uniwersalny",
+			"command": "wykonywanie polecenia…",
+			"deactivated": "wyłączony",
+			"statusmsg": "Stan odczytany pomyślnie…",
+			"title": "Hue Temperatura",
+			"input": "zapytanie o stan",
+			"output": "temperatura (zmieniona)",
+			"error-no-id": "Podaj prawidłowy identyfikator: czujnik.",
+			"error-not-available": "Czujnik nie jest jeszcze dostępny. Poczekaj, aż HueMagic nawiąże połączenie z bridge, albo sprawdź, czy identyfikator zasobu podany w konfiguracji jest prawidłowy."
+		}
+	}
+}

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

@@ -0,0 +1,59 @@
+<script type="text/markdown" data-help-name="hue-automation">
+O nó «Hue Automatização» pode ativar e desativar as automatizações que criou na aplicação Philips Hue.
+
+### Configuração
+
+Selecione o Hue Bridge pré-configurado e clique no botão de pesquisa para encontrar todas as automatizações disponíveis. Se já souber o ID da automatização, também o pode introduzir aqui manualmente. Pode atribuir internamente um novo nome à automatização 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 da automatização 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 não selecionar nenhuma automatizaçã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. Também pode aplicar definições no modo universal a uma automatização específica, transmitindo o respetivo ID como cadeia de carateres em `msg.topic` juntamente com as suas definições.
+
+### Ativar / desativar a automatização
+
+Uma automatização desativada permanece no bridge e pode ser reativada a qualquer momento. Para tal, transmita um objeto com o seguinte conteúdo:
+
+: payload (boolean): `true` ativa a automatização, `false` desativa-a
+: enabled (boolean): Como acima, se preferir transmitir um objeto
+: toggle (boolean | any): Alterna entre ativada e desativada, consoante o estado anterior
+
+### Mensagens de estado do nó
+
+Assim que a automatização muda, o nó devolve a seguinte mensagem de estado:
+
+#### Objeto de estado em `msg.payload`
+
+: enabled (boolean): Indica se a automatização está ativada
+: running (boolean): `true` enquanto o bridge estiver efetivamente a executar a automatização
+: status (string | boolean): O estado atual. Pode conter `initializing`, `running`, `disabled` ou `errored` como valor
+: lastError (string | boolean): O último erro comunicado pelo bridge ou `false`
+: updated (string): Momento da última atualização do recurso pelo HueMagic (ISO 8601)
+
+#### Informações sobre a automatização em `msg.info`
+
+: id (string): Indica o ID da automatização
+: idV1 (string | boolean): Indica o ID antigo da automatização
+: name (string | boolean): O nome que atribuiu à automatização na aplicação Philips Hue
+: type (string): O tipo do recurso (sempre `automation`)
+: script (string | boolean): O ID do script de comportamento subjacente à automatização
+
+#### Configuração em `msg.configuration`
+
+Contém as definições da automatização tal como foram guardadas pela aplicação Philips Hue. A estrutura depende do tipo de automatização e é transmitida sem alterações.
+
+#### 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 automatização. Se não tiverem sido registadas alterações, este objeto está vazio.
+
+#### Último estado da automatizaçã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-automation.json

@@ -0,0 +1,33 @@
+{
+	"hue-automation": {
+		"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 da automatização",
+			"searching": "A procurar automatizações…",
+			"none-found": "Nenhuma automatização encontrada!",
+			"automation": "Automatização"
+		},
+		"node": {
+			"not-configured": "não configurado",
+			"init": "a inicializar…",
+			"universal": "modo universal",
+			"command": "a executar comando…",
+			"statusmsg": "Estado consultado com sucesso…",
+			"title": "Hue Automatização",
+			"enabled": "ativada",
+			"disabled": "desativada",
+			"errored": "erro",
+			"input": "ativar / desativar",
+			"output": "automatização",
+			"error-no-id": "Indique um ID de automatização válido.",
+			"error-not-available": "A automatização 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-bridge-config.html

@@ -0,0 +1,31 @@
+<script type="text/markdown" data-help-name="hue-bridge">
+Liga-se a um Philips Hue Bridge.
+
+### Nome
+
+Pode atribuir ao bridge um nome interno alternativo ou manter o nome predefinido.
+
+### IP e porta do bridge
+
+Introduza manualmente o endereço IP do Hue Bridge ou prima o botão para listar todos os bridges disponíveis localmente (recomenda-se uma configuração de IP estático no Hue Bridge). Opcionalmente, pode também definir uma porta alternativa para o bridge acrescentando dois pontos ao endereço IP.
+
+### Chave API
+
+Introduza manualmente a chave API do Hue Bridge ou prima o botão para criar uma nova chave. Se quiser criar uma nova chave, tem de premir o botão físico do bridge no espaço de 20 segundos para concluir o processo.
+
+### Processos
+
+O valor «Processos» determina quantos comandos paralelos o HueMagic pode enviar ao bridge em simultâneo. De acordo com a documentação oficial do Philips Hue Bridge, não devem ser enviados mais de 10 comandos por segundo, caso contrário existe o risco de o bridge não conseguir processar os pedidos com a mesma rapidez e devolver erros.
+
+Se forem enviados em simultâneo mais comandos do que o valor aqui definido, o HueMagic executa os comandos sequencialmente assim que o débito voltar a permitir.
+
+Defina este valor abaixo de 10 (p. ex. 4 a 7) se também enviar comandos ao bridge fora do HueMagic, para respeitar o débito de comandos por segundo recomendado pela Philips Hue.
+
+### Atualizações automáticas de firmware
+
+O HueMagic verifica periodicamente se existem atualizações de firmware da Philips Hue e instala-as automaticamente quando estão disponíveis. Pode desativar este comportamento clicando na caixa de verificação correspondente.
+
+### Desativar as notificações
+
+Se ativar esta definição, todos os nós associados a este bridge deixarão de receber mensagens de estado automáticas.
+</script>

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

@@ -0,0 +1,40 @@
+{
+	"hue-bridge-config": {
+		"config": {
+			"name": "Nome",
+			"apikey": "Chave API",
+			"missing-ip": "Falta o IP do Hue Bridge…",
+			"disable-events": "Desativar eventos",
+			"disable-events-info": "Desativar os eventos em todos os nós",
+			"searching": "A procurar Hue Bridges…",
+			"none-found": "Nenhum Hue Bridge encontrado!",
+			"unknown-error": "Algo correu mal. Tente novamente.",
+			"invalid": "Lamentamos. O Hue Bridge selecionado não é válido: ",
+			"error-select-first": "Selecione o seu Hue Bridge antes de criar um novo utilizador!",
+			"waiting": "à espera do botão de ligação…",
+			"new-user-press": "Prima agora o botão do seu Hue Bridge para criar um novo utilizador!",
+			"retry": "Não foi detetada qualquer pressão do botão. Tente novamente…",
+			"success": "Utilizador criado com sucesso!",
+			"connecting": "A ligar ao bridge…",
+			"autoupdates": "Ativar as atualizações automáticas de firmware",
+			"bridge-ip": "IP do bridge",
+			"worker": "Processos"
+		},
+		"node": {
+			"title": "Hue Bridge",
+			"statusmsg": "Estado consultado com sucesso…",
+			"initializing": "A inicializar o bridge (__bridge__)…",
+			"connected": "Ligado ao bridge",
+			"processing": "A processar os recursos do bridge…",
+			"initial-emit": "Emissão inicial dos estados dos recursos…",
+			"keep-updated": "A manter os nós atualizados…",
+			"subscribing": "A subscrever os eventos do bridge…",
+			"unsubscribing": "A cancelar a subscrição dos eventos do bridge…",
+			"no-legacy-api": "O bridge não responde na API antiga, prossegue-se sem a respetiva configuração…",
+			"request-error": "Erro ao pedir informações ao bridge (__error__)",
+			"connection-lost": "Ligação ao bridge perdida (__reason__). Nova tentativa dentro de __seconds__ segundos…",
+			"resources-changed": "Os recursos do bridge foram alterados. A recarregar…",
+			"not-connected": "O bridge não está ligado."
+		}
+	}
+}

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>