DenonDenon discovery je mali pomoćni predložak za proizvode Denon HEOS. Ne pretražuje mrežu u potrazi za uređajima: spaja se na jedan reproduktor HEOS na IP adresi upisanoj pri uvozu, od sučelja HEOS CLI (Command Line Interface) traži popis reproduktora u sustavu HEOS i sprema ID reproduktora (pid) prvog reproduktora s tog popisa. Naredbe za reproduktore u sučelju HEOS CLI (heos://player/...) adresiraju reproduktor upravo tim pid-om.
Predložak sadrži jedan modul s jednom varijablom, Denon player id. Nema upravljanja glasnoćom, isključivanjem zvuka ni reprodukcijom.
Predložak uvijek čita prvi unos s popisa reproduktora (
payload[0].pid). U sustavu HEOS s više reproduktora prikazuje samo taj jedanpid. Specifikacija HEOS CLI ne definira redoslijed popisa, pa prvi unos nije nužno zvučnik čija je IP adresa upisana.
Potpuno upravljanje reproduktorom HEOS i odabir reproduktora s popisa prema indeksu (servisne radnje Get Players i Set Player Id) nudi glavni predložak Denon HEOS. Denon discovery samo čita pid.
Priprema uređaja HEOS
HEOS CLI dio je firmvera HEOS: na uređaju ne treba ništa uključivati i nije potreban dodatni hardver. Predložak je izrađen za HEOS CLI v1.17, što odgovara verziji HEOS 2.41.140.
- Instalirajte HEOS App (Android / iOS) na telefon ili tablet u istoj mreži i dovršite početno postavljanje uređaja HEOS kako bi bio spojen na Wi-Fi ili Ethernet. CLI nije dostupan dok se to postavljanje ne završi.
- Pronađite IP adresu uređaja HEOS: u aplikaciji HEOS pod Settings → My Devices → About ili na popisu DHCP klijenata u usmjerivaču. Proizvodi HEOS oglašavaju se u lokalnoj mreži i preko UPnP SSDP (search target
urn:schemas-denon-com:device:ACT-Denon:1). - Rezervirajte tu adresu u usmjerivaču (DHCP rezervacija) ili postavite statičku IP adresu, kako se ne bi promijenila nakon obnove DHCP-a.
- Provjerite može li centralna jedinica Core doći do uređaja HEOS na TCP portu 1255: ista lokalna mreža ili usmjerena podmreža, bez vatrozida koji blokira port.
Dovoljan je jedan uređaj HEOS: veza s jednim zvučnikom HEOS daje pristup svim reproduktorima HEOS u mreži, pa get_players vraća sve.
HEOS CLI nema vlastitu prijavu. Svaki uređaj koji može doći do TCP porta 1255 može slati naredbe sustavu HEOS. Proizvode HEOS držite u pouzdanom segmentu mreže.
Konfiguracija
Pri uvozu u sučelje Packet Parser u aplikaciji TapHome upišite IP adresu uređaja HEOS u parametar IP adresa. Port i okviri poruka već su postavljeni u predlošku.
| Postavka | Vrijednost |
|---|---|
| Prijenos | TCP, port 1255 |
| Graničnik poruke | \r\n za naredbe i odgovore |
| Veza | otvara se za svako očitavanje i ne ostaje otvorena (StayConnected isključeno) |
| Interval očitavanja | 15 s |
| Poslana naredba | heos://player/get_players |
| Spremljena vrijednost | payload[0].pid iz JSON odgovora |
Odgovor na get_players je JSON objekt sa zaglavljem heos (command, result, message) i poljem payload s jednim unosom za svaki reproduktor. Svaki unos sadrži name, pid, model, version i network (wired ili wifi), zatim lineout te, ovisno o uređaju, gid (samo kad je reproduktor dio grupe), control i serial. Predložak zadržava samo pid prvog unosa.
Mogućnosti uređaja
Denon player id
Denon player id je varijabla koja sadrži ID reproduktora HEOS očitan iz prvog unosa odgovora na get_players. Osvježava se svakih 15 sekundi, pa prati sustav HEOS kad se popis promijeni. Predložak za ovu varijablu nema skriptu za upis: namijenjena je samo čitanju.
Vrijednost se može koristiti svugdje gdje je potreban HEOS pid, na primjer kad se naredba heos://player/* šalje iz drugog modula Packet Parser. Kad se koristi potpuni predložak Denon HEOS, ovaj pomoćni predložak nije potreban: njegove servisne radnje Get Players i Set Player Id već prikazuju popis reproduktora i povezuju modul s odabranim reproduktorom.
Rješavanje problema
Denon player id ostaje prazan nakon uvoza
Zvučnik HEOS drži CLI u stanju mirovanja i pokreće ga tek kad stigne prva TCP veza. Odmah nakon toga CLI možda još ne može odgovarati na naredbe za reproduktore, jer najprije mora pronaći sve reproduktore u mreži. Pričekajte nekoliko ciklusa očitavanja (svaki traje 15 s). Budući da ovaj predložak zatvara vezu nakon svakog očitavanja, CLI se između očitavanja može vratiti u stanje mirovanja; zato i prva očitavanja nakon duže stanke mogu ostati prazna.
Ako se vrijednost nikad ne pojavi, provjerite:
- Pripada li IP adresa u modulu i dalje uređaju HEOS (DHCP rezervacija ili statička IP adresa).
- Je li TCP port 1255 dostupan s centralne jedinice Core: ista lokalna mreža, bez vatrozida između njih.
- Je li uređaj HEOS potpuno na mreži u aplikaciji HEOS.
Vrijednost pripada drugom zvučniku
Predložak sprema pid prvog reproduktora s popisa, a to nije nužno zvučnik na upisanoj IP adresi. Kad imate više reproduktora HEOS, koristite glavni predložak Denon HEOS: njegova servisna radnja Get Players prikazuje cijeli popis (naziv, pid, model), a Set Player Id odabire reproduktor prema indeksu koji se broji od 0.
Promijenio se pid
HEOS dodjeljuje vrijednosti pid reproduktorima u mreži. Ako je zvučnik vraćen na tvorničke postavke ili zamijenjen, može dobiti novi pid. Denon player id prikazuje novu vrijednost pri sljedećem očitavanju, ali vrijednost prepisanu negdje drugdje treba ručno ažurirati.
