TapHome

Hunter Douglas PowerView Hub

Packet Parser → HTTP
Přidal
Poslední aktualizace: 06. 2026
Hunter Douglas PowerView Hub

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.

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

V bočním menu ťukněte na Hub:

Boční menu PowerView aplikace — položka Hub

V sekci Connected Hub ťukněte na váš hub a otevřete Hub Info:

PowerView aplikace — seznam hubů

Posuňte se dolů k Static IP a ťukněte na ni:

Obrazovka Hub Info v PowerView aplikaci — položka Static IP

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

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:

1

http://<HubIP>/api/shades

Odpověď je JSON dokument; pole shadeIds obsahuje všechna ID stínidel známých hubu:

1

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

Přiřazení ID k fyzickému stínidlu zjistíte otevřením http://<HubIP>/api/shades/<id> — 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.

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

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

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

Stínidlo

Čtení úrovně žaluzie
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
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.

Zdroje

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Ověřeno TapHome

Chcete to použít ve svém TapHome jádře?

Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu.

Otevřít v portálu