[asterisk-commits] dvossel: branch dvossel/generic_aoc r257261 - /team/dvossel/generic_aoc/doc/

[SVN commits to the Asterisk project]

Author: dvossel
Date: Wed Apr 14 17:35:42 2010
New Revision: 257261

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=257261
Log:
addition of the beginnings of an AOC help document

Added:
    team/dvossel/generic_aoc/doc/advice_of_charge.txt   (with props)

Added: team/dvossel/generic_aoc/doc/advice_of_charge.txt
URL: http://svnview.digium.com/svn/asterisk/team/dvossel/generic_aoc/doc/advice_of_charge.txt?view=auto&rev=257261
==============================================================================
--- team/dvossel/generic_aoc/doc/advice_of_charge.txt (added)
+++ team/dvossel/generic_aoc/doc/advice_of_charge.txt Wed Apr 14 17:35:42 2010
@@ -1,0 +1,112 @@
+================
+Advice of Charge
+================
+
+Written by: David Vossel
+Initial version: 04-14-2010
+
+
+This document is designed to give a overview of how to configure
+Advice of Charge and detailed explanation of how each option works. 
+
+--------------------------------------
+           Terminology
+--------------------------------------
+AOC: Advice of Charge
+
+AOC-S: Advice of Charge message sent at the beginning of a call
+during call setup.  This message contains a list of rates
+associated with the call.
+
+AOC-D: Advice of Charge message sent during the call.  This message
+is typically used to update the endpoint with the current call charge.
+
+AOC-E: Advice of Charge message sent at the end of a call.  This
+message is used to indicate to the endpoint the final call charge.
+
+
+--------------------------------------
+           AOC in chan_dahdi
+--------------------------------------
+
+-----LibPRI Support:
+ETSI, or euroisdn is the only switchtype that
+Asterisk currently supports for AOC.
+
+-----Enable AOC Pass-through in chan_dahdi.c
+To enable AOC pass-through between the ISDN and Asterisk use the
+'aoc_enable' config option.  This option allows for any combination
+of AOC-S, AOC-D, and AOC-E to be enabled or disabled.
+
+For example:
+aoc_enable=s,d,e ; enables pass-through of AOC-S, AOC-D, and AOC-E
+
+aoc_enable=s,d   ; enables pass-through of AOC-S and AOC-D. Rejects
+                 ; AOC-E and AOC-E request messages
+
+Since AOC messages are often transported on facility messages, the
+'facilityenable' option must be enabled as well to fully support AOC
+pass-through.
+
+----- Handling AOC-E in chan_dahdi
+Whenever a dahdi channel receives an AOC message from Asterisk, it stores
+that message to deliver it at the appropriate time during call termination.
+This means that if two AOC-E messages are received on the same call, the last
+one will override the first one and only one AOC-E message will be sent
+during call termination.
+
+There are some tricky situations involving the final AOC-E message. During a
+bridged call, if the endpoint receiving the AOC messages terminates the call
+before the endpoint delivering the AOC does, the final AOC-E message sent by
+the sending side during termination will never make it to the receiving end
+because Asterisk has already torn down that channel.  This is where the
+chan_dahdi.conf 'aoce_delayhangup' option comes into play.
+
+By enabling 'aoce_delayhangup', anytime a hangup is initiated by the ISDN
+side of an Asterisk channel, instead of hanging up the channel, the channel
+sends a unique internal AOC-E termination request to its bridge channel. This
+indicates it is about to hangup and wishes to receive the final AOC-E message
+from the bridged channel before completely tearing down.  If the bridged channel
+knows what to do with this AOC-E termination request, it will do whatever is
+necessary to indicate to its endpoint that the call is being terminated without
+actually hanging up the Asterisk channel.  This allows the final AOC-E message
+to come in and be sent across the bridge while both channels are still up.  If
+the channel delaying its hangup for the final AOC-E message times out, the call
+will be torn down just as it normally would.  In chan_dahdi the timeout period
+is 1/2 the T305 timer which by default is 15 seconds.
+
+'aoce_delayhangup' currently only works when both bridged channels are
+dahdi_channels. If a SIP channel receives an AOC-E termination request, it just
+responds by immediately hanging up the channel.  Using this option when bridged
+to any channel technology besides SIP and DAHDI will result in the 15 second
+timeout period finally tearing down the call.
+
+----- Requesting AOC services
+AOC can be requested on a call by call basis using the DAHDI dialstring option, A().
+The A() option takes in 's', 'd', and 'e' and parameters which represent the three
+types of AOC messages, AOC-S, AOC-D, and AOC-E.  By using this option Asterisk will
+indicate to the endpoint during call setup that it wishes to receive the specified
+forms of AOC during the call.
+
+Example Usage in extensions.conf
+exten => 1111,1,Dial(DAHDI/g1/1112/A(s,d,e) ; requests AOC-S, AOC-D, and AOC-E on
+                                            ; call setup
+exten => 1111,1,Dial(DAHDI/g1/1112/A(d,e)   ; requests only AOC-D, and AOC-E on
+                                            ; call setup
+
+--------------------------------------
+           AOC in chan_sip
+--------------------------------------
+Asterisk supports a very basic way of sending AOC on a SIP channel to Snom
+phones using an AOC specification designed by Snom.  This support is limited
+to the sending of AOC-D and AOC-E pass-through messages.  No support for
+AOC-E on call termination is present, so if the Snom endpoint receiving the
+AOC messages from Asterisk terminates the call, the channel will be torn
+down before the phone can receive the final AOC-E message.
+
+
+
+
+
+
+

Propchange: team/dvossel/generic_aoc/doc/advice_of_charge.txt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: team/dvossel/generic_aoc/doc/advice_of_charge.txt
------------------------------------------------------------------------------
    svn:keywords = Author Date Id Revision

Propchange: team/dvossel/generic_aoc/doc/advice_of_charge.txt
------------------------------------------------------------------------------
    svn:mime-type = text/plain