TapHome

Hunter Douglas PowerView Hub

Packet Parser → HTTP
Beküldő
Utoljára frissítve: 06. 2026
Hunter Douglas PowerView Hub

A Hunter Douglas PowerView Hub (Európában, Ausztráliában és Ázsia egyes részein Luxaflex PowerView Hub néven forgalmazva — azonos hardver) egy okosotthon-híd, amely a motoros PowerView árnyékolókat IP-alapú otthonautomatizálási rendszerekhez köti. A hub egyik oldalán a Hunter Douglas saját 2,4 GHz-es RF mesh hálózata fut (a PowerView Shade Network párosított árnyékolókkal és jelismétlőkkel), a másik oldalán pedig egy helyi, hitelesítés nélküli HTTP REST API-t nyújt a 80-as porton.

A TapHome ezen a helyi REST API-n keresztül kommunikál a hubbal — a vezérléshez nincs szükség felhőfiókra és internetkapcsolatra sem. A sablon egyetlen PowerView árnyékoló elsődleges lécének pozícióját vezérli TapHome eszközpéldányonként; több árnyékoló kezeléséhez több PowerView Slide eszközt kell felvenni ugyanaz alatt a felület alatt, mindegyiket saját shade id-vel címezve.

Ez a sablon kizárólag a PowerView Hub (Gen 1) és PowerView Hub Gen 2 eszközöket támogatja. Az újabb PowerView 3 Gateway (Gen 3) más architektúrát használ, és nem nyújtja ugyanazt a helyi REST API-t — a sablonnal nem kompatibilis. Lásd a Gen 3 megjegyzést az oldal alján.

Támogatott eszközök

A sablon egy TapHome eszköztípust nyújt:

  • PowerView Slide — egyetlen PowerView árnyékoló elsődleges lécének (árnyékolójának) pozíciója. A hub 0–65535 tartományát leképezi a TapHome 0–100 % redőnykonvenciójára (invertálva, vagyis 0 = nyitott és 100 % = zárt a TapHome oldalán).

A PowerView Shade Network maga 34+ motoros árnyékoló, redőny, zsalugáter és függönymodellel kompatibilis a Hunter Douglas / Luxaflex termékcsaládokban — Duette, Silhouette, Pirouette, Vignette, rolók, Roman, Skyline Panel, függönyök, velencei árnyékolók és sok más. Ha egy árnyékolót a PowerView alkalmazásban párosítottál a hubbal, ugyanazzal az elsődleges léc mechanizmussal a TapHome is vezérelni tudja.

Előfeltételek

A sablon TapHome-ba importálása előtt ellenőrizd:

  • A PowerView Hub tápellátás alatt áll, Ethernet (vagy Wi-Fi Gen 2 esetén) kapcsolja a LAN-ra, és az elülső LED normál üzemet jelez (folyamatos kék Gen 1 esetén, ennek megfelelő Gen 2 esetén).
  • Az árnyékolóid a PowerView alkalmazásban már párosítva vannak a hubbal — minden árnyékolónak, amit a TapHome-nak vezérelnie kell, szerepelnie kell a PowerView alkalmazás Shades listájában.
  • A hub és a TapHome központ ugyanazon a helyi hálózaton van (NAT nélkül közöttük).
  • A telefonod, tableted vagy számítógéped böngészőjében meg tudod nyitni a http://<HubIP>/api/shades címet, és JSON választ kapsz.

Konfiguráció

1. lépés — Statikus IP-cím kiosztása a hubnak

A hubnak állandó IP-címen kell elérhetőnek lennie. A PowerView alkalmazásba be van építve a statikus IP beállítása, ez az ajánlott módja a hub címének rögzítésének — alternatívaként hozz létre DHCP foglalást a hub MAC-címére a routereden.

Nyisd meg a PowerView alkalmazást, és a bal felső sarokban koppints a menü ikonra:

PowerView alkalmazás dashboard — oldalsó menü megnyitása

Az oldalsó menüben koppints a Hub elemre:

PowerView alkalmazás oldalsó menü — Hub bejegyzés

A Connected Hub részben koppints a hubodra, hogy megnyíljon a Hub Info:

PowerView alkalmazás — hubok listája

Görgess le a Static IP ponthoz, és koppints rá:

PowerView alkalmazás Hub Info képernyő — Static IP bejegyzés

Kapcsold be a Use Static IP opciót, majd add meg az IP Address, Mask, Gateway és DNS értékeket, amelyek megfelelnek a hálózatodnak:

PowerView alkalmazás Static IP képernyő — Use Static IP kapcsoló

A statikus IP beállítása csak olyan huboknál támogatott, amelyek Ethernet-tel csatlakoznak a routerhez. Ha a hub Wi-Fi-n van, helyette hozz létre DHCP foglalást a routeren.

2. lépés — Árnyékoló ID-k kiderítése

A hubbal párosított minden árnyékolónak egyedi numerikus ID-ja van. Nyisd meg a következő URL-t bármelyik böngészőben az azonos hálózaton:

1

http://<HubIP>/api/shades

A válasz egy JSON dokumentum; a shadeIds tömb tartalmazza a hub által ismert összes árnyékoló ID-ját:

1

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

Jegyezd fel azon árnyékolók ID-ját, amelyeket a TapHome-ból szeretnél vezérelni. Ha csak egyetlen árnyékolód van, a tömb egyetlen értéket tartalmaz.

Egy ID fizikai árnyékolóhoz rendelését úgy tudod megtenni, hogy megnyitod a http://<HubIP>/api/shades/<id> címet — a name mező tartalmazza az árnyékoló olvasható nevét a PowerView alkalmazásból (Base64-kódolva; olvasáshoz dekódold). Alternatívaként a PowerView alkalmazásból egyenként mozgasd meg az árnyékolókat, és figyeld, melyik ID positions.position1 értéke változik.

3. lépés — Packet Parser felület létrehozása a TapHome-ban
  1. A TapHome alkalmazásban nyisd meg a Beállítások → Felületek részt, és vagy hozz létre új Packet Parser felületet, vagy nyiss meg egy meglévőt.
  2. Válaszd a Hozzáadás sablonból lehetőséget, és jelöld ki a PowerView Hub sablont.
  3. Az IP-cím mezőbe írd be a hub IP-címét (cseréld le a 192.168.0.1 helyőrzőt).
  4. Az Internal poll interval értékét hagyd a 10000 ms (10 s) alapértéken, hacsak nincs konkrét indokod megváltoztatni — a gyorsabb lekérdezés nem javítja a reakcióidőt, és ronthatja az árnyékoló-háló RF teljesítményét.
  5. Koppints a Létrehozás gombra.

A TapHome egy PowerView Slide eszközt importál a sablonból. Ezen a ponton az eszköz a hubhoz van kötve, de még konkrét árnyékolóhoz nem.

4. lépés — Árnyékoló ID beállítása minden Slide eszközön

Nyisd meg a létrehozott PowerView Slide eszközt a TapHome-ban, menj a Service Settings → Device ID részhez, és írd be a 2. lépésben feljegyzett árnyékoló ID-ját. Mentsd el a beállításokat.

További árnyékolók vezérléséhez adj hozzá további PowerView Slide eszközöket ugyanahhoz a Packet Parser felülethez, és mindegyikre állíts be más Device ID-t.

A SlideDeviceId érték eszközszintű beállítás, nem modulszintű. Egy Packet Parser felület tetszőleges számú PowerView Slide eszközt vezérelhet — csak az ID változik közöttük.

Hibaelhárítás

Az árnyékoló pozíciója elcsúszik távirányító használata után

A Gen 1 / Gen 2 hubokhoz tartozó Pebble távirányítók saját Bluetooth LE-t használnak, és nem jelentik vissza a hubnak az árnyékoló pozícióját. Amikor a felhasználó a Pebble-lel mozgat egy árnyékolót, a hub gyorsítótárazott pozíciója — amelyet a sablon olvas — elavulttá válik a következő mozgási parancsig, amely újra szinkronizálja. Ez a Gen 1 / Gen 2 platform hardveres korlátja, nem a TapHome sablon hibája. Ha a pontos pozíció-visszajelzés kritikus, egységesítsd az árnyékolók vezérlését a TapHome vagy a PowerView alkalmazás felé.

A hub HTTP 423 “Hub busy for maintenance” választ ad

Ez egy normál, átmeneti válasz, amíg a hub belső karbantartást végez (például jelenetfrissítés vagy firmware-ellenőrzés). A sablon a hibát ADDERROR-on keresztül jelzi, de a következő poll ciklus általában sikeres. Ha a 423 válaszok tartósan fennmaradnak, indítsd újra a hubot (nyomd meg a Reset gombot a hátulján).

A másodlagos hubok nem láthatók a PowerView alkalmazásban

A PowerView alkalmazás általában csak a fiókodhoz regisztrált hubot listázza. Az azonos PowerView Shade Network-ön lévő másodlagos hubok nem feltétlenül jelennek meg az alkalmazás hub listájában, de ettől függetlenül válaszolnak a helyi hálózaton, és ugyanazokat a REST API hívásokat fogadják. A TapHome az IP-címe alapján kötődhet egy másodlagos hubhoz — a helyi HTTP vezérléshez a PowerView alkalmazásban való láthatóság nem szükséges.

Nincs válasz a http://<HubIP>/api/shades címen
  1. Ellenőrizd, hogy az elülső LED normál üzemet jelez-e (folyamatos kék Gen 1 esetén). Lásd a LED táblázatot a PowerView Hub Quick Start Guide-ban.
  2. Ellenőrizd a hub IP-jét a PowerView alkalmazásban (Hub → Hub Info → IP Address), és hogy egyezik a TapHome-ba beírt értékkel.
  3. Pingeld a hubot egy azonos VLAN-on lévő gépről; a hub nem lehet NAT vagy tűzfal mögött a TapHome központhoz képest.
  4. A hub kizárólag a 80-as HTTP porton figyel — ne használj https:// előtagot az URL előtt.

PowerView 3 Gateway (Gen 3) — nem támogatott

A Hunter Douglas újabb PowerView 3 Gateway eszköze alapjaiban újratervezett: Matter over Thread technológiát használ, felhőközpontú, és nem teszi közzé ugyanazt a helyi /api/shades REST felületet, mint a Gen 1 / Gen 2 hubok. A TapHome Packet Parser sablon ezen az oldalon ezért nem működik a PowerView 3 Gateway-jel — a csatlakozási kísérlet vagy a gateway web UI HTML-jét adja vissza, vagy teljesen meghiúsul.

Ha Gen 3 Gateway-jed van, a Hunter Douglas oldaláról a jelenlegi migrációs út az, hogy párhuzamosan megtartasz egy Gen 1 / Gen 2 hubot harmadik fél integrációkhoz, vagy kivárod a Matter alapú árnyékoló támogatást egy jövőbeli TapHome firmware-ben.

Elérhető eszközök

PowerView Hub Modul
Egyéni változók
SlideDeviceId (numeric) = 1A PowerView árnyékoló ID-ja, amelyet ez a TapHome eszköz címez. Nyisd meg a http://{HubIP}/api/shades címet a shadeIds listázásához, és illeszd be a kiválasztott ID-t a TapHome Slide eszköz Service Settings részébe.
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.
Árnyékoló Csúszka

Egyetlen PowerView árnyékoló elsődleges lécének (árnyékolójának) pozíciója — a hub nyers 0–65535 tartományát a TapHome 0–100 %-os redőnykonvenciójára képezi le (0 = nyitott, 100 % = zárt)

numeric Egység: % json_path

Árnyékoló

Redőnyszint olvasása
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
Redőnyszint írása
VAR pos := ROUND((1 - Bl) * 65535);
VAR contentJson := "{\"shade\": { \"positions\": { \"posKind1\": 1, \"position1\":" + pos + "}}}";

SENDHTTPREQUEST("/api/shades/" + SlideDeviceId, "PUT", contentJson, "Content-Type:application/json");
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (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.

Források

Talált problémát ezzel az eszközsablonnal?

Írja meg, mi nem működik, mi hiányzik, vagy hogyan kellene a sablonnak viselkednie. Visszajelzése segít, hogy a katalógus pontos maradjon.

TapHome által hitelesítve

Használni szeretnéd ezt a TapHome Core-odban?

Nyisd meg ezt a sablont az ügyfélportálon, hogy alkalmazd az otthonaid egyikére, vagy készíts egy módosítást és küldd vissza a katalógusba.

Megnyitás a portálon