--- title: "Hunter Douglas PowerView Hub" description: "Steruj silnikowymi roletami i żaluzjami PowerView przez lokalne HTTP. Szablon TapHome dla Hunter Douglas / Luxaflex PowerView Hub Gen 1 i Gen 2." url: "https://taphome.com/pl/compatibility/powerview-hub/" language: pl lastmod: 2026-04-23 generator: hugo ai: topics: ["http","gateway","blinds","shades","rf-mesh","local-api"] questions: ["Jak zintegrować Hunter Douglas PowerView Hub z TapHome?","Czy TapHome obsługuje silnikowe rolety Luxaflex PowerView?","Jak znaleźć ID rolety PowerView dla TapHome?","Czy PowerView 3 Gateway jest obsługiwany przez TapHome?","Jak przypisać statyczne IP do PowerView Hub?","Dlaczego pozycja rolety PowerView rozjeżdża się po użyciu pilota Pebble?"] --- # Hunter Douglas PowerView Hub Komunikacja: Packet Parser → HTTP - [Hunter Douglas PowerView Hub — FAQ produktu](https://www.hunterdouglas.com/faqs/powerview-hub) - [Hunter Douglas PowerView Motorization — przegląd](https://www.hunterdouglas.com/operating-systems/powerview-motorization) > Adres w sieci > > TapHome łączy się z urządzeniem pod adresem podanym przy imporcie. Nadaj urządzeniu stały adres — rezerwację IP w routerze albo jego nazwę mDNS, jeśli ją obsługuje — inaczej integracja przestanie działać, gdy router zmieni adres. > > [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/) ## Poradnik integracji Hunter Douglas PowerView Hub (sprzedawany jako **Luxaflex PowerView Hub** w Europie, Australii i części Azji — identyczny sprzęt) to most smart home, który łączy silnikowe rolety PowerView z systemami automatyki domowej opartymi na IP. Hub z jednej strony obsługuje autorską sieć mesh RF Hunter Douglas na paśmie 2,4 GHz (PowerView Shade Network ze sparowanymi roletami i wzmacniaczami), a z drugiej udostępnia lokalne, nieuwierzytelniane API HTTP REST na porcie 80. TapHome komunikuje się z hubem przez to lokalne API REST — do sterowania nie jest wymagane konto w chmurze ani połączenie z internetem. Szablon steruje **pozycją głównej listwy** pojedynczej rolety PowerView na jedną instancję urządzenia TapHome; sterowanie wieloma roletami wymaga dodania kilku urządzeń `PowerView Slide` pod tym samym interfejsem, z których każde jest adresowane własnym shade id. > [!WARNING] > Ten szablon obsługuje wyłącznie **PowerView Hub (Gen 1)** i **PowerView Hub Gen 2**. Nowszy **PowerView 3 Gateway (Gen 3)** używa innej architektury i nie udostępnia tego samego lokalnego API REST — z tym szablonem **nie** jest kompatybilny. Zobacz notatkę o Gen 3 na dole tej strony. ## Obsługiwane urządzenia Szablon udostępnia jeden typ urządzenia TapHome: - **PowerView Slide** — pozycja głównej listwy (rolety) pojedynczej rolety PowerView. Mapuje zakres huba `0`–`65535` na konwencję TapHome dla żaluzji `0`–`100 %` (odwrócona, więc `0` = otwarte, `100 %` = zamknięte po stronie TapHome). Sama PowerView Shade Network jest kompatybilna z 34+ modelami silnikowych rolet, żaluzji, okiennic i zasłon z gam produktowych Hunter Douglas / Luxaflex — Duette, Silhouette, Pirouette, Vignette, rolety, rzymskie, Skyline Panel, zasłony, żaluzje weneckie i wiele innych. Jeśli roleta jest sparowana z hubem w aplikacji PowerView, TapHome może nią sterować tym samym mechanizmem głównej listwy. ## Warunki wstępne Przed zaimportowaniem szablonu w TapHome upewnij się, że: - PowerView Hub jest zasilany, podłączony do LAN przez Ethernet (lub Wi-Fi w przypadku Gen 2), a przednia dioda LED wskazuje normalną pracę (**stałe niebieskie światło** na Gen 1, odpowiednie na Gen 2). - Twoje rolety są już sparowane z hubem przez aplikację PowerView — każda roleta, którą TapHome ma sterować, musi pojawić się na liście *Shades* w aplikacji PowerView. - Hub i centrala TapHome znajdują się w **tej samej sieci lokalnej** (bez NAT pomiędzy nimi). - Przeglądarka na Twoim telefonie, tablecie lub komputerze może otworzyć `http:///api/shades` i zwraca odpowiedź JSON. ## Konfiguracja ### Krok 1 — Przypisz statyczny adres IP do huba Hub musi być dostępny pod stabilnym adresem IP. Aplikacja PowerView ma wbudowane ustawienie statycznego IP — to zalecany sposób przypisania stałego adresu huba. Alternatywnie utwórz rezerwację DHCP na routerze dla adresu MAC huba. Otwórz aplikację PowerView i dotknij **ikony menu** w lewym górnym rogu: ![Pulpit aplikacji PowerView — otwarcie menu bocznego](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step1-menu_hu_64ee10340ed9b61.jpeg) W menu bocznym dotknij **Hub**: ![Menu boczne aplikacji PowerView — pozycja Hub](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step2-hub_hu_fe0343b38db4b10f.jpeg) W sekcji *Connected Hub* dotknij swojego huba, aby otworzyć **Hub Info**: ![Aplikacja PowerView — lista hubów](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step3-hub-info_hu_af1eb9afe01b1443.jpeg) Przewiń do **Static IP** na dole i dotknij pozycji: ![Ekran Hub Info aplikacji PowerView — pozycja Static IP](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step4-static-ip_hu_aecb9512f80ee4bf.jpeg) Włącz **Use Static IP**, a następnie wprowadź wartości *IP Address*, *Mask*, *Gateway* i *DNS*, które pasują do Twojej sieci: ![Ekran Static IP aplikacji PowerView — przełącznik Use Static IP](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step5-enable_hu_18a6d986e0261c54.jpeg) > [!NOTE] > Ustawienia statycznego IP są obsługiwane tylko na hubach podłączonych do routera przez **Ethernet**. Jeśli hub korzysta z Wi-Fi, utwórz w zamian rezerwację DHCP na routerze. ### Krok 2 — Ustalenie ID rolet Każdej rolecie sparowanej z hubem odpowiada unikalne ID liczbowe. Otwórz następujący URL w dowolnej przeglądarce w tej samej sieci: ``` http:///api/shades ``` Odpowiedzią jest dokument JSON; tablica `shadeIds` zawiera wszystkie ID rolet znanych hubowi: ```json { "shadeIds": [ 7348, 14922, 30019 ] } ``` Zapisz ID rolet, którymi chcesz sterować z TapHome. Jeśli masz tylko jedną roletę, tablica zawiera jedną wartość. > [!TIP] > Aby dopasować ID do fizycznej rolety, otwórz `http:///api/shades/` — pole `name` zawiera czytelną nazwę rolety z aplikacji PowerView (zakodowaną w Base64; odkoduj ją, aby odczytać). Alternatywnie zmieniaj pozycję każdej rolety w aplikacji PowerView po kolei i obserwuj, którego ID wartość `positions.position1` się zmienia. ### Krok 3 — Utwórz interfejs Packet Parser w TapHome 1. W aplikacji TapHome otwórz **Ustawienia → Interfejsy** i utwórz nowy interfejs **Packet Parser** lub otwórz istniejący. 2. Wybierz **Dodaj z szablonu** i wskaż **PowerView Hub**. 3. W polu *Adres IP* wpisz adres IP huba (zastępując placeholder `192.168.0.1`). 4. Pozostaw *Internal poll interval* na domyślnej wartości `10000` ms (10 s), chyba że masz konkretny powód, aby ją zmienić — szybsze odpytywanie nie poprawia reaktywności i może pogorszyć wydajność RF sieci rolet. 5. Dotknij **Utwórz**. TapHome zaimportuje jedno urządzenie `PowerView Slide`. W tym momencie urządzenie jest powiązane z hubem, ale nie z konkretną roletą. ### Krok 4 — Ustaw ID rolety na każdym urządzeniu Slide Otwórz utworzone urządzenie `PowerView Slide` w TapHome, przejdź do **Service Settings → Device ID** i wprowadź ID rolety zapisane w kroku 2. Zapisz ustawienia. Aby sterować kolejnymi roletami, dodaj kolejne urządzenia `PowerView Slide` pod tym samym interfejsem Packet Parser i ustaw na każdym inny *Device ID*. > [!TIP] > Wartość `SlideDeviceId` jest ustawieniem poszczególnego urządzenia, nie modułu. Jeden interfejs Packet Parser może obsłużyć dowolną liczbę urządzeń PowerView Slide — między nimi zmienia się tylko ID. ## Rozwiązywanie problemów ### Pozycja rolety rozjeżdża się po użyciu pilota Piloty Pebble na hubach Gen 1 / Gen 2 używają autorskiego Bluetooth LE i **nie raportują pozycji rolety z powrotem do huba**. Gdy użytkownik poruszy roletą pilotem Pebble, pozycja w cache huba — którą czyta szablon — pozostaje nieaktualna do czasu następnej komendy ruchu, która ją uzgodni. Jest to ograniczenie sprzętowe platformy Gen 1 / Gen 2, a nie błąd szablonu TapHome. Jeśli dokładna informacja zwrotna o pozycji jest krytyczna, ustandaryzuj sterowanie roletami przez TapHome lub aplikację PowerView. ### Hub zwraca HTTP 423 "Hub busy for maintenance" To normalna, przejściowa odpowiedź w czasie wewnętrznej konserwacji huba (na przykład przy aktualizacji scen lub sprawdzaniu firmware). Szablon sygnalizuje błąd przez `ADDERROR`, ale następny cykl odpytywania zwykle kończy się sukcesem. Jeśli odpowiedzi 423 utrzymują się, zrestartuj huba (wciśnij **Reset** z tyłu). ### Huby drugorzędne niewidoczne w aplikacji PowerView Aplikacja PowerView zwykle wyświetla tylko huba zarejestrowanego na Twoim koncie. Huby drugorzędne w tej samej PowerView Shade Network mogą się nie pojawić na liście hubów w aplikacji, ale mimo to odpowiadają w sieci lokalnej i przyjmują te same wywołania API REST. TapHome może powiązać się z hubem drugorzędnym po jego adresie IP — widoczność w aplikacji PowerView nie jest wymagana do lokalnego sterowania HTTP. ### Brak odpowiedzi na `http:///api/shades` 1. Upewnij się, że przednia dioda LED wskazuje normalną pracę (stałe niebieskie światło na Gen 1). Zobacz tabelę LED w PowerView Hub Quick Start Guide. 2. Sprawdź IP huba w aplikacji PowerView (*Hub → Hub Info → IP Address*) i czy zgadza się z tym, co wpisano w TapHome. 3. Wykonaj ping huba z maszyny w tej samej sieci VLAN; hub nie może być za NAT-em ani firewallem względem centrali TapHome. 4. Hub nasłuchuje **wyłącznie na porcie HTTP 80** — nie poprzedzaj URL prefiksem `https://`. ## PowerView 3 Gateway (Gen 3) — nieobsługiwany Nowszy **PowerView 3 Gateway** od Hunter Douglas jest od podstaw przeprojektowany: używa Matter przez Thread, jest zorientowany na chmurę i nie udostępnia tej samej lokalnej powierzchni REST `/api/shades`, co huby Gen 1 / Gen 2. Szablon Packet Parser TapHome z tej strony w związku z tym **nie działa z PowerView 3 Gateway** — próba powiązania zwróci albo HTML z interfejsu web bramki, albo zakończy się całkowitym niepowodzeniem. Jeśli posiadasz Gen 3 Gateway, aktualna ścieżka migracji po stronie Hunter Douglas polega na równoległym zachowaniu huba Gen 1 / Gen 2 dla integracji zewnętrznych albo oczekiwaniu na wsparcie rolet przez Matter w przyszłym firmware TapHome. ## Dostępne urządzenia 1 Te urządzenia pojawią się w TapHome po imporcie. PowerView Hub Moduł Zmienne niestandardowe `SlideDeviceId` (numeric) = 1 ID rolety PowerView adresowanej przez to urządzenie TapHome. Otwórz http://{HubIP}/api/shades, aby wylistować shadeIds, i wklej wybrane ID w Service Settings urządzenia TapHome Slide. Open http://{HubIP}/api/shades in a browser — the shadeIds array lists all ids paired with the hub. Copy the desired shade id into the TapHome device's Service Settings → Device ID. Roleta Suwak Odczyt i zapis Pozycja głównej listwy (rolety) pojedynczej rolety PowerView — mapuje surowy zakres huba 0–65535 na konwencję TapHome dla żaluzji 0–100 % (0 = otwarte, 100 % = zamknięte) numeric Jednostka: % json\_path Odczyt poziomu rolety ```taphome VAR response := SENDHTTPREQUEST("api/shades/" + SlideDeviceId); IF response.IsSuccess VAR responseJson := response.Content; VAR pos := PARSEJSON(responseJson, "$.shade.positions.position1"); RETURN(1 - (pos/65535)); ELSE ADDERROR(response.Content); RETURN(NaN); END ``` Zapis poziomu rolety ```taphome VAR pos := ROUND((1 - Bl) * 65535); VAR contentJson := "{\"shade\": { \"positions\": { \"posKind1\": 1, \"position1\":" + pos + "}}}"; SENDHTTPREQUEST("/api/shades/" + SlideDeviceId, "PUT", contentJson, "Content-Type:application/json"); ``` **Połączenie:** Packet Parser → HTTP Możliwe ulepszenia (17) - Vane tilt — Slat/vane tilt angle for Silhouette, Pirouette, Venetian and similar shades. Range 0–32767. Not exposed by the current template — only primary rail (posKind1 = 1) is driven. - Secondary rail (TDBU) — Second independent axis for top-down/bottom-up shades (Duette TDBU, Pleated TDBU). Range 0–65535. Not exposed — TDBU shades are controlled only on the primary axis. - Activate scene — Scenes are pre-programmed shade positions within a single room, defined in the PowerView app. Activation would map naturally to a module-level service action. - Activate scene collection — Multi-room scene (set of scenes). Activation returns the list of scene ids triggered. - Move all shades in a group — Single API call moves a whole group of shades — would save RF bandwidth compared to driving individual shades in parallel. - Jog (identify shade) — Briefly moves a shade to identify it visually. Useful during commissioning to confirm which physical shade corresponds to a given id. - Calibrate shade limits — Recalibrates end-stop positions on the shade motor. Typically used after a shade has been serviced or reset. - Battery strength (per shade) — Last-read battery level for a battery-powered shade. Available on the same GET /api/shades/{id} response that the template already polls — could be added as a read-only service attribute on the PowerView Slide device without extra HTTP traffic. - Battery status (enum) — Enum: 0 = No Status, 1 = Low, 2 = Medium, 3 = High, 4 = Plugged In. Available on the same shade GET response. - Force battery level refresh — Triggers the hub to query the shade over RF for an updated battery reading. Causes a small physical movement of the shade. - Force position refresh over RF — Polls the shade over RF instead of returning the hub's cached position — useful when a Pebble remote or manual movement has caused state drift. Each refresh triggers an RF round-trip, so overuse degrades responsiveness. - Request shade firmware revision — Asks the shade over RF to report its firmware build/revision/subRevision. Useful for diagnostics, not for runtime control. - Hub firmware version — Hub main processor + radio firmware build. Good candidate for a module-level service attribute for diagnostics. - Hub metadata (IP, MAC, RF, network) — Comprehensive hub metadata including serial number, MAC, RF network ID, static IP status, SSID, location/timezone. Useful for module-level diagnostics service attributes (hub name, serial, RF status). - Room listing — Lists rooms defined in the PowerView app. Not directly actionable in TapHome — each shade is imported individually by id. Could be used for automated room grouping during import. - Base64 human-readable names — Shade/room/scene/hub names are Base64 encoded in API responses. TapHome template uses numeric ids directly, so decoding is not needed for control, but would improve the import UX (auto-named TapHome devices). - Hub-busy retry semantics — Hub returns HTTP 423 'Hub busy for maintenance' as a normal transient response. Clients should retry with backoff. Current template surfaces the error via ADDERROR(response.Content) but does not distinguish 423 from other failures. ## Parametry importu Te wartości podajesz podczas importu pliku XML. | Pytanie w aplikacji | Domyślnie | |------------------------|---------------| | Adres IP | `192.168.0.1` | | Internal poll interval | `10000` | ## Źródła - Hunter Douglas PowerView Hub API — Third-Party Integration Reference (v2.0.0) [mynzws.co.nz](https://mynzws.co.nz/wp-content/uploads/2021/05/Powerview-Third-Party-API.pdf) 2026-04-23 [PDF](https://taphome.com/compatibility/devices/powerview-hub/manufacturer/powerview-third-party-api.pdf) - PowerView Hub — Quick Start Guide (Luxaflex / Hunter Douglas) [astyleofshade.com.au](https://astyleofshade.com.au/wp-content/uploads/2020/01/PowerView-Hub-Guide.pdf) 2026-04-23 [PDF](https://taphome.com/compatibility/devices/powerview-hub/manufacturer/powerview-hub-quick-start.pdf) - Hunter Douglas PowerView Hub — Product Overview [www.hunterdouglas.com](https://www.hunterdouglas.com/faqs/powerview-hub) 2026-04-23 - Hunter Douglas PowerView — Home Assistant Integration [www.home-assistant.io](https://www.home-assistant.io/integrations/hunterdouglas_powerview/) 2026-04-23 Dokumenty producentów są © ich właścicieli. Udostępniamy je w formie opublikowanej przez producenta, wyłącznie w celach informacyjnych. ## Powiązana dokumentacja - [Integracja Packet Parser](https://taphome.com/pl/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/) - [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/) - [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/)