TapHome

Hunter Douglas PowerView Hub

Packet Parser → HTTP
Eingereicht von
Zuletzt aktualisiert: 06. 2026
Hunter Douglas PowerView Hub

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.

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

Tippen Sie im Seitenmenü auf Hub:

Seitenmenü der PowerView-App — Hub-Eintrag

Tippen Sie unter Connected Hub auf Ihren Hub, um Hub Info zu öffnen:

PowerView-App — Liste der Hubs

Scrollen Sie nach unten zu Static IP und tippen Sie darauf:

Hub-Info-Bildschirm der PowerView-App — Eintrag Static IP

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

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:

1

http://<HubIP>/api/shades

Die Antwort ist ein JSON-Dokument; das shadeIds-Array listet alle dem Hub bekannten Behänge:

1

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

Um eine ID einem physischen Behang zuzuordnen, öffnen Sie http://<HubIP>/api/shades/<id> — 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.

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

PowerView Hub Modul
Benutzerdefinierte Variablen
SlideDeviceId (numeric) = 1PowerView-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

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

Behang

Jalousiestellung lesen
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
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.

Quellen

Haben Sie ein Problem mit dieser Gerätevorlage gefunden?

Sagen Sie uns, was nicht funktioniert, was fehlt oder wie sich die Vorlage verhalten sollte. Ihr Feedback hilft uns, den Katalog genau zu halten.

Von TapHome verifiziert

Möchtest du das in deinem TapHome Core verwenden?

Öffne diese Vorlage im Kundenportal, um sie auf eine deiner Wohnungen anzuwenden, oder entwirf eine Anpassung und reiche sie an den Katalog ein.

Im Portal öffnen