Add DeviceStateChanged and PresenceStateChanged AMI events.

These events are controlled by two new modules, res_manager_devicestate
and res_manager_presencestate.

Review: https://reviewboard.asterisk.org/r/3417



git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@413060 65c4cc65-6c06-0410-ace0-fbb531ad65f3
changes/97/197/1
Mark Michelson 11 years ago
parent d3433771c9
commit 7dd64ff993

@ -12,6 +12,14 @@
--- Functionality changes from Asterisk 12 to Asterisk 13 --------------------
------------------------------------------------------------------------------
AMI
------------------
* New DeviceStateChanged and PresenceStateChanged AMI events have been added.
These events are emitted whenever a device state or presence state change
occurs. The events are controlled by res_manager_device_state.so and
res_manager_presence_state.so. If the high frequency of these events is
problematic for you, do not load these modules.
------------------------------------------------------------------------------
--- Functionality changes from Asterisk 12.2.0 to Asterisk 12.3.0 ------------
------------------------------------------------------------------------------

@ -117,6 +117,30 @@
<support_level>core</support_level>
***/
/*** DOCUMENTATION
<managerEvent language="en_US" name="DeviceStateChange">
<managerEventInstance class="EVENT_FLAG_CALL">
<synopsis>Raised when a device state changes</synopsis>
<syntax>
<parameter name="Device">
<para>The device whose state has changed</para>
</parameter>
<parameter name="State">
<para>The new state of the device</para>
</parameter>
</syntax>
<description>
<para>This differs from the <literal>ExtensionStatus</literal>
event because this event is raised for all device state changes,
not only for changes that affect dialplan hints.</para>
</description>
<see-also>
<ref type="managerEvent">ExtensionStatus</ref>
</see-also>
</managerEventInstance>
</managerEvent>
***/
#include "asterisk.h"
ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
@ -199,7 +223,11 @@ static struct stasis_cache *device_state_cache;
static struct stasis_caching_topic *device_state_topic_cached;
static struct stasis_topic_pool *device_state_topic_pool;
STASIS_MESSAGE_TYPE_DEFN(ast_device_state_message_type);
static struct ast_manager_event_blob *devstate_to_ami(struct stasis_message *msg);
STASIS_MESSAGE_TYPE_DEFN(ast_device_state_message_type,
.to_ami = devstate_to_ami,
);
/* Forward declarations */
static int getproviderstate(const char *provider, const char *address);
@ -880,3 +908,20 @@ int devstate_init(void)
return 0;
}
static struct ast_manager_event_blob *devstate_to_ami(struct stasis_message *msg)
{
struct ast_device_state_message *dev_state;
dev_state = stasis_message_data(msg);
/* Ignore non-aggregate states */
if (dev_state->eid) {
return NULL;
}
return ast_manager_event_blob_create(EVENT_FLAG_CALL, "DeviceStateChange",
"Device: %s\r\n"
"State: %s\r\n",
dev_state->device, ast_devstate_str(dev_state->state));
}

@ -25,6 +25,36 @@
<support_level>core</support_level>
***/
/*** DOCUMENTATION
<managerEvent language="en_US" name="PresenceStateChange">
<managerEventInstance class="EVENT_FLAG_CALL">
<synopsis>Raised when a presence state changes</synopsis>
<syntax>
<parameter name="Presentity">
<para>The entity whose presence state has changed</para>
</parameter>
<parameter name="Status">
<para>The new status of the presentity</para>
</parameter>
<parameter name="Subtype">
<para>The new subtype of the presentity</para>
</parameter>
<parameter name="Message">
<para>The new message of the presentity</para>
</parameter>
</syntax>
<description>
<para>This differs from the <literal>PresenceStatus</literal>
event because this event is raised for all presence state changes,
not only for changes that affect dialplan hints.</para>
</description>
<see-also>
<ref type="managerEvent">PresenceStatus</ref>
</see-also>
</managerEventInstance>
</managerEvent>
***/
#include "asterisk.h"
ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
@ -52,7 +82,11 @@ static const struct {
{ "dnd", AST_PRESENCE_DND},
};
STASIS_MESSAGE_TYPE_DEFN(ast_presence_state_message_type);
static struct ast_manager_event_blob *presence_state_to_ami(struct stasis_message *msg);
STASIS_MESSAGE_TYPE_DEFN(ast_presence_state_message_type,
.to_ami = presence_state_to_ami,
);
struct stasis_topic *presence_state_topic_all;
struct stasis_cache *presence_state_cache;
struct stasis_caching_topic *presence_state_topic_cached;
@ -351,3 +385,17 @@ int ast_presence_state_engine_init(void)
return 0;
}
static struct ast_manager_event_blob *presence_state_to_ami(struct stasis_message *msg)
{
struct ast_presence_state_message *presence_state = stasis_message_data(msg);
return ast_manager_event_blob_create(EVENT_FLAG_CALL, "PresenceStateChange",
"Presentity: %s\r\n"
"Status: %s\r\n"
"Subtype: %s\r\n"
"Message: %s\r\n",
presence_state->provider,
ast_presence_state2str(presence_state->state),
presence_state->subtype,
presence_state->message);
}

@ -0,0 +1,50 @@
/*
* Asterisk -- An open source telephony toolkit.
*
* Copyright (C) 2014, Digium, Inc.
*
* Mark Michelson <mmichelson@digium.com>
*
* See http://www.asterisk.org for more information about
* the Asterisk project. Please do not directly contact
* any of the maintainers of this project for assistance;
* the project provides a web site, mailing lists and IRC
* channels for your use.
*
* This program is free software, distributed under the terms of
* the GNU General Public License Version 2. See the LICENSE file
* at the top of the source tree.
*/
#include "asterisk.h"
#include "asterisk/module.h"
#include "asterisk/stasis.h"
#include "asterisk/devicestate.h"
static struct stasis_forward *topic_forwarder;
static int unload_module(void)
{
topic_forwarder = stasis_forward_cancel(topic_forwarder);
return 0;
}
static int load_module(void)
{
struct stasis_topic *manager_topic;
manager_topic = ast_manager_get_topic();
if (!manager_topic) {
return AST_MODULE_LOAD_DECLINE;
}
topic_forwarder = stasis_forward_all(ast_device_state_topic_all(), manager_topic);
return AST_MODULE_LOAD_SUCCESS;
}
AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Manager Device State Topic Forwarder",
.load = load_module,
.unload = unload_module,
.load_pri = AST_MODPRI_DEVSTATE_CONSUMER,
);

@ -0,0 +1,50 @@
/*
* Asterisk -- An open source telephony toolkit.
*
* Copyright (C) 2014, Digium, Inc.
*
* Mark Michelson <mmichelson@digium.com>
*
* See http://www.asterisk.org for more information about
* the Asterisk project. Please do not directly contact
* any of the maintainers of this project for assistance;
* the project provides a web site, mailing lists and IRC
* channels for your use.
*
* This program is free software, distributed under the terms of
* the GNU General Public License Version 2. See the LICENSE file
* at the top of the source tree.
*/
#include "asterisk.h"
#include "asterisk/module.h"
#include "asterisk/stasis.h"
#include "asterisk/presencestate.h"
static struct stasis_forward *topic_forwarder;
static int unload_module(void)
{
topic_forwarder = stasis_forward_cancel(topic_forwarder);
return 0;
}
static int load_module(void)
{
struct stasis_topic *manager_topic;
manager_topic = ast_manager_get_topic();
if (!manager_topic) {
return AST_MODULE_LOAD_DECLINE;
}
topic_forwarder = stasis_forward_all(ast_presence_state_topic_all(), manager_topic);
return AST_MODULE_LOAD_SUCCESS;
}
AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Manager Presence State Topic Forwarder",
.load = load_module,
.unload = unload_module,
.load_pri = AST_MODPRI_DEVSTATE_CONSUMER,
);
Loading…
Cancel
Save