--- title: "Hunter Douglas PowerView Hub" description: "Motoros PowerView árnyékolók és redőnyök vezérlése helyi HTTP-n. TapHome sablon Hunter Douglas / Luxaflex PowerView Hub Gen 1 és Gen 2 eszközhöz." url: "https://taphome.com/hu/compatibility/powerview-hub/" language: hu lastmod: 2026-04-23 generator: hugo ai: topics: ["http","gateway","blinds","shades","rf-mesh","local-api"] questions: ["Hogyan integrálható a Hunter Douglas PowerView Hub a TapHome rendszerbe?","Támogatja a TapHome a Luxaflex PowerView motoros árnyékolókat?","Hogyan lehet megtudni egy PowerView árnyékoló ID-ját a TapHome-hoz?","Támogatja a TapHome a PowerView 3 Gateway eszközt?","Hogyan kell statikus IP-címet beállítani a PowerView Hubhoz?","Miért csúszik el egy PowerView árnyékoló pozíciója a Pebble távirányító használata után?"] --- # Hunter Douglas PowerView Hub Kommunikáció: Packet Parser → HTTP - [Hunter Douglas PowerView Hub — termék GYIK](https://www.hunterdouglas.com/faqs/powerview-hub) - [Hunter Douglas PowerView Motorization — áttekintés](https://www.hunterdouglas.com/operating-systems/powerview-motorization) > Hálózati cím > > A TapHome az importáláskor megadott címen éri el az eszközt. Adjon az eszköznek állandó címet — IP-foglalást a routerben, vagy az mDNS-nevét, ha támogatja —, különben az integráció leáll, amikor a router megváltoztatja a címet. > > [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/) ## Integrációs útmutató 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. > [!WARNING] > 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:///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](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step1-menu_hu_64ee10340ed9b61.jpeg) Az oldalsó menüben koppints a **Hub** elemre: ![PowerView alkalmazás oldalsó menü — Hub bejegyzés](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step2-hub_hu_fe0343b38db4b10f.jpeg) A *Connected Hub* részben koppints a hubodra, hogy megnyíljon a **Hub Info**: ![PowerView alkalmazás — hubok listája](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step3-hub-info_hu_af1eb9afe01b1443.jpeg) Görgess le a **Static IP** ponthoz, és koppints rá: ![PowerView alkalmazás Hub Info képernyő — Static IP bejegyzés](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step4-static-ip_hu_aecb9512f80ee4bf.jpeg) 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ó](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step5-enable_hu_18a6d986e0261c54.jpeg) > [!NOTE] > 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: ``` http:///api/shades ``` A válasz egy JSON dokumentum; a `shadeIds` tömb tartalmazza a hub által ismert összes árnyékoló ID-ját: ```json { "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. > [!TIP] > Egy ID fizikai árnyékolóhoz rendelését úgy tudod megtenni, hogy megnyitod a `http:///api/shades/` 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. > [!TIP] > 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:///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 1 Ezek az eszközök az importálás után jelennek meg a TapHome-ban. PowerView Hub Modul Egyéni változók `SlideDeviceId` (numeric) = 1 A 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 Olvasás és írás 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 Redőnyszint olvasása ```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 ``` Redőnyszint írása ```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"); ``` **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. ## Importálási paraméterek Ezeket az értékeket az XML importálásakor adja meg. | Az alkalmazás kéri | Alapérték | |------------------------|---------------| | IP-cím | `192.168.0.1` | | Internal poll interval | `10000` | ## Források - 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 A gyártói dokumentumok © a mindenkori tulajdonosaikat illetik. A gyártó által közzétett formában, kizárólag tájékoztatásul tesszük elérhetővé őket. ## Kapcsolódó dokumentáció - [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/) - [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/) - [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)