TapHome

Hunter Douglas PowerView Hub

Packet Parser → HTTP
Inviato da
Ultimo aggiornamento: 06. 2026
Hunter Douglas PowerView Hub

L’Hunter Douglas PowerView Hub (commercializzato come Luxaflex PowerView Hub in Europa, Australia e parti dell’Asia — hardware identico) è un bridge smart home che collega le tende motorizzate PowerView ai sistemi di domotica IP. L’hub esegue da un lato la rete mesh RF proprietaria a 2,4 GHz di Hunter Douglas (la PowerView Shade Network con tende e ripetitori accoppiati) e dall’altro espone un’API HTTP REST locale non autenticata sulla porta 80.

TapHome comunica con l’hub tramite questa API REST locale — per il controllo non sono richiesti un account cloud né la connessione a internet. Il template pilota la posizione della guida principale di una singola tenda PowerView per istanza di dispositivo TapHome; per controllare più tende è necessario aggiungere più dispositivi PowerView Slide sotto la stessa interfaccia, ciascuno indirizzato dal proprio shade id.

Questo template supporta soltanto PowerView Hub (Gen 1) e PowerView Hub Gen 2. Il più recente PowerView 3 Gateway (Gen 3) utilizza un’architettura diversa e non espone la stessa API REST locale — non è compatibile con questo template. Vedi la nota sul Gen 3 in fondo a questa pagina.

Dispositivi supportati

Il template espone un tipo di dispositivo TapHome:

  • PowerView Slide — posizione della guida principale (tenda) di una singola tenda PowerView. Mappa il range 0–65535 dell’hub sulla convenzione TapHome per tapparelle 0–100 % (invertita, quindi 0 = aperto e 100 % = chiuso lato TapHome).

La PowerView Shade Network è compatibile con oltre 34 modelli di tende, veneziane, scuri e tendaggi motorizzati nelle gamme Hunter Douglas / Luxaflex — Duette, Silhouette, Pirouette, Vignette, tende avvolgibili, Roman, Skyline Panel, tendaggi, veneziane e altri. Finché una tenda è accoppiata all’hub nell’app PowerView, TapHome può pilotarla con lo stesso meccanismo della guida principale.

Prerequisiti

Prima di importare il template in TapHome, verifica:

  • Il PowerView Hub è alimentato, connesso alla LAN tramite Ethernet (o Wi-Fi su Gen 2) e il LED frontale indica il normale funzionamento (blu fisso su Gen 1, equivalente su Gen 2).
  • Le tende sono già accoppiate all’hub tramite l’app PowerView — ogni tenda che TapHome dovrà controllare deve comparire nell’elenco Shades dell’app PowerView.
  • Hub e centralina TapHome si trovano sulla stessa rete locale (senza NAT tra loro).
  • Un browser sul tuo smartphone, tablet o computer è in grado di aprire http://<HubIP>/api/shades e ricevere una risposta JSON.

Configurazione

Passo 1 — Assegnare un IP statico all’hub

L’hub deve essere raggiungibile a un indirizzo IP stabile. L’app PowerView dispone di un’impostazione integrata per l’IP statico — è il modo consigliato per fissare l’indirizzo dell’hub. In alternativa, crea una prenotazione DHCP sul router per il MAC dell’hub.

Apri l’app PowerView e tocca l’icona menu in alto a sinistra:

Dashboard app PowerView — apertura del menu laterale

Nel menu laterale tocca Hub:

Menu laterale app PowerView — voce Hub

In Connected Hub tocca il tuo hub per aprire Hub Info:

App PowerView — elenco degli hub

Scorri fino a Static IP in basso e toccalo:

Schermata Hub Info dell'app PowerView — voce Static IP

Attiva Use Static IP, quindi inserisci i valori di IP Address, Mask, Gateway e DNS adatti alla tua rete:

Schermata Static IP dell'app PowerView — interruttore Use Static IP

Le modifiche a IP statico sono supportate solo sugli hub collegati al router tramite Ethernet. Se l’hub è su Wi-Fi, crea invece una prenotazione DHCP direttamente sul router.

Passo 2 — Individuare gli ID delle tende

A ogni tenda accoppiata all’hub è associato un ID numerico univoco. Apri il seguente URL in un qualsiasi browser sulla stessa rete:

1

http://<HubIP>/api/shades

La risposta è un documento JSON; l’array shadeIds elenca tutti gli ID delle tende note all’hub:

1

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

Annota gli ID delle tende che vuoi controllare da TapHome. Se hai una sola tenda, l’array contiene un unico valore.

Per associare un ID alla tenda fisica, apri http://<HubIP>/api/shades/<id> — il campo name contiene il nome leggibile della tenda così come impostato nell’app PowerView (codificato in Base64; decodificalo per leggerlo). In alternativa, cambia la posizione di ciascuna tenda dall’app PowerView una alla volta e osserva quale ID ha positions.position1 che cambia.

Passo 3 — Creare l’interfaccia Packet Parser in TapHome
  1. Nell’app TapHome apri Impostazioni → Interfacce e crea una nuova interfaccia Packet Parser oppure apri una esistente.
  2. Seleziona Aggiungi da template e scegli PowerView Hub.
  3. Inserisci l’indirizzo IP dell’hub nel campo Indirizzo IP (sostituendo il segnaposto 192.168.0.1).
  4. Lascia Internal poll interval al valore predefinito 10000 ms (10 s) a meno che tu non abbia un motivo specifico per modificarlo — un polling più rapido non migliora la reattività e può peggiorare le prestazioni RF della rete delle tende.
  5. Tocca Crea.

TapHome importa un dispositivo PowerView Slide dal template. A questo punto il dispositivo è collegato all’hub ma non ancora a una tenda specifica.

Passo 4 — Impostare l’ID tenda su ciascun dispositivo Slide

Apri il dispositivo PowerView Slide creato in TapHome, vai in Service Settings → Device ID e inserisci l’ID tenda annotato al Passo 2. Salva le impostazioni.

Per controllare altre tende, aggiungi altri dispositivi PowerView Slide sotto la stessa interfaccia Packet Parser e imposta un Device ID diverso su ognuno.

Il valore SlideDeviceId è un’impostazione per dispositivo, non a livello di modulo. Una singola interfaccia Packet Parser può pilotare un numero qualsiasi di dispositivi PowerView Slide — tra di loro cambia solo l’ID.

Risoluzione dei problemi

La posizione della tenda va in drift dopo aver usato un telecomando

I telecomandi Pebble su hub Gen 1 / Gen 2 utilizzano Bluetooth LE proprietario e non riportano la posizione della tenda all’hub. Quando un utente muove una tenda con il Pebble, la posizione in cache dell’hub — che il template legge — rimane obsoleta fino al successivo comando di movimento che la riallinea. Si tratta di un limite hardware della piattaforma Gen 1 / Gen 2, non del template TapHome. Se il feedback di posizione accurato è critico, standardizza il movimento delle tende tramite TapHome o l’app PowerView.

L’hub restituisce HTTP 423 “Hub busy for maintenance”

È una risposta transitoria normale mentre l’hub esegue operazioni di manutenzione interna (per esempio aggiornamenti di scene o controlli firmware). Il template segnala l’errore tramite ADDERROR, ma il ciclo di polling successivo di solito va a buon fine. Se le risposte 423 persistono, riavvia l’hub (premi Reset sul retro).

Hub secondari non visibili nell’app PowerView

L’app PowerView di solito elenca solo l’hub registrato sul tuo account. Gli hub secondari sulla stessa PowerView Shade Network potrebbero non comparire nell’elenco degli hub dell’app, ma rispondono comunque sulla rete locale e accettano le stesse chiamate all’API REST. TapHome può legarsi a un hub secondario tramite il suo indirizzo IP — la visibilità nell’app PowerView non è richiesta per il controllo HTTP locale.

Nessuna risposta su http://<HubIP>/api/shades
  1. Verifica che il LED frontale indichi il funzionamento normale (blu fisso su Gen 1). Vedi la tabella dei LED nella PowerView Hub Quick Start Guide.
  2. Controlla l’IP dell’hub nell’app PowerView (Hub → Hub Info → IP Address) e che corrisponda a quanto inserito in TapHome.
  3. Fai ping all’hub da una macchina nella stessa VLAN; l’hub non deve essere dietro NAT o firewall rispetto alla centralina TapHome.
  4. L’hub ascolta solo sulla porta HTTP 80 — non anteporre https:// all’URL.

PowerView 3 Gateway (Gen 3) — non supportato

Il nuovo PowerView 3 Gateway di Hunter Douglas è una riprogettazione da zero: utilizza Matter su Thread, è cloud-first e non espone la stessa superficie REST locale /api/shades degli hub Gen 1 / Gen 2. Il template Packet Parser TapHome di questa pagina non funziona quindi con il PowerView 3 Gateway — il tentativo di collegamento restituirà l’HTML dell’UI web del gateway o fallirà del tutto.

Se possiedi un Gen 3 Gateway, la strada di migrazione lato Hunter Douglas attualmente consigliata è tenere in parallelo un hub Gen 1 / Gen 2 per le integrazioni di terze parti, oppure aspettare il supporto alle tende tramite Matter in un futuro firmware TapHome.

Dispositivi disponibili

PowerView Hub Modulo
Variabili personalizzate
SlideDeviceId (numeric) = 1ID della tenda PowerView indirizzata da questo dispositivo TapHome. Apri http://{HubIP}/api/shades per elencare gli shadeIds e incolla l'ID scelto nei Service Settings del dispositivo TapHome Slide.
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.
Tenda Cursore

Posizione della guida principale (tenda) di una singola tenda PowerView — mappa il range grezzo 0–65535 dell'hub sulla convenzione TapHome per tapparelle 0–100 % (0 = aperto, 100 % = chiuso)

numeric Unità: % json_path

Tenda

Lettura livello tapparella
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
Scrittura livello tapparella
VAR pos := ROUND((1 - Bl) * 65535);
VAR contentJson := "{\"shade\": { \"positions\": { \"posKind1\": 1, \"position1\":" + pos + "}}}";

SENDHTTPREQUEST("/api/shades/" + SlideDeviceId, "PUT", contentJson, "Content-Type:application/json");
Connessione: Packet Parser → HTTP
Possibili miglioramenti (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.

Fonti

Hai trovato un problema con questo template?

Dicci cosa non funziona, cosa manca o come dovrebbe comportarsi il template. Il tuo feedback ci aiuta a mantenere il catalogo accurato.

Verificato da TapHome

Vuoi usarlo nel tuo TapHome Core?

Apri questo template nel Customer Portal per applicarlo a una delle tue case, o crea una proposta di modifica e inviala al catalogo.

Apri nel portale