Pár lakásos Doorbird kaputelefonok integrációja

Bevezetés:

Ebben a cikkben a Doordbird típusú kaputelefonok beállításáról lesz szó, főként a kültéri egységek integrálásáról a Chameleon rendszerbe.

A Chameleon által jól támogatott kaputelefonok közül a Doorbird készülékek a prémiumabb kategóriát képviselik. Jól integrálhatóak, van webes konfigurációs lehetőségük (https://webadmin.doorbird.com/login), és alternatívaként van saját applikációjuk is, ha valamiért a Chameleon kaputelefonos megoldása nem lenne elegendő.

A támogatott Doorbird kaputelefonokkal kapcsolatban több információt itt részleteztünk: 

Támogatott Doorbird kaputelefonok Chameleonhoz

A Doorbird-ös applikációnál figyelembe kell venni;

• hogy a telefon némított módjánál nehezen vehető észre a kicsörgés,
• és amennyiben a Chameleon és a Doorbird applikáció is fel van telepítve, és egyszerre csörögnek, úgy az fennakadásokat okozhat a használatukban. Jól működő Chameleon megoldás esetén javasoljuk, hogy a Doorbird applikációban jelentkezzünk ki a kaputelefonból, vagy töröljük az alkalmazást.

A Chameleon emellett még az Akuvox készülékekkel tud jól együtt működni, erről további cikket itt találhatunk: 

Akuvox kaputelefonok integrációja.

Használható eszközök az integráció során:

• Doorbird Webadmin: https://webadmin.doorbird.com/login 
• Kaputelefon távoli státusz lekérdezése, IP cím megtalálása: https://www.doorbird.com/checkonline
• Chameleon Config site/Integrations/Doorphone, Camers, Stream
• Doorbird alkalmazás Android készülékekhez: https://play.google.com/store/apps/details?id=com.doorbird.doorbird&hl=en&gl=US
• Doorbird alkalmazás iOS készülékekhez: https://apps.apple.com/us/app/doorbird/id898756315

Megjegyzések a helyes telepítéshez:

• A kaputelefon kültéri (és opcionálisan beltéri egysége is) legyen egy LAN hálózaton a Chameleon Controllerrel, ez az integráció alap feltétele.
• A kaputelefon megtáplálásához ne alkalmazzuk egyszerre a mellékelt tápegységet és a PoE szabványt, mivel az a készülék meghibásodásához vezethet. 
• PoE megtáplálással elérhető, hogy a kaputelefon önmagában egy Cat5e/Cat6 kábellel is elműködjön. Ez viszont nem elégséges kábel akkor, ha a kaputelefonnal mágneszárat is szeretnénk vezérelni, mivel ilyenkor még a mágneszár tápját is be kell húznunk, például egy 2 eres MT kábellel, amit keresztül kell vezetnünk a kaputelefon reléjén.
• A PoE szabványból több féle is létezik. PoE Mode A és B (802.3af Mode A és 802.3af Mode B). Mindig ellenőrizzük le a termék adatlapján, hogy melyik szabvány szükséges számára. Maximális teljesítményre való tekintettel létezik PoE(802.3af), PoE+(802.3at) és PoE++(802.3bt) szabvány is.
  • A Doorbird D101S és D1101V modellek adatlapja alapján a PoE 802.3af Mode-A szabványt fogadják el. 

Chameleon oldali konfiguráció a Config Site segítségével:

    Navigáljunk a Integrations/Doorphone, Cameras, Stream menüpont alá:

    A megjelent felületen másoljuk ki legalább az egyik címet, mivel az Add new streamre kattintva, a Lokációt kell az első sorban kiválasztani, és legalább a Local vagy a Remote címet meg kell adnunk, mert egyébként a rendszer nem enged menteni.

• Ha idáig eljutottunk, másodjuk ki a példák közül a másodikat is, értelem szerűen a Remote URL Example-nél található címet a Remote Address sorba illesszük be, a Local URL Example-t pedig a Local Addresshez másoljuk be. 
• Fontos, hogy a {streamID}-t át kell írnunk egy numerikus karakterre/számra, amely a Channel ID-t fogja jelenteni innentől. Amennyiben még nincs másik stream a Controllerhez párosítva, úgy ide írhatunk 1-est, ha viszont már van, akkor választhatjuk a soron következőt. Két külön eszköznél nem szerepelhet ugyanaz a streamID, mert komplikációkat okozna a működés során. 
• A {sreamID}-t a Local és a Remote addressnél is cseréljük ki, ugyanarra a számra.

• Miután a Remote és a Local Address-t is kitöltöttük a minta alapján, adjuk meg a Snapshot címet is, ami alapján a Controller tudni fogja, milyen címen keresse a kaputelefon-t. A kaputelefon címét vagy Router DHCP táblájából tudjuk kiszedni, vagy, ha van külső internet elérése, akkor ezen a linken is meg tudjuk nézni: https://www.doorbird.com/checkonline, az oldalon található útmutatót követve, amihez kelleni fog a Digital Passport.
• A Snapshot address így alakul: http://X.X.X.X/bha-api/image.cgi?http-user=xxxxxxxx&http-password=xxxxxxxx
  • A Snapshot címben az IP cím a doorbird IP címe, a http-user és a http-password a Digital Passporton található normál user vagy az administrator user is lehet.
• Sip address: használjuk a sip:100@"ControllerIP" formátumot. Ezt kimásolhatjuk a fentebbi Local Address címből is.
• Bell button: ha szeretnénk ide megadhatunk olyan bemenetet (NO/NC), amellyel alternatív módon, is csöngetést tudunk indítani, de nem a Doorbirdtől jön.
• Bell relay (output): Ide olyan relét tudunk megadni, amit már az Automation/Turn off timer alatt megadtunk (másként, itt nem fog megjelenni). Ez a relé meg fog húzni minden esetben, mikor csöngetés érkezik a Controllerre.
• Driveway opener relay: Ide azt a relét adjuk meg, amit már az Automation/Turn off timer alatt megadtunk (másként, itt nem fog megjelenni. Ennek a relének a célja, hogy meghúzásra kerüljön, amikor a mobilból hívás közben kaput nyitunk. 
  • A relé meghívásáról lentebb részletesebben beszélni fogunk.

    Miután ezeket beállítottuk, nyomjunk a Save Stream gombra.

TIPP: Le tudjuk tesztelni, hogy jól állítottuk-e be a hivatkozási címeket, ha a beállított remote address címet beillesztjük a böngésző felső sávjába, Ekkor meg kellene jelennie az élőképnek:

    Mentést követően a mobilban is már be kell jönnie az élőképnek.

    Miután megadtunk SIP addresst a Config siteon, a mentést követően meg kell jelennie egy Call Endpointnak, amit ha lokális hálón tartózkodva beütünk egy böngésző ablakba, úgy hívást tudunk szimulálni.

    A most megjelent cím struktúrájából látszik, hogy a Controller IP címét, a streamID-t és egy egyedi tokent generálva tud a mobilokra hívást generálni. Gyakorlatban ez az a cím, amit a kaputelefon is meg fog hívni a beállítások után, hogy értesítse a felhasználókat, amennyiben megnyomták a hívó gombot.

    Tipp: Amennyiben nem tartózkodunk a helyszínen, de szeretnénk távolról is hívást szimulálni, úgy meg tudjuk tenni, hogy kicseréljük a fentebb IP cím IP:PORT részét a távoli elérésre. Egyszerűen csak másoljuk ki a lokális endpointot, hagyjuk meg benne a streamID-t és a tokent, és a megadott részt cseréljük ki a már jól ismert távoli csatlakozásra használt linkre:

    Például: http://xxxxxxxx.dns.chameleon.sh/api/streams/call/{streamID}?token=TOKEN, ahol a "xxxxxxxx" a public ID a TOKEN pedig a generált kulcs. Ne felejtsük el a megfelelő StreamID-T használni, konzekvensen azt kell, amelyet a Lokál és a Remote címeknél is megadtunk.

   Figyelem! Ez a távoli csörgetés funkció csak akkor működik, ha a controller rendelkezik távoli elérési lehetőséggel!

Doorbird reléjének használata:

• Az Akuvox kaputelefonok esetében már megismerhettük a kaputelefon reléjének meghívását Config Siteon keresztül, ami a Doorbird esetében szinte ugyan az.
• Hozzunk létre erre egy Virtual Switchet, az Integrations/Manage Virtual devices alatt
  • Segítség: Manage virtual devices
  • 
• A létrehozott Virtual Switchet nevezzük el, a relének adjunk Locationt, Device Type-ot és Category-t.
  • 
• A HTTP ON url-hez rakjuk be a Doorbird kaputelefonokhoz használt speciális linket, ami így néz ki:
  • http://DOORBIRDIP/bha-api/open-door.cgi?http-user=USER&http-password=PASSWORD,ahol
    • A DOORBIRDIP, a doorbird saját IP címe
    • a USER lehet a sima vagy az admin user, ami a készülékhez mellékelt DIGITAL PASSPORT-on megtalálható
    • a PASSWORD lehet a sima vagy az admin user jelszava, ami a készülékhez mellékelt DIGITAL PASSPORT-on megtalálható
    • A normál user hitelesítési adatok használata teljesen elégséges
• A létrehozott virtuális relét rakjuk be Automation/Turn off timer alá egy 1-2 mp-es automata kikapcsolással. A relé meghúzási idejét a Doorbird applikációból tudjuk személyre szabni, mivel a Config siteról csak a HTTP parancsot küldjük el.
• 
• A létrehozott, Turn-off timerrel rendelkező relét rakjuk be a kaputelefon konfigurációnk Driveway Opener reléjéhez.

    Ezen a ponton előkészítettük a Chameleon Config site-ot arra, hogy egy Doorbird kaputelefont csatoljunk hozzá. A további beállításokat már a Doorbird applikáción vagy a Doorbird webadminon keresztül tudjuk befejezni.

Doorbird oldali konfiguráció a saját alkalmazásán keresztül:

Mindenképpen szükséges lesz a kaputelefonhoz mellékelt QUICKSTART GUIDE-ra, aminek az alján megtalálható egy szaggatottan bekeretezett Digital Passport rész, abból is egyenlőre az admin felhasználónév és jelszó páros, vagy a QR kód. Ezen lap nélkül (pl. ha elveszett) a beállítási felületre nem tudunk bejutni, így újat kell kérnünk.

Minta egy Digital Passporthoz:

Nyissuk meg a Doorbird alkalmazást, miután letöltöttük a telefonunkra, majd navigáljunk el a Beállítások>(Further functionality) Administration menüponthoz. Ebben a menüpontban tudjuk felhasználni az administration felhasználónevet és jelszavat, amennyiben kézzel bírjuk, vagy a Passporton található jobb oldali QR kódot bescanneljük. A Save Login funkció hazsnálatával elkerülhetjük, hogy minden egyes újra belépéskor manuálisan kelljen megadni a hitelesítési adatokat:

Sikeres bejelentkezést követően az alábbi felület fogad minket, ahol erősen ajánlott megadni egy email címet, hiszen elfelejtett jelszó esetén ide küldi a helyreállításhoz szükséges teendőket. 

A USER Settings alatt tudunk normál jogosultságú hiteleítési adatokat változtatni.

A Device name alá nem kötelező írni megnevezést, viszont amennyiben több Doorbird készülék adminisztrátor jelszavát is megjegyeztettük a mobiltelefonnal, úgy ez a név segíthet a könnyebb azonosításban.

Kezdjük el a SIP protokollt beállítani:

Görgessünk a fentebbi kép legaljára, ahol megtaláljuk a SIP Settings fület, ebbe kattintsunk bele:

• SIP Activated: Ezt mindenképpen aktiváljuk, a hangkommunikáció használatához!
• SIP Proxy: A Chameleon Controller IP címe, ami jelen esetben a hangszerver is. Formátuma: normál IPv4 cím, port megadása nélkül, X.X.X.X alakban. (Ezt a Chameleon konfigurációs felületéből is ki tudjuk szedni, a Integrations/Doorphone, Camers, Stream alatt a Local Example URL-t megtekintve, vagy a System/Network Settings alatt).
• SIP User: Mindig 100-ast kell ide írni (beépített hitelesítési adat a Controllerbe, nem változtatható)
• SIP Password: Ide is írjunk mindig 100-ast (beépített hitelesítési adat a Controllerbe, nem változtatható) 
• Auth ID, Display name, STUN server: nem szükséges kitölteni
• DTMF: Kikapcsolva
• Allow incoming calls: Ez egy fontos beállítás, legyen bekapcsolva
• Allowed SIP Users: Ez ugyancsak egy fontos beállítás, itt engedélyezzük a doorbird számára a mobillal való kapcsolatfelvételt. (A mobil azonosítója a 101, a kaputelefoné a 100-as). Itt mindenképpen a 101-es fel kell vennünk:
  • A 101 a kötelező felvevendő user, a "smarthome" és a "100" a visszafelé kompatbilitás, régi megoldások miatt lett megadva.

• Az Allowed SIP usersből kilépve lentebb még konfigurálni tudjuk a Doorbird hangszórójának hangosságát és a mikrofon hangosságát, egyéni preferencia alapján, de az alap beállítások is jók:

Folytassuk a Doorbird hívógomb megnyomására elinduló csörgetés beállításával:

• Navigáljunk vissza arra a felületre, ahová a rendszer az Administration hitelesítési adatok megadását követően dobott, vagyis a kaputelefonunk Admin beállítási felületére. Keressük meg a a Favorites alatt a HTTP(S) Calls opciót, és kattintsunk bele.

• Ebben a menüben lehetőségünk van olyan hivatkozásokat létrehozni, amit későbbiekben a kaputelefon meg tud hívni, amennyiben a hívógombot megnyomják. Ez még nem lesz elégséges feltétel, mert a későbbiekben még egy ütemezést is létre kell hoznunk rá, hogy a kaputelefon mikor hívhatja meg a létrehozandó végpontot.

• A mellékelt ábrák szerint, adjunk hozzá egy új végpontot, a névhez írjunk be valami ékezetet nem tartalmazó nevet, pl. chameleon, smarthome, ring stb., és használjuk fel a Config Siteon létrehozott Call Endpointot. Majd nyomjunk a Save-ra, hogy elmentsük a beállításokat.
• Érdemes a Config sitról kimásolni és elküldeni magunknak oly módon, hogy telefonról azt később ki tudjuk másolni, mert hosszú a link és elütés miatt hibalehetőséget ad.
• A mentés után a megjelenő felület már tartalmazni fogja a hozzáadott opciót, erre később már tudunk hivatkozni:

• Itt lépjünk vissza egy menüvel (BACK), majd görgessünk le az Admin felület legaljára, és kattintsunk a Schedule for doorbell opcióra.
• A megjelenő felületen kattintsunk bal felülre, a csengő ikonra, és váltsunk át HTTP(S) calls felületre.

• Ezzel eljutottunk az általunk előbbiekben létrehozott endpoint menedzseléséhez, ahol azt tudjuk beállítani, hogy gombnyomás esetén a kaputelefon mikor hívhassa meg a csörgetési végpontot. Pont emiatt azt is meg tudjuk csinálni, hogy napközben a chameleont csörgethesse a kaputelefon, de például este nem.
• Amennyiben több különböző végpontunk is van, úgy tudnánk közöttük váltani. Jelenleg csak egyet hoztunk létre, de lehetőségünk lenne akár nappal és este, vagy különböző időszakokban más és más végpontokat meghívni.

• A fentebbi képen a jobb felső téglalap megnyomásával gyorsan "soha" és "0-24" csörgés engedélyezés között váltani. A kék téglalapokkal 30 perces bontásokban tudok engedélyező időablakokat készíteni.
• Ezen a ponton, ha a Backre rányomunk, és eddig mindent jól csináltunk, akkor a kaputelefon hívógombjának megnyomásakor már el kellene indulnia a mobilon való kicsörgésnek is, amelyet már fel lehet venni, a hívó kijelzőn pedig kaput is lehet nyitni, amennyiben hozzárendeltük azt a beállításokhoz a Doorbird reléjének használata bekezdésnél.

Doorbird konfiguráció webadmin használatával:

• Lépjünk fel https://webadmin.doorbird.com/login felületre, ahol a rendszer a Doorbird Digital Passportján lévő admin felhasználónevet és jelszót fogja kérni.

• Állítsuk be az értesítési email címet a mobil alkalmazáshoz hasonlóan:

• "HTTP(S) Calls": Híváskori linkek megadása (Ide könnyebb a config site-ról bemásolni a Call endpointot, mint mobilos beállításhoz eljuttatni a Linket)

• "Relays": Relé elnevezés, és meghúzási idők:

• "Schedule for doorbell": A létrehozott HTTP Call-t itt tudjuk a mobilhoz hasonló módon engedélyezni 0-24-ben.

• "SIP Settings": Audio kommunikáció összehangolása a Chameleon controllerrel

 (Hasonlóan a mobilos beállításoknál, a SIP Proxy-hoz a Chameleon Controller IP címét írjuk, a SIP User-hez 100-at, és a SIP passwordhoz is 100-at.)