Skip to content

Asterisk Binding

John Cocula edited this page Jan 15, 2017 · 8 revisions

Documentation of the Asterisk binding bundle

Introduction

The Asterisk binding is used to enable communication between openhab and the free and open source PBX solution Asterisk. By help of this binding you can e.g. detect incoming phone calls or determine if someone currently does a phone call. In combination with other bindings (e.g. Samsung TV Binding) you can display caller IDs on your TV.

For installation of the binding, please see Wiki page Bindings.

Binding Configuration

Under openHAB 2+, edit or create the file services/asterisk.cfg:

############################### Asterisk Binding ######################################
#
# Please note: The Asterisk Management Interface (AMI) has to be activated in the
# manager.conf file of your Asterisk PBX.

# hostname of the AMI
#host=

# the username and password to login to the AMI
#username=
#password=

Under openHAB 1.x, edit the file configurations/openhab.cfg to include:

############################### Asterisk Binding ######################################
#
# Please note: The Asterisk Management Interface (AMI) has to be activated in the
# manager.conf file of your Asterisk PBX.

# hostname of the AMI
#asterisk:host=

# the username and password to login to the AMI
#asterisk:username=
#asterisk:password=

Item Configuration

In order to bind an item to the Asterisk PBX you need to provide configuration settings for each item to which you want to bind in your .items file (in the items folder).

The format of the binding configuration is simple and looks like this:

asterisk=<eventType>

where <eventType> is of the value active for currently active calls. Currently there are no other valid values.

Asterisk binding configurations are valid on Switch and String items.

Switch items with this binding will receive an ON update event at the start and an OFF update event at the end.

String items will receive the external phone number in the form of a string value as a status update. At the end of an event, an empty string is sent as a status update.

As a result, your lines in your items file might look like follows:

Switch Incoming_Call	"Ringing"			(Phone)    { asterisk=active }
Call Active_Call	"Connected [to %1$s from %2$s]"	(Phone)    { asterisk=active }
Call Active_Call	"Connected to [%s]"		(Phone)    { asterisk=active }

Examples

Active call examples

  • Switch on a light when there is at least an active call (when there are no active calls the light will turn off)
Switch light (lights) { asterisk="active" }

or

Switch light (lights) { asterisk="active:*:*" }
  • Switch on a light when '215' calls '101' and turn it off when the call ends
Switch light (lights) { asterisk="active:215:101" }
  • Switch on a light on every call to '101' and turn it off when the call ends
Switch light (lights) { asterisk="active:*:101" }
  • Switch on a light on every call originated from '215' and turn it off when the call ends
Switch light (lights) { asterisk="active:215:*" }

DTMF Digit examples

  • Switch on a light when '1' digit is sent from '215' to '101' during an active call
Switch light (lights) { asterisk="digit:215:101:1" }
  • Switch on a light whenever a '1' digit is sent to '101' during an active call
Switch light (lights) { asterisk="digit:*:101:1" }
  • Switch on a light whenever a '1' digit is sent from '215' during an active call
Switch light (lights) { asterisk="digit:215:*:1" }
  • Switch on a light whenever a '1' digit is sent during an active call
Switch light (lights) { asterisk="digit:*:*:1" }

feature overview

Installation

Setup intro

Linux and OS X

Windows

FreeBSD


Configuration

Automation*

User Interfaces

Persistence


Community

(link to openHAB forum)

Development


Bindings


Application Integration

Misc


Samples

A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules

Scripts

Syntax highlighting for external editors


Release Notes

Clone this wiki locally
You can’t perform that action at this time.