TapHome

Hunter Douglas PowerView Hub

Packet Parser → HTTP
Dodane przez
Ostatnia aktualizacja: 06. 2026
Hunter Douglas PowerView Hub

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.

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://<HubIP>/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

W menu bocznym dotknij Hub:

Menu boczne aplikacji PowerView — pozycja Hub

W sekcji Connected Hub dotknij swojego huba, aby otworzyć Hub Info:

Aplikacja PowerView — lista hubów

Przewiń do Static IP na dole i dotknij pozycji:

Ekran Hub Info aplikacji PowerView — pozycja Static IP

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

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:

1

http://<HubIP>/api/shades

Odpowiedzią jest dokument JSON; tablica shadeIds zawiera wszystkie ID rolet znanych hubowi:

1

{ "shadeIds": [ 7348, 14922, 30019 ] }

Zapisz ID rolet, którymi chcesz sterować z TapHome. Jeśli masz tylko jedną roletę, tablica zawiera jedną wartość.

Aby dopasować ID do fizycznej rolety, otwórz http://<HubIP>/api/shades/<id> — 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.

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://<HubIP>/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

PowerView Hub Moduł
Zmienne niestandardowe
SlideDeviceId (numeric) = 1ID 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

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

Roleta

Odczyt poziomu rolety
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
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.

Źródła

Znalazłeś problem z tym szablonem urządzenia?

Napisz nam, co nie działa, czego brakuje lub jak powinien zachowywać się szablon. Twoja opinia pomaga nam utrzymać katalog dokładnym.

Zweryfikowane przez TapHome

Chcesz tego użyć w swoim TapHome Core?

Otwórz ten szablon w portalu klienta, aby zastosować go w swoim domu, lub zaproponuj modyfikację i wyślij ją z powrotem do katalogu.

Otwórz w portalu