node-red-contrib-huemagic 4.2.2 → 5.0.1

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

@@ -0,0 +1,59 @@
+<script type="text/markdown" data-help-name="hue-automation">
+Węzeł „Hue Automatyzacja” włącza i wyłącza automatyzacje utworzone w aplikacji Philips Hue.
+
+### Konfiguracja
+
+Wybierz skonfigurowany Hue Bridge i kliknij przycisk wyszukiwania, aby znaleźć wszystkie dostępne automatyzacje. Jeśli znasz już identyfikator automatyzacji, możesz go też wpisać ręcznie. Możesz nadać automatyzacji 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. 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 wybranej automatyzacji. 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 automatyzacji 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 konkretnej automatyzacji, przekazując jej identyfikator jako ciąg znaków w `msg.topic` razem z ustawieniami.
+
+### Włączanie / wyłączanie automatyzacji
+
+Wyłączona automatyzacja pozostaje na bridge i można ją w każdej chwili ponownie włączyć. Przekaż w tym celu obiekt o następującej zawartości:
+
+: payload (boolean): `true` włącza automatyzację, `false` ją wyłącza
+: enabled (boolean): Jak wyżej, jeśli wolisz przekazać obiekt
+: toggle (boolean | any): Przełącza między stanem włączonym a wyłączonym, zależnie od poprzedniego stanu
+
+### Komunikaty stanu węzła
+
+Gdy tylko automatyzacja się zmieni, węzeł zwraca następujący komunikat stanu:
+
+#### Obiekt stanu w `msg.payload`
+
+: enabled (boolean): Wskazuje, czy automatyzacja jest włączona
+: running (boolean): `true`, gdy bridge faktycznie wykonuje automatyzację
+: status (string | boolean): Bieżący stan. Może przyjmować wartości `initializing`, `running`, `disabled` lub `errored`
+: lastError (string | boolean): Ostatni błąd zgłoszony przez bridge albo `false`
+: updated (string): Czas ostatniej aktualizacji zasobu przez HueMagic (ISO 8601)
+
+#### Informacje o automatyzacji w `msg.info`
+
+: id (string): Wskazuje identyfikator automatyzacji
+: idV1 (string | boolean): Wskazuje stary identyfikator automatyzacji
+: name (string | boolean): Nazwa nadana automatyzacji w aplikacji Philips Hue
+: type (string): Typ zasobu (zawsze `automation`)
+: script (string | boolean): Identyfikator skryptu zachowania stojącego za automatyzacją
+
+#### Konfiguracja w `msg.configuration`
+
+Zawiera ustawienia automatyzacji w postaci zapisanej przez aplikację Philips Hue. Struktura zależy od typu automatyzacji i jest przekazywana bez zmian.
+
+#### Zmiany stanu w `msg.updated`
+
+Wymienia w postaci obiektu poszczególne parametry, które zmieniły się względem poprzedniego stanu automatyzacji. Jeśli nie zarejestrowano żadnych zmian, obiekt jest pusty.
+
+#### Poprzedni stan automatyzacji 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-automation.json

@@ -0,0 +1,33 @@
+{
+	"hue-automation": {
+		"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 automatyzacji",
+			"searching": "Wyszukiwanie automatyzacji…",
+			"none-found": "Nie znaleziono żadnej automatyzacji!",
+			"automation": "Automatyzacja"
+		},
+		"node": {
+			"not-configured": "nieskonfigurowany",
+			"init": "inicjalizacja…",
+			"universal": "tryb uniwersalny",
+			"command": "wykonywanie polecenia…",
+			"statusmsg": "Stan odczytany pomyślnie…",
+			"title": "Hue Automatyzacja",
+			"enabled": "włączona",
+			"disabled": "wyłączona",
+			"errored": "błąd",
+			"input": "włącz / wyłącz",
+			"output": "automatyzacja",
+			"error-no-id": "Podaj prawidłowy identyfikator: automatyzacja.",
+			"error-not-available": "Automatyzacja 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/pl/hue-bridge-config.html

@@ -0,0 +1,31 @@
+<script type="text/markdown" data-help-name="hue-bridge">
+Łączy się z mostkiem Philips Hue Bridge.
+
+### Nazwa
+
+Możesz nadać bridge własną nazwę wewnętrzną albo zachować nazwę domyślną.
+
+### Adres IP i port bridge
+
+Wpisz adres IP Hue Bridge ręcznie albo naciśnij przycisk, aby wyświetlić wszystkie dostępne lokalnie mostki (zalecana jest statyczna konfiguracja IP na Hue Bridge). Opcjonalnie możesz też określić inny port, dopisując dwukropek do adresu IP.
+
+### Klucz API
+
+Wpisz klucz API Hue Bridge ręcznie albo naciśnij przycisk, aby utworzyć nowy klucz. Aby utworzyć nowy klucz, w ciągu 20 sekund naciśnij fizyczny przycisk na bridge, co zakończy proces.
+
+### Procesy robocze
+
+Wartość „Procesy robocze” określa, ile równoległych poleceń HueMagic może wysyłać do bridge jednocześnie. Zgodnie z oficjalną dokumentacją Philips Hue Bridge nie należy wysyłać więcej niż 10 poleceń na sekundę, w przeciwnym razie bridge może nie nadążyć z przetwarzaniem żądań i zwróci błędy.
+
+Jeśli jednocześnie zostanie wysłanych więcej poleceń niż ustawiona tu wartość, HueMagic wykona je po kolei, gdy tylko przepustowość znów na to pozwoli.
+
+Ustaw wartość poniżej 10 (np. od 4 do 7), jeśli wysyłasz polecenia do bridge również poza HueMagic, aby zachować zalecaną przez Philips Hue przepustowość poleceń na sekundę.
+
+### Automatyczne aktualizacje oprogramowania układowego
+
+HueMagic okresowo sprawdza dostępność aktualizacji oprogramowania układowego Philips Hue i instaluje je automatycznie, gdy są dostępne. Możesz wyłączyć to zachowanie, klikając odpowiednie pole wyboru.
+
+### Wyłączanie powiadomień
+
+Po włączeniu tego ustawienia wszystkie węzły powiązane z tym bridge przestaną otrzymywać automatyczne komunikaty stanu.
+</script>

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

@@ -0,0 +1,40 @@
+{
+	"hue-bridge-config": {
+		"config": {
+			"name": "Nazwa",
+			"apikey": "Klucz API",
+			"missing-ip": "Brak adresu IP Hue Bridge…",
+			"disable-events": "Wyłącz zdarzenia",
+			"disable-events-info": "Wyłącz zdarzenia we wszystkich węzłach",
+			"searching": "Wyszukiwanie urządzeń Hue Bridge…",
+			"none-found": "Nie znaleziono żadnego Hue Bridge!",
+			"unknown-error": "Coś poszło nie tak. Spróbuj ponownie.",
+			"invalid": "Niestety. Wybrany Hue Bridge jest nieprawidłowy: ",
+			"error-select-first": "Wybierz swój Hue Bridge, zanim utworzysz nowego użytkownika!",
+			"waiting": "oczekiwanie na przycisk parowania…",
+			"new-user-press": "Naciśnij teraz przycisk na swoim Hue Bridge, aby utworzyć nowego użytkownika!",
+			"retry": "Nie wykryto naciśnięcia przycisku. Spróbuj ponownie…",
+			"success": "Użytkownik został utworzony!",
+			"connecting": "Łączenie z bridge…",
+			"autoupdates": "Włącz automatyczne aktualizacje oprogramowania układowego",
+			"bridge-ip": "Adres IP bridge",
+			"worker": "Procesy robocze"
+		},
+		"node": {
+			"title": "Hue Bridge",
+			"statusmsg": "Stan odczytany pomyślnie…",
+			"initializing": "Inicjalizacja bridge (__bridge__)…",
+			"connected": "Połączono z bridge",
+			"processing": "Przetwarzanie zasobów bridge…",
+			"initial-emit": "Pierwsza emisja stanów zasobów…",
+			"keep-updated": "Aktualizowanie węzłów…",
+			"subscribing": "Subskrybowanie zdarzeń bridge…",
+			"unsubscribing": "Anulowanie subskrypcji zdarzeń bridge…",
+			"no-legacy-api": "Bridge nie odpowiada na starym API, kontynuacja bez jego konfiguracji…",
+			"request-error": "Błąd podczas pobierania informacji z bridge (__error__)",
+			"connection-lost": "Utracono połączenie z bridge (__reason__). Ponowna próba za __seconds__ s…",
+			"resources-changed": "Zasoby na bridge uległy zmianie. Ponowne wczytywanie…",
+			"not-connected": "Bridge nie jest połączony."
+		}
+	}
+}

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

@@ -0,0 +1,96 @@
+<script type="text/markdown" data-help-name="hue-bridge-node">
+Węzeł „Hue Bridge” to uniwersalny węzeł, który potrafi zwracać wszystkie ustawienia bridge oraz komunikaty stanu pozostałych węzłów.
+
+### Konfiguracja
+
+Najpierw wybierz żądany Hue Bridge. Opcjonalnie możesz wyłączyć wszystkie automatyczne komunikaty stanu tego węzła ustawieniem „Pomijaj globalne aktualizacje i komunikaty urządzeń w tym węźle”. Węzeł przestanie wtedy wysyłać aktualizacje urządzeń.
+
+Możesz też zdecydować, aby komunikaty inicjalizacji wszystkich węzłów nie były pomijane przy starcie Node-RED. Po włączeniu tego ustawienia po każdym wdrożeniu otrzymasz komunikat stanu ze wszystkich zasobów połączonych z bridge.
+
+### Odczyt ustawień i stanu
+
+Zwraca bieżący stan i ustawienia bridge, gdy tylko do węzła zostanie wysłany poniższy komunikat. Możesz też nacisnąć przycisk w interfejsie Node-RED, bez wcześniejszego wysyłania komunikatu do węzła.
+
+: payload (boolean): Zwraca bieżący stan bridge
+
+### Uruchamianie skanowania TouchLink
+
+Za pomocą „skanowania TouchLink” możesz sparować z bridge nowe lub stare urządzenia (np. po przywróceniu ustawień fabrycznych). Przekaż w tym celu obiekt `msg.payload` o następującej zawartości:
+
+: touchLink (boolean): Paruje stare lub nowe urządzenia z bridge
+
+### Odczyt wszystkich urządzeń i zasobów
+
+Poleceniem „fetch” możesz uzyskać listę wybranych urządzeń aktualnie połączonych z bridge. Przekaż w tym celu obiekt `msg.payload` o następującej zawartości:
+
+: fetch (string | array [string, ...]): Przyjmuje wartości `light`, `group`, `button`, `motion`, `temperature`, `light_level` lub `rule`
+
+### Zmiana ustawień Hue Bridge
+
+Poniższym poleceniem możesz zmienić wybrane ustawienia bridge. Przekaż do węzła obiekt `msg.payload.settings` z następującymi opcjami:
+
+> [!WARNING]
+> Zmiana ustawień sieciowych wymaga ponownej konfiguracji bridge w HueMagic.
+
+: name (string): Zmienia nazwę bridge; musi zawierać od 4 do 16 znaków
+: zigbeeChannel (int): Zmienia bieżący kanał ZigBee (`11`, `15`, `20`, `25` lub `0`)
+: ipAddress (string): Zmienia adres IP w ustawieniach sieciowych
+: dhcpEnabled (boolean): `true` włącza DHCP w ustawieniach sieciowych, `false` je wyłącza
+: netmask (string): Zmienia maskę sieci w ustawieniach sieciowych
+: gateway (string): Określa bramę w ustawieniach sieciowych
+: proxyAddress (string): Ustawia adres serwera proxy w ustawieniach sieciowych
+: proxyPort (string | int): Określa port serwera proxy w ustawieniach sieciowych
+: timeZone (string): Zmienia strefę czasową ustawioną na bridge
+
+### Komunikaty stanu węzła
+
+Komunikaty stanu węzła „Hue Bridge” są dynamiczne. Choć mają określony schemat, ich zawartość może się różnić w zależności od tego, jaka akcja została właśnie wykonana na węźle.
+
+#### Obiekt stanu w `msg.payload`
+
+: id (string): Unikatowy identyfikator Hue Bridge
+: name (string): Aktualnie ustawiona nazwa
+: factoryNew (boolean): Wskazuje, czy bridge jest fabrycznie nowy
+: replacesBridgeId (string | boolean): Zwraca stary identyfikator bridge (jeśli przeprowadzono migrację) albo `false`
+: dataStoreVersion (string): Wersja magazynu danych
+: starterKitId (string | boolean): Nazwa zestawu startowego utworzonego fabrycznie albo `false`
+: softwareVersion (string): Wersja oprogramowania bridge
+: apiVersion (string): Wersja API bridge
+: zigbeeChannel (int): Aktualnie używany kanał ZigBee
+: macAddress (string): Adres MAC bridge
+: ipAddress (string): Adres IP bridge
+: dhcpEnabled (boolean): Wskazuje, czy DHCP jest włączone
+: netmask (string): Maska sieci bridge
+: gateway (string): Brama bridge
+: proxyAddress (string | boolean): Aktualnie używany adres serwera proxy albo `false`
+: proxyPort (string): Aktualnie używany port serwera proxy
+: utcTime (string): Czas UTC na bridge
+: timeZone (string): Strefa czasowa ustawiona na bridge
+: localTime (string): Lokalna strefa czasowa
+: portalServicesEnabled (boolean): Wskazuje, czy usługi portalu są włączone
+: portalConnected (boolean): Wskazuje, czy bridge jest połączony z portalem
+: linkButtonEnabled (boolean): Wskazuje, czy przycisk parowania jest aktywny
+: touchlinkEnabled (boolean): Wskazuje, czy TouchLink jest włączony
+: autoUpdatesEnabled (boolean): Wskazuje, czy HueMagic będzie automatycznie sprawdzać aktualizacje
+: users (array [object, ...]): Lista wszystkich użytkowników bridge (tablica obiektów)
+: updated (string): Czas ostatniej aktualizacji zasobu przez HueMagic (ISO 8601)
+: model (object): Zawiera informacje o modelu bridge w polach `id`, `manufacturer` i `name`
+
+#### Wyniki „fetch” w `msg.results` (opcjonalnie)
+
+Jeśli w węźle użyto polecenia „fetch”, bridge zwraca odpowiednie wyniki w obiekcie `msg.results`. Obiekt zawiera odpytane grupy zasobów, a te z kolei wszystkie odpowiadające im zasoby w postaci tablicy.
+
+#### Globalne komunikaty stanu w `msg.updated` (opcjonalnie)
+
+O ile nie zostanie to wyłączone, węzeł zwraca zaktualizowany komunikat stanu dla każdego zasobu na bridge. Komunikat w `msg.updated` odpowiada schematowi danego zasobu i różni się w zależności od typu urządzenia, które zaktualizowano jako ostatnie.
+
+#### 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-bridge.json

@@ -0,0 +1,26 @@
+{
+	"hue-bridge": {
+		"config": {
+			"name": "Nazwa",
+			"input-name": "Nazwa Hue Bridge",
+			"skipglobalevents-info": "Pomijaj globalne aktualizacje i komunikaty urządzeń w tym węźle",
+			"sendinitevents-node": "Nie pomijaj komunikatu inicjalizacji",
+			"bridge": "Bridge"
+		},
+		"node": {
+			"title": "Hue Bridge",
+			"not-configured": "nieskonfigurowany",
+			"connecting": "łączenie…",
+			"connected": "połączono",
+			"starting-tl": "uruchamianie TouchLink…",
+			"started-tl": "TouchLink uruchomiony…",
+			"f-resources": "pobieranie zasobów…",
+			"updating-settings": "aktualizowanie ustawień…",
+			"settings-updated": "ustawienia zaktualizowane",
+			"input": "ustawienia / pobranie",
+			"output": "informacje o bridge",
+			"statusmsg": "Stan odczytany pomyślnie…",
+			"error-not-available": "Bridge nie jest jeszcze dostępny. Poczekaj, aż HueMagic nawiąże z nim połączenie."
+		}
+	}
+}

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

@@ -0,0 +1,70 @@
+<script type="text/markdown" data-help-name="hue-brightness">
+Węzeł „Hue Jasność” odczytuje bieżący poziom oświetlenia 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.
+
+Ustawienie „Ciemno poniżej” określa, od jakiego poziomu oświetlenia węzeł uznaje pomieszczenie za ciemne. Pokój z jasną lampą wymaga zupełnie innej wartości niż korytarz bez okna, więc po prostu wpisz liczbę luksów pasującą do Twojego pomieszczenia. Wartości `dark` i `daylight` będą się wtedy kierować Twoim ustawieniem zamiast domyślnymi 90 luksami.
+
+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 poziomu oświetlenia 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 wykryje zmianę poziomu oświetlenia, zwracany jest 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`
+: lux (int): Wskazuje rzeczywistą wartość LUX poziomu oświetlenia
+: lightLevel (int): Wskazuje natężenie światła mierzone przez czujnik
+: dark (boolean): `true`, jeśli zarejestrowano ciemność
+: daylight (boolean): `true`, jeśli zarejestrowano światło dzienne
+: darkThreshold (int): Poziom oświetlenia w luksach, poniżej którego węzeł zgłasza ciemność
+: 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 `light_level`)
+: 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-brightness.json

@@ -0,0 +1,37 @@
+{
+	"hue-brightness": {
+		"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 jasności",
+			"searching": "Wyszukiwanie czujników…",
+			"none-found": "Nie znaleziono żadnego czujnika jasności!",
+			"sensor": "Czujnik",
+			"all": "Wszystkie grupy / światła",
+			"darkthreshold": "Ciemno poniżej"
+		},
+		"node": {
+			"not-configured": "nieskonfigurowany",
+			"deactivated": "wyłączony",
+			"init": "inicjalizacja…",
+			"not-reachable": "nieosiągalny",
+			"universal": "tryb uniwersalny",
+			"command": "wykonywanie polecenia…",
+			"statusmsg": "Stan odczytany pomyślnie…",
+			"title": "Hue Jasność",
+			"lux": "__lux__ lx",
+			"lux-dark": "__lux__ lx (ciemno)",
+			"lux-daylight": "__lux__ lx (światło dzienne)",
+			"input": "zapytanie o stan",
+			"output": "jasność (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/pl/hue-buttons.html

@@ -0,0 +1,61 @@
+<script type="text/markdown" data-help-name="hue-buttons">
+Węzeł „Hue Przyciski” odbiera zdarzenia przełączania z urządzeń wejściowych podłączonych do bridge.
+
+### Konfiguracja
+
+Wybierz skonfigurowany Hue Bridge i kliknij przycisk wyszukiwania, aby znaleźć wszystkie dostępne przełączniki i przyciski. Jeśli znasz już identyfikator przełącznika lub przycisku, możesz go też wpisać ręcznie. Możesz nadać urządzeniu 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ć zdarzenia przełączania. 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 przełącznika lub przycisku. 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 przełącznika ani przycisku 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.
+
+W sekcji „Dodatkowe wyjścia” możesz dodać jedno wyjście na każdy zakres przycisków, z których każde jest wyzwalane przez określone działanie (początek naciśnięcia, koniec krótkiego naciśnięcia, koniec długiego naciśnięcia po osiągnięciu skonfigurowanego czasu trwania, lub cyklicznie podczas trwania długiego naciśnięcia). Pierwsze wyjście węzła nadal zawsze otrzymuje każde zdarzenie, tak jak dotychczas; dodatkowe wyjścia otrzymują kopię komunikatu tylko wtedy, gdy pasują zarówno zakres przycisków, jak i działanie.
+
+### Odczyt stanu
+
+Zwraca bieżący stan przełącznika lub przycisku, 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 przełącznika lub przycisku
+
+### Komunikaty stanu węzła
+
+Gdy tylko zostanie naciśnięty przycisk, węzeł zwraca następujący komunikat stanu:
+
+#### Obiekt stanu w `msg.payload`
+
+: reachable (boolean | string): `true`, jeśli przełącznik lub przycisk 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`
+: button (int | boolean): Numeryczny identyfikator ostatnio naciśniętego przycisku albo `false`, jeśli nie naciśnięto żadnego
+: action (string | boolean): `false`, jeśli nie naciśnięto żadnego przycisku, albo `initial_press`, `repeat`, `short_release`, `long_press`, `long_release` lub `double_short_release` w postaci ciągu znaków
+: rotation (object | boolean): `false`, jeśli urządzenie nie ma pokrętła lub nim nie obrócono; w przeciwnym razie obiekt z polami `action` (`start` lub `repeat`), `direction` (`clock_wise` lub `counter_clock_wise`), `clockwise` (wartość logiczna), `steps` (1000 kroków to pełny obrót), `degrees` i `duration` w milisekundach
+: updated (string): Czas ostatniej aktualizacji zasobu przez HueMagic (ISO 8601)
+
+#### Informacje o przełączniku lub przycisku w `msg.info`
+
+: id (string): Wskazuje nowy identyfikator przełącznika lub przycisku
+: idV1 (string | boolean): Wskazuje stary identyfikator przełącznika lub przycisku
+: uniqueId (string): Unikatowy identyfikator przełącznika lub przycisku
+: deviceId (string): Unikatowy identyfikator urządzenia
+: name (string): Aktualnie ustawiona nazwa przełącznika lub przycisku
+: type (string): Typ przełącznika lub przycisku (zawsze `button`)
+: softwareVersion (string): Bieżące oprogramowanie układowe przełącznika lub przycisku
+: battery (float | boolean): Bieżący poziom naładowania baterii przełącznika lub przycisku, `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
+: model (object): Zawiera informacje o modelu przełącznika lub przycisku 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 przełącznika lub przycisku. Jeśli nie zarejestrowano żadnych zmian, obiekt jest pusty.
+
+#### Poprzedni stan przełącznika lub przycisku 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-buttons.json

@@ -0,0 +1,62 @@
+{
+	"hue-buttons": {
+		"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 przycisku",
+			"searching": "Wyszukiwanie Hue Buttons…",
+			"none-found": "Nie znaleziono żadnego Hue Button!",
+			"button": "Przycisk",
+			"add-outputs": "Dodatkowe wyjścia...",
+			"add-outputs-range": "Zakres przycisków...",
+			"add-outputs-newflow": "Uruchom nowy przepływ przy...",
+			"add-outputs-nr": "Wyjście nr",
+			"add-outputs-btn-from": "Od...",
+			"add-outputs-btn-to": "Do...",
+			"add-outputs-startpress": "Początek naciśnięcia",
+			"add-outputs-shortpress": "Koniec krótkiego naciśnięcia",
+			"add-outputs-longpress": "Koniec długiego naciśnięcia po >",
+			"add-outputs-longpresswhile": "Długie naciśnięcie (podczas trzymania)",
+			"add-outputs-btn-addnew": "dodaj nowy zakres przycisków",
+			"outputlabel-btn-from": "przycisk #__from__",
+			"outputlabel-btn-from-to": "przyciski #__from__ do #__to__",
+			"outputlabel-btn-on": "przy:",
+			"outputlabel-btn-startpress": "Początek naciśnięcia",
+			"outputlabel-btn-shortpress": "Koniec krótkiego naciśnięcia",
+			"outputlabel-btn-longpress": "Długie naciśnięcie (>__duration__s)",
+			"outputlabel-btn-longpresswhile": "Długie naciśnięcie (podczas trzymania)"
+		},
+		"node": {
+			"not-configured": "nieskonfigurowany",
+			"universal": "tryb uniwersalny",
+			"command": "wykonywanie polecenia…",
+			"statusmsg": "Stan odczytany pomyślnie…",
+			"title": "Hue Przyciski",
+			"waiting": "oczekiwanie…",
+			"button-on": "On",
+			"action-pressed": "naciśnięty",
+			"action-holded": "przytrzymany",
+			"action-shortreleased": "krótko zwolniony",
+			"action-longreleased": "zwolniony po przytrzymaniu",
+			"action-repeated": "powtórzony",
+			"action-doublepressed": "naciśnięty dwukrotnie",
+			"action-started": "początek naciśnięcia",
+			"dial-clockwise": "Pokrętło ↻ __degrees__°",
+			"dial-counterclockwise": "Pokrętło ↺ __degrees__°",
+			"button-status": "Przycisk nr __button__ (__action__)",
+			"button-status-duration": "Przycisk nr __button__ (__action__, __duration__s)",
+			"input": "zapytanie o stan",
+			"output": "naciśnięty przycisk",
+			"error-no-id": "Podaj prawidłowy identyfikator: przełącznik.",
+			"error-not-available": "Przełącznik 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-switchmode": "To urządzenie nie ma konfigurowalnego trybu przełącznika.",
+			"error-invalid-switchmode": "Nieprawidłowy tryb przełącznika. To urządzenie obsługuje: __modes__"
+		}
+	}
+}

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

@@ -0,0 +1,67 @@
+<script type="text/markdown" data-help-name="hue-contact">
+Węzeł „Hue Kontakt” informuje, czy czujnik kontaktowy (np. Hue Secure) jest obecnie otwarty, czy zamknięty.
+
+### 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.
+
+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 kontaktu 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 zmieni się stan kontaktu, 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`
+: contact (string | boolean): `contact`, jeśli kontakt jest zamknięty, `no_contact`, jeśli jest otwarty, lub `false`, jeśli czujnik jeszcze nic nie zgłosił
+: changed (string | boolean): Czas ostatniej zmiany kontaktu (ISO 8601) lub `false`, jeśli czujnik jeszcze nic nie zgłosił
+: tampered (boolean): Dostępne tylko w czujnikach z wykrywaniem sabotażu; `true`, jeśli czujnik został naruszony
+: 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 `contact`)
+: softwareVersion (string): Bieżące oprogramowanie układowe czujnika
+: battery (float | boolean): Bieżący poziom naładowania baterii czujnika, `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
+: 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-contact.json

@@ -0,0 +1,35 @@
+{
+	"hue-contact": {
+		"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 kontaktowych…",
+			"none-found": "Nie znaleziono żadnego czujnika kontaktowego!",
+			"sensor": "Czujnik"
+		},
+		"node": {
+			"not-configured": "nieskonfigurowany",
+			"not-reachable": "nieosiągalny",
+			"activated": "włączony",
+			"deactivated": "wyłączony",
+			"universal": "tryb uniwersalny",
+			"command": "wykonywanie polecenia…",
+			"statusmsg": "Stan odczytany pomyślnie…",
+			"title": "Hue Kontakt",
+			"contact": "kontakt",
+			"no-contact": "brak kontaktu",
+			"input": "włącz / wyłącz / stan",
+			"output": "kontakt",
+			"tampered": "naruszony",
+			"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."
+		}
+	}
+}