app_flash.c

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 1999 - 2005, Digium, Inc.
 *
 * Mark Spencer <[email protected]>
 *
 * 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.
 */

/*! \file
 *
 * \brief App to flash a DAHDI trunk
 *
 * \author Mark Spencer <[email protected]>
 *
 * \ingroup applications
 */

/*** MODULEINFO
   <depend>dahdi</depend>
   <support_level>core</support_level>
 ***/

#include "asterisk.h"

#include <dahdi/user.h>

#include "asterisk/lock.h"
#include "asterisk/file.h"
#include "asterisk/channel.h"
#include "asterisk/pbx.h"
#include "asterisk/module.h"
#include "asterisk/translate.h"
#include "asterisk/image.h"

/*** DOCUMENTATION
   <application name="Flash" language="en_US">
      <synopsis>
         Flashes a DAHDI Trunk.
      </synopsis>
      <syntax />
      <description>
         <para>Performs a flash on a DAHDI trunk. This can be used to access features
         provided on an incoming analogue circuit such as conference and call waiting.
         Use with SendDTMF() to perform external transfers.</para>
      </description>
      <see-also>
         <ref type="application">SendDTMF</ref>
      </see-also>
   </application>
 ***/

static char *app = "Flash";

static inline int dahdi_wait_event(int fd)
{
   /* Avoid the silly dahdi_waitevent which ignores a bunch of events */
   int i,j=0;
   i = DAHDI_IOMUX_SIGEVENT;
   if (ioctl(fd, DAHDI_IOMUX, &i) == -1) return -1;
   if (ioctl(fd, DAHDI_GETEVENT, &j) == -1) return -1;
   return j;
}

static int flash_exec(struct ast_channel *chan, const char *data)
{
   int res = -1;
   int x;
   struct dahdi_params dahdip;

   if (strcasecmp(ast_channel_tech(chan)->type, "DAHDI")) {
      ast_log(LOG_WARNING, "%s is not a DAHDI channel\n", ast_channel_name(chan));
      return -1;
   }

   memset(&dahdip, 0, sizeof(dahdip));
   res = ioctl(ast_channel_fd(chan, 0), DAHDI_GET_PARAMS, &dahdip);
   if (!res) {
      if (dahdip.sigtype & __DAHDI_SIG_FXS) {
         x = DAHDI_FLASH;
         res = ioctl(ast_channel_fd(chan, 0), DAHDI_HOOK, &x);
         if (!res || (errno == EINPROGRESS)) {
            if (res) {
               /* Wait for the event to finish */
               dahdi_wait_event(ast_channel_fd(chan, 0));
            }
            res = ast_safe_sleep(chan, 1000);
            ast_verb(3, "Flashed channel %s\n", ast_channel_name(chan));
         } else
            ast_log(LOG_WARNING, "Unable to flash channel %s: %s\n", ast_channel_name(chan), strerror(errno));
      } else
         ast_log(LOG_WARNING, "%s is not an FXO Channel\n", ast_channel_name(chan));
   } else
      ast_log(LOG_WARNING, "Unable to get parameters of %s: %s\n", ast_channel_name(chan), strerror(errno));

   return res;
}

static int unload_module(void)
{
   return ast_unregister_application(app);
}

static int load_module(void)
{
   return ast_register_application_xml(app, flash_exec);
}

AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Flash channel application");