--- title: "Hunter Douglas PowerView Hub" description: "Ovládajte motorizované PowerView tienidlá a žalúzie cez lokálne HTTP. TapHome šablóna pre Hunter Douglas / Luxaflex PowerView Hub Gen 1 a Gen 2." url: "https://taphome.com/sk/compatibility/powerview-hub/" language: sk lastmod: 2026-04-23 generator: hugo ai: topics: ["http","gateway","blinds","shades","rf-mesh","local-api"] questions: ["Ako integrovať Hunter Douglas PowerView Hub s TapHome?","Podporuje TapHome motorizované tienidlá Luxaflex PowerView?","Ako zistiť ID PowerView tienidla pre TapHome?","Je PowerView 3 Gateway podporovaný TapHome?","Ako priradiť statickú IP adresu PowerView Hub-u?","Prečo sa poloha PowerView tienidla rozchádza po použití Pebble diaľkového ovládača?"] --- # Hunter Douglas PowerView Hub Komunikácia: Packet Parser → HTTP - [Hunter Douglas PowerView Hub — FAQ produktu](https://www.hunterdouglas.com/faqs/powerview-hub) - [Hunter Douglas PowerView Motorization — prehľad](https://www.hunterdouglas.com/operating-systems/powerview-motorization) > Adresa v sieti > > TapHome komunikuje so zariadením na adrese zadanej pri importe. Dajte zariadeniu stálu adresu — rezerváciu IP v routeri, alebo jeho mDNS meno, ak ho podporuje —, inak integrácia prestane fungovať, keď router adresu zmení. > > [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/) ## Návod na integráciu Hunter Douglas PowerView Hub (predávaný ako **Luxaflex PowerView Hub** v Európe, Austrálii a častiach Ázie — identický hardvér) je smart home mostík, ktorý pripája motorizované PowerView tienidlá k IP smart home systémom. Hub prevádzkuje na jednej strane proprietárnu 2,4 GHz RF sieť Hunter Douglas (PowerView Shade Network so spárovanými tienidlami a opakovačmi) a na druhej strane vystavuje lokálne neautentifikované HTTP REST API na porte 80. TapHome komunikuje s hub-om cez toto lokálne REST API — na ovládanie nie je potrebný cloudový účet ani pripojenie na internet. Šablóna riadi **polohu primárnej lamely** jedného PowerView tienidla na jednu TapHome device inštanciu; ovládanie viacerých tienidiel si vyžaduje pridanie viacerých `PowerView Slide` zariadení pod to isté rozhranie, pričom každé je adresované vlastným shade id. > [!WARNING] > Táto šablóna podporuje len **PowerView Hub (Gen 1)** a **PowerView Hub Gen 2**. Novší **PowerView 3 Gateway (Gen 3)** používa odlišnú architektúru a nevystavuje rovnaké lokálne REST API — s touto šablónou **nie je** kompatibilný. Pozri poznámku o Gen 3 na konci tejto stránky. ## Podporované zariadenia Šablóna vystavuje jeden TapHome device typ: - **PowerView Slide** — poloha primárnej lamely (tienidla) jedného PowerView tienidla. Mapuje rozsah hub-u `0`–`65535` na konvenciu TapHome žalúzií `0`–`100 %` (invertovane, takže `0` = otvorené a `100 %` = zatvorené na strane TapHome). Samotná PowerView Shade Network je kompatibilná s 34+ modelmi motorizovaných tienidiel, žalúzií, okeníc a závesov naprieč produktovými radami Hunter Douglas / Luxaflex — Duette, Silhouette, Pirouette, Vignette, rolety, Roman, Skyline Panel, závesy, benátske žalúzie a ďalšie. Pokiaľ je tienidlo spárované s hub-om v PowerView aplikácii, TapHome ho dokáže ovládať rovnakým mechanizmom primárnej lamely. ## Predpoklady Pred importovaním šablóny v TapHome overte: - PowerView Hub je napájaný, pripojený do LAN cez Ethernet (alebo Wi-Fi na Gen 2) a predná LED signalizuje normálnu prevádzku (**stále modrá** na Gen 1, ekvivalentná na Gen 2). - Vaše tienidlá sú už spárované s hub-om cez PowerView aplikáciu — každé tienidlo, ktoré má TapHome ovládať, musí byť v zozname *Shades* v PowerView aplikácii. - Hub a TapHome centrála sú v **rovnakej lokálnej sieti** (bez NAT medzi nimi). - Webový prehliadač na telefóne, tablete alebo počítači dokáže otvoriť `http:///api/shades` a vrátiť JSON odpoveď. ## Konfigurácia ### Krok 1 — Priradenie statickej IP adresy hub-u Hub musí byť dostupný na stabilnej IP adrese. PowerView aplikácia má zabudované nastavenie statickej IP, čo je odporúčaný spôsob ako zafixovať adresu hub-u — prípadne vytvorte DHCP rezerváciu pre MAC adresu hub-u na vašom routeri. Otvorte PowerView aplikáciu a ťuknite na **ikonu menu** v ľavom hornom rohu: ![PowerView aplikácia dashboard — otvorenie bočného menu](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step1-menu_hu_64ee10340ed9b61.jpeg) V bočnom menu ťuknite na **Hub**: ![Bočné menu PowerView aplikácie — položka Hub](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step2-hub_hu_fe0343b38db4b10f.jpeg) V sekcii *Connected Hub* ťuknite na váš hub a otvorte **Hub Info**: ![PowerView aplikácia — zoznam hubov](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step3-hub-info_hu_af1eb9afe01b1443.jpeg) Posuňte sa nadol k **Static IP** a ťuknite na ňu: ![Obrazovka Hub Info v PowerView aplikácii — 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 zadajte hodnoty *IP Address*, *Mask*, *Gateway* a *DNS*, ktoré zodpovedajú vašej sieti: ![Obrazovka Static IP v PowerView aplikácii — prepínač Use Static IP](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step5-enable_hu_18a6d986e0261c54.jpeg) > [!NOTE] > Nastavenie statickej IP je podporované len na hub-och pripojených k routeru cez **Ethernet**. Ak je hub na Wi-Fi, vytvorte DHCP rezerváciu priamo na routeri. ### Krok 2 — Zistenie ID tienidiel Každé tienidlo spárované s hub-om má jedinečné číselné ID. Otvorte nasledujúcu URL v ľubovoľnom prehliadači na rovnakej sieti: ``` http:///api/shades ``` Odpoveď je JSON dokument; pole `shadeIds` obsahuje všetky ID tienidiel známych hub-u: ```json { "shadeIds": [ 7348, 14922, 30019 ] } ``` Zapíšte si ID tienidiel, ktoré chcete ovládať z TapHome. Ak máte len jedno tienidlo, pole obsahuje jedinú hodnotu. > [!TIP] > Priradenie ID k fyzickému tienidlu zistíte otvorením `http:///api/shades/` — pole `name` obsahuje ľudsky čitateľný názov tienidla z PowerView aplikácie (kódovaný Base64; na čítanie dekódujte). Alternatívne zmeňte polohu každého tienidla z PowerView aplikácie postupne a sledujte, ktorému ID sa mení `positions.position1`. ### Krok 3 — Vytvorenie Packet Parser rozhrania v TapHome 1. V TapHome aplikácii otvorte **Nastavenia → Rozhrania** a buď vytvorte nové **Packet Parser** rozhranie, alebo otvorte existujúce. 2. Zvoľte **Pridať zo šablóny** a vyberte **PowerView Hub**. 3. Do poľa *IP adresa* zadajte IP adresu hub-u (nahraďte zástupný text `192.168.0.1`). 4. Hodnotu *Internal poll interval* nechajte na predvolených `10000` ms (10 s), pokiaľ nemáte špecifický dôvod ju meniť — rýchlejšie dotazovanie nezlepší odozvu a môže zhoršiť RF výkon na sieti tienidiel. 5. Ťuknite na **Vytvoriť**. TapHome importuje jedno `PowerView Slide` zariadenie. V tomto bode je zariadenie zviazané s hub-om, ale ešte nie s konkrétnym tienidlom. ### Krok 4 — Nastavenie ID tienidla na každom Slide zariadení Otvorte vytvorené `PowerView Slide` zariadenie v TapHome, prejdite do **Service Settings → Device ID** a zadajte ID tienidla, ktoré ste si zapísali v kroku 2. Uložte nastavenia. Na ovládanie ďalších tienidiel pridajte ďalšie `PowerView Slide` zariadenia pod to isté Packet Parser rozhranie a na každom nastavte iné *Device ID*. > [!TIP] > Hodnota `SlideDeviceId` je nastavenie na úrovni zariadenia, nie na úrovni modulu. Jedno Packet Parser rozhranie dokáže riadiť ľubovoľný počet PowerView Slide zariadení — medzi nimi sa mení len ID. ## Riešenie problémov ### Poloha tienidla sa rozchádza po použití diaľkového ovládača Pebble diaľkové ovládače na Gen 1 / Gen 2 hub-och používajú proprietárny Bluetooth LE a **nereportujú polohu tienidla späť hub-u**. Keď používateľ pohne tienidlom cez Pebble, cache poloha hub-u — ktorú číta šablóna — zostane neaktuálna až do ďalšieho pohybového príkazu, ktorý ju zosúladí. Ide o hardvérové obmedzenie platformy Gen 1 / Gen 2, nie o chybu TapHome šablóny. Ak je presná spätná väzba polohy kritická, štandardizujte ovládanie tienidiel cez TapHome alebo cez PowerView aplikáciu. ### Hub vracia HTTP 423 "Hub busy for maintenance" Toto je bežná prechodná odpoveď počas vnútornej údržby hub-u (napríklad pri aktualizácii scén alebo kontrole firmvéru). Šablóna chybu signalizuje cez `ADDERROR`, ale ďalší poll cyklus zvyčajne prejde. Ak 423 odpovede pretrvávajú, reštartujte hub (stlačte **Reset** na zadnej strane). ### Sekundárne huby nie sú viditeľné v PowerView aplikácii PowerView aplikácia zvyčajne zobrazuje len hub registrovaný pod váš účet. Sekundárne huby na rovnakej PowerView Shade Network sa v zozname hub-ov v aplikácii nemusia objaviť, no napriek tomu odpovedajú v lokálnej sieti a prijímajú rovnaké REST API volania. TapHome sa môže naviazať na sekundárny hub podľa jeho IP adresy — viditeľnosť v PowerView aplikácii pre lokálne HTTP ovládanie nie je potrebná. ### Žiadna odpoveď na `http:///api/shades` 1. Overte, že predná LED indikuje normálnu prevádzku (stále modrá na Gen 1). Pozri LED tabuľku v PowerView Hub Quick Start Guide. 2. Overte IP hub-u v PowerView aplikácii (*Hub → Hub Info → IP Address*) a že sa zhoduje s tým, čo ste zadali v TapHome. 3. Pingnite hub zo zariadenia v rovnakej VLAN; hub nesmie byť za NAT-om ani firewallom vzhľadom na TapHome centrálu. 4. Hub počúva **len na HTTP porte 80** — nepoužívajte prefix `https://`. ## PowerView 3 Gateway (Gen 3) — nepodporovaný Novší **PowerView 3 Gateway** od Hunter Douglas je úplne prepracovaný: používa Matter cez Thread, je cloud-first a nevystavuje rovnaké lokálne `/api/shades` REST rozhranie ako huby Gen 1 / Gen 2. TapHome Packet Parser šablóna z tejto stránky preto **nefunguje s PowerView 3 Gateway** — pokus o naviazanie buď vráti HTML z webového UI brány, alebo zlyhá úplne. Ak máte Gen 3 Gateway, aktuálna migračná cesta zo strany Hunter Douglas je paralelne ponechať Gen 1 / Gen 2 hub pre integrácie tretích strán, alebo počkať na podporu blinds cez Matter v budúcom firmvéri TapHome. ## Dostupné zariadenia 1 Tieto zariadenia sa po importe zobrazia v TapHome. PowerView Hub Modul Vlastné premenné `SlideDeviceId` (numeric) = 1 ID PowerView tienidla, ktoré adresuje toto TapHome zariadenie. Otvorte http://{HubIP}/api/shades pre zoznam shadeIds a zvolené ID vložte do Service Settings TapHome Slide zariadenia. 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. Tienidlo Posuvný Čítanie aj zápis Poloha primárnej lamely (tienidla) jedného PowerView tienidla — mapuje surový rozsah hub-u 0–65535 na TapHome konvenciu žalúzií 0–100 % (0 = otvorené, 100 % = zatvorené) numeric Jednotka: % json\_path Čítanie úrovne žalúzie ```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 úrovne žalúzie ```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"); ``` **Pripojenie:** Packet Parser → HTTP Možné vylepšenia (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. ## Parametre importu Tieto hodnoty zadáte pri importe XML. | Pýta sa v aplikácii | Predvolené | |------------------------|---------------| | 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ýrobcov sú © ich príslušných vlastníkov. Poskytujeme ich tak, ako ich zverejnil výrobca, len na informačné účely. ## Súvisiaca dokumentácia - [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/) - [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/) - [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)