TapHome

Hunter Douglas PowerView Hub

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 04. 2026
Hunter Douglas PowerView Hub

Hunter Douglas PowerView Hub (u Europi, Australiji i dijelovima Azije prodaje se kao Luxaflex PowerView Hub, s istim hardverom) je most za pametnu kuću koji povezuje motorizirane zastore PowerView sa sustavima automatizacije kuće temeljenima na IP-u. Hub s jedne strane koristi vlasničku 2,4 GHz RF mesh mrežu tvrtke Hunter Douglas (PowerView Shade Network s uparenim zastorima i repetitorima), a s druge strane daje lokalni HTTP REST API bez autentifikacije na portu 80.

TapHome s hubom komunicira preko tog lokalnog REST API-ja: za upravljanje nisu potrebni korisnički račun u oblaku ni internetska veza. Predložak upravlja položajem glavne letvice jednog zastora PowerView po jednoj instanci uređaja TapHome. Za upravljanje većim brojem zastora potrebno je pod istim sučeljem dodati više uređaja PowerView Slide, svaki s vlastitim ID-om zastora.

Ovaj predložak podržava samo PowerView Hub (Gen 1) i PowerView Hub Gen 2. Noviji PowerView 3 Gateway (Gen 3) ima drugačiju arhitekturu i ne daje isti lokalni REST API, pa nije kompatibilan s ovim predloškom. Pogledajte napomenu o Gen 3 na dnu ove stranice.

Podržani uređaji

Predložak daje jednu vrstu uređaja TapHome:

  • PowerView Slide — položaj glavne letvice (zastora) za jedan zastor PowerView. Skalu položaja huba 0–65535 preslikava na konvenciju sustava TapHome za žaluzine 0–100 % (obrnuto, pa je na strani sustava TapHome 0 = otvoreno, a 100 % = zatvoreno).

Sama mreža PowerView Shade Network kompatibilna je s najmanje 34 modela motoriziranih zastora, žaluzina, roleta i zavjesa iz linija proizvoda Hunter Douglas / Luxaflex: Duette, Silhouette, Pirouette, Vignette, Roller, Roman, Skyline Panels, Curtains, Venetians i drugi. Ako je zastor uparen s hubom u aplikaciji PowerView, TapHome njime može upravljati istim mehanizmom glavne letvice.

Preduvjeti

Prije uvoza predloška u TapHome provjerite sljedeće:

  • PowerView Hub je pod napajanjem, spojen na lokalnu mrežu Ethernetom (ili Wi-Fi-jem kod Gen 2), a prednja LED dioda je u stanju normalnog rada (stalno plavo kod Gen 1, odgovarajuće stanje kod Gen 2).
  • Vaši zastori već su upareni s hubom u aplikaciji PowerView: svaki zastor kojim TapHome treba upravljati mora se pojaviti na popisu Shades u aplikaciji PowerView.
  • Hub i centralna jedinica Core nalaze se u istoj lokalnoj mreži (bez NAT-a između njih).
  • Web preglednik na vašem telefonu, tabletu ili računalu može otvoriti http://<HubIP>/api/shades i vraća JSON odgovor.

Konfiguracija

Korak 1 — Dodijelite hubu statičku IP adresu

Hub mora biti dostupan na stabilnoj IP adresi. Aplikacija PowerView ima ugrađenu postavku statičke IP adrese, što je preporučeni način da se adresa huba fiksira. Druga je mogućnost da u usmjerivaču napravite DHCP rezervaciju za MAC adresu huba.

Otvorite aplikaciju PowerView i dodirnite ikonu izbornika u gornjem lijevom kutu:

Dashboard aplikacije PowerView — otvaranje bočnog izbornika

U bočnom izborniku dodirnite Hub:

Bočni izbornik aplikacije PowerView — stavka Hub

Pod Connected Hub dodirnite svoj hub kako biste otvorili Hub Info:

Aplikacija PowerView — popis hubova

Pomaknite se do stavke Static IP na dnu i dodirnite je:

Zaslon Hub Info u aplikaciji PowerView — stavka Static IP

Uključite Use Static IP, a zatim unesite vrijednosti IP Address, Mask, Gateway i DNS koje odgovaraju vašoj mreži:

Zaslon Static IP u aplikaciji PowerView — preklopnik Use Static IP

Postavljanje statičke IP adrese podržano je samo na hubovima spojenima na usmjerivač Ethernetom. Ako je hub na Wi-Fi-ju, umjesto toga napravite DHCP rezervaciju u usmjerivaču.

Korak 2 — Pronađite ID-ove zastora

Svaki zastor uparen s hubom ima jedinstveni brojčani ID. U bilo kojem pregledniku u istoj mreži otvorite sljedeći URL:

1

http://<HubIP>/api/shades

Odgovor je JSON dokument; polje shadeIds navodi sve zastore poznate hubu:

1

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

Zabilježite ID-ove zastora kojima želite upravljati iz sustava TapHome. Ako imate samo jedan zastor, polje sadrži jednu vrijednost.

Da biste ID povezali s fizičkim zastorom, otvorite http://<HubIP>/api/shades/<id>: polje name sadrži čitljivi naziv zastora iz aplikacije PowerView (kodiran u Base64; za čitanje ga dekodirajte). Druga je mogućnost da u aplikaciji PowerView mijenjate položaj jednog po jednog zastora i pratite kojem se ID-u mijenja positions.position1.

Korak 3 — Napravite sučelje Packet Parser u sustavu TapHome
  1. U aplikaciji TapHome otvorite Postavke → Sučelja i napravite novo sučelje Packet Parser ili otvorite postojeće.
  2. Odaberite Dodaj iz predloška i zatim PowerView Hub.
  3. U polje IP adresa unesite IP adresu huba (umjesto zamjenske vrijednosti 192.168.0.1).
  4. Interni interval očitavanja ostavite na zadanih 10000 ms (10 s), osim ako imate konkretan razlog za njegovu promjenu: brže očitavanje ne poboljšava odziv i može pogoršati RF performanse mesh mreže zastora.
  5. Dodirnite Napravite.

TapHome za predložak uvozi jedan uređaj PowerView Slide. U tom trenutku uređaj je povezan s hubom, ali još ne s određenim zastorom.

Korak 4 — Postavite ID zastora na svakom uređaju Slide

U sustavu TapHome otvorite napravljeni uređaj PowerView Slide, idite na Servisne postavke → Device ID i unesite ID zastora koji ste zabilježili u koraku 2. Spremite postavke.

Za upravljanje dodatnim zastorima dodajte pod isto sučelje Packet Parser još uređaja PowerView Slide i na svakom postavite drugi Device ID.

Vrijednost SlideDeviceId je postavka pojedinog uređaja, a ne cijelog modula. Jedno sučelje Packet Parser može upravljati bilo kojim brojem uređaja PowerView Slide: među njima se mijenja samo ID.

Rješavanje problema

Položaj zastora odstupa nakon upotrebe daljinskog upravljača

Daljinski upravljači Pebble kod hubova Gen 1 / Gen 2 koriste vlasnički Bluetooth LE i hubu ne javljaju položaj zastora. Kada korisnik pomakne zastor upravljačem Pebble, položaj spremljen u hubu (koji predložak čita) zastarijeva sve do sljedeće naredbe za pomicanje koja ga uskladi. To je hardversko ograničenje platforme Gen 1 / Gen 2, a ne predloška TapHome. Ako je točna povratna informacija o položaju ključna, zastore dosljedno pomičite preko sustava TapHome ili aplikacije PowerView.

Hub vraća HTTP 423 „Hub busy for maintenance”

To je normalan privremeni odgovor dok hub obavlja interno održavanje (na primjer tijekom ažuriranja scena ili provjere firmvera). Predložak pogrešku prijavljuje preko ADDERROR, ali sljedeći ciklus očitavanja obično uspije. Ako se odgovori 423 nastave, ponovno pokrenite hub (pritisnite Reset na stražnjoj strani).

Sekundarni hubovi nisu vidljivi u aplikaciji PowerView

Aplikacija PowerView obično prikazuje samo hub registriran na vaš račun. Sekundarni hubovi u istoj mreži PowerView Shade Network možda se neće pojaviti na popisu hubova u aplikaciji, ali i dalje odgovaraju u lokalnoj mreži i prihvaćaju iste pozive REST API-ja. TapHome se može povezati sa sekundarnim hubom preko njegove IP adrese: vidljivost u aplikaciji PowerView nije potrebna za lokalno upravljanje preko HTTP-a.

Nema odgovora na http://<HubIP>/api/shades
  1. Provjerite pokazuje li LED dioda na prednjoj ploči normalan rad (stalno plavo kod Gen 1). Pogledajte tablicu LED indikacija u vodiču PowerView Hub Quick Start Guide.
  2. Provjerite IP adresu huba u aplikaciji PowerView (Hub → Hub Info → IP Address) i odgovara li onoj koju ste unijeli u TapHome.
  3. Pingajte hub s računala u istom VLAN-u; hub ne smije biti iza NAT-a ili vatrozida u odnosu na centralnu jedinicu Core.
  4. Hub sluša samo na HTTP portu 80: ne stavljajte https:// ispred URL-a.

PowerView 3 Gateway (Gen 3) — nije podržan

Noviji PowerView 3 Gateway tvrtke Hunter Douglas potpuno je nova konstrukcija: koristi Matter preko Threada, prvenstveno se oslanja na oblak i ne daje isto lokalno REST sučelje /api/shades kao hubovi Gen 1 / Gen 2. Predložak TapHome Packet Parser na ovoj stranici zato ne radi s pristupnikom PowerView 3 Gateway: pokušaj povezivanja vratit će HTML web-sučelja pristupnika ili odmah neće uspjeti.

Ako imate Gen 3 Gateway, Hunter Douglas trenutačno nudi dvije mogućnosti: za integracije s drugim sustavima usporedno zadržati hub Gen 1 / Gen 2 ili pričekati podršku za žaluzine s protokolom Matter u budućem firmveru TapHome.

Dostupni uređaji

PowerView Hub Modul
Prilagođene varijable
SlideDeviceId (numeric) = 1ID zastora PowerView kojim upravlja ovaj uređaj TapHome. Otvorite http://{HubIP}/api/shades za popis shadeIds i odabrani ID upišite u Servisne postavke uređaja Slide u sustavu TapHome.
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.
Zastor Roleta

Položaj glavne letvice (zastora) za jedan zastor PowerView — preslikava izvornu skalu huba 0–65535 na konvenciju sustava TapHome za žaluzine 0–100 % (0 = otvoreno, 100 % = zatvoreno)

numeric Jedinica: % json_path

Zastor

Čitanje položaja žaluzine
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
Zapis položaja žaluzine
VAR pos := ROUND((1 - Bl) * 65535);
VAR contentJson := "{\"shade\": { \"positions\": { \"posKind1\": 1, \"position1\":" + pos + "}}}";

SENDHTTPREQUEST("/api/shades/" + SlideDeviceId, "PUT", contentJson, "Content-Type:application/json");
Povezivanje: Packet Parser → HTTP
Moguća poboljšanja (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.

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu