Refactor chan_dahdi/sig_analog/sig_pri and chan_misdn to use the common transfer...
[asterisk/asterisk.git] / channels / sig_pri.h
1 #ifndef _SIG_PRI_H
2 #define _SIG_PRI_H
3 /*
4  * Asterisk -- An open source telephony toolkit.
5  *
6  * Copyright (C) 1999 - 2009, Digium, Inc.
7  *
8  * Mark Spencer <markster@digium.com>
9  *
10  * See http://www.asterisk.org for more information about
11  * the Asterisk project. Please do not directly contact
12  * any of the maintainers of this project for assistance;
13  * the project provides a web site, mailing lists and IRC
14  * channels for your use.
15  *
16  * This program is free software, distributed under the terms of
17  * the GNU General Public License Version 2. See the LICENSE file
18  * at the top of the source tree.
19  */
20
21 /*! \file
22  *
23  * \brief Interface header for PRI signaling module
24  *
25  * \author Matthew Fredrickson <creslin@digium.com>
26  */
27
28 #include "asterisk/channel.h"
29 #include "asterisk/frame.h"
30 #include "asterisk/event.h"
31 #include "asterisk/ccss.h"
32 #include <libpri.h>
33 #include <dahdi/user.h>
34
35 #if defined(HAVE_PRI_CCSS)
36 /*! PRI debug message flags when normal PRI debugging is turned on at the command line. */
37 #define SIG_PRI_DEBUG_NORMAL    \
38         (PRI_DEBUG_APDU | PRI_DEBUG_Q931_STATE | PRI_DEBUG_Q921_STATE | PRI_DEBUG_CC)
39 #else
40
41 /*! PRI debug message flags when normal PRI debugging is turned on at the command line. */
42 #define SIG_PRI_DEBUG_NORMAL    \
43         (PRI_DEBUG_APDU | PRI_DEBUG_Q931_STATE | PRI_DEBUG_Q921_STATE)
44 #endif  /* !defined(HAVE_PRI_CCSS) */
45
46 #if 0
47 /*! PRI debug message flags set on initial startup. */
48 #define SIG_PRI_DEBUG_DEFAULT   (SIG_PRI_DEBUG_NORMAL | PRI_DEBUG_Q931_DUMP)
49 #else
50 /*! PRI debug message flags set on initial startup. */
51 #define SIG_PRI_DEBUG_DEFAULT   0
52 #endif
53
54 #define SIG_PRI_AOC_GRANT_S    (1 << 0)
55 #define SIG_PRI_AOC_GRANT_D    (1 << 1)
56 #define SIG_PRI_AOC_GRANT_E    (1 << 2)
57
58 enum sig_pri_tone {
59         SIG_PRI_TONE_RINGTONE = 0,
60         SIG_PRI_TONE_STUTTER,
61         SIG_PRI_TONE_CONGESTION,
62         SIG_PRI_TONE_DIALTONE,
63         SIG_PRI_TONE_DIALRECALL,
64         SIG_PRI_TONE_INFO,
65         SIG_PRI_TONE_BUSY,
66 };
67
68 enum sig_pri_law {
69         SIG_PRI_DEFLAW = 0,
70         SIG_PRI_ULAW,
71         SIG_PRI_ALAW
72 };
73
74 enum sig_pri_moh_signaling {
75         /*! Generate MOH to the remote party. */
76         SIG_PRI_MOH_SIGNALING_MOH,
77         /*! Send hold notification signaling to the remote party. */
78         SIG_PRI_MOH_SIGNALING_NOTIFY,
79 #if defined(HAVE_PRI_CALL_HOLD)
80         /*! Use HOLD/RETRIEVE signaling to release the B channel while on hold. */
81         SIG_PRI_MOH_SIGNALING_HOLD,
82 #endif  /* defined(HAVE_PRI_CALL_HOLD) */
83 };
84
85 enum sig_pri_moh_state {
86         /*! Bridged peer has not put us on hold. */
87         SIG_PRI_MOH_STATE_IDLE,
88         /*! Bridged peer has put us on hold and we were to notify the remote party. */
89         SIG_PRI_MOH_STATE_NOTIFY,
90         /*! Bridged peer has put us on hold and we were to play MOH or HOLD/RETRIEVE fallback. */
91         SIG_PRI_MOH_STATE_MOH,
92 #if defined(HAVE_PRI_CALL_HOLD)
93         /*! Requesting to put channel on hold. */
94         SIG_PRI_MOH_STATE_HOLD_REQ,
95         /*! Trying to go on hold when bridged peer requested to unhold. */
96         SIG_PRI_MOH_STATE_PEND_UNHOLD,
97         /*! Channel is held. */
98         SIG_PRI_MOH_STATE_HOLD,
99         /*! Requesting to take channel out of hold. */
100         SIG_PRI_MOH_STATE_RETRIEVE_REQ,
101         /*! Trying to take channel out of hold when bridged peer requested to hold. */
102         SIG_PRI_MOH_STATE_PEND_HOLD,
103         /*! Failed to take the channel out of hold. No B channels were available? */
104         SIG_PRI_MOH_STATE_RETRIEVE_FAIL,
105 #endif  /* defined(HAVE_PRI_CALL_HOLD) */
106
107         /*! Number of MOH states.  Must be last in enum. */
108         SIG_PRI_MOH_STATE_NUM
109 };
110
111 enum sig_pri_moh_event {
112         /*! Reset the MOH state machine. (Because of hangup.) */
113         SIG_PRI_MOH_EVENT_RESET,
114         /*! Bridged peer placed this channel on hold. */
115         SIG_PRI_MOH_EVENT_HOLD,
116         /*! Bridged peer took this channel off hold. */
117         SIG_PRI_MOH_EVENT_UNHOLD,
118 #if defined(HAVE_PRI_CALL_HOLD)
119         /*! The hold request was successfully acknowledged. */
120         SIG_PRI_MOH_EVENT_HOLD_ACK,
121         /*! The hold request was rejected. */
122         SIG_PRI_MOH_EVENT_HOLD_REJ,
123         /*! The unhold request was successfully acknowledged. */
124         SIG_PRI_MOH_EVENT_RETRIEVE_ACK,
125         /*! The unhold request was rejected. */
126         SIG_PRI_MOH_EVENT_RETRIEVE_REJ,
127         /*! The remote party took this channel off hold. */
128         SIG_PRI_MOH_EVENT_REMOTE_RETRIEVE_ACK,
129 #endif  /* defined(HAVE_PRI_CALL_HOLD) */
130
131         /*! Number of MOH events.  Must be last in enum. */
132         SIG_PRI_MOH_EVENT_NUM
133 };
134
135 /*! Call establishment life cycle level for simple comparisons. */
136 enum sig_pri_call_level {
137         /*! Call does not exist. */
138         SIG_PRI_CALL_LEVEL_IDLE,
139         /*! Call is present but has no response yet. (SETUP) */
140         SIG_PRI_CALL_LEVEL_SETUP,
141         /*! Call is collecting digits for overlap dialing. (SETUP ACKNOWLEDGE) */
142         SIG_PRI_CALL_LEVEL_OVERLAP,
143         /*! Call routing is happening. (PROCEEDING) */
144         SIG_PRI_CALL_LEVEL_PROCEEDING,
145         /*! Called party is being alerted of the call. (ALERTING) */
146         SIG_PRI_CALL_LEVEL_ALERTING,
147         /*! Call is dialing 'w' deferred digits. (CONNECT) */
148         SIG_PRI_CALL_LEVEL_DEFER_DIAL,
149         /*! Call is connected/answered. (CONNECT) */
150         SIG_PRI_CALL_LEVEL_CONNECT,
151 };
152
153 enum sig_pri_reset_state {
154         /*! \brief The channel is not being RESTARTed. */
155         SIG_PRI_RESET_IDLE,
156         /*!
157          * \brief The channel is being RESTARTed.
158          * \note Waiting for a RESTART ACKNOWLEDGE from the peer.
159          */
160         SIG_PRI_RESET_ACTIVE,
161         /*!
162          * \brief Peer may not be sending the expected RESTART ACKNOWLEDGE.
163          *
164          * \details We have already received a SETUP on this channel.
165          * If another SETUP comes in on this channel then the peer
166          * considers this channel useable.  Assume that the peer is
167          * never going to give us a RESTART ACKNOWLEDGE and assume that
168          * we have received one.  This is not according to Q.931, but
169          * some peers occasionally fail to send a RESTART ACKNOWLEDGE.
170          */
171         SIG_PRI_RESET_NO_ACK,
172 };
173
174 struct sig_pri_span;
175 struct xfer_rsp_data;
176
177 struct sig_pri_callback {
178         /* Unlock the private in the signalling private structure.  This is used for three way calling madness. */
179         void (* const unlock_private)(void *pvt);
180         /* Lock the private in the signalling private structure.  ... */
181         void (* const lock_private)(void *pvt);
182         /* Do deadlock avoidance for the private signaling structure lock.  */
183         void (* const deadlock_avoidance_private)(void *pvt);
184         /* Function which is called back to handle any other DTMF events that are received.  Called by analog_handle_event.  Why is this
185          * important to use, instead of just directly using events received before they are passed into the library?  Because sometimes,
186          * (CWCID) the library absorbs DTMF events received. */
187         //void (* const handle_dtmf)(void *pvt, struct ast_channel *ast, enum analog_sub analog_index, struct ast_frame **dest);
188
189         //int (* const dial_digits)(void *pvt, enum analog_sub sub, struct analog_dialoperation *dop);
190         int (* const play_tone)(void *pvt, enum sig_pri_tone tone);
191
192         int (* const set_echocanceller)(void *pvt, int enable);
193         int (* const train_echocanceller)(void *pvt);
194         int (* const dsp_reset_and_flush_digits)(void *pvt);
195
196         struct ast_channel * (* const new_ast_channel)(void *pvt, int state, enum sig_pri_law law, char *exten, const struct ast_channel *chan);
197
198         void (* const fixup_chans)(void *old_chan, void *new_chan);
199
200         /* Note: Called with PRI lock held */
201         void (* const handle_dchan_exception)(struct sig_pri_span *pri, int index);
202         void (* const set_alarm)(void *pvt, int in_alarm);
203         void (* const set_dialing)(void *pvt, int is_dialing);
204         void (* const set_digital)(void *pvt, int is_digital);
205         void (* const set_outgoing)(void *pvt, int is_outgoing);
206         void (* const set_callerid)(void *pvt, const struct ast_party_caller *caller);
207         void (* const set_dnid)(void *pvt, const char *dnid);
208         void (* const set_rdnis)(void *pvt, const char *rdnis);
209         void (* const queue_control)(void *pvt, int subclass);
210         int (* const new_nobch_intf)(struct sig_pri_span *pri);
211         void (* const init_config)(void *pvt, struct sig_pri_span *pri);
212         const char *(* const get_orig_dialstring)(void *pvt);
213         void (* const make_cc_dialstring)(void *pvt, char *buf, size_t buf_size);
214         void (* const update_span_devstate)(struct sig_pri_span *pri);
215         void (* const dial_digits)(void *pvt, const char *dial_string);
216
217         void (* const open_media)(void *pvt);
218
219         /*!
220          * \brief Post an AMI B channel association event.
221          *
222          * \param pvt Private structure of the user of this module.
223          * \param chan Channel associated with the private pointer
224          *
225          * \return Nothing
226          */
227         void (* const ami_channel_event)(void *pvt, struct ast_channel *chan);
228
229         /*! Reference the parent module. */
230         void (*module_ref)(void);
231         /*! Unreference the parent module. */
232         void (*module_unref)(void);
233 };
234
235 /*! Global sig_pri callbacks to the upper layer. */
236 extern struct sig_pri_callback sig_pri_callbacks;
237
238 #define SIG_PRI_NUM_DCHANS              4               /*!< No more than 4 d-channels */
239 #define SIG_PRI_MAX_CHANNELS    672             /*!< No more than a DS3 per trunk group */
240
241 #define SIG_PRI         DAHDI_SIG_CLEAR
242 #define SIG_BRI         (0x2000000 | DAHDI_SIG_CLEAR)
243 #define SIG_BRI_PTMP    (0X4000000 | DAHDI_SIG_CLEAR)
244
245 /* QSIG channel mapping option types */
246 #define DAHDI_CHAN_MAPPING_PHYSICAL     0
247 #define DAHDI_CHAN_MAPPING_LOGICAL      1
248
249 /* Overlap dialing option types */
250 #define DAHDI_OVERLAPDIAL_NONE 0
251 #define DAHDI_OVERLAPDIAL_OUTGOING 1
252 #define DAHDI_OVERLAPDIAL_INCOMING 2
253 #define DAHDI_OVERLAPDIAL_BOTH (DAHDI_OVERLAPDIAL_INCOMING|DAHDI_OVERLAPDIAL_OUTGOING)
254
255 #if defined(HAVE_PRI_SERVICE_MESSAGES)
256 /*! \brief Persistent Service State */
257 #define SRVST_DBKEY "service-state"
258 /*! \brief The out-of-service SERVICE state */
259 #define SRVST_TYPE_OOS "O"
260 /*! \brief SRVST_INITIALIZED is used to indicate a channel being out-of-service
261  *  The SRVST_INITIALIZED is mostly used maintain backwards compatibility but also may
262  *  mean that the channel has not yet received a RESTART message.  If a channel is
263  *  out-of-service with this reason a RESTART message will result in the channel
264  *  being put into service. */
265 #define SRVST_INITIALIZED 0
266 /*! \brief SRVST_NEAREND is used to indicate that the near end was put out-of-service */
267 #define SRVST_NEAREND  (1 << 0)
268 /*! \brief SRVST_FAREND is used to indicate that the far end was taken out-of-service */
269 #define SRVST_FAREND   (1 << 1)
270 /*! \brief SRVST_BOTH is used to indicate that both sides of the channel are out-of-service */
271 #define SRVST_BOTH (SRVST_NEAREND | SRVST_FAREND)
272
273 /*! \brief The AstDB family */
274 static const char dahdi_db[] = "dahdi/registry";
275 #endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
276
277 struct sig_pri_chan {
278         /* Options to be set by user */
279         unsigned int hidecallerid:1;
280         unsigned int hidecalleridname:1;      /*!< Hide just the name not the number for legacy PBX use */
281         unsigned int immediate:1;                       /*!< Answer before getting digits? */
282         unsigned int priexclusive:1;                    /*!< Whether or not to override and use exculsive mode for channel selection */
283         unsigned int priindication_oob:1;
284         unsigned int use_callerid:1;                    /*!< Whether or not to use caller id on this channel */
285         unsigned int use_callingpres:1;                 /*!< Whether to use the callingpres the calling switch sends */
286         char context[AST_MAX_CONTEXT];
287         char mohinterpret[MAX_MUSICCLASS];
288         int stripmsd;
289         int channel;                                    /*!< Channel Number or CRV */
290
291         /* Options to be checked by user */
292         int cid_ani2;                                           /*!< Automatic Number Identification number (Alternate PRI caller ID number) */
293         int cid_ton;                                    /*!< Type Of Number (TON) */
294         int callingpres;                                /*!< The value of calling presentation that we're going to use when placing a PRI call */
295         char cid_num[AST_MAX_EXTENSION];
296         char cid_subaddr[AST_MAX_EXTENSION];
297         char cid_name[AST_MAX_EXTENSION];
298         char cid_ani[AST_MAX_EXTENSION];
299         /*! \brief User tag for party id's sent from this device driver. */
300         char user_tag[AST_MAX_EXTENSION];
301         char exten[AST_MAX_EXTENSION];
302
303         /* Internal variables -- Don't touch */
304         /* Probably will need DS0 number, DS1 number, and a few other things */
305         char dialdest[256];                             /* Queued up digits for overlap dialing.  They will be sent out as information messages when setup ACK is received */
306 #if defined(HAVE_PRI_SETUP_KEYPAD)
307         /*! \brief Keypad digits that came in with the SETUP message. */
308         char keypad_digits[AST_MAX_EXTENSION];
309 #endif  /* defined(HAVE_PRI_SETUP_KEYPAD) */
310         /*! 'w' deferred dialing digits. */
311         char deferred_digits[AST_MAX_EXTENSION];
312         /*! Music class suggested with AST_CONTROL_HOLD. */
313         char moh_suggested[MAX_MUSICCLASS];
314         enum sig_pri_moh_state moh_state;
315
316 #if defined(HAVE_PRI_AOC_EVENTS)
317         struct pri_subcmd_aoc_e aoc_e;
318         int aoc_s_request_invoke_id;     /*!< If an AOC-S request was present for the call, this is the invoke_id to use for the response */
319         unsigned int aoc_s_request_invoke_id_valid:1; /*!< This is set when the AOC-S invoke id is present */
320         unsigned int waiting_for_aoce:1; /*!< Delaying hangup for AOC-E msg. If this is set and AOC-E is received, continue with hangup before timeout period. */
321         unsigned int holding_aoce:1;     /*!< received AOC-E msg from asterisk. holding for disconnect/release */
322 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
323         unsigned int inalarm:1;
324         unsigned int alreadyhungup:1;   /*!< TRUE if the call has already gone/hungup */
325         unsigned int isidlecall:1;              /*!< TRUE if this is an idle call */
326         unsigned int progress:1;                /*!< TRUE if the call has seen inband-information progress through the network */
327
328         /*!
329          * \brief TRUE when this channel is allocated.
330          *
331          * \details
332          * Needed to hold an outgoing channel allocation before the
333          * owner pointer is created.
334          *
335          * \note This is one of several items to check to see if a
336          * channel is available for use.
337          */
338         unsigned int allocated:1;
339         unsigned int outgoing:1;
340         unsigned int digital:1;
341         /*! \brief TRUE if this interface has no B channel.  (call hold and call waiting) */
342         unsigned int no_b_channel:1;
343 #if defined(HAVE_PRI_CALL_WAITING)
344         /*! \brief TRUE if this is a call waiting call */
345         unsigned int is_call_waiting:1;
346 #endif  /* defined(HAVE_PRI_CALL_WAITING) */
347
348         struct ast_channel *owner;
349
350         struct sig_pri_span *pri;
351         q931_call *call;                                /*!< opaque libpri call control structure */
352
353         /*! Call establishment life cycle level for simple comparisons. */
354         enum sig_pri_call_level call_level;
355         /*! \brief Channel reset/restart state. */
356         enum sig_pri_reset_state resetting;
357 #if defined(HAVE_PRI_TRANSFER)
358         /*! If non-NULL, send transfer disconnect successfull response to first call disconnecting. */
359         struct xfer_rsp_data *xfer_data;
360 #endif  /* defined(HAVE_PRI_TRANSFER) */
361         int prioffset;                                  /*!< channel number in span */
362         int logicalspan;                                /*!< logical span number within trunk group */
363         int mastertrunkgroup;                   /*!< what trunk group is our master */
364 #if defined(HAVE_PRI_SERVICE_MESSAGES)
365         /*! \brief Active SRVST_DBKEY out-of-service status value. */
366         unsigned service_status;
367 #endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
368
369         void *chan_pvt;                                 /*!< Private structure of the user of this module. */
370 #if defined(HAVE_PRI_REVERSE_CHARGE)
371         /*!
372          * \brief Reverse charging indication
373          * \details
374          * -1 - No reverse charging,
375          *  1 - Reverse charging,
376          * 0,2-7 - Reserved for future use
377          */
378         int reverse_charging_indication;
379 #endif
380 };
381
382 #if defined(HAVE_PRI_MWI)
383 /*! Maximum number of mailboxes per span. */
384 #define SIG_PRI_MAX_MWI_MAILBOXES                       8
385 /*! Typical maximum length of mwi voicemail controlling number */
386 #define SIG_PRI_MAX_MWI_VM_NUMBER_LEN           10      /* digits in number */
387 /*! Typical maximum length of mwi mailbox number */
388 #define SIG_PRI_MAX_MWI_MBOX_NUMBER_LEN         10      /* digits in number */
389 /*! Typical maximum length of mwi mailbox context */
390 #define SIG_PRI_MAX_MWI_CONTEXT_LEN                     10
391 /*!
392  * \brief Maximum mwi_vm_numbers string length.
393  * \details
394  * max_length = #mailboxes * (vm_number + ',')
395  * The last ',' is a null terminator instead.
396  */
397 #define SIG_PRI_MAX_MWI_VM_NUMBER_STR   (SIG_PRI_MAX_MWI_MAILBOXES \
398         * (SIG_PRI_MAX_MWI_VM_NUMBER_LEN + 1))
399 /*!
400  * \brief Maximum mwi_mailboxs string length.
401  * \details
402  * max_length = #mailboxes * (mbox_number + '@' + context + ',')
403  * The last ',' is a null terminator instead.
404  */
405 #define SIG_PRI_MAX_MWI_MAILBOX_STR             (SIG_PRI_MAX_MWI_MAILBOXES      \
406         * (SIG_PRI_MAX_MWI_MBOX_NUMBER_LEN + 1 + SIG_PRI_MAX_MWI_CONTEXT_LEN + 1))
407
408 struct sig_pri_mbox {
409         /*!
410          * \brief MWI mailbox event subscription.
411          * \note NULL if mailbox not configured.
412          */
413         struct stasis_subscription *sub;
414         /*! \brief Mailbox number */
415         const char *number;
416         /*! \brief Mailbox context. */
417         const char *context;
418         /*! \brief Voicemail controlling number. */
419         const char *vm_number;
420 };
421 #endif  /* defined(HAVE_PRI_MWI) */
422
423 enum sig_pri_colp_signaling {
424         /*! Block all connected line updates. */
425         SIG_PRI_COLP_BLOCK,
426         /*! Only send connected line information with the CONNECT message. */
427         SIG_PRI_COLP_CONNECT,
428         /*! Allow all connected line updates. */
429         SIG_PRI_COLP_UPDATE,
430 };
431
432 struct sig_pri_span {
433         /* Should be set by user */
434         struct ast_cc_config_params *cc_params;                 /*!< CC config parameters for each new call. */
435         int     pritimers[PRI_MAX_TIMERS];
436         int overlapdial;                                                                /*!< In overlap dialing mode */
437         int qsigchannelmapping;                                                 /*!< QSIG channel mapping type */
438         int discardremoteholdretrieval;                                 /*!< shall remote hold or remote retrieval notifications be discarded? */
439         int facilityenable;                                                             /*!< Enable facility IEs */
440 #if defined(HAVE_PRI_L2_PERSISTENCE)
441         /*! Layer 2 persistence option. */
442         int l2_persistence;
443 #endif  /* defined(HAVE_PRI_L2_PERSISTENCE) */
444         int dchan_logical_span[SIG_PRI_NUM_DCHANS];             /*!< Logical offset the DCHAN sits in */
445         int fds[SIG_PRI_NUM_DCHANS];                                    /*!< FD's for d-channels */
446
447 #if defined(HAVE_PRI_AOC_EVENTS)
448         int aoc_passthrough_flag;                                               /*!< Represents what AOC messages (S,D,E) are allowed to pass-through */
449         unsigned int aoce_delayhangup:1;                                /*!< defines whether the aoce_delayhangup option is enabled or not */
450 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
451
452 #if defined(HAVE_PRI_SERVICE_MESSAGES)
453         unsigned int enable_service_message_support:1;  /*!< enable SERVICE message support */
454 #endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
455 #ifdef HAVE_PRI_INBANDDISCONNECT
456         unsigned int inbanddisconnect:1;                                /*!< Should we support inband audio after receiving DISCONNECT? */
457 #endif
458 #if defined(HAVE_PRI_CALL_HOLD)
459         /*! \brief TRUE if held calls are transferred on disconnect. */
460         unsigned int hold_disconnect_transfer:1;
461 #endif  /* defined(HAVE_PRI_CALL_HOLD) */
462         /*!
463          * \brief TRUE if call transfer is enabled for the span.
464          * \note Support switch-side transfer (called 2BCT, RLT or other names)
465          */
466         unsigned int transfer:1;
467 #if defined(HAVE_PRI_CALL_WAITING)
468         /*! \brief TRUE if we will allow incoming ISDN call waiting calls. */
469         unsigned int allow_call_waiting_calls:1;
470 #endif  /* defined(HAVE_PRI_CALL_WAITING) */
471         /*! TRUE if layer 1 alarm status is ignored */
472         unsigned int layer1_ignored:1;
473         /*!
474          * TRUE if a new call's sig_pri_chan.user_tag[] has the MSN
475          * appended to the initial_user_tag[].
476          */
477         unsigned int append_msn_to_user_tag:1;
478         /*! TRUE if a PROCEEDING message needs to unsquelch the received audio. */
479         unsigned int inband_on_proceeding:1;
480 #if defined(HAVE_PRI_MCID)
481         /*! \brief TRUE if allow sending MCID request on this span. */
482         unsigned int mcid_send:1;
483 #endif  /* defined(HAVE_PRI_MCID) */
484 #if defined(HAVE_PRI_DATETIME_SEND)
485         /*! \brief Configured date/time ie send policy option. */
486         int datetime_send;
487 #endif  /* defined(HAVE_PRI_DATETIME_SEND) */
488         int dialplan;                                                   /*!< Dialing plan */
489         int localdialplan;                                              /*!< Local dialing plan */
490         int cpndialplan;                                                /*!< Connected party dialing plan */
491         char internationalprefix[10];                   /*!< country access code ('00' for european dialplans) */
492         char nationalprefix[10];                                /*!< area access code ('0' for european dialplans) */
493         char localprefix[20];                                   /*!< area access code + area code ('0'+area code for european dialplans) */
494         char privateprefix[20];                                 /*!< for private dialplans */
495         char unknownprefix[20];                                 /*!< for unknown dialplans */
496         enum sig_pri_moh_signaling moh_signaling;
497         /*! Send connected line signaling to peer option. */
498         enum sig_pri_colp_signaling colp_send;
499         long resetinterval;                                             /*!< Interval (in seconds) for resetting unused channels */
500 #if defined(HAVE_PRI_DISPLAY_TEXT)
501         unsigned long display_flags_send;               /*!< PRI_DISPLAY_OPTION_xxx flags for display text sending */
502         unsigned long display_flags_receive;    /*!< PRI_DISPLAY_OPTION_xxx flags for display text receiving */
503 #endif  /* defined(HAVE_PRI_DISPLAY_TEXT) */
504 #if defined(HAVE_PRI_MWI)
505         /*! \brief Active MWI mailboxes */
506         struct sig_pri_mbox mbox[SIG_PRI_MAX_MWI_MAILBOXES];
507         /*!
508          * \brief Comma separated list of mailboxes to indicate MWI.
509          * \note Empty if disabled.
510          * \note Format: mailbox_number[@context]{,mailbox_number[@context]}
511          * \note String is split apart when span is started.
512          */
513         char mwi_mailboxes[SIG_PRI_MAX_MWI_MAILBOX_STR];
514         /*!
515          * \brief Comma separated list of voicemail access controlling numbers for MWI.
516          * \note Format: vm_number{,vm_number}
517          * \note String is split apart when span is started.
518          */
519         char mwi_vm_numbers[SIG_PRI_MAX_MWI_VM_NUMBER_STR];
520 #endif  /* defined(HAVE_PRI_MWI) */
521         /*!
522          * \brief Initial user tag for party id's sent from this device driver.
523          * \note String set by config file.
524          */
525         char initial_user_tag[AST_MAX_EXTENSION];
526         char msn_list[AST_MAX_EXTENSION];               /*!< Comma separated list of MSNs to handle.  Empty if disabled. */
527         char idleext[AST_MAX_EXTENSION];                /*!< Where to idle extra calls */
528         char idlecontext[AST_MAX_CONTEXT];              /*!< What context to use for idle */
529         char idledial[AST_MAX_EXTENSION];               /*!< What to dial before dumping */
530         int minunused;                                                  /*!< Min # of channels to keep empty */
531         int minidle;                                                    /*!< Min # of "idling" calls to keep active */
532         int nodetype;                                                   /*!< Node type */
533         int switchtype;                                                 /*!< Type of switch to emulate */
534         int nsf;                                                                /*!< Network-Specific Facilities */
535         int trunkgroup;                                                 /*!< What our trunkgroup is */
536 #if defined(HAVE_PRI_CCSS)
537         int cc_ptmp_recall_mode;                                /*!< CC PTMP recall mode. globalRecall(0), specificRecall(1) */
538         int cc_qsig_signaling_link_req;                 /*!< CC Q.SIG signaling link retention (Party A) release(0), retain(1), do-not-care(2) */
539         int cc_qsig_signaling_link_rsp;                 /*!< CC Q.SIG signaling link retention (Party B) release(0), retain(1) */
540 #endif  /* defined(HAVE_PRI_CCSS) */
541 #if defined(HAVE_PRI_CALL_WAITING)
542         /*!
543          * \brief Number of extra outgoing calls to allow on a span before
544          * considering that span congested.
545          */
546         int max_call_waiting_calls;
547         struct {
548                 int stripmsd;
549                 unsigned int hidecallerid:1;
550                 unsigned int hidecalleridname:1;      /*!< Hide just the name not the number for legacy PBX use */
551                 unsigned int immediate:1;                       /*!< Answer before getting digits? */
552                 unsigned int priexclusive:1;                    /*!< Whether or not to override and use exculsive mode for channel selection */
553                 unsigned int priindication_oob:1;
554                 unsigned int use_callerid:1;                    /*!< Whether or not to use caller id on this channel */
555                 unsigned int use_callingpres:1;                 /*!< Whether to use the callingpres the calling switch sends */
556                 char context[AST_MAX_CONTEXT];
557                 char mohinterpret[MAX_MUSICCLASS];
558         } ch_cfg;
559
560         /*!
561          * \brief Number of outstanding call waiting calls.
562          * \note Must be zero to allow new calls from asterisk to
563          * immediately allocate a B channel.
564          */
565         int num_call_waiting_calls;
566 #endif  /* defined(HAVE_PRI_CALL_WAITING) */
567         int dchanavail[SIG_PRI_NUM_DCHANS];             /*!< Whether each channel is available */
568         int debug;                                                              /*!< set to true if to dump PRI event info */
569         int span;                                                               /*!< span number put into user output messages */
570         int resetting;                                                  /*!< true if span is being reset/restarted */
571         int resetpos;                                                   /*!< current position during a reset (-1 if not started) */
572         int sig;                                                                /*!< ISDN signalling type (SIG_PRI, SIG_BRI, SIG_BRI_PTMP, etc...) */
573         int new_chan_seq;                                               /*!< New struct ast_channel sequence number */
574         /*! TRUE if we have already whined about no D channels available. */
575         unsigned int no_d_channels:1;
576
577         /* Everything after here is internally set */
578         struct pri *dchans[SIG_PRI_NUM_DCHANS];         /*!< Actual d-channels */
579         struct pri *pri;                                                        /*!< Currently active D-channel */
580         /*!
581          * List of private structures of the user of this module for no B channel
582          * interfaces. (hold and call waiting interfaces)
583          */
584         void *no_b_chan_iflist;
585         /*!
586          * List of private structures of the user of this module for no B channel
587          * interfaces. (hold and call waiting interfaces)
588          */
589         void *no_b_chan_end;
590         int numchans;                                                           /*!< Num of channels we represent */
591         struct sig_pri_chan *pvts[SIG_PRI_MAX_CHANNELS];/*!< Member channel pvt structs */
592         pthread_t master;                                                       /*!< Thread of master */
593         ast_mutex_t lock;                                                       /*!< libpri access Mutex */
594         time_t lastreset;                                                       /*!< time when unused channels were last reset */
595         /*!
596          * \brief Congestion device state of the span.
597          * \details
598          * AST_DEVICE_NOT_INUSE - Span does not have all B channels in use.
599          * AST_DEVICE_BUSY - All B channels are in use.
600          * AST_DEVICE_UNAVAILABLE - Span is in alarm.
601          * \note
602          * Device name: \verbatim DAHDI/I<span>/congestion. \endverbatim
603          */
604         int congestion_devstate;
605 #if defined(THRESHOLD_DEVSTATE_PLACEHOLDER)
606         /*! \todo An ISDN span threshold device state could be useful in determining how often a span utilization goes over a configurable threshold. */
607         /*!
608          * \brief User threshold device state of the span.
609          * \details
610          * AST_DEVICE_NOT_INUSE - There are no B channels in use.
611          * AST_DEVICE_INUSE - The number of B channels in use is less than
612          *    the configured threshold but not zero.
613          * AST_DEVICE_BUSY - The number of B channels in use meets or exceeds
614          *    the configured threshold.
615          * AST_DEVICE_UNAVAILABLE - Span is in alarm.
616          * \note
617          * Device name:  DAHDI/I<span>/threshold
618          */
619         int threshold_devstate;
620         /*!
621          * \brief Number of B channels in use to consider the span in a busy state.
622          * \note Setting the threshold to zero is interpreted as all B channels.
623          */
624         int user_busy_threshold;
625 #endif  /* defined(THRESHOLD_DEVSTATE_PLACEHOLDER) */
626 };
627
628 void sig_pri_extract_called_num_subaddr(struct sig_pri_chan *p, const char *rdest, char *called, size_t called_buff_size);
629 int sig_pri_call(struct sig_pri_chan *p, struct ast_channel *ast, const char *rdest, int timeout, int layer1);
630
631 int sig_pri_hangup(struct sig_pri_chan *p, struct ast_channel *ast);
632
633 int sig_pri_indicate(struct sig_pri_chan *p, struct ast_channel *chan, int condition, const void *data, size_t datalen);
634
635 int sig_pri_answer(struct sig_pri_chan *p, struct ast_channel *ast);
636
637 int sig_pri_is_chan_available(struct sig_pri_chan *pvt);
638 int sig_pri_available(struct sig_pri_chan **pvt, int is_specific_channel);
639
640 void sig_pri_init_pri(struct sig_pri_span *pri);
641
642 /* If return 0, it means this function was able to handle it (pre setup digits).  If non zero, the user of this
643  * functions should handle it normally (generate inband DTMF) */
644 int sig_pri_digit_begin(struct sig_pri_chan *pvt, struct ast_channel *ast, char digit);
645 void sig_pri_dial_complete(struct sig_pri_chan *pvt, struct ast_channel *ast);
646
647 void sig_pri_stop_pri(struct sig_pri_span *pri);
648 int sig_pri_start_pri(struct sig_pri_span *pri);
649
650 void sig_pri_set_alarm(struct sig_pri_chan *p, int in_alarm);
651 void sig_pri_chan_alarm_notify(struct sig_pri_chan *p, int noalarm);
652
653 int sig_pri_is_alarm_ignored(struct sig_pri_span *pri);
654 void pri_event_alarm(struct sig_pri_span *pri, int index, int before_start_pri);
655 void pri_event_noalarm(struct sig_pri_span *pri, int index, int before_start_pri);
656
657 struct ast_channel *sig_pri_request(struct sig_pri_chan *p, enum sig_pri_law law, const struct ast_channel *requestor, int transfercapability);
658
659 struct sig_pri_chan *sig_pri_chan_new(void *pvt_data, struct sig_pri_span *pri, int logicalspan, int channo, int trunkgroup);
660 void sig_pri_chan_delete(struct sig_pri_chan *doomed);
661
662 int pri_is_up(struct sig_pri_span *pri);
663
664 struct mansession;
665 int sig_pri_ami_show_spans(struct mansession *s, const char *show_cmd, struct sig_pri_span *pri, const int *dchannels, const char *action_id);
666
667 void sig_pri_cli_show_channels_header(int fd);
668 void sig_pri_cli_show_channels(int fd, struct sig_pri_span *pri);
669 void sig_pri_cli_show_spans(int fd, int span, struct sig_pri_span *pri);
670
671 void sig_pri_cli_show_span(int fd, int *dchannels, struct sig_pri_span *pri);
672
673 int pri_send_keypad_facility_exec(struct sig_pri_chan *p, const char *digits);
674 int pri_send_callrerouting_facility_exec(struct sig_pri_chan *p, enum ast_channel_state chanstate, const char *destination, const char *original, const char *reason);
675
676 #if defined(HAVE_PRI_SERVICE_MESSAGES)
677 int pri_maintenance_bservice(struct pri *pri, struct sig_pri_chan *p, int changestatus);
678 #endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
679
680 void sig_pri_fixup(struct ast_channel *oldchan, struct ast_channel *newchan, struct sig_pri_chan *pchan);
681 #if defined(HAVE_PRI_DISPLAY_TEXT)
682 void sig_pri_sendtext(struct sig_pri_chan *pchan, const char *text);
683 #endif  /* defined(HAVE_PRI_DISPLAY_TEXT) */
684
685 int sig_pri_cc_agent_init(struct ast_cc_agent *agent, struct sig_pri_chan *pvt_chan);
686 int sig_pri_cc_agent_start_offer_timer(struct ast_cc_agent *agent);
687 int sig_pri_cc_agent_stop_offer_timer(struct ast_cc_agent *agent);
688 void sig_pri_cc_agent_req_rsp(struct ast_cc_agent *agent, enum ast_cc_agent_response_reason reason);
689 int sig_pri_cc_agent_status_req(struct ast_cc_agent *agent);
690 int sig_pri_cc_agent_stop_ringing(struct ast_cc_agent *agent);
691 int sig_pri_cc_agent_party_b_free(struct ast_cc_agent *agent);
692 int sig_pri_cc_agent_start_monitoring(struct ast_cc_agent *agent);
693 int sig_pri_cc_agent_callee_available(struct ast_cc_agent *agent);
694 void sig_pri_cc_agent_destructor(struct ast_cc_agent *agent);
695
696 int sig_pri_cc_monitor_req_cc(struct ast_cc_monitor *monitor, int *available_timer_id);
697 int sig_pri_cc_monitor_suspend(struct ast_cc_monitor *monitor);
698 int sig_pri_cc_monitor_unsuspend(struct ast_cc_monitor *monitor);
699 int sig_pri_cc_monitor_status_rsp(struct ast_cc_monitor *monitor, enum ast_device_state devstate);
700 int sig_pri_cc_monitor_cancel_available_timer(struct ast_cc_monitor *monitor, int *sched_id);
701 void sig_pri_cc_monitor_destructor(void *monitor_pvt);
702
703 int sig_pri_load(const char *cc_type_name);
704 void sig_pri_unload(void);
705
706 #endif /* _SIG_PRI_H */