--- title: "Hunter Douglas PowerView Hub" description: "PowerView Hub Gen 1 a Gen 2 (Hunter Douglas, Luxaflex) přes lokální HTTP REST API: poloha motorizovaných stínidel, každé podle shade id. Bez cloudu." url: "https://taphome.com/cs/compatibility/powerview-hub/" language: cs lastmod: 2026-04-23 generator: hugo ai: topics: ["http","gateway","blinds","shades","rf-mesh","local-api"] questions: ["Jak integrovat Hunter Douglas PowerView Hub s TapHome?","Podporuje TapHome motorizovaná stínidla Luxaflex PowerView?","Jak zjistit ID PowerView stínidla pro TapHome?","Je PowerView 3 Gateway podporovaný TapHome?","Jak přiřadit statickou IP adresu PowerView Hubu?","Proč se poloha PowerView stínidla rozchází po použití Pebble dálkového ovladače?"] --- # Hunter Douglas PowerView Hub Komunikace: Packet Parser → HTTP - [Hunter Douglas PowerView Hub — FAQ produktu](https://www.hunterdouglas.com/faqs/powerview-hub) - [Hunter Douglas PowerView Motorization — přehled](https://www.hunterdouglas.com/operating-systems/powerview-motorization) > Adresa v síti > > TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní. > > [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/) ## Návod na integraci Hunter Douglas PowerView Hub (prodávaný jako **Luxaflex PowerView Hub** v Evropě, Austrálii a částech Asie — identický hardware) je smart home můstek, který propojuje motorizovaná PowerView stínidla s IP smart home systémy. Hub provozuje na jedné straně proprietární 2,4 GHz RF síť Hunter Douglas (PowerView Shade Network se spárovanými stínidly a opakovači) a na druhé straně vystavuje lokální neautentifikované HTTP REST API na portu 80. TapHome komunikuje s hubem přes toto lokální REST API — pro ovládání není potřeba cloudový účet ani připojení k internetu. Šablona řídí **polohu primární lamely** jednoho PowerView stínidla na jednu TapHome device instanci; ovládání více stínidel vyžaduje přidání více `PowerView Slide` zařízení pod stejné rozhraní, přičemž každé je adresováno vlastním shade id. > [!WARNING] > Tato šablona podporuje pouze **PowerView Hub (Gen 1)** a **PowerView Hub Gen 2**. Novější **PowerView 3 Gateway (Gen 3)** používá odlišnou architekturu a nevystavuje stejné lokální REST API — s touto šablonou **není** kompatibilní. Viz poznámka o Gen 3 na konci této stránky. ## Podporovaná zařízení Šablona vystavuje jeden TapHome device typ: - **PowerView Slide** — poloha primární lamely (stínidla) jednoho PowerView stínidla. Mapuje rozsah hubu `0`–`65535` na konvenci TapHome žaluzií `0`–`100 %` (invertovaně, takže `0` = otevřené a `100 %` = zavřené na straně TapHome). Samotná PowerView Shade Network je kompatibilní s 34+ modely motorizovaných stínidel, žaluzií, okenic a závěsů napříč produktovými řadami Hunter Douglas / Luxaflex — Duette, Silhouette, Pirouette, Vignette, rolety, Roman, Skyline Panel, závěsy, benátské žaluzie a další. Dokud je stínidlo spárováno s hubem v PowerView aplikaci, TapHome ho dokáže ovládat stejným mechanismem primární lamely. ## Předpoklady Před importem šablony v TapHome ověřte: - PowerView Hub je napájený, připojený k LAN přes Ethernet (nebo Wi-Fi na Gen 2) a přední LED signalizuje normální provoz (**trvale modrá** na Gen 1, ekvivalentní na Gen 2). - Vaše stínidla jsou již spárována s hubem přes PowerView aplikaci — každé stínidlo, které má TapHome ovládat, musí být v seznamu *Shades* v PowerView aplikaci. - Hub a TapHome centrála jsou ve **stejné lokální síti** (bez NAT mezi nimi). - Webový prohlížeč na telefonu, tabletu nebo počítači dokáže otevřít `http:///api/shades` a vrátit JSON odpověď. ## Konfigurace ### Krok 1 — Přiřazení statické IP adresy hubu Hub musí být dostupný na stabilní IP adrese. PowerView aplikace má vestavěné nastavení statické IP, což je doporučený způsob, jak zafixovat adresu hubu — alternativně vytvořte DHCP rezervaci pro MAC adresu hubu na vašem routeru. Otevřete PowerView aplikaci a ťukněte na **ikonu menu** v levém horním rohu: ![PowerView aplikace dashboard — otevření bočního menu](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step1-menu_hu_64ee10340ed9b61.jpeg) V bočním menu ťukněte na **Hub**: ![Boční menu PowerView aplikace — položka Hub](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step2-hub_hu_fe0343b38db4b10f.jpeg) V sekci *Connected Hub* ťukněte na váš hub a otevřete **Hub Info**: ![PowerView aplikace — seznam hubů](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step3-hub-info_hu_af1eb9afe01b1443.jpeg) Posuňte se dolů k **Static IP** a ťukněte na ni: ![Obrazovka Hub Info v PowerView aplikaci — položka Static IP](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step4-static-ip_hu_aecb9512f80ee4bf.jpeg) Aktivujte **Use Static IP** a zadejte hodnoty *IP Address*, *Mask*, *Gateway* a *DNS*, které odpovídají vaší síti: ![Obrazovka Static IP v PowerView aplikaci — přepínač Use Static IP](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step5-enable_hu_18a6d986e0261c54.jpeg) > [!NOTE] > Nastavení statické IP je podporováno pouze na hubech připojených k routeru přes **Ethernet**. Pokud je hub na Wi-Fi, vytvořte DHCP rezervaci přímo na routeru. ### Krok 2 — Zjištění ID stínidel Každé stínidlo spárované s hubem má jedinečné číselné ID. Otevřete následující URL v libovolném prohlížeči ve stejné síti: ``` http:///api/shades ``` Odpověď je JSON dokument; pole `shadeIds` obsahuje všechna ID stínidel známých hubu: ```json { "shadeIds": [ 7348, 14922, 30019 ] } ``` Zapište si ID stínidel, která chcete ovládat z TapHome. Pokud máte jen jedno stínidlo, pole obsahuje jedinou hodnotu. > [!TIP] > Přiřazení ID k fyzickému stínidlu zjistíte otevřením `http:///api/shades/` — pole `name` obsahuje lidsky čitelný název stínidla z PowerView aplikace (kódovaný Base64; pro čtení dekódujte). Alternativně postupně měňte polohu každého stínidla z PowerView aplikace a sledujte, kterému ID se mění `positions.position1`. ### Krok 3 — Vytvoření Packet Parser rozhraní v TapHome 1. V TapHome aplikaci otevřete **Nastavení → Rozhraní** a buď vytvořte nové **Packet Parser** rozhraní, nebo otevřete existující. 2. Zvolte **Přidat ze šablony** a vyberte **PowerView Hub**. 3. Do pole *IP adresa* zadejte IP adresu hubu (nahraďte zástupný text `192.168.0.1`). 4. Hodnotu *Internal poll interval* ponechte na výchozích `10000` ms (10 s), pokud nemáte konkrétní důvod ji měnit — rychlejší dotazování nezlepší odezvu a může zhoršit RF výkon sítě stínidel. 5. Ťukněte na **Vytvořit**. TapHome naimportuje jedno `PowerView Slide` zařízení. V tomto bodě je zařízení svázáno s hubem, ale ještě ne s konkrétním stínidlem. ### Krok 4 — Nastavení ID stínidla na každém Slide zařízení Otevřete vytvořené `PowerView Slide` zařízení v TapHome, přejděte do **Service Settings → Device ID** a zadejte ID stínidla, které jste si zapsali v kroku 2. Uložte nastavení. Pro ovládání dalších stínidel přidejte další `PowerView Slide` zařízení pod stejné Packet Parser rozhraní a na každém nastavte jiné *Device ID*. > [!TIP] > Hodnota `SlideDeviceId` je nastavení na úrovni zařízení, ne modulu. Jedno Packet Parser rozhraní dokáže řídit libovolný počet PowerView Slide zařízení — mezi nimi se mění jen ID. ## Řešení problémů ### Poloha stínidla se rozchází po použití dálkového ovladače Pebble dálkové ovladače na Gen 1 / Gen 2 hubech používají proprietární Bluetooth LE a **nehlásí polohu stínidla zpět hubu**. Když uživatel pohne stínidlem přes Pebble, cache poloha hubu — kterou čte šablona — zůstane neaktuální až do dalšího pohybového příkazu, který ji sladí. Jde o hardwarové omezení platformy Gen 1 / Gen 2, ne o chybu TapHome šablony. Pokud je přesná zpětná vazba polohy kritická, standardizujte ovládání stínidel přes TapHome nebo přes PowerView aplikaci. ### Hub vrací HTTP 423 "Hub busy for maintenance" Toto je běžná přechodná odpověď během vnitřní údržby hubu (například při aktualizaci scén nebo kontrole firmwaru). Šablona chybu signalizuje přes `ADDERROR`, ale další poll cyklus obvykle projde. Pokud 423 odpovědi přetrvávají, restartujte hub (stiskněte **Reset** na zadní straně). ### Sekundární huby nejsou viditelné v PowerView aplikaci PowerView aplikace obvykle zobrazuje pouze hub registrovaný na váš účet. Sekundární huby ve stejné PowerView Shade Network se v seznamu hubů v aplikaci nemusí objevit, přesto však odpovídají v lokální síti a přijímají stejná REST API volání. TapHome se může navázat na sekundární hub podle jeho IP adresy — viditelnost v PowerView aplikaci není pro lokální HTTP ovládání vyžadována. ### Žádná odpověď na `http:///api/shades` 1. Ověřte, že přední LED indikuje normální provoz (trvale modrá na Gen 1). Viz LED tabulka v PowerView Hub Quick Start Guide. 2. Ověřte IP hubu v PowerView aplikaci (*Hub → Hub Info → IP Address*) a že se shoduje s tím, co jste zadali v TapHome. 3. Pingněte hub ze zařízení ve stejné VLAN; hub nesmí být za NATem ani firewallem vzhledem k TapHome centrále. 4. Hub naslouchá **pouze na HTTP portu 80** — nepoužívejte prefix `https://`. ## PowerView 3 Gateway (Gen 3) — nepodporovaný Novější **PowerView 3 Gateway** od Hunter Douglas je zcela přepracovaný: používá Matter přes Thread, je cloud-first a nevystavuje stejné lokální `/api/shades` REST rozhraní jako huby Gen 1 / Gen 2. TapHome Packet Parser šablona z této stránky proto **nefunguje s PowerView 3 Gateway** — pokus o navázání buď vrátí HTML z webového UI brány, nebo zcela selže. Pokud máte Gen 3 Gateway, aktuální migrační cesta ze strany Hunter Douglas je souběžně ponechat Gen 1 / Gen 2 hub pro integrace třetích stran, nebo počkat na podporu blinds přes Matter v budoucím firmwaru TapHome. ## Dostupná zařízení 1 Tato zařízení se po importu zobrazí v TapHome. PowerView Hub Modul Vlastní proměnné `SlideDeviceId` (numeric) = 1 ID PowerView stínidla, které adresuje toto TapHome zařízení. Otevřete http://{HubIP}/api/shades pro seznam shadeIds a zvolené ID vložte do Service Settings TapHome Slide zařízení. 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. Stínidlo Posuvný Čtení i zápis Poloha primární lamely (stínidla) jednoho PowerView stínidla — mapuje surový rozsah hubu 0–65535 na TapHome konvenci žaluzií 0–100 % (0 = otevřené, 100 % = zavřené) numeric Jednotka: % json\_path Čtení úrovně žaluzie ```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 ``` Zápis úrovně žaluzie ```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"); ``` **Připojení:** Packet Parser → HTTP Možná vylepšení (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 Tyto hodnoty zadáte při importu XML. | Ptá se v aplikaci | Výchozí | |------------------------|---------------| | IP adresa | `192.168.0.1` | | Internal poll interval | `10000` | ## Zdroje - 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 výrobců jsou © jejich příslušných vlastníků. Poskytujeme je tak, jak je výrobce zveřejnil, pouze pro informaci. ## Související dokumentace - [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/) - [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/) - [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)