Verwendung der VASERControl DoorCom App zur Integration von SIP Türsprechanlagen. Version Letzte Änderung:

Transkript

1 VASERCONTROL Verwendung der VASERControl DoorCom App zur Integration von SIP Türsprechanlagen Version Letzte Änderung: Copyright Natural Software SL, Alle Rechte reserviert

2 ios frontend zur Türkommunikation Warenzeichen Baudisch.SIP-Modulsystem - von Baudisch Electronic GmbH Asterisk - registriertes Warenzeichen von Digium, Inc. VASERCONTROL - registriertes Warenzeichen von Natural Software Services S.L. Notation Service Manager OK Komponenten von VASERCONTROL werden in fett dargestellt. Oberflächenelemente werden in fett und kursiv dargestellt. ii Copyright Natural Software Services,

3 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Inhaltsverzeichnis MOTIVATION 1 KONFIGURATION 1 TÜRKOMMUNIKATION MIT IPAD, ASTERISK UND SIP TÜRSPRECHANLAGE 2 KONFIGURATION DER TÜRSPRECHANLAGE 3 NETZWERK KONFIGURATION 3 EINRICHTEN DER AUDIO CODECS 4 SIP REGISTRIERUNG DER TÜRSPRECHANLAGE 5 AKTIVIERUNG DER FERNSTEUERUNG 6 EINSTELLEN DER ZIELRUFNUMMER 7 KONFIGURATION DER MJPG KAMERA 8 NETZWERK KONFIGURATION 8 KONFIGURATION DES ASTERISK SERVER 10 SIP.CONF FILE 10 EXTENSION.CONF FILE 11 KONFIGURATION DER APPLIKATION 12 PART 1 ENTRANCE <NN> 12 PART NN.1 GENERAL 12 PART NN.2 VIDEO 12 PART NN.3 PHONE 12 PART NN.4 SAVE TO CAMERA ROLL 14 PART 2 QUICK DIALS (AB VERSION 1.6) 14 PART 3 SIP TÜRSTATION 14 PART 4 STUN SUPPORT 15 PART 5 OUTBOUND PROXY SUPPORT 15 PART 6 NETWORKS 15 PART 7 LOCAL SETTINGS 16 PART 8 CODECS 16 PART 9 AUDIO 16 PART 10 APPLICATION 16 TEST DER KONFIGURATION 1 17 KONFIGURATION 2 TÜRKOMMUNIKATION MIT 2 IPAD, ASTERISK UND 2 SIP TÜRSPRECHANLAGEN 20 TEST DER KONFIGURATION 2 22 KONFIGURATION DER QUICKDIALS (AB VERSION 1.6) 23 ANHANG A: FRAGEN UND ANTWORTEN 25 WIE KANN ICH FESTSTELLEN, OB DIE SIP PARTNER RICHTIG REGISTRIERT SIND 25 DAS SYSTEM FUNKTIONIERT, ALLERDINGS IST DIE SPRACHE SCHLECHT VERSTÄNDLICH. 25 ES GIBT STARKE RÜCKKOPPLUNGEN. 25 DIE PERSON AN DER TÜRSTATION KANN MICH VERSTEHEN ABER ICH HÖRE NICHTS 26 ICH KANN DIE DIE PERSON AN DER TÜRSTATION VERSTEHEN, ABER AN DER TÜRSTATION KOMMT NICHTS AN. 26 DIE URL EINER ANZUZEIGENDEN WEBSITE IST ZWAR IN ORDNUNG, ABER ES WIRD NICHTS ANGEZEIGT. IN SAFARI FUNKTIONIERT DIE WEBSEITE 26 BEI EINER VERWENDUNG EINER AVM FRITZBOX KOMMEN KEINE DTMF TÖNE AN 26 WIE KANN VERHINDERT WERDEN, DASS ANDEREN APPLIKATIONEN GESTARTET WERDEN 26 Copyright Natural Software Services, iii

4 ios frontend zur Türkommunikation iv Copyright Natural Software Services,

5 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Motivation Dieses Dokument beschreibt die Konfiguration des ios Frontends VASERControl DoorCom, um mit einer oder mehreren SIP basierten Türsprechanlage(n) zu kommunizieren. Die Türsprechanlage, die in den folgenden Beispielen zum Einsatz kommt, ist das Modulsystem der Fa. Baudisch Electronics GmbH aus Wäschenbeuren. Die VASERControl DoorCom kann von dem Apple AppStore heruntergeladen werden. Deutscher AppStore Schweizer AppStore Für alle anderen Länder suchen Sie bitte nach dem Begriff VASERControl. Die folgenden Konfigurationen werden in diesem Dokument diskutiert Konfiguration 1 Türkommunikation mit einem ipad, Asterisk SIP Server und einer Baudisch Türkommunikationsanlage Konfiguration 2 Türkommunikation mit zwei ipads, Asterisk SIP Server und zwei Baudisch Türkommunikationsanlagen Die unterstützten ios Geräte sind das ipad 2-4, ipad air, ipad air 2, ipod touch sowie iphone 4s, 5, 5c, 5s sowie 6s und 6c. Es wird ios Version 7.0 oder höher vorausgesetzt. Copyright Natural Software Services,

6 ios frontend zur Türkommunikation Konfiguration 1 Türkommunikation mit ipad, Asterisk und SIP Türsprechanlage Vier Komponenten sind in dem Netzwerk notwendig. Das SIP Türsprechmodul, eine MJPG Kamera, die VASERControl DoorCom Applikation sowie ein Asterisk SIP Server. Asterisk SIP Server SIP door station Sip/100 Extension 801 ios device (iphone, ipad) DHCP Sip/200 Extension 800 MJPG Kamera Gemäß der obigen Abbildung, sind die Netzwerkadressen für jedes dieser Geräte wie folgt: SIP Türsprechanlage: IP Adresse (Subnetz: ) SIP Tel.Nr. 100 (Kennwort: 1234) MJPG Kamera: IP Address (Subnetz: ) Pfad zu dem MJPG Stream 2 Copyright Natural Software Services,

7 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Asterisk SIP Server IP Adresse (Subnetz ) Sip Port ipad IP Adresse mittels DHCP (die IP Adresse kann sich somit in unterschiedlichen Sessions ändern) SIP Tel.Nr. 200 (Kennwort: 4321) Konfiguration der Türsprechanlage Netzwerk Konfiguration Auf der Seite für die Netzwerk Konfiguration der Baudisch Türsprechanlage, wird die IP Adresse mit Subnetz eingetragen. Da die SIP Kommunikation auf das angegebene Subnetz beschränkt ist, wird eine Angabe des Gateways nicht benötigt. Da die Kommunikation ferner auf fixen IP Adressen basiert, ist auch die DNS Definition nicht nötig. Copyright Natural Software Services,

8 ios frontend zur Türkommunikation Einrichten der Audio Codecs Die Audio Codecs definieren, wie Sprache digitalisiert und wieder verständlich gemacht wird. Die optimalen Einstellungen hängen von der jeweiligen Begebenheit ab und sind z.b. von Rückkopplungseigenschaften des Einbaus, Netzwerk Einstellungen und Kapazitäten, QoS Einstellungen, etc. abhängig. Es sei an dieser Stelle auf die Dokumentation der SIP Türsprechanlage verwiesen. 4 Copyright Natural Software Services,

9 VASERCONTROLDOORCOM ios frontend zur Türkommunikation SIP Registrierung der Türsprechanlage Die wichtigste Angabe sind die Netzwerkadresse des SIP Servers sowie die Registrierungsdaten. Wird dies nicht definiert, so kennt der Asterisk Server die Türstation nicht. Die Benutzerkennung sowie das Passwort muß mit den Einträgen in der sip.conf Datei des Asterisk Servers übereinstimmen. In diesem Beispiel ist dersip Autentifizierungs PIN Copyright Natural Software Services,

10 ios frontend zur Türkommunikation Aktivierung der Fernsteuerung Für die folgenden Beispiele bei der Umsetzung des Türöffners mit UDP Telegrammen, müssen diese Settings, besonders der Authentifizierungscode sowie die Ports, wie in dem vorangegangen Beispiel eingetragen sein. Die restlichen Konfigurationsseiten können auf den vorgegebenen Standardwerten gelassen werden. 6 Copyright Natural Software Services,

11 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Einstellen der Zielrufnummer Auf dieser Konfigurationsseite der Baudisch Türkommunikation wird die Zielrufnummer angegeben, die angerufen wird, sobald eine Person die Zentralrufnummer an der Türstation drückt. Diese Nummer muß innerhalb des Wähl- und Rufnummerplans in der extension.conf Datei des Asterisk Servers angegeben sein. Im unten stehenden Beispiel wird die Nummer 800 angegeben. Des weiteren wird der DTMF Code 1234 für den Türöffner definiert. Dieser DTMF Code kann während eines aktiven Gesprächs mit der Türsprechanlage geschickt werden, so dass das Türrelais betätigt wird. Des weiteren sollte die Option Annehmen + Pieps für ankommende Gespräche definiert sein, sodass die Möglichkeit besteht die Türsprechanlage von der Applikation aus anzurufen. Copyright Natural Software Services,

12 ios frontend zur Türkommunikation Konfiguration der MJPG Kamera Netzwerk Konfiguration Wie bereits in der Konfiguration zu der SIP Türsprechanlage erwähnt, ist es nicht notwendig eine Gateway Adresse sowie einen DNS Server anzugeben. 8 Copyright Natural Software Services,

13 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Für diese Beispiele sollte die Authentifizierung ausgeschaltet sein. Es wird empfohlen für einen Fernzugriff eine VPN in das lokale Netzwerk aufzubauen. Copyright Natural Software Services,

14 ios frontend zur Türkommunikation Konfiguration des Asterisk Server Die beiden wichtigsten Konfigurationsdateien des Asterisk Servers sind die Dateien sip.conf und extensions.conf. Diese Dateien befinden sich im Verzeichnis /etc/asterisk. Über die weiteren Dateien und deren Aufbau sei an dieser Stelle an die Asterisk Dokumentation verwiesen. Sip.conf file Die sip.conf Datei enthält die Deklaration von allen SIP Teilnehmern. In dieser Beispielkonfiguration muß somit ein Eintrag für die SIP Türsprechanlage (Id 100) sowie für die VASERControl DoorCom Applikation (Id 200) eingetragen sein. Falls noch weitere Geräte im Netzwerk bereitstehen müssen diese an dieser Stelle natürlich auch deklariert werden. [sip] ;SIP door station [100] type = friend context = sip username = 100 host = dynamic secret = 4321 ;VASERControl ios frontend [200] type = friend context = sip username = 200 host = dynamic secret = 9876 transport = tcp dtmfmode=info 10 Copyright Natural Software Services,

15 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Extension.conf file Die Datei extension.conf enthält den Wählplan der Asterisk Installation. Wenn ein Gerät eine bestimmte Nummer wählt, so wird durch den entsprechenden Eintrag in dieser Datei die Aktionen drauf bestimmt. In dieser Beispielkonfiguration werden zwei Nummern benötigt. Wenn eine Person an der Türsprechanlage die Taste drückt (Zentralruf), so wird die Nummer 800 gewählt. Diese soll nun bei der VASERControl DoorCom Applikation (Id 200) einen Rufeingang erzeugen. Wenn ein Benutzer auf der VASERControl DoorCom Applikation die call Taste betätigt, so soll die Nummer 801 angerufen werden, welches wiederum in einem Anruf auf die Türstation zur Folge hat (Id 100) Dies wird wie folgt in der extension.conf Datei konfiguriert [sip] ;Door station calls the ios device exten => 800,1,dial(sip/200) exten => 801,1,dial(sip/100) Copyright Natural Software Services,

16 ios frontend zur Türkommunikation Konfiguration der VASERControl DoorCom Applikation Die Konfiguration der VASERControl DoorCom Applikation erfolgt über die Einstellungen Dialoge des ios Betriebssystems. Öffnen Sie das Icon Einstellungen und wählen Sie das Subitem VASERControl. Scollen Sie nach unten, bis Sie den Bereich VOIP/SIP Server sehen. Part 1 Entrance <nn> In dem Submenü für einen Eingang ( Entrance <nn> ) werden die Einstellungen je Eingang angegeben. Part nn.1 General In Title wird der Text angegeben, der als Überschrift über die jeweilige Kamera kommen soll. Mit Enabled wird definiert, ob der Eingang aktiv ist oder nicht. Es sollte mindestens ein Eingang aktiviert sein. Ab Version 1.6 können bis zu 11 Eingänge installiert werden. In dem Standardprodukt sind 2 Eingänge freigeschaltet. Wenn mehr Eingänge benötigt werden, sollten diese Seiten Enabled werden. Auf der jeweiligen Seite in der Anwendung wird nun ein Button erzeugt, der einen In- App Purchase auslöst, um diesen Eingang freizuschalten. Es werden immer 3 weitere Eingänge mit einem Einkauf freigeschaltet. Für diese Beispielkonfiguration sollte nur der erste Eingang Enabled sein, alle weiteren sollten diese Einstellung ausgeschaltet haben. Part nn.2 Video Durch Wahl der Embed Option wird in der Anwendung ein Rahmen generiert, in dem der Video angezeigt wird (Anmerkung: es wird der HTML Tag <img> verwendet). In dem Feld URL to show wird die URL für den Zugriff auf einen MJPG Bilderstrom angegeben werden. In diesem Fall ist dies Je nach Kamerasystem sieht die URL natürlich anders aus. Part nn.3 Phone In diesem Block werden die Telefonparameter für einen Eingang eingestellt. In dem Feld Phone number sollte der Eintrag aus der extension.conf Datei stehen, mit der dieser Eingang angerufen werden kann. D.h. Welche Nummer muß gewählt werden, sodass man mit der Türstation sprechen kann. Dies kann auch in anderen Konfigurationen eine Sammelrufnummer sein. In dieser Konfiguration sollte dies die Nummer 801 sein. In dem Feld Caller Id sollte die Nummer oder der Name des Anschlusses stehen, die als Identifizierung von einer Türstation mit dem Anruf mitgeschickt werden. Dies ist in diesem Fall die Nummer Copyright Natural Software Services,

17 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Mit Dooropener Type kann entschieden werden, wie der Türöffner der Türstation zu betätigen ist. Es stehen folgende Werte zur Verfügung DTMF Es wird ein Codesignal im Rahmen des Telefongesprächs an den SIP Server geschickt, der dies dann an das Endgerät weiterleitet. Hierbei kommt entweder RFC2833 oder SIP-Info zum Tragen. Dieses Format wird allerdings auf der Hauptseite für den Anschluss an den Server definiert UDP Durch ein UDP Telegramm kann über die Fernsteuerung des Eingangs eine Türöffnung ausgelöst werden. Der Vorteil hiervon ist dass kein aktives Gespräch mit der Türsprechanlage notwendig ist, um dies auszulösen. HTTP Es wird ein HTTP Befehl verschickt, um die Türöffnung auszulösen. Dies wird z.b. angewendet, wenn ein VASERControl Server oder z.b. ein Gira Homerserver verwendet wird, um z.b. über das KNX Automatisierungssystem einen Schaltkontakt zu betätigen. Für dieses Konfigurationsbeispiel soll UDP ausgewählt werden In dem Feld Door opener address wird die Netzwerkadresse sowie der Port angegeben, falls ein UDP oder HTTP Telegramm verschickt wird. Für DTMF Kommunikation kann dieses Feld leer bleiben. Für dieses Beispiel wird die Adresse :8113 angegeben. Dies ergibt sich aus der Netzwerkadresse der Türsprechanlage und der Portnummer, die unter Fernsteuerung in den Einstellungen der Türsprechanlage angegeben wurden. In dem Feld Door opener code wird der Code angegeben, mit dem die Tür geöffnet werden kann. Bei Door opener type DTMF wird hier der Code angegeben, der übertragen werden soll. Dies entrspricht dem Feld DTMF Code in der Konfiguration von der Baudisch Türsprechanlage. UDP Da in diesem Beispiel der Türöffner durch ein Fernsteuertelegramm betätigt werden soll, wird hier der Code. BSREM BA Diesen Code bitte genau so angeben. Er wurde für die IP Adresse und den Authentifizierungscode 7123 erzeugt. An dieser Stelle sei auf die Dokumentation der Türsprechanlage bzgl. Aufbau verwiesen. HTTP Als Beispiel soll hier ein Aufruf an den VASERControl Server aufgezeigt werden, der das Element DoorOpener auf den Wert true setzt. /vashas?vcusername=user&vcpassword=secret&elementname =DoorOpener&message=setTrue Copyright Natural Software Services,

18 ios frontend zur Türkommunikation Part nn.4 Save to camera roll Mit der Option Save to camera roll wird ein Bild von der Türkamera in den Bildern des iphone bzw. ipads gespeichert, wenn eine Person auf den Klingelknopf drückt. In dem Eintrag Still image URL wird die URL eingetragen, die das Bild von der Kamera überträgt. In diesem Beispiel ist dies Part 2 Quick dials (ab Version 1.6) In diesem Submenü können Schnellwahlnummern von anderen Teilnehmern angegeben werden. Für jeden Eintrag gibt es ein Feld Name welches den Eintrag beschreibt und ein Feld Number bei dem angegeben werden kann, welche Nummer bei der Auswahl angerufen werden soll. Wenn ein Name Feld leer bleibt, so erscheint der Eintrag später nicht in der Schnellwahlnummern-Liste auf der VASERControl Door Oberfläche. Part 3 SIP Türstation In dem SIP Server Block werden folgende Parameter gesetzt. SIP Server ist die IP Adresse des SIP Servers. In diesem Beispiel läuft der Asterisk Server auf der IP Adresse Der SIP Server port definiert den SIP Port des Asterisk Servers. Per default ist dies Bei einem abweichenden Port sollte in diesem Fall der Server und der Port auch in den Outbound proxy support angegeben werden. Die SIP Userid muß mit dem username Eintrag in der sip.conf des Asterisk Servers übereinstimmen. In diesem Fall ist dies 102. Das SIP Passwort ist der secret Eintrag aus der sip.conf. Dies ist in diesem Fall 9876 Die SIP Registration sollte eingeschaltet sein. Damit wird der Applikation mitgeteilt, dass sie sich beim Start an dem Asterisk SIP Server registrieren soll. Der Registration Timeout ist die Zeit, in der eine Neuanmeldung an dem SIP Server erfolgt. Aufgrund von ios Beschränkungen bzgl. Hintergrund Modus sollte dieser Wert größer als 10 Minuten sein (Bei kleineren Werten kann durch ios der Hintergrundprozess gestoppt werden). Bei Werten größer 600 Sekunden wird von VASERControl 75% des angegebenen Wertes für die Wiederanmeldung genommen vorausgesetzt dies ist größer als 600 Sekunden. In der Praxis hat sich ein Wert von 801 bei einem Asterisk Server bewährt. In der Liste Transport wird ausgewählt, unter welchem Protokoll die Verbindung mit dem Server erfolgen soll. Es stehen die Möglichkeiten UDP, TCP und TLS zur Verfügung. Gemäß SIP Standard wird UDP erwartet. Allerdings ist die Hintergrundverwendung von UDP 14 Copyright Natural Software Services,

19 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Netzwerkverbindungen in ios nicht von Apple gewünscht. Hier sollte, wenn möglich, TCP ausgewählt werden. TLS sollte nur verwendet werden, wenn es von dem Server die ausdrückliche Anforderung gibt diese verschlüsselte Kommunikation zu verwenden. Auch muß die Übertragung der Sicherheitsparameter entsprechend bei der SIP Anmeldung berücksichtig werden. Mit der Option TCP Keepalive kann ausgewählt werden, ob zur Reregistrierung eine Keep- Alive Datenpaket (CrLf) verschickt werden soll oder der komplette SIP-Register Befehl. Bei der Auswahl DTMF-Mode wird definiert, wie DTMF codes an den SIP Server übertragen werden. Es stehen die Möglichkeiten RFC 2833-Outband Daten werden als Töne werden in einem separaten Audiostrom verschickt. RFC 2833 Inband - Daten werden als Töne werden in dem Audiostrom verschickt. SIP-INFO Daten werden als separate SIP Pakete verschickt. Bitte beachten Sie, dass die meisten SIP Server DTMF Daten auch zwischen den Formaten transkodieren. Dies bedeutet, dass z.b. unabhängig von der Herkunft die Daten bei einem Endgerät in einem anderen Format ankommen. Mit der Option Hangup after door opener kann spezifiziert werden, dass ein Gespräch nach Betätigung eines Türöffners beendet werden soll. Über Register as Doorcloud client wird bei der Server Registrierung ein zusätzliches Datenpaket an den Server geschickt, welches dieses ios Geräte als Doorcloud-fähig spezifiziert. Part 4 Stun Support Mit diesen Einstellungen kann der Zugriff auf einen STUN Server konfiguriert werden. Durch Enabled wird der Zugriff eingschaltet. Wenn der Zugriff definiert ist, wird der Server welcher mit der Server address und Server Port definiert ist angesprochen, um den Kommunikationspfad zwischen dem Client und den Server zu definieren. Die Option Use RPort definiert dass der Weg gemäß der RFC3581 (SIP Syymetric Response Routing) verwendet wird. Dies bedeutet, dass im wesentlichen derselbe Socket für den Hinals auch für den Rückweg verwendet wird. Diese Option ist bei dem Einsatz von SIP Server sinnvoll, die nicht in dem lokalen Netzwerk liegen. Part 5 Outbound proxy support Mit diesen Einstellungen wird definiert, unter welcher Adresse der erste Schritt in einer mehrstufigen Netzwerkarchitektur erreichbar ist. Durch Enabled wird dies eingeschaltet. Unter Server und Port ist dies dann zu definieren. Bitte beachten Sie, dass bei einer Abweichung von dem 5060 Standard SIP Port in diesen Feldern ein Eintrag gemacht werden soll. Part 6 Networks Copyright Natural Software Services,

20 ios frontend zur Türkommunikation Mit der Option 3G enabled kann der Zugriff von dem Client zu dem Server auch über das 3G Netzwerk ermöglicht werden. Das 3G Netzwerk wird nur verwendet, wenn ein Zugriff über das WiFi Netzwerk nicht möglich ist. Die Option VPN enabled spezifiziert, dass bevorzugt eine VPN verwendet werden soll. Part 7 Local settings Der local port definiert den lokalen Port welcher geöffnet wird, um Telefonate zu empfangen. Dies ist wichtig für den Fall dass ein Konfiguration ohne SIP Server verwendet wird und die App direkt über das Netzwerk angesprochen wird. Part 8 Codecs Der Bereich Codecs definiert die Audio Codecs, die die App verwenden darf. Mindestens ein Codec muß definiert sein. Sehr häufig werden der G711-A PCMA (a-law) and G711-U PCMU (µ - law) verwendet, quasi alle SIP basierten Geräte verwenden diesen. Diese beiden Codecs sowie der Speex Codec sind auch die Standardeinstellungen bei einer Neuinstallation der App. Part 9 Audio Mit der Option Echo cancellation wird eine systemnahe Echounterdrückung aktiviert. Dies führt i.d.r. zu einer Verbesserung der Sprachqualität. Je nach Codec, Netzwerkauslastung und Servertyp kann aber auch das Gegenteil der Fall sein. Falls Rückkopplungen auftreten sollte diese Option geändert werden. Mit Silence suppression werden Geräusche unter einer bestimmten Lautstärke nicht übertragen. Durch Setzen dieser Option kann die Verständlichkeit erhöht werden. In dieser Liste können unterschiedliche Klingeltöne ausgewählt werden. Mit der Einstellung Number of Loops wird die Anzahl der Wiederholungen angegeben. Ein Wert von -1 bedeutet, dass der Klingelton gespielt wird, bis entweder der eingehende Anruf beantwortet wird oder von dem Anrufer abgebrochen wird. Part 10 Application Mit dem Setzen der Option Idle timer disabled wird verhindert, dass das ipad in den Hintergrundmodus bei Inaktivität geht. 16 Copyright Natural Software Services,

21 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Test der Konfiguration 1 Hinweis: Falls die VASERControl DoorCom Applikation vor einer Änderung der Einstellungen aktiv war, sollte diese zuerst beendet werden. Hierzu machen Sie einen Doppelklick auf dem Home Button. Dann selektieren Sie die VASERControl DoorCom Applikation in der Scrollliste im Fussbereich. Durch einen Slide nach oben wird die Anwendung gestoppt. Durch einen erneuten Klick auf das VASERControl Icon wird die Applikation nun gestartet. Falls eine Fehlermeldung beim Start der Applikation erscheint ist dies meistens wegen einer fehlerhaften SIP Registrierung. In diesem Fall prüfen Sie bitte die Benutzerkennung sowie das Passwort. Des weiteren sollte die IP Adresse des SIP Servers geprüft werden. Die Anwendung sollte das aktive Videobild von der Kamera zeigen. Copyright Natural Software Services,

22 ios frontend zur Türkommunikation Rechts unten befindet sich ein Status Feld, welches Informationen über den Zustand der Verbindung zum Server anzeigt. Hierbei gibt es folgende Zustände: On Hook VASERControl DoorCom hat sich beim SIP Server angemeldet und ist bereit, Anrufe von der Türstation zu erhalten. Dieser Zustand sollte nach dem Start der Applikation angezeigt werden. Failed to register Ein Fehler ist während des Anmeldeprozesses mit dem SIP Server aufgetreten. Die Benutzerkennung und/oder das Passwort wurden nicht akzeptiert. Bitte prüfen Sie die Konfigurations- und/oder Log-Dateien des SIP Servers. Not Registered VASERControl DoorCom wurde nicht angemeldet, da das Kontrollkästchen (Checkbox) für die Anmeldung nicht gesetzt wurde. Dieser Zustand ist in Ordnung, wenn die Kommunikation ohne einen SIP Server durchgeführt wird. Dialing Der Client ruft einen Nummer an. Ringing Das Telefon auf der Partnerseite klingelt oder die VASERControl DoorCom klingelt aufgrund eines ankommenden Anrufs. Established Ein Wechselsprechbetrieb wurde hergestellt. Wenn eine Person nun an der Türsprechanlage den Rufbutton betätigt, wird in der Applikation ein Klingelton gepielt. Der große runde Button blinkt nun in rot und grün. Wenn dieser Button betätigt wird, wird eine Zweiweg SIP Audioverbindung mit der Türstation aufgebaut. Der Button ändert nun seine Farbe in rot. Wenn er betätigt wird beendet er das Gespräch. Der blaue Button mit dem Schlüssel bietet nun die Möglichkeit den Türöffner zu betätigen. Hierzu wird entweder eine DTMF sequenz, ein UDP Telegramm oder ein http Aufruf getätigt. Wenn DTMF als Kommunikation gewählt wurde, dann ist er nur aktiv während einer bestehenden Verbindung. Bei den beiden anderen Möglichkeiten (udp und http) ist der Button immer aktiv. Um ein Gespräch mit der Türsprechanlage aufzubauen, kann auch von der Applikation ein Ruf zur Türstation ausgelöst werden. Hierzu wird auf den großen Button geklickt. Wird der Button mit dem grünen Telefon geklickt, so kann jede Nummer aus dem Wählplan des SIP Servers angerufen werden. 18 Copyright Natural Software Services,

23 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Copyright Natural Software Services,

24 ios frontend zur Türkommunikation Konfiguration 2 Türkommunikation mit 2 ipad, Asterisk und 2 SIP Türsprechanlagen Als zweites Beispiel soll hier eine Konfiguration mit 2 ipads und 2 Türstationen mit Video aufgezeigt werden. Asterisk SIP Server SIP door station Sip/100 Extension 801 MJPG Kamera SIP door station Sip/101 Extension 802 MJPG Kamera ios device (iphone, ipad) DHCP Sip/200 Extension 810 ios device (iphone, ipad) DHCP Sip/201 Extension 811 Die Konfiguration von der ersten Türstation und der Kamera kann bleiben wie sie ist. Bei Konfiguration sollten folgende Änderungen umgesetzt werden. Die anderen Parameter sollten dieselben sein, wie bei der ersten Türstation und Kamera. Türstation 2: Netzwerkeinstellungen: IP Adresse: SIP Registrierung Benutzer Id: 101 Authentifizierungs Id: 101 Fernsteuerung Statusport: 8114 Fernsteuerport: Copyright Natural Software Services,

25 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Kamera 2: Netzwerkeinstellungen: IP Adresse: Asterisk sip.conf [sip] ;SIP door station [100] type = friend context = sip username = 100 host = dynamic secret = 4321 ;SIP door station 2 [101] type = friend context = sip username = 101 host = dynamic secret = 4321 ;VASERControl ios frontend [200] type = friend context = sip username = 200 host = dynamic secret = 9876 transport = tcp dtmfmode=info ;VASERControl ios frontend [201] type = friend context = sip username = 201 host = dynamic secret = 9876 transport = tcp dtmfmode=info Asterisk extension.conf [sip] ;Door station calls the ios device exten => 800,1,dial(sip/200&sip/201) exten => 801,1,dial(sip/100) exten => 802,1,dial(sip/101) exten => 810,1,dial(sip/200) exten => 811,1,dial(sip/201) Copyright Natural Software Services,

26 ios frontend zur Türkommunikation VASERControl DoorCom Settings Entrance 2 Title: Extra Entrance Enabled: Yes Embed: Yes URL to show: Phone number: 802 CallerId: 101 Door opener type: UDP Dooropener address: :8115 Dooropener code: BSREM FA Save to camera roll Yes Still image URL: Test der Konfiguration 2 Falls die VASERControl DoorCom Applikation vor einer Änderung der Einstellungen aktiv war, sollte diese zuerst beendet werden. Hierzu machen Sie einen Doppelklick auf dem Home Button. Dann selektieren Sie die VASERControl DoorCom Applikation in der Scrollliste im Fussbereich. Durch einen Slide nach oben wird die Anwendung gestoppt. Durch einen erneuten Klick auf das VASERControl Icon wird die Applikation nun gestartet. Falls es eine Fehlermeldung gibt, siehe hierzu die Kommentare zu dem Test der Konfiguration 1. Wenn nun an dem Haupteingang geklingelt wird, sollte die Anwendung dies melden und den Video der Haupttür anzeigen. Wenn an der Nebentür geklingelt wird, sollte die Anwendung dies melden und das Video der Nebentür anzeigen. Es sollten beide ipads klingeln. 22 Copyright Natural Software Services,

27 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Konfiguration der Quickdials (ab Version 1.6) Gehen Sie hierzu in die Einstellungen der VASERControl DoorCom. Öffnen Sie das Untermenü Quick Dials und geben Sie für ipad 1 folgende Werte an Entry 1: Name: ipad 2 Number: 811 Entry 2: Name: Front door Number: 801 Entry 3: Name: Extra Entrance Number: 801 Bei dem zweiten ipad geben Sie dieselben Werte ein mit Ausnahme der Entry 1 Entry 1: Name: ipad 1 Number: 810 Starten Sie nun die Anwendung neu. Wenn Sie nun einen Swipe nach rechts durchführen, dann erscheint auf der linken Seite die Auswahl der Quick Dials. Copyright Natural Software Services,

28 ios frontend zur Türkommunikation Durch einen Klick auf den Listeneintrag kann diese Nummer angerufen werden. 24 Copyright Natural Software Services,

29 VASERCONTROLDOORCOM ios frontend zur Türkommunikation Anhang A: Fragen und Antworten Wie kann ich feststellen, ob die SIP Partner richtig registriert sind Wenn die Applikation gestartet ist, kann man mit dem folgenden Befehl in dem Asterisk CLI (Command Line Interface) die registrierten SIP Geräte und deren Status anzeigen lassen. Der Aufruf der CLI hängt von der Installation des Asterisk Servers ab. Bitte geben Sie folgenden Befehl ein sip show peers in den Asterisk CLI Interface. Das Ergebnis sollte wie folgt sein Name/username Host Dyn Nat ACL Port Status 100/ D 5060 Unmonitored 101/ D 5060 Unmonitored 2 sip peers [Monitored: 2 online, 0 offline Unmonitored: 2 online, 0 offline] Falls ein Gerät nicht online ist, prüfen Sie bitte die Benutzer Id sowie die Kennwörter. Dies deutet auf eine Diskrepanz zwischen der sip.conf Datei des Asterisk sowie den individuellen Gerätekonfigurationen hin. Das System funktioniert, allerdings ist die Sprache schlecht verständlich. Dies deutet auf ein Problem mit den Codecs hin. Wir empfehlen den PCMU (u-law), PCMA (a- Law) und Speex codec. Bitte prüfen Sie auch die Verstärker- und Lautsprecherpegel der einzelnen Geräte. Bitte überprüfen Sie auch bei Installationen in eigenen Briefkastensystemen, dass z.b. der Lautsprecher oder das Mikrofon der Türsprechanlage nicht verdeckt sind. Es gibt starke Rückkopplungen. Hierzu sollten folgende Punkte probiert werden In der App - Einstellung Echo cancellation ändern (d.h. wenn es an war, dann aus schalten und vice versa) - Dasseble mit der Option Silence suppression In der Türsprechanlage - Lautstärke reduzieren - Empfindlichkeit des Mikrofons reduzieren In dem SIP Server - Anderen Codec verwenden - Echo cancellation Filter im SIP Server installieren (z.b. als PlugIn im Asterisk) Copyright Natural Software Services,