2 * Asterisk -- An open source telephony toolkit.
4 * Copyright (C) 2013, Digium, Inc.
6 * Joshua Colp <jcolp@digium.com>
8 * See http://www.asterisk.org for more information about
9 * the Asterisk project. Please do not directly contact
10 * any of the maintainers of this project for assistance;
11 * the project provides a web site, mailing lists and IRC
12 * channels for your use.
14 * This program is free software, distributed under the terms of
15 * the GNU General Public License Version 2. See the LICENSE file
16 * at the top of the source tree.
21 * \author Joshua Colp <jcolp@digium.com>
23 * \brief PSJIP SIP Channel Driver
25 * \ingroup channel_drivers
29 <depend>pjproject</depend>
30 <depend>res_pjsip</depend>
31 <depend>res_pjsip_session</depend>
32 <support_level>core</support_level>
41 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
43 #include "asterisk/lock.h"
44 #include "asterisk/channel.h"
45 #include "asterisk/module.h"
46 #include "asterisk/pbx.h"
47 #include "asterisk/rtp_engine.h"
48 #include "asterisk/acl.h"
49 #include "asterisk/callerid.h"
50 #include "asterisk/file.h"
51 #include "asterisk/cli.h"
52 #include "asterisk/app.h"
53 #include "asterisk/musiconhold.h"
54 #include "asterisk/causes.h"
55 #include "asterisk/taskprocessor.h"
56 #include "asterisk/dsp.h"
57 #include "asterisk/stasis_endpoints.h"
58 #include "asterisk/stasis_channels.h"
59 #include "asterisk/indications.h"
61 #include "asterisk/res_pjsip.h"
62 #include "asterisk/res_pjsip_session.h"
65 <function name="PJSIP_DIAL_CONTACTS" language="en_US">
67 Return a dial string for dialing all contacts on an AOR.
70 <parameter name="endpoint" required="true">
71 <para>Name of the endpoint</para>
73 <parameter name="aor" required="false">
74 <para>Name of an AOR to use, if not specified the configured AORs on the endpoint are used</para>
76 <parameter name="request_user" required="false">
77 <para>Optional request user to use in the request URI</para>
81 <para>Returns a properly formatted dial string for dialing all contacts on an AOR.</para>
84 <function name="PJSIP_MEDIA_OFFER" language="en_US">
86 Media and codec offerings to be set on an outbound SIP channel prior to dialing.
89 <parameter name="media" required="true">
90 <para>types of media offered</para>
94 <para>Returns the codecs offered based upon the media choice</para>
99 static const char desc[] = "PJSIP Channel";
100 static const char channel_type[] = "PJSIP";
102 static unsigned int chan_idx;
105 * \brief Positions of various media
107 enum sip_session_media_position {
108 /*! \brief First is audio */
110 /*! \brief Second is video */
112 /*! \brief Last is the size for media details */
116 struct chan_pjsip_pvt {
117 struct ast_sip_session_media *media[SIP_MEDIA_SIZE];
120 static void chan_pjsip_pvt_dtor(void *obj)
122 struct chan_pjsip_pvt *pvt = obj;
125 for (i = 0; i < SIP_MEDIA_SIZE; ++i) {
126 ao2_cleanup(pvt->media[i]);
127 pvt->media[i] = NULL;
131 /* \brief Asterisk core interaction functions */
132 static struct ast_channel *chan_pjsip_request(const char *type, struct ast_format_cap *cap, const struct ast_channel *requestor, const char *data, int *cause);
133 static int chan_pjsip_sendtext(struct ast_channel *ast, const char *text);
134 static int chan_pjsip_digit_begin(struct ast_channel *ast, char digit);
135 static int chan_pjsip_digit_end(struct ast_channel *ast, char digit, unsigned int duration);
136 static int chan_pjsip_call(struct ast_channel *ast, const char *dest, int timeout);
137 static int chan_pjsip_hangup(struct ast_channel *ast);
138 static int chan_pjsip_answer(struct ast_channel *ast);
139 static struct ast_frame *chan_pjsip_read(struct ast_channel *ast);
140 static int chan_pjsip_write(struct ast_channel *ast, struct ast_frame *f);
141 static int chan_pjsip_indicate(struct ast_channel *ast, int condition, const void *data, size_t datalen);
142 static int chan_pjsip_transfer(struct ast_channel *ast, const char *target);
143 static int chan_pjsip_fixup(struct ast_channel *oldchan, struct ast_channel *newchan);
144 static int chan_pjsip_devicestate(const char *data);
145 static int chan_pjsip_queryoption(struct ast_channel *ast, int option, void *data, int *datalen);
147 /*! \brief PBX interface structure for channel registration */
148 static struct ast_channel_tech chan_pjsip_tech = {
149 .type = channel_type,
150 .description = "PJSIP Channel Driver",
151 .requester = chan_pjsip_request,
152 .send_text = chan_pjsip_sendtext,
153 .send_digit_begin = chan_pjsip_digit_begin,
154 .send_digit_end = chan_pjsip_digit_end,
155 .call = chan_pjsip_call,
156 .hangup = chan_pjsip_hangup,
157 .answer = chan_pjsip_answer,
158 .read = chan_pjsip_read,
159 .write = chan_pjsip_write,
160 .write_video = chan_pjsip_write,
161 .exception = chan_pjsip_read,
162 .indicate = chan_pjsip_indicate,
163 .transfer = chan_pjsip_transfer,
164 .fixup = chan_pjsip_fixup,
165 .devicestate = chan_pjsip_devicestate,
166 .queryoption = chan_pjsip_queryoption,
167 .properties = AST_CHAN_TP_WANTSJITTER | AST_CHAN_TP_CREATESJITTER
170 /*! \brief SIP session interaction functions */
171 static void chan_pjsip_session_begin(struct ast_sip_session *session);
172 static void chan_pjsip_session_end(struct ast_sip_session *session);
173 static int chan_pjsip_incoming_request(struct ast_sip_session *session, struct pjsip_rx_data *rdata);
174 static void chan_pjsip_incoming_response(struct ast_sip_session *session, struct pjsip_rx_data *rdata);
176 /*! \brief SIP session supplement structure */
177 static struct ast_sip_session_supplement chan_pjsip_supplement = {
179 .priority = AST_SIP_SESSION_SUPPLEMENT_PRIORITY_CHANNEL,
180 .session_begin = chan_pjsip_session_begin,
181 .session_end = chan_pjsip_session_end,
182 .incoming_request = chan_pjsip_incoming_request,
183 .incoming_response = chan_pjsip_incoming_response,
186 static int chan_pjsip_incoming_ack(struct ast_sip_session *session, struct pjsip_rx_data *rdata);
188 static struct ast_sip_session_supplement chan_pjsip_ack_supplement = {
190 .priority = AST_SIP_SESSION_SUPPLEMENT_PRIORITY_CHANNEL,
191 .incoming_request = chan_pjsip_incoming_ack,
194 /*! \brief Dialplan function for constructing a dial string for calling all contacts */
195 static int chan_pjsip_dial_contacts(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
197 RAII_VAR(struct ast_sip_endpoint *, endpoint, NULL, ao2_cleanup);
198 RAII_VAR(struct ast_str *, dial, NULL, ast_free_ptr);
199 const char *aor_name;
202 AST_DECLARE_APP_ARGS(args,
203 AST_APP_ARG(endpoint_name);
204 AST_APP_ARG(aor_name);
205 AST_APP_ARG(request_user);
208 AST_STANDARD_APP_ARGS(args, data);
210 if (ast_strlen_zero(args.endpoint_name)) {
211 ast_log(LOG_WARNING, "An endpoint name must be specified when using the '%s' dialplan function\n", cmd);
213 } else if (!(endpoint = ast_sorcery_retrieve_by_id(ast_sip_get_sorcery(), "endpoint", args.endpoint_name))) {
214 ast_log(LOG_WARNING, "Specified endpoint '%s' was not found\n", args.endpoint_name);
218 aor_name = S_OR(args.aor_name, endpoint->aors);
220 if (ast_strlen_zero(aor_name)) {
221 ast_log(LOG_WARNING, "No AOR has been provided and no AORs are configured on endpoint '%s'\n", args.endpoint_name);
223 } else if (!(dial = ast_str_create(len))) {
224 ast_log(LOG_WARNING, "Could not get enough buffer space for dialing contacts\n");
226 } else if (!(rest = ast_strdupa(aor_name))) {
227 ast_log(LOG_WARNING, "Could not duplicate provided AORs\n");
231 while ((aor_name = strsep(&rest, ","))) {
232 RAII_VAR(struct ast_sip_aor *, aor, ast_sip_location_retrieve_aor(aor_name), ao2_cleanup);
233 RAII_VAR(struct ao2_container *, contacts, NULL, ao2_cleanup);
234 struct ao2_iterator it_contacts;
235 struct ast_sip_contact *contact;
238 /* If the AOR provided is not found skip it, there may be more */
240 } else if (!(contacts = ast_sip_location_retrieve_aor_contacts(aor))) {
241 /* No contacts are available, skip it as well */
243 } else if (!ao2_container_count(contacts)) {
244 /* We were given a container but no contacts are in it... */
248 it_contacts = ao2_iterator_init(contacts, 0);
249 for (; (contact = ao2_iterator_next(&it_contacts)); ao2_ref(contact, -1)) {
250 ast_str_append(&dial, -1, "PJSIP/");
252 if (!ast_strlen_zero(args.request_user)) {
253 ast_str_append(&dial, -1, "%s@", args.request_user);
255 ast_str_append(&dial, -1, "%s/%s&", args.endpoint_name, contact->uri);
257 ao2_iterator_destroy(&it_contacts);
260 /* Trim the '&' at the end off */
261 ast_str_truncate(dial, ast_str_strlen(dial) - 1);
263 ast_copy_string(buf, ast_str_buffer(dial), len);
268 static struct ast_custom_function chan_pjsip_dial_contacts_function = {
269 .name = "PJSIP_DIAL_CONTACTS",
270 .read = chan_pjsip_dial_contacts,
273 static int media_offer_read_av(struct ast_sip_session *session, char *buf,
274 size_t len, enum ast_format_type media_type)
277 struct ast_format fmt;
280 for (i = 0; ast_codec_pref_index(&session->override_prefs, i, &fmt); ++i) {
281 if (AST_FORMAT_GET_TYPE(fmt.id) != media_type) {
285 name = ast_getformatname(&fmt);
287 if (ast_strlen_zero(name)) {
288 ast_log(LOG_WARNING, "PJSIP_MEDIA_OFFER unrecognized format %s\n", name);
292 /* add one since we'll include a comma */
293 size = strlen(name) + 1;
299 /* no reason to use strncat here since we have already ensured buf has
300 enough space, so strcat can be safely used */
306 /* remove the extra comma */
307 buf[strlen(buf) - 1] = '\0';
312 struct media_offer_data {
313 struct ast_sip_session *session;
314 enum ast_format_type media_type;
318 static int media_offer_write_av(void *obj)
320 struct media_offer_data *data = obj;
322 struct ast_format fmt;
323 /* remove all of the given media type first */
324 for (i = 0; ast_codec_pref_index(&data->session->override_prefs, i, &fmt); ++i) {
325 if (AST_FORMAT_GET_TYPE(fmt.id) == data->media_type) {
326 ast_codec_pref_remove(&data->session->override_prefs, &fmt);
329 ast_format_cap_remove_bytype(data->session->req_caps, data->media_type);
330 ast_parse_allow_disallow(&data->session->override_prefs, data->session->req_caps, data->value, 1);
335 static int media_offer_read(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
337 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(chan);
339 if (!strcmp(data, "audio")) {
340 return media_offer_read_av(channel->session, buf, len, AST_FORMAT_TYPE_AUDIO);
341 } else if (!strcmp(data, "video")) {
342 return media_offer_read_av(channel->session, buf, len, AST_FORMAT_TYPE_VIDEO);
348 static int media_offer_write(struct ast_channel *chan, const char *cmd, char *data, const char *value)
350 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(chan);
352 struct media_offer_data mdata = {
353 .session = channel->session,
357 if (!strcmp(data, "audio")) {
358 mdata.media_type = AST_FORMAT_TYPE_AUDIO;
359 } else if (!strcmp(data, "video")) {
360 mdata.media_type = AST_FORMAT_TYPE_VIDEO;
363 return ast_sip_push_task_synchronous(channel->session->serializer, media_offer_write_av, &mdata);
366 static struct ast_custom_function media_offer_function = {
367 .name = "PJSIP_MEDIA_OFFER",
368 .read = media_offer_read,
369 .write = media_offer_write
372 /*! \brief Function called by RTP engine to get local audio RTP peer */
373 static enum ast_rtp_glue_result chan_pjsip_get_rtp_peer(struct ast_channel *chan, struct ast_rtp_instance **instance)
375 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(chan);
376 struct chan_pjsip_pvt *pvt = channel->pvt;
377 struct ast_sip_endpoint *endpoint;
379 if (!pvt || !channel->session || !pvt->media[SIP_MEDIA_AUDIO]->rtp) {
380 return AST_RTP_GLUE_RESULT_FORBID;
383 endpoint = channel->session->endpoint;
385 *instance = pvt->media[SIP_MEDIA_AUDIO]->rtp;
386 ao2_ref(*instance, +1);
388 ast_assert(endpoint != NULL);
389 if (endpoint->media.rtp.encryption != AST_SIP_MEDIA_ENCRYPT_NONE) {
390 return AST_RTP_GLUE_RESULT_FORBID;
393 if (endpoint->media.direct_media.enabled) {
394 return AST_RTP_GLUE_RESULT_REMOTE;
397 return AST_RTP_GLUE_RESULT_LOCAL;
400 /*! \brief Function called by RTP engine to get local video RTP peer */
401 static enum ast_rtp_glue_result chan_pjsip_get_vrtp_peer(struct ast_channel *chan, struct ast_rtp_instance **instance)
403 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(chan);
404 struct chan_pjsip_pvt *pvt = channel->pvt;
405 struct ast_sip_endpoint *endpoint;
407 if (!pvt || !channel->session || !pvt->media[SIP_MEDIA_VIDEO]->rtp) {
408 return AST_RTP_GLUE_RESULT_FORBID;
411 endpoint = channel->session->endpoint;
413 *instance = pvt->media[SIP_MEDIA_VIDEO]->rtp;
414 ao2_ref(*instance, +1);
416 ast_assert(endpoint != NULL);
417 if (endpoint->media.rtp.encryption != AST_SIP_MEDIA_ENCRYPT_NONE) {
418 return AST_RTP_GLUE_RESULT_FORBID;
421 return AST_RTP_GLUE_RESULT_LOCAL;
424 /*! \brief Function called by RTP engine to get peer capabilities */
425 static void chan_pjsip_get_codec(struct ast_channel *chan, struct ast_format_cap *result)
427 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(chan);
429 ast_format_cap_copy(result, channel->session->endpoint->media.codecs);
432 static int send_direct_media_request(void *data)
434 RAII_VAR(struct ast_sip_session *, session, data, ao2_cleanup);
436 return ast_sip_session_refresh(session, NULL, NULL, NULL,
437 session->endpoint->media.direct_media.method, 1);
440 static struct ast_datastore_info direct_media_mitigation_info = { };
442 static int direct_media_mitigate_glare(struct ast_sip_session *session)
444 RAII_VAR(struct ast_datastore *, datastore, NULL, ao2_cleanup);
446 if (session->endpoint->media.direct_media.glare_mitigation ==
447 AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_NONE) {
451 datastore = ast_sip_session_get_datastore(session, "direct_media_glare_mitigation");
456 /* Removing the datastore ensures we won't try to mitigate glare on subsequent reinvites */
457 ast_sip_session_remove_datastore(session, "direct_media_glare_mitigation");
459 if ((session->endpoint->media.direct_media.glare_mitigation ==
460 AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_OUTGOING &&
461 session->inv_session->role == PJSIP_ROLE_UAC) ||
462 (session->endpoint->media.direct_media.glare_mitigation ==
463 AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_INCOMING &&
464 session->inv_session->role == PJSIP_ROLE_UAS)) {
471 static int check_for_rtp_changes(struct ast_channel *chan, struct ast_rtp_instance *rtp,
472 struct ast_sip_session_media *media, int rtcp_fd)
477 changed = ast_rtp_instance_get_and_cmp_remote_address(rtp, &media->direct_media_addr);
479 ast_channel_set_fd(chan, rtcp_fd, -1);
480 ast_rtp_instance_set_prop(media->rtp, AST_RTP_PROPERTY_RTCP, 0);
482 } else if (!ast_sockaddr_isnull(&media->direct_media_addr)){
483 ast_sockaddr_setnull(&media->direct_media_addr);
486 ast_rtp_instance_set_prop(media->rtp, AST_RTP_PROPERTY_RTCP, 1);
487 ast_channel_set_fd(chan, rtcp_fd, ast_rtp_instance_fd(media->rtp, 1));
494 /*! \brief Function called by RTP engine to change where the remote party should send media */
495 static int chan_pjsip_set_rtp_peer(struct ast_channel *chan,
496 struct ast_rtp_instance *rtp,
497 struct ast_rtp_instance *vrtp,
498 struct ast_rtp_instance *tpeer,
499 const struct ast_format_cap *cap,
502 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(chan);
503 struct chan_pjsip_pvt *pvt = channel->pvt;
504 struct ast_sip_session *session = channel->session;
506 struct ast_channel *bridge_peer;
508 /* Don't try to do any direct media shenanigans on early bridges */
509 bridge_peer = ast_channel_bridge_peer(chan);
510 if ((rtp || vrtp || tpeer) && !bridge_peer) {
513 ast_channel_cleanup(bridge_peer);
515 if (nat_active && session->endpoint->media.direct_media.disable_on_nat) {
519 if (pvt->media[SIP_MEDIA_AUDIO]) {
520 changed |= check_for_rtp_changes(chan, rtp, pvt->media[SIP_MEDIA_AUDIO], 1);
522 if (pvt->media[SIP_MEDIA_VIDEO]) {
523 changed |= check_for_rtp_changes(chan, vrtp, pvt->media[SIP_MEDIA_VIDEO], 3);
526 if (direct_media_mitigate_glare(session)) {
530 if (cap && !ast_format_cap_is_empty(cap) && !ast_format_cap_identical(session->direct_media_cap, cap)) {
531 ast_format_cap_copy(session->direct_media_cap, cap);
536 ao2_ref(session, +1);
539 if (ast_sip_push_task(session->serializer, send_direct_media_request, session)) {
540 ao2_cleanup(session);
547 /*! \brief Local glue for interacting with the RTP engine core */
548 static struct ast_rtp_glue chan_pjsip_rtp_glue = {
550 .get_rtp_info = chan_pjsip_get_rtp_peer,
551 .get_vrtp_info = chan_pjsip_get_vrtp_peer,
552 .get_codec = chan_pjsip_get_codec,
553 .update_peer = chan_pjsip_set_rtp_peer,
556 /*! \brief Function called to create a new PJSIP Asterisk channel */
557 static struct ast_channel *chan_pjsip_new(struct ast_sip_session *session, int state, const char *exten, const char *title, const char *linkedid, const char *cid_name)
559 struct ast_channel *chan;
560 struct ast_format fmt;
561 RAII_VAR(struct chan_pjsip_pvt *, pvt, NULL, ao2_cleanup);
562 struct ast_sip_channel_pvt *channel;
564 if (!(pvt = ao2_alloc(sizeof(*pvt), chan_pjsip_pvt_dtor))) {
568 if (!(chan = ast_channel_alloc(1, state, S_OR(session->id.number.str, ""), S_OR(session->id.name.str, ""), "", "", "", linkedid, 0, "PJSIP/%s-%08x", ast_sorcery_object_get_id(session->endpoint),
569 ast_atomic_fetchadd_int((int *)&chan_idx, +1)))) {
573 ast_channel_tech_set(chan, &chan_pjsip_tech);
575 if (!(channel = ast_sip_channel_pvt_alloc(pvt, session))) {
580 ast_channel_stage_snapshot(chan);
582 /* If res_pjsip_session is ever updated to create/destroy ast_sip_session_media
583 * during a call such as if multiple same-type stream support is introduced,
584 * these will need to be recaptured as well */
585 pvt->media[SIP_MEDIA_AUDIO] = ao2_find(session->media, "audio", OBJ_KEY);
586 pvt->media[SIP_MEDIA_VIDEO] = ao2_find(session->media, "video", OBJ_KEY);
587 ast_channel_tech_pvt_set(chan, channel);
588 if (pvt->media[SIP_MEDIA_AUDIO] && pvt->media[SIP_MEDIA_AUDIO]->rtp) {
589 ast_rtp_instance_set_channel_id(pvt->media[SIP_MEDIA_AUDIO]->rtp, ast_channel_uniqueid(chan));
591 if (pvt->media[SIP_MEDIA_VIDEO] && pvt->media[SIP_MEDIA_VIDEO]->rtp) {
592 ast_rtp_instance_set_channel_id(pvt->media[SIP_MEDIA_VIDEO]->rtp, ast_channel_uniqueid(chan));
595 if (ast_format_cap_is_empty(session->req_caps) || !ast_format_cap_has_joint(session->req_caps, session->endpoint->media.codecs)) {
596 ast_format_cap_copy(ast_channel_nativeformats(chan), session->endpoint->media.codecs);
598 ast_format_cap_copy(ast_channel_nativeformats(chan), session->req_caps);
601 ast_codec_choose(&session->endpoint->media.prefs, ast_channel_nativeformats(chan), 1, &fmt);
602 ast_format_copy(ast_channel_writeformat(chan), &fmt);
603 ast_format_copy(ast_channel_rawwriteformat(chan), &fmt);
604 ast_format_copy(ast_channel_readformat(chan), &fmt);
605 ast_format_copy(ast_channel_rawreadformat(chan), &fmt);
607 if (state == AST_STATE_RING) {
608 ast_channel_rings_set(chan, 1);
611 ast_channel_adsicpe_set(chan, AST_ADSI_UNAVAILABLE);
613 ast_channel_context_set(chan, session->endpoint->context);
614 ast_channel_exten_set(chan, S_OR(exten, "s"));
615 ast_channel_priority_set(chan, 1);
617 ast_channel_callgroup_set(chan, session->endpoint->pickup.callgroup);
618 ast_channel_pickupgroup_set(chan, session->endpoint->pickup.pickupgroup);
620 ast_channel_named_callgroups_set(chan, session->endpoint->pickup.named_callgroups);
621 ast_channel_named_pickupgroups_set(chan, session->endpoint->pickup.named_pickupgroups);
623 if (!ast_strlen_zero(session->endpoint->language)) {
624 ast_channel_language_set(chan, session->endpoint->language);
627 if (!ast_strlen_zero(session->endpoint->zone)) {
628 struct ast_tone_zone *zone = ast_get_indication_zone(session->endpoint->zone);
630 ast_log(LOG_ERROR, "Unknown country code '%s' for tonezone. Check indications.conf for available country codes.\n", session->endpoint->zone);
632 ast_channel_zone_set(chan, zone);
635 ast_endpoint_add_channel(session->endpoint->persistent, chan);
637 ast_channel_stage_snapshot_done(chan);
642 static int answer(void *data)
644 pj_status_t status = PJ_SUCCESS;
645 pjsip_tx_data *packet;
646 struct ast_sip_session *session = data;
648 pjsip_dlg_inc_lock(session->inv_session->dlg);
649 if (session->inv_session->invite_tsx) {
650 status = pjsip_inv_answer(session->inv_session, 200, NULL, NULL, &packet);
652 pjsip_dlg_dec_lock(session->inv_session->dlg);
654 if (status == PJ_SUCCESS && packet) {
655 ast_sip_session_send_response(session, packet);
658 ao2_ref(session, -1);
660 return (status == PJ_SUCCESS) ? 0 : -1;
663 /*! \brief Function called by core when we should answer a PJSIP session */
664 static int chan_pjsip_answer(struct ast_channel *ast)
666 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
668 if (ast_channel_state(ast) == AST_STATE_UP) {
672 ast_setstate(ast, AST_STATE_UP);
674 ao2_ref(channel->session, +1);
675 if (ast_sip_push_task(channel->session->serializer, answer, channel->session)) {
676 ast_log(LOG_WARNING, "Unable to push answer task to the threadpool. Cannot answer call\n");
677 ao2_cleanup(channel->session);
684 /*! \brief Internal helper function called when CNG tone is detected */
685 static struct ast_frame *chan_pjsip_cng_tone_detected(struct ast_sip_session *session, struct ast_frame *f)
687 const char *target_context;
690 /* If we only needed this DSP for fax detection purposes we can just drop it now */
691 if (session->endpoint->dtmf == AST_SIP_DTMF_INBAND) {
692 ast_dsp_set_features(session->dsp, DSP_FEATURE_DIGIT_DETECT);
694 ast_dsp_free(session->dsp);
698 /* If already executing in the fax extension don't do anything */
699 if (!strcmp(ast_channel_exten(session->channel), "fax")) {
703 target_context = S_OR(ast_channel_macrocontext(session->channel), ast_channel_context(session->channel));
705 /* We need to unlock the channel here because ast_exists_extension has the
706 * potential to start and stop an autoservice on the channel. Such action
707 * is prone to deadlock if the channel is locked.
709 ast_channel_unlock(session->channel);
710 exists = ast_exists_extension(session->channel, target_context, "fax", 1,
711 S_COR(ast_channel_caller(session->channel)->id.number.valid,
712 ast_channel_caller(session->channel)->id.number.str, NULL));
713 ast_channel_lock(session->channel);
716 ast_verb(2, "Redirecting '%s' to fax extension due to CNG detection\n",
717 ast_channel_name(session->channel));
718 pbx_builtin_setvar_helper(session->channel, "FAXEXTEN", ast_channel_exten(session->channel));
719 if (ast_async_goto(session->channel, target_context, "fax", 1)) {
720 ast_log(LOG_ERROR, "Failed to async goto '%s' into fax extension in '%s'\n",
721 ast_channel_name(session->channel), target_context);
726 ast_log(LOG_NOTICE, "FAX CNG detected on '%s' but no fax extension in '%s'\n",
727 ast_channel_name(session->channel), target_context);
733 /*! \brief Function called by core to read any waiting frames */
734 static struct ast_frame *chan_pjsip_read(struct ast_channel *ast)
736 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
737 struct chan_pjsip_pvt *pvt = channel->pvt;
739 struct ast_sip_session_media *media = NULL;
741 int fdno = ast_channel_fdno(ast);
745 media = pvt->media[SIP_MEDIA_AUDIO];
748 media = pvt->media[SIP_MEDIA_AUDIO];
752 media = pvt->media[SIP_MEDIA_VIDEO];
755 media = pvt->media[SIP_MEDIA_VIDEO];
760 if (!media || !media->rtp) {
761 return &ast_null_frame;
764 if (!(f = ast_rtp_instance_read(media->rtp, rtcp))) {
768 if (f->frametype != AST_FRAME_VOICE) {
772 if (!(ast_format_cap_iscompatible(ast_channel_nativeformats(ast), &f->subclass.format))) {
773 ast_debug(1, "Oooh, format changed to %s\n", ast_getformatname(&f->subclass.format));
774 ast_format_cap_set(ast_channel_nativeformats(ast), &f->subclass.format);
775 ast_set_read_format(ast, ast_channel_readformat(ast));
776 ast_set_write_format(ast, ast_channel_writeformat(ast));
779 if (channel->session->dsp) {
780 f = ast_dsp_process(ast, channel->session->dsp, f);
782 if (f && (f->frametype == AST_FRAME_DTMF)) {
783 if (f->subclass.integer == 'f') {
784 ast_debug(3, "Fax CNG detected on %s\n", ast_channel_name(ast));
785 f = chan_pjsip_cng_tone_detected(channel->session, f);
787 ast_debug(3, "* Detected inband DTMF '%c' on '%s'\n", f->subclass.integer,
788 ast_channel_name(ast));
796 /*! \brief Function called by core to write frames */
797 static int chan_pjsip_write(struct ast_channel *ast, struct ast_frame *frame)
799 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
800 struct chan_pjsip_pvt *pvt = channel->pvt;
801 struct ast_sip_session_media *media;
804 switch (frame->frametype) {
805 case AST_FRAME_VOICE:
806 media = pvt->media[SIP_MEDIA_AUDIO];
811 if (!(ast_format_cap_iscompatible(ast_channel_nativeformats(ast), &frame->subclass.format))) {
815 "Asked to transmit frame type %s, while native formats is %s (read/write = %s/%s)\n",
816 ast_getformatname(&frame->subclass.format),
817 ast_getformatname_multiple(buf, sizeof(buf), ast_channel_nativeformats(ast)),
818 ast_getformatname(ast_channel_readformat(ast)),
819 ast_getformatname(ast_channel_writeformat(ast)));
823 res = ast_rtp_instance_write(media->rtp, frame);
826 case AST_FRAME_VIDEO:
827 if ((media = pvt->media[SIP_MEDIA_VIDEO]) && media->rtp) {
828 res = ast_rtp_instance_write(media->rtp, frame);
831 case AST_FRAME_MODEM:
834 ast_log(LOG_WARNING, "Can't send %d type frames with PJSIP\n", frame->frametype);
842 struct ast_sip_session *session;
843 struct ast_channel *chan;
846 static int fixup(void *data)
848 struct fixup_data *fix_data = data;
849 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(fix_data->chan);
850 struct chan_pjsip_pvt *pvt = channel->pvt;
852 channel->session->channel = fix_data->chan;
853 if (pvt->media[SIP_MEDIA_AUDIO] && pvt->media[SIP_MEDIA_AUDIO]->rtp) {
854 ast_rtp_instance_set_channel_id(pvt->media[SIP_MEDIA_AUDIO]->rtp, ast_channel_uniqueid(fix_data->chan));
856 if (pvt->media[SIP_MEDIA_VIDEO] && pvt->media[SIP_MEDIA_VIDEO]->rtp) {
857 ast_rtp_instance_set_channel_id(pvt->media[SIP_MEDIA_VIDEO]->rtp, ast_channel_uniqueid(fix_data->chan));
863 /*! \brief Function called by core to change the underlying owner channel */
864 static int chan_pjsip_fixup(struct ast_channel *oldchan, struct ast_channel *newchan)
866 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(newchan);
867 struct fixup_data fix_data;
869 fix_data.session = channel->session;
870 fix_data.chan = newchan;
872 if (channel->session->channel != oldchan) {
876 if (ast_sip_push_task_synchronous(channel->session->serializer, fixup, &fix_data)) {
877 ast_log(LOG_WARNING, "Unable to perform channel fixup\n");
884 /*! \brief Function called to get the device state of an endpoint */
885 static int chan_pjsip_devicestate(const char *data)
887 RAII_VAR(struct ast_sip_endpoint *, endpoint, ast_sorcery_retrieve_by_id(ast_sip_get_sorcery(), "endpoint", data), ao2_cleanup);
888 enum ast_device_state state = AST_DEVICE_UNKNOWN;
889 RAII_VAR(struct ast_endpoint_snapshot *, endpoint_snapshot, NULL, ao2_cleanup);
890 RAII_VAR(struct stasis_cache *, cache, NULL, ao2_cleanup);
891 struct ast_devstate_aggregate aggregate;
895 return AST_DEVICE_INVALID;
898 endpoint_snapshot = ast_endpoint_latest_snapshot(ast_endpoint_get_tech(endpoint->persistent),
899 ast_endpoint_get_resource(endpoint->persistent));
901 if (!endpoint_snapshot) {
902 return AST_DEVICE_INVALID;
905 if (endpoint_snapshot->state == AST_ENDPOINT_OFFLINE) {
906 state = AST_DEVICE_UNAVAILABLE;
907 } else if (endpoint_snapshot->state == AST_ENDPOINT_ONLINE) {
908 state = AST_DEVICE_NOT_INUSE;
911 if (!endpoint_snapshot->num_channels || !(cache = ast_channel_cache())) {
915 ast_devstate_aggregate_init(&aggregate);
919 for (num = 0; num < endpoint_snapshot->num_channels; num++) {
920 RAII_VAR(struct stasis_message *, msg, NULL, ao2_cleanup);
921 struct ast_channel_snapshot *snapshot;
923 msg = stasis_cache_get(cache, ast_channel_snapshot_type(),
924 endpoint_snapshot->channel_ids[num]);
930 snapshot = stasis_message_data(msg);
932 if (snapshot->state == AST_STATE_DOWN) {
933 ast_devstate_aggregate_add(&aggregate, AST_DEVICE_NOT_INUSE);
934 } else if (snapshot->state == AST_STATE_RINGING) {
935 ast_devstate_aggregate_add(&aggregate, AST_DEVICE_RINGING);
936 } else if ((snapshot->state == AST_STATE_UP) || (snapshot->state == AST_STATE_RING) ||
937 (snapshot->state == AST_STATE_BUSY)) {
938 ast_devstate_aggregate_add(&aggregate, AST_DEVICE_INUSE);
943 if (endpoint->devicestate_busy_at && (inuse == endpoint->devicestate_busy_at)) {
944 state = AST_DEVICE_BUSY;
945 } else if (ast_devstate_aggregate_result(&aggregate) != AST_DEVICE_INVALID) {
946 state = ast_devstate_aggregate_result(&aggregate);
952 /*! \brief Function called to query options on a channel */
953 static int chan_pjsip_queryoption(struct ast_channel *ast, int option, void *data, int *datalen)
955 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
956 struct ast_sip_session *session = channel->session;
958 enum ast_sip_session_t38state state = T38_STATE_UNAVAILABLE;
961 case AST_OPTION_T38_STATE:
962 if (session->endpoint->media.t38.enabled) {
963 switch (session->t38state) {
964 case T38_LOCAL_REINVITE:
965 case T38_PEER_REINVITE:
966 state = T38_STATE_NEGOTIATING;
969 state = T38_STATE_NEGOTIATED;
972 state = T38_STATE_REJECTED;
975 state = T38_STATE_UNKNOWN;
980 *((enum ast_t38_state *) data) = state;
991 struct indicate_data {
992 struct ast_sip_session *session;
999 static void indicate_data_destroy(void *obj)
1001 struct indicate_data *ind_data = obj;
1003 ast_free(ind_data->frame_data);
1004 ao2_ref(ind_data->session, -1);
1007 static struct indicate_data *indicate_data_alloc(struct ast_sip_session *session,
1008 int condition, int response_code, const void *frame_data, size_t datalen)
1010 struct indicate_data *ind_data = ao2_alloc(sizeof(*ind_data), indicate_data_destroy);
1016 ind_data->frame_data = ast_malloc(datalen);
1017 if (!ind_data->frame_data) {
1018 ao2_ref(ind_data, -1);
1022 memcpy(ind_data->frame_data, frame_data, datalen);
1023 ind_data->datalen = datalen;
1024 ind_data->condition = condition;
1025 ind_data->response_code = response_code;
1026 ao2_ref(session, +1);
1027 ind_data->session = session;
1032 static int indicate(void *data)
1034 pjsip_tx_data *packet = NULL;
1035 struct indicate_data *ind_data = data;
1036 struct ast_sip_session *session = ind_data->session;
1037 int response_code = ind_data->response_code;
1039 if (pjsip_inv_answer(session->inv_session, response_code, NULL, NULL, &packet) == PJ_SUCCESS) {
1040 ast_sip_session_send_response(session, packet);
1043 ao2_ref(ind_data, -1);
1048 /*! \brief Send SIP INFO with video update request */
1049 static int transmit_info_with_vidupdate(void *data)
1052 "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\r\n"
1053 " <media_control>\r\n"
1054 " <vc_primitive>\r\n"
1056 " <picture_fast_update/>\r\n"
1057 " </to_encoder>\r\n"
1058 " </vc_primitive>\r\n"
1059 " </media_control>\r\n";
1061 const struct ast_sip_body body = {
1062 .type = "application",
1063 .subtype = "media_control+xml",
1067 RAII_VAR(struct ast_sip_session *, session, data, ao2_cleanup);
1068 struct pjsip_tx_data *tdata;
1070 if (ast_sip_create_request("INFO", session->inv_session->dlg, session->endpoint, NULL, &tdata)) {
1071 ast_log(LOG_ERROR, "Could not create text video update INFO request\n");
1074 if (ast_sip_add_body(tdata, &body)) {
1075 ast_log(LOG_ERROR, "Could not add body to text video update INFO request\n");
1078 ast_sip_session_send_request(session, tdata);
1083 /*! \brief Update connected line information */
1084 static int update_connected_line_information(void *data)
1086 RAII_VAR(struct ast_sip_session *, session, data, ao2_cleanup);
1087 struct ast_party_id connected_id;
1089 if ((ast_channel_state(session->channel) != AST_STATE_UP) && (session->inv_session->role == PJSIP_UAS_ROLE)) {
1090 int response_code = 0;
1092 if (ast_channel_state(session->channel) == AST_STATE_RING) {
1093 response_code = !session->endpoint->inband_progress ? 180 : 183;
1094 } else if (ast_channel_state(session->channel) == AST_STATE_RINGING) {
1095 response_code = 183;
1098 if (response_code) {
1099 struct pjsip_tx_data *packet = NULL;
1101 if (pjsip_inv_answer(session->inv_session, response_code, NULL, NULL, &packet) == PJ_SUCCESS) {
1102 ast_sip_session_send_response(session, packet);
1106 enum ast_sip_session_refresh_method method = session->endpoint->id.refresh_method;
1108 if (session->inv_session->invite_tsx && (session->inv_session->options & PJSIP_INV_SUPPORT_UPDATE)) {
1109 method = AST_SIP_SESSION_REFRESH_METHOD_UPDATE;
1112 connected_id = ast_channel_connected_effective_id(session->channel);
1113 if ((session->endpoint->id.send_pai || session->endpoint->id.send_rpid) &&
1114 (session->endpoint->id.trust_outbound ||
1115 ((connected_id.name.presentation & AST_PRES_RESTRICTION) == AST_PRES_ALLOWED &&
1116 (connected_id.number.presentation & AST_PRES_RESTRICTION) == AST_PRES_ALLOWED))) {
1117 ast_sip_session_refresh(session, NULL, NULL, NULL, method, 1);
1124 /*! \brief Function called by core to ask the channel to indicate some sort of condition */
1125 static int chan_pjsip_indicate(struct ast_channel *ast, int condition, const void *data, size_t datalen)
1127 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
1128 struct chan_pjsip_pvt *pvt = channel->pvt;
1129 struct ast_sip_session_media *media;
1130 int response_code = 0;
1133 switch (condition) {
1134 case AST_CONTROL_RINGING:
1135 if (ast_channel_state(ast) == AST_STATE_RING) {
1136 if (channel->session->endpoint->inband_progress) {
1137 response_code = 183;
1140 response_code = 180;
1145 ast_devstate_changed(AST_DEVICE_UNKNOWN, AST_DEVSTATE_CACHABLE, "PJSIP/%s", ast_sorcery_object_get_id(channel->session->endpoint));
1147 case AST_CONTROL_BUSY:
1148 if (ast_channel_state(ast) != AST_STATE_UP) {
1149 response_code = 486;
1154 case AST_CONTROL_CONGESTION:
1155 if (ast_channel_state(ast) != AST_STATE_UP) {
1156 response_code = 503;
1161 case AST_CONTROL_INCOMPLETE:
1162 if (ast_channel_state(ast) != AST_STATE_UP) {
1163 response_code = 484;
1168 case AST_CONTROL_PROCEEDING:
1169 if (ast_channel_state(ast) != AST_STATE_UP) {
1170 response_code = 100;
1175 case AST_CONTROL_PROGRESS:
1176 if (ast_channel_state(ast) != AST_STATE_UP) {
1177 response_code = 183;
1182 case AST_CONTROL_VIDUPDATE:
1183 media = pvt->media[SIP_MEDIA_VIDEO];
1184 if (media && media->rtp) {
1185 /* FIXME: Only use this for VP8. Additional work would have to be done to
1186 * fully support other video codecs */
1187 struct ast_format_cap *fcap = ast_channel_nativeformats(ast);
1188 struct ast_format vp8;
1189 ast_format_set(&vp8, AST_FORMAT_VP8, 0);
1190 if (ast_format_cap_iscompatible(fcap, &vp8)) {
1191 /* FIXME Fake RTP write, this will be sent as an RTCP packet. Ideally the
1192 * RTP engine would provide a way to externally write/schedule RTCP
1194 struct ast_frame fr;
1195 fr.frametype = AST_FRAME_CONTROL;
1196 fr.subclass.integer = AST_CONTROL_VIDUPDATE;
1197 res = ast_rtp_instance_write(media->rtp, &fr);
1199 ao2_ref(channel->session, +1);
1201 if (ast_sip_push_task(channel->session->serializer, transmit_info_with_vidupdate, channel->session)) {
1202 ao2_cleanup(channel->session);
1209 case AST_CONTROL_CONNECTED_LINE:
1210 ao2_ref(channel->session, +1);
1211 if (ast_sip_push_task(channel->session->serializer, update_connected_line_information, channel->session)) {
1212 ao2_cleanup(channel->session);
1215 case AST_CONTROL_UPDATE_RTP_PEER:
1217 case AST_CONTROL_PVT_CAUSE_CODE:
1220 case AST_CONTROL_HOLD:
1221 ast_moh_start(ast, data, NULL);
1223 case AST_CONTROL_UNHOLD:
1226 case AST_CONTROL_SRCUPDATE:
1228 case AST_CONTROL_SRCCHANGE:
1230 case AST_CONTROL_REDIRECTING:
1231 if (ast_channel_state(ast) != AST_STATE_UP) {
1232 response_code = 181;
1237 case AST_CONTROL_T38_PARAMETERS:
1240 if (channel->session->t38state == T38_PEER_REINVITE) {
1241 const struct ast_control_t38_parameters *parameters = data;
1243 if (parameters->request_response == AST_T38_REQUEST_PARMS) {
1244 res = AST_T38_REQUEST_PARMS;
1253 ast_log(LOG_WARNING, "Don't know how to indicate condition %d\n", condition);
1258 if (response_code) {
1259 struct indicate_data *ind_data = indicate_data_alloc(channel->session, condition, response_code, data, datalen);
1260 if (!ind_data || ast_sip_push_task(channel->session->serializer, indicate, ind_data)) {
1261 ast_log(LOG_NOTICE, "Cannot send response code %d to endpoint %s. Could not queue task properly\n",
1262 response_code, ast_sorcery_object_get_id(channel->session->endpoint));
1263 ao2_cleanup(ind_data);
1271 struct transfer_data {
1272 struct ast_sip_session *session;
1276 static void transfer_data_destroy(void *obj)
1278 struct transfer_data *trnf_data = obj;
1280 ast_free(trnf_data->target);
1281 ao2_cleanup(trnf_data->session);
1284 static struct transfer_data *transfer_data_alloc(struct ast_sip_session *session, const char *target)
1286 struct transfer_data *trnf_data = ao2_alloc(sizeof(*trnf_data), transfer_data_destroy);
1292 if (!(trnf_data->target = ast_strdup(target))) {
1293 ao2_ref(trnf_data, -1);
1297 ao2_ref(session, +1);
1298 trnf_data->session = session;
1303 static void transfer_redirect(struct ast_sip_session *session, const char *target)
1305 pjsip_tx_data *packet;
1306 enum ast_control_transfer message = AST_TRANSFER_SUCCESS;
1307 pjsip_contact_hdr *contact;
1310 if (pjsip_inv_end_session(session->inv_session, 302, NULL, &packet) != PJ_SUCCESS) {
1311 message = AST_TRANSFER_FAILED;
1312 ast_queue_control_data(session->channel, AST_CONTROL_TRANSFER, &message, sizeof(message));
1317 if (!(contact = pjsip_msg_find_hdr(packet->msg, PJSIP_H_CONTACT, NULL))) {
1318 contact = pjsip_contact_hdr_create(packet->pool);
1321 pj_strdup2_with_null(packet->pool, &tmp, target);
1322 if (!(contact->uri = pjsip_parse_uri(packet->pool, tmp.ptr, tmp.slen, PJSIP_PARSE_URI_AS_NAMEADDR))) {
1323 message = AST_TRANSFER_FAILED;
1324 ast_queue_control_data(session->channel, AST_CONTROL_TRANSFER, &message, sizeof(message));
1325 pjsip_tx_data_dec_ref(packet);
1329 pjsip_msg_add_hdr(packet->msg, (pjsip_hdr *) contact);
1331 ast_sip_session_send_response(session, packet);
1332 ast_queue_control_data(session->channel, AST_CONTROL_TRANSFER, &message, sizeof(message));
1335 static void transfer_refer(struct ast_sip_session *session, const char *target)
1338 enum ast_control_transfer message = AST_TRANSFER_SUCCESS;
1340 pjsip_tx_data *packet;
1342 if (pjsip_xfer_create_uac(session->inv_session->dlg, NULL, &sub) != PJ_SUCCESS) {
1343 message = AST_TRANSFER_FAILED;
1344 ast_queue_control_data(session->channel, AST_CONTROL_TRANSFER, &message, sizeof(message));
1349 if (pjsip_xfer_initiate(sub, pj_cstr(&tmp, target), &packet) != PJ_SUCCESS) {
1350 message = AST_TRANSFER_FAILED;
1351 ast_queue_control_data(session->channel, AST_CONTROL_TRANSFER, &message, sizeof(message));
1352 pjsip_evsub_terminate(sub, PJ_FALSE);
1357 pjsip_xfer_send_request(sub, packet);
1358 ast_queue_control_data(session->channel, AST_CONTROL_TRANSFER, &message, sizeof(message));
1361 static int transfer(void *data)
1363 struct transfer_data *trnf_data = data;
1365 if (ast_channel_state(trnf_data->session->channel) == AST_STATE_RING) {
1366 transfer_redirect(trnf_data->session, trnf_data->target);
1368 transfer_refer(trnf_data->session, trnf_data->target);
1371 ao2_ref(trnf_data, -1);
1375 /*! \brief Function called by core for Asterisk initiated transfer */
1376 static int chan_pjsip_transfer(struct ast_channel *chan, const char *target)
1378 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(chan);
1379 struct transfer_data *trnf_data = transfer_data_alloc(channel->session, target);
1385 if (ast_sip_push_task(channel->session->serializer, transfer, trnf_data)) {
1386 ast_log(LOG_WARNING, "Error requesting transfer\n");
1387 ao2_cleanup(trnf_data);
1394 /*! \brief Function called by core to start a DTMF digit */
1395 static int chan_pjsip_digit_begin(struct ast_channel *chan, char digit)
1397 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(chan);
1398 struct chan_pjsip_pvt *pvt = channel->pvt;
1399 struct ast_sip_session_media *media = pvt->media[SIP_MEDIA_AUDIO];
1402 switch (channel->session->endpoint->dtmf) {
1403 case AST_SIP_DTMF_RFC_4733:
1404 if (!media || !media->rtp) {
1408 ast_rtp_instance_dtmf_begin(media->rtp, digit);
1409 case AST_SIP_DTMF_NONE:
1411 case AST_SIP_DTMF_INBAND:
1421 struct info_dtmf_data {
1422 struct ast_sip_session *session;
1424 unsigned int duration;
1427 static void info_dtmf_data_destroy(void *obj)
1429 struct info_dtmf_data *dtmf_data = obj;
1430 ao2_ref(dtmf_data->session, -1);
1433 static struct info_dtmf_data *info_dtmf_data_alloc(struct ast_sip_session *session, char digit, unsigned int duration)
1435 struct info_dtmf_data *dtmf_data = ao2_alloc(sizeof(*dtmf_data), info_dtmf_data_destroy);
1439 ao2_ref(session, +1);
1440 dtmf_data->session = session;
1441 dtmf_data->digit = digit;
1442 dtmf_data->duration = duration;
1446 static int transmit_info_dtmf(void *data)
1448 RAII_VAR(struct info_dtmf_data *, dtmf_data, data, ao2_cleanup);
1450 struct ast_sip_session *session = dtmf_data->session;
1451 struct pjsip_tx_data *tdata;
1453 RAII_VAR(struct ast_str *, body_text, NULL, ast_free_ptr);
1455 struct ast_sip_body body = {
1456 .type = "application",
1457 .subtype = "dtmf-relay",
1460 if (!(body_text = ast_str_create(32))) {
1461 ast_log(LOG_ERROR, "Could not allocate buffer for INFO DTMF.\n");
1464 ast_str_set(&body_text, 0, "Signal=%c\r\nDuration=%u\r\n", dtmf_data->digit, dtmf_data->duration);
1466 body.body_text = ast_str_buffer(body_text);
1468 if (ast_sip_create_request("INFO", session->inv_session->dlg, session->endpoint, NULL, &tdata)) {
1469 ast_log(LOG_ERROR, "Could not create DTMF INFO request\n");
1472 if (ast_sip_add_body(tdata, &body)) {
1473 ast_log(LOG_ERROR, "Could not add body to DTMF INFO request\n");
1474 pjsip_tx_data_dec_ref(tdata);
1477 ast_sip_session_send_request(session, tdata);
1482 /*! \brief Function called by core to stop a DTMF digit */
1483 static int chan_pjsip_digit_end(struct ast_channel *ast, char digit, unsigned int duration)
1485 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
1486 struct chan_pjsip_pvt *pvt = channel->pvt;
1487 struct ast_sip_session_media *media = pvt->media[SIP_MEDIA_AUDIO];
1490 switch (channel->session->endpoint->dtmf) {
1491 case AST_SIP_DTMF_INFO:
1493 struct info_dtmf_data *dtmf_data = info_dtmf_data_alloc(channel->session, digit, duration);
1499 if (ast_sip_push_task(channel->session->serializer, transmit_info_dtmf, dtmf_data)) {
1500 ast_log(LOG_WARNING, "Error sending DTMF via INFO.\n");
1501 ao2_cleanup(dtmf_data);
1506 case AST_SIP_DTMF_RFC_4733:
1507 if (!media || !media->rtp) {
1511 ast_rtp_instance_dtmf_end_with_duration(media->rtp, digit, duration);
1512 case AST_SIP_DTMF_NONE:
1514 case AST_SIP_DTMF_INBAND:
1522 static int call(void *data)
1524 struct ast_sip_session *session = data;
1525 pjsip_tx_data *tdata;
1527 int res = ast_sip_session_create_invite(session, &tdata);
1530 ast_queue_hangup(session->channel);
1532 ast_sip_session_send_request(session, tdata);
1534 ao2_ref(session, -1);
1538 /*! \brief Function called by core to actually start calling a remote party */
1539 static int chan_pjsip_call(struct ast_channel *ast, const char *dest, int timeout)
1541 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
1543 ao2_ref(channel->session, +1);
1544 if (ast_sip_push_task(channel->session->serializer, call, channel->session)) {
1545 ast_log(LOG_WARNING, "Error attempting to place outbound call to call '%s'\n", dest);
1546 ao2_cleanup(channel->session);
1553 /*! \brief Internal function which translates from Asterisk cause codes to SIP response codes */
1554 static int hangup_cause2sip(int cause)
1557 case AST_CAUSE_UNALLOCATED: /* 1 */
1558 case AST_CAUSE_NO_ROUTE_DESTINATION: /* 3 IAX2: Can't find extension in context */
1559 case AST_CAUSE_NO_ROUTE_TRANSIT_NET: /* 2 */
1561 case AST_CAUSE_CONGESTION: /* 34 */
1562 case AST_CAUSE_SWITCH_CONGESTION: /* 42 */
1564 case AST_CAUSE_NO_USER_RESPONSE: /* 18 */
1566 case AST_CAUSE_NO_ANSWER: /* 19 */
1567 case AST_CAUSE_UNREGISTERED: /* 20 */
1569 case AST_CAUSE_CALL_REJECTED: /* 21 */
1571 case AST_CAUSE_NUMBER_CHANGED: /* 22 */
1573 case AST_CAUSE_NORMAL_UNSPECIFIED: /* 31 */
1575 case AST_CAUSE_INVALID_NUMBER_FORMAT:
1577 case AST_CAUSE_USER_BUSY:
1579 case AST_CAUSE_FAILURE:
1581 case AST_CAUSE_FACILITY_REJECTED: /* 29 */
1583 case AST_CAUSE_CHAN_NOT_IMPLEMENTED:
1585 case AST_CAUSE_DESTINATION_OUT_OF_ORDER:
1587 case AST_CAUSE_BEARERCAPABILITY_NOTAVAIL: /* Can't find codec to connect to host */
1589 case AST_CAUSE_INTERWORKING: /* Unspecified Interworking issues */
1591 case AST_CAUSE_NOTDEFINED:
1593 ast_debug(1, "AST hangup cause %d (no match found in PJSIP)\n", cause);
1601 struct hangup_data {
1603 struct ast_channel *chan;
1606 static void hangup_data_destroy(void *obj)
1608 struct hangup_data *h_data = obj;
1610 h_data->chan = ast_channel_unref(h_data->chan);
1613 static struct hangup_data *hangup_data_alloc(int cause, struct ast_channel *chan)
1615 struct hangup_data *h_data = ao2_alloc(sizeof(*h_data), hangup_data_destroy);
1621 h_data->cause = cause;
1622 h_data->chan = ast_channel_ref(chan);
1627 /*! \brief Clear a channel from a session along with its PVT */
1628 static void clear_session_and_channel(struct ast_sip_session *session, struct ast_channel *ast, struct chan_pjsip_pvt *pvt)
1630 session->channel = NULL;
1631 if (pvt->media[SIP_MEDIA_AUDIO] && pvt->media[SIP_MEDIA_AUDIO]->rtp) {
1632 ast_rtp_instance_set_channel_id(pvt->media[SIP_MEDIA_AUDIO]->rtp, "");
1634 if (pvt->media[SIP_MEDIA_VIDEO] && pvt->media[SIP_MEDIA_VIDEO]->rtp) {
1635 ast_rtp_instance_set_channel_id(pvt->media[SIP_MEDIA_VIDEO]->rtp, "");
1637 ast_channel_tech_pvt_set(ast, NULL);
1640 static int hangup(void *data)
1643 pjsip_tx_data *packet = NULL;
1644 struct hangup_data *h_data = data;
1645 struct ast_channel *ast = h_data->chan;
1646 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
1647 struct chan_pjsip_pvt *pvt = channel->pvt;
1648 struct ast_sip_session *session = channel->session;
1649 int cause = h_data->cause;
1651 if (!session->defer_terminate &&
1652 ((status = pjsip_inv_end_session(session->inv_session, cause ? cause : 603, NULL, &packet)) == PJ_SUCCESS) && packet) {
1653 if (packet->msg->type == PJSIP_RESPONSE_MSG) {
1654 ast_sip_session_send_response(session, packet);
1656 ast_sip_session_send_request(session, packet);
1660 clear_session_and_channel(session, ast, pvt);
1661 ao2_cleanup(channel);
1662 ao2_cleanup(h_data);
1667 /*! \brief Function called by core to hang up a PJSIP session */
1668 static int chan_pjsip_hangup(struct ast_channel *ast)
1670 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
1671 struct chan_pjsip_pvt *pvt = channel->pvt;
1672 int cause = hangup_cause2sip(ast_channel_hangupcause(channel->session->channel));
1673 struct hangup_data *h_data = hangup_data_alloc(cause, ast);
1679 if (ast_sip_push_task(channel->session->serializer, hangup, h_data)) {
1680 ast_log(LOG_WARNING, "Unable to push hangup task to the threadpool. Expect bad things\n");
1687 /* Go ahead and do our cleanup of the session and channel even if we're not going
1688 * to be able to send our SIP request/response
1690 clear_session_and_channel(channel->session, ast, pvt);
1691 ao2_cleanup(channel);
1692 ao2_cleanup(h_data);
1697 struct request_data {
1698 struct ast_sip_session *session;
1699 struct ast_format_cap *caps;
1704 static int request(void *obj)
1706 struct request_data *req_data = obj;
1707 struct ast_sip_session *session = NULL;
1708 char *tmp = ast_strdupa(req_data->dest), *endpoint_name = NULL, *request_user = NULL;
1709 RAII_VAR(struct ast_sip_endpoint *, endpoint, NULL, ao2_cleanup);
1711 AST_DECLARE_APP_ARGS(args,
1712 AST_APP_ARG(endpoint);
1716 if (ast_strlen_zero(tmp)) {
1717 ast_log(LOG_ERROR, "Unable to create PJSIP channel with empty destination\n");
1718 req_data->cause = AST_CAUSE_CHANNEL_UNACCEPTABLE;
1722 AST_NONSTANDARD_APP_ARGS(args, tmp, '/');
1724 /* If a request user has been specified extract it from the endpoint name portion */
1725 if ((endpoint_name = strchr(args.endpoint, '@'))) {
1726 request_user = args.endpoint;
1727 *endpoint_name++ = '\0';
1729 endpoint_name = args.endpoint;
1732 if (ast_strlen_zero(endpoint_name)) {
1733 ast_log(LOG_ERROR, "Unable to create PJSIP channel with empty endpoint name\n");
1734 req_data->cause = AST_CAUSE_CHANNEL_UNACCEPTABLE;
1735 } else if (!(endpoint = ast_sorcery_retrieve_by_id(ast_sip_get_sorcery(), "endpoint", endpoint_name))) {
1736 ast_log(LOG_ERROR, "Unable to create PJSIP channel - endpoint '%s' was not found\n", endpoint_name);
1737 req_data->cause = AST_CAUSE_NO_ROUTE_DESTINATION;
1741 if (!(session = ast_sip_session_create_outgoing(endpoint, args.aor, request_user, req_data->caps))) {
1742 req_data->cause = AST_CAUSE_NO_ROUTE_DESTINATION;
1746 req_data->session = session;
1751 /*! \brief Function called by core to create a new outgoing PJSIP session */
1752 static struct ast_channel *chan_pjsip_request(const char *type, struct ast_format_cap *cap, const struct ast_channel *requestor, const char *data, int *cause)
1754 struct request_data req_data;
1755 RAII_VAR(struct ast_sip_session *, session, NULL, ao2_cleanup);
1757 req_data.caps = cap;
1758 req_data.dest = data;
1760 if (ast_sip_push_task_synchronous(NULL, request, &req_data)) {
1761 *cause = req_data.cause;
1765 session = req_data.session;
1767 if (!(session->channel = chan_pjsip_new(session, AST_STATE_DOWN, NULL, NULL, requestor ? ast_channel_linkedid(requestor) : NULL, NULL))) {
1768 /* Session needs to be terminated prematurely */
1772 return session->channel;
1775 struct sendtext_data {
1776 struct ast_sip_session *session;
1780 static void sendtext_data_destroy(void *obj)
1782 struct sendtext_data *data = obj;
1783 ao2_ref(data->session, -1);
1786 static struct sendtext_data* sendtext_data_create(struct ast_sip_session *session, const char *text)
1788 int size = strlen(text) + 1;
1789 struct sendtext_data *data = ao2_alloc(sizeof(*data)+size, sendtext_data_destroy);
1795 data->session = session;
1796 ao2_ref(data->session, +1);
1797 ast_copy_string(data->text, text, size);
1801 static int sendtext(void *obj)
1803 RAII_VAR(struct sendtext_data *, data, obj, ao2_cleanup);
1804 pjsip_tx_data *tdata;
1806 const struct ast_sip_body body = {
1809 .body_text = data->text
1812 /* NOT ast_strlen_zero, because a zero-length message is specifically
1813 * allowed by RFC 3428 (See section 10, Examples) */
1818 ast_debug(3, "Sending in dialog SIP message\n");
1820 ast_sip_create_request("MESSAGE", data->session->inv_session->dlg, data->session->endpoint, NULL, &tdata);
1821 ast_sip_add_body(tdata, &body);
1822 ast_sip_send_request(tdata, data->session->inv_session->dlg, data->session->endpoint);
1827 /*! \brief Function called by core to send text on PJSIP session */
1828 static int chan_pjsip_sendtext(struct ast_channel *ast, const char *text)
1830 struct ast_sip_channel_pvt *channel = ast_channel_tech_pvt(ast);
1831 struct sendtext_data *data = sendtext_data_create(channel->session, text);
1833 if (!data || ast_sip_push_task(channel->session->serializer, sendtext, data)) {
1840 /*! \brief Convert SIP hangup causes to Asterisk hangup causes */
1841 static int hangup_sip2cause(int cause)
1843 /* Possible values taken from causes.h */
1846 case 401: /* Unauthorized */
1847 return AST_CAUSE_CALL_REJECTED;
1848 case 403: /* Not found */
1849 return AST_CAUSE_CALL_REJECTED;
1850 case 404: /* Not found */
1851 return AST_CAUSE_UNALLOCATED;
1852 case 405: /* Method not allowed */
1853 return AST_CAUSE_INTERWORKING;
1854 case 407: /* Proxy authentication required */
1855 return AST_CAUSE_CALL_REJECTED;
1856 case 408: /* No reaction */
1857 return AST_CAUSE_NO_USER_RESPONSE;
1858 case 409: /* Conflict */
1859 return AST_CAUSE_NORMAL_TEMPORARY_FAILURE;
1860 case 410: /* Gone */
1861 return AST_CAUSE_NUMBER_CHANGED;
1862 case 411: /* Length required */
1863 return AST_CAUSE_INTERWORKING;
1864 case 413: /* Request entity too large */
1865 return AST_CAUSE_INTERWORKING;
1866 case 414: /* Request URI too large */
1867 return AST_CAUSE_INTERWORKING;
1868 case 415: /* Unsupported media type */
1869 return AST_CAUSE_INTERWORKING;
1870 case 420: /* Bad extension */
1871 return AST_CAUSE_NO_ROUTE_DESTINATION;
1872 case 480: /* No answer */
1873 return AST_CAUSE_NO_ANSWER;
1874 case 481: /* No answer */
1875 return AST_CAUSE_INTERWORKING;
1876 case 482: /* Loop detected */
1877 return AST_CAUSE_INTERWORKING;
1878 case 483: /* Too many hops */
1879 return AST_CAUSE_NO_ANSWER;
1880 case 484: /* Address incomplete */
1881 return AST_CAUSE_INVALID_NUMBER_FORMAT;
1882 case 485: /* Ambiguous */
1883 return AST_CAUSE_UNALLOCATED;
1884 case 486: /* Busy everywhere */
1885 return AST_CAUSE_BUSY;
1886 case 487: /* Request terminated */
1887 return AST_CAUSE_INTERWORKING;
1888 case 488: /* No codecs approved */
1889 return AST_CAUSE_BEARERCAPABILITY_NOTAVAIL;
1890 case 491: /* Request pending */
1891 return AST_CAUSE_INTERWORKING;
1892 case 493: /* Undecipherable */
1893 return AST_CAUSE_INTERWORKING;
1894 case 500: /* Server internal failure */
1895 return AST_CAUSE_FAILURE;
1896 case 501: /* Call rejected */
1897 return AST_CAUSE_FACILITY_REJECTED;
1899 return AST_CAUSE_DESTINATION_OUT_OF_ORDER;
1900 case 503: /* Service unavailable */
1901 return AST_CAUSE_CONGESTION;
1902 case 504: /* Gateway timeout */
1903 return AST_CAUSE_RECOVERY_ON_TIMER_EXPIRE;
1904 case 505: /* SIP version not supported */
1905 return AST_CAUSE_INTERWORKING;
1906 case 600: /* Busy everywhere */
1907 return AST_CAUSE_USER_BUSY;
1908 case 603: /* Decline */
1909 return AST_CAUSE_CALL_REJECTED;
1910 case 604: /* Does not exist anywhere */
1911 return AST_CAUSE_UNALLOCATED;
1912 case 606: /* Not acceptable */
1913 return AST_CAUSE_BEARERCAPABILITY_NOTAVAIL;
1915 if (cause < 500 && cause >= 400) {
1916 /* 4xx class error that is unknown - someting wrong with our request */
1917 return AST_CAUSE_INTERWORKING;
1918 } else if (cause < 600 && cause >= 500) {
1919 /* 5xx class error - problem in the remote end */
1920 return AST_CAUSE_CONGESTION;
1921 } else if (cause < 700 && cause >= 600) {
1922 /* 6xx - global errors in the 4xx class */
1923 return AST_CAUSE_INTERWORKING;
1925 return AST_CAUSE_NORMAL;
1931 static void chan_pjsip_session_begin(struct ast_sip_session *session)
1933 RAII_VAR(struct ast_datastore *, datastore, NULL, ao2_cleanup);
1935 if (session->endpoint->media.direct_media.glare_mitigation ==
1936 AST_SIP_DIRECT_MEDIA_GLARE_MITIGATION_NONE) {
1940 datastore = ast_sip_session_alloc_datastore(&direct_media_mitigation_info,
1941 "direct_media_glare_mitigation");
1947 ast_sip_session_add_datastore(session, datastore);
1950 /*! \brief Function called when the session ends */
1951 static void chan_pjsip_session_end(struct ast_sip_session *session)
1953 if (!session->channel) {
1957 if (!ast_channel_hangupcause(session->channel) && session->inv_session) {
1958 int cause = hangup_sip2cause(session->inv_session->cause);
1960 ast_queue_hangup_with_cause(session->channel, cause);
1962 ast_queue_hangup(session->channel);
1966 /*! \brief Function called when a request is received on the session */
1967 static int chan_pjsip_incoming_request(struct ast_sip_session *session, struct pjsip_rx_data *rdata)
1969 pjsip_tx_data *packet = NULL;
1971 if (session->channel) {
1975 if (!(session->channel = chan_pjsip_new(session, AST_STATE_RING, session->exten, NULL, NULL, NULL))) {
1976 if (pjsip_inv_end_session(session->inv_session, 503, NULL, &packet) == PJ_SUCCESS) {
1977 ast_sip_session_send_response(session, packet);
1980 ast_log(LOG_ERROR, "Failed to allocate new PJSIP channel on incoming SIP INVITE\n");
1983 /* channel gets created on incoming request, but we wait to call start
1984 so other supplements have a chance to run */
1988 static int pbx_start_incoming_request(struct ast_sip_session *session, pjsip_rx_data *rdata)
1992 res = ast_pbx_start(session->channel);
1995 case AST_PBX_FAILED:
1996 ast_log(LOG_WARNING, "Failed to start PBX ;(\n");
1997 ast_channel_hangupcause_set(session->channel, AST_CAUSE_SWITCH_CONGESTION);
1998 ast_hangup(session->channel);
2000 case AST_PBX_CALL_LIMIT:
2001 ast_log(LOG_WARNING, "Failed to start PBX (call limit reached) \n");
2002 ast_channel_hangupcause_set(session->channel, AST_CAUSE_SWITCH_CONGESTION);
2003 ast_hangup(session->channel);
2005 case AST_PBX_SUCCESS:
2010 ast_debug(3, "Started PBX on new PJSIP channel %s\n", ast_channel_name(session->channel));
2012 return (res == AST_PBX_SUCCESS) ? 0 : -1;
2015 static struct ast_sip_session_supplement pbx_start_supplement = {
2017 .priority = AST_SIP_SESSION_SUPPLEMENT_PRIORITY_LAST,
2018 .incoming_request = pbx_start_incoming_request,
2021 /*! \brief Function called when a response is received on the session */
2022 static void chan_pjsip_incoming_response(struct ast_sip_session *session, struct pjsip_rx_data *rdata)
2024 struct pjsip_status_line status = rdata->msg_info.msg->line.status;
2026 if (!session->channel) {
2030 switch (status.code) {
2032 ast_queue_control(session->channel, AST_CONTROL_RINGING);
2033 if (ast_channel_state(session->channel) != AST_STATE_UP) {
2034 ast_setstate(session->channel, AST_STATE_RINGING);
2038 ast_queue_control(session->channel, AST_CONTROL_PROGRESS);
2041 ast_queue_control(session->channel, AST_CONTROL_ANSWER);
2048 static int chan_pjsip_incoming_ack(struct ast_sip_session *session, struct pjsip_rx_data *rdata)
2050 if (rdata->msg_info.msg->line.req.method.id == PJSIP_ACK_METHOD) {
2051 if (session->endpoint->media.direct_media.enabled && session->channel) {
2052 ast_queue_control(session->channel, AST_CONTROL_SRCCHANGE);
2059 * \brief Load the module
2061 * Module loading including tests for configuration or dependencies.
2062 * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE,
2063 * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails
2064 * tests return AST_MODULE_LOAD_FAILURE. If the module can not load the
2065 * configuration file or other non-critical problem return
2066 * AST_MODULE_LOAD_DECLINE. On success return AST_MODULE_LOAD_SUCCESS.
2068 static int load_module(void)
2070 if (!(chan_pjsip_tech.capabilities = ast_format_cap_alloc(0))) {
2071 return AST_MODULE_LOAD_DECLINE;
2074 ast_format_cap_add_all_by_type(chan_pjsip_tech.capabilities, AST_FORMAT_TYPE_AUDIO);
2076 ast_rtp_glue_register(&chan_pjsip_rtp_glue);
2078 if (ast_channel_register(&chan_pjsip_tech)) {
2079 ast_log(LOG_ERROR, "Unable to register channel class %s\n", channel_type);
2083 if (ast_custom_function_register(&chan_pjsip_dial_contacts_function)) {
2084 ast_log(LOG_ERROR, "Unable to register PJSIP_DIAL_CONTACTS dialplan function\n");
2088 if (ast_custom_function_register(&media_offer_function)) {
2089 ast_log(LOG_WARNING, "Unable to register PJSIP_MEDIA_OFFER dialplan function\n");
2092 if (ast_sip_session_register_supplement(&chan_pjsip_supplement)) {
2093 ast_log(LOG_ERROR, "Unable to register PJSIP supplement\n");
2097 if (ast_sip_session_register_supplement(&pbx_start_supplement)) {
2098 ast_log(LOG_ERROR, "Unable to register PJSIP pbx start supplement\n");
2099 ast_sip_session_unregister_supplement(&chan_pjsip_supplement);
2103 if (ast_sip_session_register_supplement(&chan_pjsip_ack_supplement)) {
2104 ast_log(LOG_ERROR, "Unable to register PJSIP ACK supplement\n");
2105 ast_sip_session_unregister_supplement(&pbx_start_supplement);
2106 ast_sip_session_unregister_supplement(&chan_pjsip_supplement);
2113 ast_custom_function_unregister(&media_offer_function);
2114 ast_custom_function_unregister(&chan_pjsip_dial_contacts_function);
2115 ast_channel_unregister(&chan_pjsip_tech);
2116 ast_rtp_glue_unregister(&chan_pjsip_rtp_glue);
2118 return AST_MODULE_LOAD_FAILURE;
2121 /*! \brief Reload module */
2122 static int reload(void)
2127 /*! \brief Unload the PJSIP channel from Asterisk */
2128 static int unload_module(void)
2130 ast_custom_function_unregister(&media_offer_function);
2132 ast_sip_session_unregister_supplement(&chan_pjsip_supplement);
2133 ast_sip_session_unregister_supplement(&pbx_start_supplement);
2134 ast_sip_session_unregister_supplement(&chan_pjsip_ack_supplement);
2136 ast_custom_function_unregister(&chan_pjsip_dial_contacts_function);
2137 ast_channel_unregister(&chan_pjsip_tech);
2138 ast_rtp_glue_unregister(&chan_pjsip_rtp_glue);
2143 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "PJSIP Channel Driver",
2144 .load = load_module,
2145 .unload = unload_module,
2147 .load_pri = AST_MODPRI_CHANNEL_DRIVER,