---
title: "Hunter Douglas PowerView Hub"
description: "Upravljanje motoriziranim zastorima i žaluzinama PowerView preko lokalnog HTTP-a. Predložak TapHome za Hunter Douglas / Luxaflex PowerView Hub Gen 1 i 2."
url: "https://taphome.com/hr/compatibility/powerview-hub/"
language: hr
lastmod: 2026-04-23
generator: hugo
ai:
  topics: ["http","gateway","blinds","shades","rf-mesh","local-api"]
  questions: ["Kako integrirati Hunter Douglas PowerView Hub sa sustavom TapHome?","Podržava li TapHome motorizirane zastore Luxaflex PowerView?","Kako pronaći ID zastora PowerView za TapHome?","Podržava li TapHome pristupnik PowerView 3 Gateway?","Kako dodijeliti statičku IP adresu uređaju PowerView Hub?","Zašto položaj mojeg zastora PowerView odstupa nakon pomicanja daljinskim upravljačem Pebble?"]
---

# Hunter Douglas PowerView Hub

Komunikacija: Packet Parser → HTTP

- [Hunter Douglas PowerView Hub — česta pitanja o proizvodu](https://www.hunterdouglas.com/faqs/powerview-hub)
- [Hunter Douglas PowerView motorizacija — pregled](https://www.hunterdouglas.com/operating-systems/powerview-motorization)

> Adresa u mreži
> 
> TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Hunter Douglas PowerView Hub (u Europi, Australiji i dijelovima Azije prodaje se kao **Luxaflex PowerView Hub**, s istim hardverom) je smart home most 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.

> [!WARNING]
> 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](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step1-menu_hu_64ee10340ed9b61.jpeg)

U bočnom izborniku dodirnite **Hub**:

![Bočni izbornik aplikacije PowerView — stavka Hub](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step2-hub_hu_fe0343b38db4b10f.jpeg)

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

![Aplikacija PowerView — popis hubova](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step3-hub-info_hu_af1eb9afe01b1443.jpeg)

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

![Zaslon Hub Info u aplikaciji PowerView — stavka Static IP](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step4-static-ip_hu_aecb9512f80ee4bf.jpeg)

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](https://taphome.com/images/compatibility/powerview-hub/app-static-ip-step5-enable_hu_18a6d986e0261c54.jpeg)

> [!NOTE]
> 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:

```
http://<HubIP>/api/shades
```

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

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

> [!TIP]
> 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*.

> [!TIP]
> 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 1

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

PowerView Hub Modul

Prilagođene varijable

`SlideDeviceId` (numeric) = 1 ID 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 Čitanje i pisanje

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

Čitanje položaja žaluzine

```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
```

Zapis položaja žaluzine

```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");
```

**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.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji   | Zadano        |
|------------------------|---------------|
| IP adresa              | `192.168.0.1` |
| Internal poll interval | `10000`       |

## Izvori

- 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

Dokumenti proizvođača zaštićeni su autorskim pravom (©) svojih vlasnika. Dostupni su onako kako ih je proizvođač objavio, samo za informaciju.

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

