Asterisk AMI

Mit der Asterisk AMI-Schnittstelle kann ein Asterisk Server abgehört und konfiguriert werden.

Info: Die Schnittstelle synchronisiert automatisch mit dem langsamsten Zyklus der zugeordneten SPS. Die Telegramme werden vom System gepuffert, sodass kein Telegramm verloren geht.

Hinweis: Es können auch Ereignisse direkt im Telefon erstellt werden. Diese kommunizieren mit einem vorhandenen Visualisierungs-Objekt.

Funktionsbeschreibung

Das Asterisk Manager Interface (AMI) ist ein Monitor und dient auch zur Verwaltung der Asterisk Telefonanlage. Alle Befehle werden mittels Klartext via TCP/IP übermittelt.

Ist die Verbindung für 30 Sekunden inaktiv, so wird automatisch ein Ping Befehl gesendet.

Aktionen senden

Aktionen werden als mehrzeilige Zeichenkette an die Variable action gesendet. Dabei wird das normale Zeilenende von Antcas Control übermittelt. Dies unterscheidet sich von der Dokumentation von Asterisk.

Hier ein Beispiel:

Action: SIPpeerstatus
ActionID: 1234

Die Antwort des ausgeführten Befehls wird an die Variable response gesendet. Eine abgefragte Liste wird dann an event gesendet. Diese kann gleich wie ein Event ausgewertet werden.

Hinweis: Die Dokumentation ist zu finden unter: https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+AMI+Actions ab der zweiten Generation lautet diese https://wiki.asterisk.org/wiki/display/AST/Asterisk+18+AMI+Events

Beispiel

Nummer wählen.

Action: Originate
Channel: SIP/<ZIELNUMMER@HOST>
Context: dp<PROJEKTID>
Exten: <TELEFONID>
Priority: 1
Async: True

Events auswerten

Jedes Event wird mit der Zykluszeit der langsamsten Applikation synchronisiert. Dies bedeutet, dass bei mehreren Antworten hintereinander jede Antwort ausgewertet werden kann und dabei keine verloren geht.

Anbei ein Beispiel, um einen Ruf zu erkennen. Dabei wird eine positive Flanke am Funktionsblock Ring erzeugt. Die Teilnehmer-ID ist nach dem Wert Exten: zu ändern. Die ID kann auf dem Telefon oder dem Monitor entnommen werden.

Hinweis: Die Dokumentation ist zu finden unter: https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+AMI+Events

Verwenden des internen Servers

Der Asterisk-Server, der auf dem Antcas Server läuft, hat diverse Einschränkungen. Unter anderem können keine System-Änderungen getätigt werden. Zudem ist es nicht möglich die Verbindung von aussen zur Verfügung zu stellen.

Um eine Verbindung herzustellen, wählen Sie in der Konfiguration unter ausgehende Schnittstelle die Option Intern aus.