node-red-contrib-huemagic 4.2.2 → 5.0.1

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

@@ -0,0 +1,32 @@
+{
+	"hue-scene": {
+		"config": {
+			"name": "Nazwa",
+			"input-name": "Nazwa sceny",
+			"skipevents-node": "Pomijaj komunikaty węzła",
+			"sendinitevents-node": "Nie pomijaj komunikatu inicjalizacji",
+			"searching": "Wyszukiwanie scen…",
+			"none-found": "Nie znaleziono żadnej sceny!",
+			"unknown-error": "Coś poszło nie tak. Spróbuj ponownie.",
+			"scene": "Scena",
+			"group": "Grupa",
+			"group-none-found": "Nie znaleziono żadnej grupy!",
+			"group-searching": "Wyszukiwanie grup…",
+			"groups-all": "Wszystkie grupy / światła",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Scena",
+			"not-configured": "nieskonfigurowany",
+			"recalled": "scena włączona",
+			"recalled-on-group": "scena włączona w grupie",
+			"no-id": "Brak identyfikatora sceny.",
+			"input": "włącz scenę",
+			"output": "grupa docelowa",
+			"command": "wykonywanie polecenia…",
+			"statusmsg": "Włączanie sceny…",
+			"error-not-available": "Scena nie jest jeszcze dostępna. Poczekaj, aż HueMagic nawiąże połączenie z bridge, albo sprawdź, czy identyfikator zasobu podany w konfiguracji jest prawidłowy.",
+			"error-invalid-brightness": "Nieprawidłowe ustawienie jasności. Dozwolone są tylko wartości od 0 do 100 procent."
+		}
+	}
+}

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

@@ -0,0 +1,80 @@
+<script type="text/markdown" data-help-name="hue-speaker">
+Węzeł „Hue Głośnik” odtwarza dźwięki dzwonka Hue Secure i pozwala używać go jako syreny wewnętrznej.
+
+### Konfiguracja
+
+Wybierz skonfigurowany Hue Bridge i kliknij przycisk wyszukiwania, aby znaleźć wszystkie dostępne głośniki. Jeśli znasz już identyfikator głośnika, możesz go też wpisać ręcznie. Możesz nadać głośnikowi 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 głośnika. 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.
+
+Jeśli nie wybierzesz głośnika 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 głośnika, przekazując jego identyfikator jako ciąg znaków w `msg.topic` razem z ustawieniami.
+
+### Odczyt stanu
+
+Zwraca bieżący stan głośnika, 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 głośnika
+
+### Odtwarzanie dźwięku
+
+Głośnik ma trzy osobne kanały. `chime` to dźwięk dzwonka do drzwi, `alarm` to syrena, a `alert` to krótkie powiadomienie. Dźwięki, które dane urządzenie faktycznie zna, są wymienione w `msg.info.sounds`. Przekaż następujące parametry w obiekcie `msg.payload`:
+
+: chime (string | object | boolean): Nazwa dźwięku dzwonka; `false` ponownie go zatrzymuje
+: alarm (string | object | boolean): Nazwa dźwięku syreny; `false` ponownie go zatrzymuje
+: alert (string | object | boolean): Nazwa dźwięku powiadomienia; `false` ponownie go zatrzymuje
+: mute (boolean): `true` wycisza głośnik, `false` ponownie włącza dźwięk
+
+Zamiast samej nazwy dźwięku możesz też przekazać obiekt, aby sterować głośnością i czasem trwania:
+
+: sound (string): Nazwa dźwięku, np. `ding_dong_classic` lub `siren`
+: volume (int): Głośność w procentach (0-100)
+: duration (float): Czas odtwarzania w sekundach
+
+### Komunikaty stanu węzła
+
+Gdy tylko głośnik zacznie lub przestanie odtwarzać, węzeł zwraca następujący komunikat stanu.
+
+> [!NOTE]
+> Bridge zgłasza ostatnio odtworzony dźwięk i zeruje go dopiero długo po zakończeniu odtwarzania, więc te wartości nieco się opóźniają względem dźwięku.
+
+#### Obiekt stanu w `msg.payload`
+
+: reachable (boolean | string): `true`, jeśli głośnik 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`
+: playing (boolean): `true`, gdy głośnik odtwarza jakikolwiek dźwięk
+: chime (string | boolean): Nazwa odtwarzanego dźwięku dzwonka albo `false`
+: alarm (string | boolean): Nazwa odtwarzanego dźwięku syreny albo `false`
+: alert (string | boolean): Nazwa odtwarzanego dźwięku powiadomienia albo `false`
+: muted (boolean): Wskazuje, czy głośnik jest wyciszony
+: updated (string): Czas ostatniej aktualizacji zasobu przez HueMagic (ISO 8601)
+
+#### Informacje o głośniku w `msg.info`
+
+: id (string): Wskazuje nowy identyfikator głośnika
+: idV1 (string | boolean): Wskazuje stary identyfikator głośnika
+: uniqueId (string): Unikatowy identyfikator głośnika
+: deviceId (string): Unikatowy identyfikator urządzenia
+: name (string): Aktualnie ustawiona nazwa głośnika
+: type (string): Typ urządzenia (zawsze `speaker`)
+: softwareVersion (string): Bieżące oprogramowanie układowe głośnika
+: battery (float | boolean): Bieżący poziom naładowania baterii głośnika, `false`, gdy urządzenie nie ma baterii
+: batteryState (string | boolean): Bieżący stan poziomu baterii. Może przyjmować wartości `normal`, `low` lub `critical`, albo `false`, gdy urządzenie nie ma baterii
+: sounds (object): Zawiera dźwięki znane temu urządzeniu w polach `chime`, `alarm` i `alert`
+: model (object): Zawiera informacje o modelu głośnika 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 głośnika. Jeśli nie zarejestrowano żadnych zmian, obiekt jest pusty.
+
+#### Poprzedni stan głośnika 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-speaker.json

@@ -0,0 +1,38 @@
+{
+	"hue-speaker": {
+		"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 głośnika",
+			"searching": "Wyszukiwanie głośników…",
+			"none-found": "Nie znaleziono żadnego głośnika!",
+			"speaker": "Głośnik"
+		},
+		"node": {
+			"not-configured": "nieskonfigurowany",
+			"not-reachable": "nieosiągalny",
+			"universal": "tryb uniwersalny",
+			"command": "wykonywanie polecenia…",
+			"statusmsg": "Stan odczytany pomyślnie…",
+			"title": "Hue Głośnik",
+			"silent": "cisza",
+			"muted": "wyciszony",
+			"playing-alarm": "alarm (__sound__)",
+			"playing-chime": "dzwonek (__sound__)",
+			"playing-alert": "ostrzeżenie (__sound__)",
+			"input": "odtwórz dźwięk / stan",
+			"output": "głośnik",
+			"error-no-id": "Podaj prawidłowy identyfikator: głośnik.",
+			"error-not-available": "Głośnik 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.",
+			"error-no-channel": "Ten głośnik nie ma dźwięku typu __channel__.",
+			"error-invalid-sound": "Nieprawidłowy dźwięk __channel__. Dozwolone są: __sounds__",
+			"error-invalid-volume": "Nieprawidłowe ustawienie głośności. Dozwolone są tylko wartości od 0 do 100."
+		}
+	}
+}

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."
+		}
+	}
+}