[asterisk-dev] [Code Review]: SIP NOTIFY dialog event infos: Number & Name Presentation for BLF signaling and pickup offers

Guenther Kelleter reviewboard at asterisk.org
Wed Aug 1 03:52:48 CDT 2012



> On July 31, 2012, 11:07 a.m., Mark Michelson wrote:
> > From what I can tell, all the changes here are good. The problem is that the chan_sip.c portion of the diff has a lot of unrelated changes. I looked through and found the changes you made to extensionstate_update(). Did you make any other changes in the latest version of the diff?

The unrelated changes in chan_sip.c are not completely unrelated:-)

Determination of the oldest ringing channel of all watched devices was moved from pbx.c to chan_sip extension_state_update(). The extra argument "queued" is required for proper operation when a notification was queued and is sent after the current notification dialog was acked.
Along the way I fixed the prototype of extension_state_update() to use const to avoid having to cast away const of arguments, which is plain ugly. 
The first change in state_notify_build_xml() is a bug fix and is required because the passed data->state can be -1 or -2 when the hint goes away and the final notification is generated. Without this fix state -1 and -2 would be regarded as AST_EXTENSION_RINGING which is obviously wrong.

There are no other unrelated changes.


- Guenther


-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviewboard.asterisk.org/r/2048/#review6842
-----------------------------------------------------------


On July 30, 2012, 4:43 a.m., Guenther Kelleter wrote:
> 
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviewboard.asterisk.org/r/2048/
> -----------------------------------------------------------
> 
> (Updated July 30, 2012, 4:43 a.m.)
> 
> 
> Review request for Asterisk Developers, Mark Michelson, Matt Jordan, and Thomas Arimont.
> 
> 
> Summary
> -------
> 
> (For Digium: this is the implementation of the feature described in chapter 2 of the document SIP_NOTIFY_dialog_event_infos_DATUS_v1_4.odt)
> 
> This patch extends the extension state callbacks so that monitoring channels (as chan_sip) get more information of the devices which are responsible for an extension state change. The additional information is needed by chan_sip to present names/numbers of the caller and callee in an early-state SIP notification. Users of extenstion state callback not interested in the additional information are not affected by the changes.
> 
> Motivation: to present the involved party's name/number in an early-state nofification (used by the notified device as a pickup offer) one after another so that a user can see which call he will pick up in an undirected pickup.
> Such a pickup offer to a user shall indicate the same call (number/name-A calls number/name-B) as the call which would be picked up when an undirected pickup is executed.
> 
> 
> Users interested in additional state info must use the new functions ast_extension_state_add_extended() resp. ast_extension_state_add_destroy_extended() to register an extended state callback. When the callback is registered this way, an extra member device_state_info of struct ast_state_cb_info is passed to the callback in addition to the aggregated extension state. This container holds an object for every device of the monitored extension hint consisting of the device name, the device state and a channel reference to the channel which (presumably) caused the device state.
> 
> The information is used by chan_sip for early-state notifications. When the state of a device changes and the new state contains AST_EVENT_RINGING, an early-state notification is sent to the subscribed devices with the caller/callee names/numbers of the oldest ringing channel of the monitored extension.
> The notified user may then invoke a direct pickup, which will pickup exactly this channel.
> 
> Users of the old non-extended callbacks will only be called when the aggregated state did change (same behavior as before). Users of the extended callback will also be called when the state is unchanged but does contain AST_EVENT_RINGING. That could be the case if two channels are ringing at one device and one of them hangs up, so the aggregated state does not change. This way the monitoring channel can create a new early-state notification with the now ringing party-ids.
> 
> This patch requires the channel creation time member of ast_channel and the changes for the direct pickup to pick up the oldest ringing channel, which are both introduced in review https://reviewboard.asterisk.org/r/2043/.
> 
> 
> Diffs
> -----
> 
>   /trunk/channels/chan_sip.c 370418 
>   /trunk/channels/sip/include/sip.h 370418 
>   /trunk/include/asterisk/pbx.h 370418 
>   /trunk/main/pbx.c 370418 
> 
> Diff: https://reviewboard.asterisk.org/r/2048/diff
> 
> 
> Testing
> -------
> 
> Checked the name/number of caller/callee displayed on the notified phone.
> Checked that a second call at an already ringing device does not invoke a notification as long as the first call is ringing, instead it is sent when the first ringing channel is picked up by some other party or hung up.
> Checked that the picked up caller is the same as advertized in the early-state notification when more than one calls are ringing on the subscribed extension.
> Ref counting for the containers and channels checked.
> Checked that a notification is sent to newly subscribed watchers.
> 
> 
> Thanks,
> 
> Guenther
> 
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.digium.com/pipermail/asterisk-dev/attachments/20120801/194b06bb/attachment.htm>


More information about the asterisk-dev mailing list