--- title: "Hunter Douglas PowerView Hub" description: "Motorisierte PowerView-Behänge und -Jalousien über lokales HTTP steuern. TapHome-Vorlage für Hunter Douglas / Luxaflex PowerView Hub Gen 1 und Gen 2." url: "https://taphome.com/de/compatibility/powerview-hub/" language: de lastmod: 2026-04-23 generator: hugo ai: topics: ["http","gateway","blinds","shades","rf-mesh","local-api"] questions: ["Wie integriert man Hunter Douglas PowerView Hub mit TapHome?","Unterstützt TapHome motorisierte Behänge von Luxaflex PowerView?","Wie findet man die ID eines PowerView-Behangs für TapHome?","Wird das PowerView 3 Gateway von TapHome unterstützt?","Wie weist man dem PowerView Hub eine statische IP zu?","Warum driftet die Position eines PowerView-Behangs nach Nutzung der Pebble-Fernbedienung?"] --- # Hunter Douglas PowerView Hub Kommunikation: Packet Parser → HTTP - [Hunter Douglas PowerView Hub — Produkt-FAQ](https://www.hunterdouglas.com/faqs/powerview-hub) - [Hunter Douglas PowerView Motorization — Übersicht](https://www.hunterdouglas.com/operating-systems/powerview-motorization) > Netzwerkadresse > > TapHome erreicht dieses Gerät unter der beim Import eingegebenen Adresse. Geben Sie dem Gerät eine feste Adresse — eine IP-Reservierung im Router oder seinen mDNS-Namen, falls es einen unterstützt —, sonst funktioniert die Integration nicht mehr, sobald der Router die Adresse ändert. > > [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/) ## Integrationsanleitung Der Hunter Douglas PowerView Hub (in Europa, Australien und Teilen Asiens als **Luxaflex PowerView Hub** verkauft — identische Hardware) ist eine Smart-Home-Bridge, die motorisierte PowerView-Fensterbehänge mit IP-basierten Hausautomationssystemen verbindet. Der Hub betreibt auf der einen Seite das proprietäre 2,4-GHz-RF-Mesh-Netz von Hunter Douglas (das PowerView Shade Network mit gekoppelten Behängen und Repeatern) und stellt auf der anderen Seite eine lokale, unauthentifizierte HTTP-REST-API auf Port 80 bereit. TapHome kommuniziert mit dem Hub über diese lokale REST-API — für die Steuerung sind weder ein Cloud-Konto noch eine Internetverbindung erforderlich. Die Vorlage steuert die **Position der Hauptschiene** eines einzelnen PowerView-Behangs pro TapHome-Geräteinstanz; für die Steuerung mehrerer Behänge müssen mehrere `PowerView Slide`-Geräte unter derselben Schnittstelle angelegt werden, jedes mit eigener Shade-ID. > [!WARNING] > Diese Vorlage unterstützt ausschließlich **PowerView Hub (Gen 1)** und **PowerView Hub Gen 2**. Das neuere **PowerView 3 Gateway (Gen 3)** verwendet eine andere Architektur und stellt die gleiche lokale REST-API nicht bereit — es ist mit dieser Vorlage **nicht** kompatibel. Siehe den Gen-3-Hinweis am Ende dieser Seite. ## Unterstützte Geräte Die Vorlage stellt einen TapHome-Gerätetyp bereit: - **PowerView Slide** — Position der Hauptschiene (Behang) eines einzelnen PowerView-Behangs. Bildet den Hub-Bereich `0`–`65535` auf die TapHome-Jalousienkonvention `0`–`100 %` ab (invertiert, also `0` = offen und `100 %` = geschlossen auf der TapHome-Seite). Das PowerView Shade Network selbst ist mit 34+ Modellen motorisierter Behänge, Jalousien, Rollläden und Vorhänge aus den Produktlinien Hunter Douglas / Luxaflex kompatibel — Duette, Silhouette, Pirouette, Vignette, Rollos, Roman, Skyline Panels, Vorhänge, venezianische Jalousien und weitere. Sofern ein Behang in der PowerView-App mit dem Hub gekoppelt ist, kann er von TapHome über denselben Hauptschienen-Mechanismus angesteuert werden. ## Voraussetzungen Prüfen Sie vor dem Import der Vorlage in TapHome: - Der PowerView Hub ist mit Strom versorgt, per Ethernet (oder Wi-Fi bei Gen 2) mit dem LAN verbunden und die Front-LED signalisiert Normalbetrieb (**dauerhaft blau** bei Gen 1, entsprechend bei Gen 2). - Ihre Behänge sind bereits über die PowerView-App mit dem Hub gekoppelt — jeder Behang, den TapHome steuern soll, muss in der *Shades*-Liste der PowerView-App erscheinen. - Der Hub und die TapHome-Zentrale befinden sich im **selben lokalen Netzwerk** (kein NAT dazwischen). - Ein Webbrowser auf Ihrem Smartphone, Tablet oder Computer kann `http:///api/shades` öffnen und erhält eine JSON-Antwort. ## Konfiguration ### Schritt 1 — Statische IP-Adresse für den Hub vergeben Der Hub muss unter einer stabilen IP-Adresse erreichbar sein. Die PowerView-App verfügt über eine integrierte Static-IP-Einstellung — der empfohlene Weg, die Hub-Adresse zu fixieren. Alternativ können Sie am Router eine DHCP-Reservierung für die MAC-Adresse des Hubs anlegen. Öffnen Sie die PowerView-App und tippen Sie auf das **Menü-Symbol** oben links: ![PowerView-App Dashboard — Seitenmenü öffnen](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step1-menu_hu_64ee10340ed9b61.jpeg) Tippen Sie im Seitenmenü auf **Hub**: ![Seitenmenü der PowerView-App — Hub-Eintrag](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step2-hub_hu_fe0343b38db4b10f.jpeg) Tippen Sie unter *Connected Hub* auf Ihren Hub, um **Hub Info** zu öffnen: ![PowerView-App — Liste der Hubs](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step3-hub-info_hu_af1eb9afe01b1443.jpeg) Scrollen Sie nach unten zu **Static IP** und tippen Sie darauf: ![Hub-Info-Bildschirm der PowerView-App — Eintrag Static IP](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step4-static-ip_hu_aecb9512f80ee4bf.jpeg) Aktivieren Sie **Use Static IP** und tragen Sie passende Werte für *IP Address*, *Mask*, *Gateway* und *DNS* für Ihr Netzwerk ein: ![Static-IP-Bildschirm der PowerView-App — Schalter Use Static IP](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step5-enable_hu_18a6d986e0261c54.jpeg) > [!NOTE] > Static-IP-Einstellungen werden nur bei Hubs unterstützt, die per **Ethernet** mit dem Router verbunden sind. Ist der Hub per Wi-Fi verbunden, legen Sie stattdessen eine DHCP-Reservierung am Router an. ### Schritt 2 — Shade-IDs ermitteln Jeder Behang, der mit dem Hub gekoppelt ist, besitzt eine eindeutige numerische ID. Öffnen Sie die folgende URL in einem beliebigen Browser im selben Netzwerk: ``` http:///api/shades ``` Die Antwort ist ein JSON-Dokument; das `shadeIds`-Array listet alle dem Hub bekannten Behänge: ```json { "shadeIds": [ 7348, 14922, 30019 ] } ``` Notieren Sie die IDs der Behänge, die Sie aus TapHome steuern möchten. Ist nur ein Behang vorhanden, enthält das Array einen einzigen Wert. > [!TIP] > Um eine ID einem physischen Behang zuzuordnen, öffnen Sie `http:///api/shades/` — das Feld `name` enthält den lesbaren Namen des Behangs aus der PowerView-App (Base64-codiert; zum Lesen dekodieren). Alternativ ändern Sie in der PowerView-App nacheinander die Position jedes Behangs und beobachten, bei welcher ID sich `positions.position1` ändert. ### Schritt 3 — Packet-Parser-Schnittstelle in TapHome anlegen 1. Öffnen Sie in der TapHome-App **Einstellungen → Schnittstellen** und legen Sie entweder eine neue **Packet Parser**-Schnittstelle an oder öffnen Sie eine vorhandene. 2. Wählen Sie **Aus Vorlage hinzufügen** und dann **PowerView Hub**. 3. Tragen Sie die IP-Adresse des Hubs im Feld *IP-Adresse* ein (ersetzen Sie den Platzhalter `192.168.0.1`). 4. Lassen Sie *Internal poll interval* beim Standardwert `10000` ms (10 s), wenn kein konkreter Grund für eine Änderung besteht — schnelleres Polling verbessert die Reaktionszeit nicht und kann die RF-Leistung im Shade-Mesh verschlechtern. 5. Tippen Sie auf **Erstellen**. TapHome importiert ein `PowerView Slide`-Gerät für die Vorlage. Zu diesem Zeitpunkt ist das Gerät an den Hub gebunden, aber noch nicht an einen konkreten Behang. ### Schritt 4 — Shade-ID für jedes Slide-Gerät einstellen Öffnen Sie das erstellte `PowerView Slide`-Gerät in TapHome, navigieren Sie zu **Service Settings → Device ID** und tragen Sie die in Schritt 2 notierte Shade-ID ein. Speichern Sie die Einstellungen. Um weitere Behänge zu steuern, legen Sie weitere `PowerView Slide`-Geräte unter derselben Packet-Parser-Schnittstelle an und setzen auf jedem eine andere *Device ID*. > [!TIP] > Der Wert `SlideDeviceId` ist eine geräteweise Einstellung, nicht modulweit. Eine einzige Packet-Parser-Schnittstelle kann beliebig viele PowerView-Slide-Geräte ansteuern — dazwischen ändert sich nur die ID. ## Fehlerbehebung ### Behang-Position driftet nach Nutzung einer Fernbedienung Pebble-Fernbedienungen an Gen-1-/Gen-2-Hubs nutzen proprietäres Bluetooth LE und **melden die Behang-Position nicht an den Hub zurück**. Bewegt ein Nutzer einen Behang über die Pebble, wird die Cache-Position im Hub — die die Vorlage abfragt — veraltet, bis der nächste Bewegungsbefehl sie abgleicht. Dies ist eine Hardware-Einschränkung der Gen-1-/Gen-2-Plattform, nicht der TapHome-Vorlage. Ist präzises Positions-Feedback kritisch, steuern Sie Behänge konsequent über TapHome oder die PowerView-App. ### Hub liefert HTTP 423 "Hub busy for maintenance" Dies ist eine normale, vorübergehende Antwort, während der Hub interne Wartung durchführt (z. B. bei Szenen-Aktualisierungen oder Firmware-Prüfungen). Die Vorlage meldet den Fehler über `ADDERROR`, der nächste Poll-Zyklus gelingt jedoch in der Regel. Halten 423-Antworten an, starten Sie den Hub neu (Knopf **Reset** auf der Rückseite). ### Sekundäre Hubs sind in der PowerView-App nicht sichtbar Die PowerView-App listet in der Regel nur den Hub auf, der unter Ihrem Konto registriert ist. Sekundäre Hubs im selben PowerView Shade Network erscheinen in der Hub-Liste der App möglicherweise nicht, antworten aber dennoch im lokalen Netzwerk und akzeptieren dieselben REST-API-Aufrufe. TapHome kann sich über die IP-Adresse an einen sekundären Hub binden — Sichtbarkeit in der PowerView-App ist für die lokale HTTP-Steuerung nicht erforderlich. ### Keine Antwort unter `http:///api/shades` 1. Vergewissern Sie sich, dass die Front-LED Normalbetrieb signalisiert (dauerhaft blau bei Gen 1). Siehe LED-Tabelle im PowerView Hub Quick Start Guide. 2. Prüfen Sie die IP des Hubs in der PowerView-App (*Hub → Hub Info → IP Address*) und vergleichen Sie sie mit dem in TapHome eingetragenen Wert. 3. Pingen Sie den Hub von einem Gerät im selben VLAN an; der Hub darf gegenüber der TapHome-Zentrale nicht hinter NAT oder einer Firewall liegen. 4. Der Hub lauscht **ausschließlich auf HTTP-Port 80** — stellen Sie der URL kein `https://` voran. ## PowerView 3 Gateway (Gen 3) — nicht unterstützt Das neuere **PowerView 3 Gateway** von Hunter Douglas ist von Grund auf neu konzipiert: Es setzt auf Matter über Thread, ist cloud-zentriert und stellt nicht dieselbe lokale `/api/shades`-REST-Oberfläche bereit wie die Gen-1- und Gen-2-Hubs. Die TapHome-Packet-Parser-Vorlage auf dieser Seite **funktioniert daher nicht mit dem PowerView 3 Gateway** — ein Bindungsversuch liefert entweder HTML aus dem Web-UI des Gateways oder schlägt ganz fehl. Wenn Sie ein Gen-3-Gateway besitzen, ist der derzeit empfohlene Hunter-Douglas-seitige Migrationspfad, einen Gen-1- oder Gen-2-Hub parallel für Drittanbieter-Integrationen zu behalten oder auf eine Matter-basierte Behang-Unterstützung in zukünftiger TapHome-Firmware zu warten. ## Verfügbare Geräte 1 Diese Geräte erscheinen nach dem Import in TapHome. PowerView Hub Modul Benutzerdefinierte Variablen `SlideDeviceId` (numeric) = 1 PowerView-Shade-ID, die von diesem TapHome-Gerät angesprochen wird. Öffnen Sie http://{HubIP}/api/shades, um die shadeIds aufzulisten, und tragen Sie die gewählte ID in den Service Settings des TapHome-Slide-Geräts ein. 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. Behang Schieber Lesen und Schreiben Position der Hauptschiene (Behang) eines einzelnen PowerView-Behangs — bildet den Rohbereich 0–65535 des Hubs auf die TapHome-Jalousienkonvention 0–100 % ab (0 = offen, 100 % = geschlossen) numeric Einheit: % json\_path Jalousiestellung lesen ```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 ``` Jalousiestellung schreiben ```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"); ``` **Verbindung:** Packet Parser → HTTP Mögliche Verbesserungen (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. ## Importparameter Diese Werte geben Sie beim Import des XML ein. | In der App abgefragt | Standard | |------------------------|---------------| | IP-Adresse | `192.168.0.1` | | Internal poll interval | `10000` | ## Quellen - 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 Herstellerdokumente sind © ihrer jeweiligen Eigentümer. Sie werden so bereitgestellt, wie der Hersteller sie veröffentlicht hat, nur zur Information. ## Verwandte Dokumentation - [Packet-Parser-Integration](https://taphome.com/de/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/) - [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/) - [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)