TapHome

Hunter Douglas PowerView Hub

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 05. 2026
Hunter Douglas PowerView Hub

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.

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

V bočnom menu ťuknite na Hub:

Bočné menu PowerView aplikácie — položka Hub

V sekcii Connected Hub ťuknite na váš hub a otvorte Hub Info:

PowerView aplikácia — zoznam hubov

Posuňte sa nadol k Static IP a ťuknite na ňu:

Obrazovka Hub Info v PowerView aplikácii — položka Static IP

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

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:

1

http://<HubIP>/api/shades

Odpoveď je JSON dokument; pole shadeIds obsahuje všetky ID tienidiel známych hub-u:

1

{ "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.

Priradenie ID k fyzickému tienidlu zistíte otvorením http://<HubIP>/api/shades/<id> — 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.

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

PowerView Hub Modul
Vlastné premenné
SlideDeviceId (numeric) = 1ID 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ý

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

Tienidlo

Čítanie úrovne žalúzie
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
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.

Zdroje

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Overené TapHomom

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli