TapHome

Hunter Douglas PowerView Hub

Packet Parser → HTTP
Trimis de
Ultima actualizare: 04. 2026
Hunter Douglas PowerView Hub

Hunter Douglas PowerView Hub (vândut ca Luxaflex PowerView Hub în Europa, Australia și în unele părți ale Asiei — hardware identic) este o punte smart home care conectează storurile motorizate PowerView la sistemele de automatizare a casei bazate pe IP. Pe de o parte, hubul gestionează rețeaua RF mesh proprietară Hunter Douglas de 2,4 GHz (PowerView Shade Network cu storurile asociate și repetoarele), iar pe de altă parte oferă un API HTTP REST local, fără autentificare, pe portul 80.

TapHome comunică cu hubul prin acest API REST local — pentru control nu este nevoie nici de cont în cloud, nici de conexiune la internet. Șablonul controlează poziția șinei principale a unui singur stor PowerView pentru fiecare instanță de dispozitiv TapHome; pentru controlul mai multor storuri trebuie adăugate mai multe dispozitive PowerView Slide sub aceeași interfață, fiecare adresat prin propriul ID de stor.

Acest șablon acceptă doar PowerView Hub (Gen 1) și PowerView Hub Gen 2. Noul PowerView 3 Gateway (Gen 3) folosește o arhitectură diferită și nu oferă același API REST local — nu este compatibil cu acest șablon. Consultați nota despre Gen 3 de la sfârșitul acestei pagini.

Dispozitive acceptate

Șablonul oferă un singur tip de dispozitiv TapHome:

  • PowerView Slide — poziția șinei principale (a storului) pentru un singur stor PowerView. Convertește scala de poziție 0–65535 a hubului în convenția TapHome pentru jaluzele 0–100 % (inversată, astfel încât 0 = deschis și 100 % = închis în TapHome).

Rețeaua PowerView Shade Network este compatibilă cu cel puțin 34 de modele de storuri, jaluzele, obloane și draperii motorizate din liniile de produse Hunter Douglas / Luxaflex — Duette, Silhouette, Pirouette, Vignette, Roller, Roman, Skyline Panels, Curtains, Venetians și altele. Dacă un stor este asociat cu hubul în aplicația PowerView, TapHome îl poate controla prin același mecanism al șinei principale.

Cerințe preliminare

Înainte de a importa șablonul în TapHome, verificați următoarele:

  • PowerView Hub este alimentat, conectat la rețeaua LAN prin Ethernet (sau prin Wi-Fi la Gen 2), iar LED-ul frontal indică funcționarea normală (albastru continuu la Gen 1, starea echivalentă la Gen 2).
  • Storurile sunt deja asociate cu hubul prin aplicația PowerView — fiecare stor pe care trebuie să-l controleze TapHome trebuie să apară în lista Shades din aplicația PowerView.
  • Hubul și controlerul TapHome sunt în aceeași rețea locală (fără NAT între ele).
  • Un browser web de pe telefon, tabletă sau computer poate deschide http://<HubIP>/api/shades și primește un răspuns JSON.

Configurare

Pasul 1 — Atribuiți hubului o adresă IP statică

Hubul trebuie să fie accesibil la o adresă IP stabilă. Aplicația PowerView are o setare integrată pentru IP static, care este metoda recomandată pentru fixarea adresei hubului — alternativ, creați în router o rezervare DHCP pentru adresa MAC a hubului.

Deschideți aplicația PowerView și atingeți pictograma de meniu din colțul din stânga sus:

Dashboard-ul aplicației PowerView — deschiderea meniului lateral

În meniul lateral, atingeți Hub:

Meniul lateral al aplicației PowerView — opțiunea Hub

La Connected Hub, atingeți hubul dvs. pentru a deschide Hub Info:

Aplicația PowerView — lista huburilor

Derulați până la Static IP în partea de jos și atingeți opțiunea:

Ecranul Hub Info din aplicația PowerView — opțiunea Static IP

Activați Use Static IP, apoi introduceți valorile IP Address, Mask, Gateway și DNS care corespund rețelei dvs.:

Ecranul Static IP din aplicația PowerView — comutatorul Use Static IP

Setarea IP-ului static este acceptată doar la huburile conectate la router prin Ethernet. Dacă hubul este conectat prin Wi-Fi, creați în schimb o rezervare DHCP în router.

Pasul 2 — Aflați ID-urile storurilor

Fiecare stor asociat cu hubul are un ID numeric unic. Deschideți următoarea adresă URL în orice browser din aceeași rețea:

1

http://<HubIP>/api/shades

Răspunsul este un document JSON; matricea shadeIds conține toate storurile cunoscute de hub:

1

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

Notați ID-urile storurilor pe care doriți să le controlați din TapHome. Dacă aveți un singur stor, matricea conține o singură valoare.

Pentru a asocia un ID cu un stor fizic, deschideți http://<HubIP>/api/shades/<id> — câmpul name conține numele storului din aplicația PowerView (codificat Base64; decodificați-l pentru a-l citi). Alternativ, schimbați pe rând poziția fiecărui stor din aplicația PowerView și urmăriți la care ID se schimbă positions.position1.

Pasul 3 — Creați interfața Packet Parser în TapHome
  1. În aplicația TapHome, deschideți Setări → Interfețe și creați o interfață nouă Packet Parser sau deschideți una existentă.
  2. Alegeți Adăugați din șablon și selectați PowerView Hub.
  3. Introduceți adresa IP a hubului în câmpul IP address (în locul valorii provizorii 192.168.0.1).
  4. Lăsați Internal poll interval la valoarea implicită 10000 ms (10 s), dacă nu aveți un motiv anume să o schimbați — o interogare mai rapidă nu îmbunătățește timpul de răspuns și poate înrăutăți performanța RF a rețelei mesh a storurilor.
  5. Atingeți Creați.

TapHome importă un dispozitiv PowerView Slide pentru șablon. În acest moment, dispozitivul este legat de hub, dar încă nu de un anumit stor.

Pasul 4 — Setați ID-ul storului pe fiecare dispozitiv Slide

Deschideți dispozitivul PowerView Slide creat în TapHome, mergeți la Setări de service → Device ID și introduceți ID-ul storului notat la Pasul 2. Salvați setările.

Pentru a controla și alte storuri, adăugați mai multe dispozitive PowerView Slide sub aceeași interfață Packet Parser și setați pe fiecare un alt Device ID.

Valoarea SlideDeviceId este o setare a fiecărui dispozitiv, nu a întregului modul. O singură interfață Packet Parser poate controla oricâte dispozitive PowerView Slide — dispozitivele diferă doar prin ID.

Depanare

Poziția storului se decalează după folosirea telecomenzii

Telecomenzile Pebble pentru huburile Gen 1 / Gen 2 folosesc Bluetooth LE proprietar și nu raportează poziția storului înapoi către hub. Când utilizatorul mișcă un stor cu telecomanda Pebble, poziția memorată în hub — pe care o citește șablonul — rămâne neactualizată până când următoarea comandă de mișcare o sincronizează. Aceasta este o limitare hardware a platformei Gen 1 / Gen 2, nu a șablonului TapHome. Dacă feedbackul precis al poziției este esențial, mișcați storurile doar prin TapHome sau prin aplicația PowerView.

Hubul returnează HTTP 423 „Hub busy for maintenance”

Acesta este un răspuns temporar normal, cât timp hubul efectuează întreținerea internă (de exemplu la actualizarea scenelor sau la verificarea firmware-ului). Șablonul semnalează eroarea prin ADDERROR, dar următorul ciclu de interogare reușește de obicei. Dacă răspunsurile 423 persistă, reporniți hubul (apăsați Reset pe partea din spate).

Huburile secundare nu sunt vizibile în aplicația PowerView

Aplicația PowerView afișează de obicei doar hubul înregistrat în contul dvs. Huburile secundare din aceeași rețea PowerView Shade Network pot să nu apară în lista de huburi a aplicației, dar ele răspund în continuare în rețeaua locală și acceptă aceleași apeluri API REST. TapHome se poate conecta la un hub secundar prin adresa lui IP — pentru controlul local prin HTTP nu este necesar ca hubul să fie vizibil în aplicația PowerView.

Niciun răspuns la http://<HubIP>/api/shades
  1. Verificați că LED-ul de pe panoul frontal indică funcționarea normală (albastru continuu la Gen 1). Consultați tabelul LED-urilor din ghidul de pornire rapidă PowerView Hub Quick Start Guide.
  2. Verificați adresa IP a hubului în aplicația PowerView (Hub → Hub Info → IP Address) și dacă aceasta corespunde celei introduse în TapHome.
  3. Dați ping hubului de pe un computer din același VLAN; hubul nu trebuie să fie în spatele unui NAT sau al unui firewall față de controlerul TapHome.
  4. Hubul ascultă doar pe portul HTTP 80 — nu folosiți prefixul https:// în adresa URL.

PowerView 3 Gateway (Gen 3) — nu este acceptat

Noul PowerView 3 Gateway de la Hunter Douglas a fost reproiectat de la zero: folosește Matter over Thread, funcționează în primul rând prin cloud și nu oferă aceeași interfață REST locală /api/shades ca huburile Gen 1 / Gen 2. Prin urmare, șablonul TapHome Packet Parser de pe această pagină nu funcționează cu PowerView 3 Gateway — o încercare de conectare fie returnează HTML din interfața web a gateway-ului, fie eșuează complet.

Dacă aveți un Gateway Gen 3, soluția actuală de migrare din partea Hunter Douglas este să păstrați în paralel un hub Gen 1 / Gen 2 pentru integrările terțe sau să așteptați suportul pentru jaluzele bazate pe Matter într-un firmware TapHome viitor.

Dispozitive disponibile

PowerView Hub Modul
Variabile personalizate
SlideDeviceId (numeric) = 1ID-ul storului PowerView adresat de acest dispozitiv TapHome. Deschideți http://{HubIP}/api/shades pentru lista shadeIds și introduceți ID-ul ales în setările de service ale dispozitivului 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.
Stor Glisare

Poziția șinei principale (a storului) pentru un singur stor PowerView — convertește scala brută 0–65535 a hubului în convenția TapHome pentru jaluzele 0–100 % (0 = deschis, 100 % = închis)

numeric Unitate: % json_path

Stor

Citirea nivelului jaluzelei
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
Scrierea nivelului jaluzelei
VAR pos := ROUND((1 - Bl) * 65535);
VAR contentJson := "{\"shade\": { \"positions\": { \"posKind1\": 1, \"position1\":" + pos + "}}}";

SENDHTTPREQUEST("/api/shades/" + SlideDeviceId, "PUT", contentJson, "Content-Type:application/json");
Conexiune: Packet Parser → HTTP
Îmbunătățiri posibile (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.

Surse

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal