Version 0.3.0 from FTP
authorMark Spencer <markster@digium.com>
Wed, 13 Nov 2002 15:14:37 +0000 (15:14 +0000)
committerMark Spencer <markster@digium.com>
Wed, 13 Nov 2002 15:14:37 +0000 (15:14 +0000)
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@549 65c4cc65-6c06-0410-ace0-fbb531ad65f3

include/asterisk/indications.h [new file with mode: 0755]

diff --git a/include/asterisk/indications.h b/include/asterisk/indications.h
new file mode 100755 (executable)
index 0000000..1ff4dac
--- /dev/null
@@ -0,0 +1,75 @@
+/*
+ * BSD Telephony Of Mexico "Tormenta" Tone Zone Support 2/22/01
+ * 
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 
+ *
+ * Primary Author: Pauline Middelink <middelink@polyware.nl>
+ *
+ */
+
+#ifndef _ASTERISK_INDICATIONS_H
+#define _ASTERISK_INDICATIONS_H
+
+/* forward reference */
+struct ast_channel;
+
+struct tone_zone_sound {
+       struct tone_zone_sound *next;           /* next element */
+       const char *name;                       /* Identifing name */
+       const char *data;                       /* Actual zone description */
+       /* Description is a series of tones of the format:
+          [!]freq1[+freq2][/duration] separated by commas.  There
+          are no spaces.  The sequence is repeated back to the 
+          first tone description not preceeded by !. Duration is
+          specified in milliseconds */
+};
+
+struct tone_zone {
+       struct tone_zone* next;                         /* next in list */
+       char country[5];                                /* Country code */
+       char alias[5];                                  /* is this an alias? */
+       char description[40];                           /* Description */
+       int  nrringcadance;                             /* # registered ringcadance elements */
+       int *ringcadance;                               /* Ring cadence */
+       struct tone_zone_sound *tones;                  /* The known tones for this zone */
+};
+
+/* set the default tone country */
+extern int ast_set_indication_country(const char *country);
+
+/* locate tone_zone, given the country. if country == NULL, use the default country */
+extern struct tone_zone *ast_get_indication_zone(const char *country);
+/* locate a tone_zone_sound, given the tone_zone. if tone_zone == NULL, use the default tone_zone */
+extern struct tone_zone_sound *ast_get_indication_tone(const struct tone_zone *zone, const char *indication);
+
+/* add a new country, if country exists, it will be replaced. */
+extern int ast_register_indication_country(struct tone_zone *country);
+/* remove an existing country and all its indications, country must exist */
+extern int ast_unregister_indication_country(const char *country);
+/* add a new indication to a tone_zone. tone_zone must exist. if the indication already
+ * exists, it will be replaced. */
+extern int ast_register_indication(struct tone_zone *zone, const char *indication, const char *tonelist);
+/* remove an existing tone_zone's indication. tone_zone must exist */
+extern int ast_unregister_indication(struct tone_zone *zone, const char *indication);
+
+/* Start a tone-list going */
+int ast_playtones_start(struct ast_channel *chan, int vol, const char* tonelist);
+/*! Stop the tones from playing */
+void ast_playtones_stop(struct ast_channel *chan);
+
+extern struct tone_zone *tone_zones;
+extern pthread_mutex_t tzlock;
+
+#endif