{"type":"doc","content":[{"type":"paragraph","content":[{"text":"chan_dahdi","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Asterisk PRI/BRI Debugging ","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow one or more of the steps below to resolve an issue with any of your PRI/BRI spans:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The first step in troubleshooting your PRI/BRI issues is to try and restart the wanpipe driver for a resolve","type":"text"},{"text":".","type":"text","marks":[{"type":"em"}]},{"text":" This is done by typing the following command in your Linux CLI:","type":"text"},{"type":"hardBreak"},{"text":"-> wanrouter restart","type":"text"}]},{"type":"paragraph","content":[{"text":"If you notice some error messages populate on your screen then check the driver output log in: /var/log/messages","type":"text"},{"type":"hardBreak"},{"text":"-","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the line status by typing the wanpipe command: wanrouter status. The possible outputs are: \"connected\", \"connecting\" and \"disconnected\".","type":"text"},{"type":"hardBreak"},{"text":"=> if the status indicates \"connecting\", or \"disconnected\", there is a possibility of alarms on the line. The alarms can be viewed by running the command: wanpipemon -i wXg1 -c Ta (replace X in \"wXg1\" with the wanpipe number in question). A description of the possible line alarms can be found Here: ","type":"text"},{"text":"wanpipemon line alarm status","type":"text","marks":[{"type":"link","attrs":{"href":"https://sangomakb.atlassian.net/wiki/spaces/TC/pages/53706877"}}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"-","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the Wanpipe network Interface for data processing issues. Run ifconfig and locate the wanpipe interface (w1g1,w2g1,w3g1..etc) and verify the ","type":"text"},{"text":"Rx","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Tx","type":"text","marks":[{"type":"em"}]},{"text":" packets are incrementing. Below is an example output of ","type":"text"},{"text":"ifconfig","type":"text","marks":[{"type":"em"}]},{"text":" for \"w1g1\"","type":"text"},{"type":"hardBreak"},{"text":"w1g1 Link encap:Point-to-Point Protocol","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" UP POINTOPOINT NOARP MTU:1500 Metric:1","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" RX packets:1232 errors:0 dropped:0 overruns:0 frame:0","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" TX packets:1424 errors:0 dropped:0 overruns:0 carrier:0","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" collisions:0 txqueuelen:100","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" Interrupt:169 Memory:f8e20000-f8e21fff","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"If you do not see the above packets increment when you run \"ifconfig\" multiple times consecutively, then please contact Sangoma Technical Support at ","type":"text"},{"text":"techdesk@sangoma.com","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:techdesk@sangoma.com"}}]},{"text":" and include the the PRI troubleshooting information","type":"text"},{"type":"hardBreak"},{"text":"-","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Register the wanpipe interfaces with the Dahdi/Zaptel stack:","type":"text"},{"type":"hardBreak"},{"text":"-> dahdi_cfg -vvv (if you have dahdi)","type":"text"},{"type":"hardBreak"},{"text":"-> ztcfg -vvv (if you have Zaptel)","type":"text"}]},{"type":"paragraph","content":[{"text":"If you notice error messages after running the above commands, verify the configuration settings in /etc/dahdi/system.conf (dahdi) or /etc/zaptel.conf (zaptel)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Confirm that Asterisk is able to detect all the Dahdi/zaptel spans. Enter the Asterisk CLI and type the following:","type":"text"},{"type":"hardBreak"},{"text":"-> (Dahdi): dahdi show channels ","type":"text"},{"type":"hardBreak"},{"text":"-> (zaptel): zap show channels","type":"text"}]},{"type":"paragraph","content":[{"text":"If there is no output from the above, this means that","type":"text"},{"text":" chan_dahdi.so","type":"text","marks":[{"type":"em"}]},{"text":" (dahdi) or ","type":"text"},{"text":"zaptel.so","type":"text","marks":[{"type":"em"}]},{"text":" was not able to load into Asterisk. The next step is to parse chan_dahdi.conf/zaptel.conf files to find the error. ","type":"text"},{"type":"hardBreak"},{"text":"*Note","type":"text","marks":[{"type":"strong"}]},{"text":": If you are using a binary distro (Trixbox, Elastix..) then the actual dahdi channels/zaptel channels are configured in dahdi-channels.conf/zap-channels.confand ","type":"text"},{"text":"#included","type":"text","marks":[{"type":"strong"}]},{"text":" into chan_dahdi.confg/zaptel.conf","type":"text"},{"type":"hardBreak"},{"text":"RBS: for Robbed Bit Signaling, please click ","type":"text"},{"text":"HERE","type":"text","marks":[{"type":"link","attrs":{"href":"http://sangoma.editme.com/wanpipe-linux-asterisk-appendix#rbs_debug"}}]},{"text":" for debugging steps.","type":"text"},{"type":"hardBreak"},{"text":"-","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that all the Dahdi/zaptel spans are \"Up and Active\". Type the following in the Asterisk CLI:-> pri show spans ","type":"text"}]},{"type":"paragraph","content":[{"text":"NOT Scenario:","type":"text","marks":[{"type":"strong"}]},{"text":" If a particular span is not \"Up and Active\" (if it should be), then turn on span debugging in the Asterisk CLI to trace the D-channel message on that span in question.","type":"text"},{"type":"hardBreak"},{"text":"-> pri intense debug span X (replace X with the span)","type":"text"},{"type":"hardBreak"},{"text":"Note: Asterisk 1.6.2","type":"text","marks":[{"type":"strong"}]},{"text":" uses the following:","type":"text"},{"type":"hardBreak"},{"text":"-> pri set debug 2 span X (replace X for the span value)","type":"text"}]},{"type":"paragraph","content":[{"text":"Here you are trying to confirm that there are BOTH incoming and outgoing D-channel messages. Messages with arrows pointing towards the right of your Monitor (","type":"text"},{"text":">","type":"text","marks":[{"type":"strong"}]},{"text":") are ","type":"text"},{"text":"outgoing ","type":"text","marks":[{"type":"em"}]},{"text":"and messages with arrows pointing to the Left of your Monitor (","type":"text"},{"text":"<","type":"text","marks":[{"type":"strong"}]},{"text":") are ","type":"text"},{"text":"incoming ","type":"text","marks":[{"type":"em"}]},{"text":"messages. The information you gather here is only from the highest layer (asterisk), verifying the D-channel message flow in the Asterisk CLI is not enough proof to indicate an issue. You ","type":"text"},{"text":"must","type":"text","marks":[{"type":"strong"}]},{"text":" also verify the same issue is occurring in the lower physical layer to prove if the issue is line related, by using the following command:","type":"text"},{"type":"hardBreak"},{"text":"-> wanpipemon -i wXg1 -c trd (replace X with the wanpipe interface in question)","type":"text"}]},{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" this command only works when Wanpipe is performing HDLC framing (which is configured by default)","type":"text"}]},{"type":"paragraph","content":[{"text":"Below are steps to follow depending on the scenario:","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"=> If there are ","type":"text"},{"text":"only incoming","type":"text","marks":[{"type":"strong"}]},{"text":" frames check the following link: ","type":"text"},{"text":"Hardware HDLC","type":"text","marks":[{"type":"link","attrs":{"href":"http://sangoma.editme.com/wanpipe-linux-asterisk-appendix#PRI_FailsToComeUp"}}]},{"type":"hardBreak"},{"text":"=> If there are ","type":"text"},{"text":"only outbound","type":"text","marks":[{"type":"strong"}]},{"text":" frames then contact you telco and confirm that the D-channel has been activated","type":"text"},{"type":"hardBreak"},{"text":"=> if there are both incoming AND outgoing messages and you are using the latest Wanpipe driver, then consult with ","type":"text"},{"text":"HARDHDLC vs DCHAN","type":"text","marks":[{"type":"link","attrs":{"href":"http://sangoma.editme.com/Asterisk-FAQ#hardhdlc%20vs%20dchan"}}]},{"text":" to find out why the spans are not \"Up and Active\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: To disable intense debugging in the Asterisk CLI type the following:","type":"text"},{"type":"hardBreak"},{"text":"-> no pri intense debug span X (replace X with the span)","type":"text"},{"type":"hardBreak"},{"text":"-> Asterisk 1.6.2: pri set debug 0 span X","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IS Scenario: ","type":"text","marks":[{"type":"strong"}]},{"text":"If the span IS \"Up and Active\", then verify if the test call is transferring to the zap/dahdi channel by enabling verbosity in the Asterisk CLI :","type":"text"},{"type":"hardBreak"},{"text":"-> Asterisk CLI: core set verbose 10","type":"text"},{"type":"hardBreak"},{"text":"-> search for dial (zap/dahdi...)","type":"text"}]},{"type":"paragraph","content":[{"text":"If the call IS transferring to the zap/dahdi channel, check the PRI ","type":"text"},{"text":"cause code","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"by reading the PRI messages in the Asterisk CLI:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]},{"type":"hardBreak"},{"text":"-> Asterisk CLI: pri intense debug span X (replace X with the span of your choice)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]},{"type":"hardBreak"},{"text":"-> search for \"","type":"text"},{"text":"Cause Code","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"\" and research the internet for ISDN Cause Codes with this Code","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"An alternative to searching the Asterisk CLI for PRI message cause codes, you can take a pcap trace, which is a trace at the lower wanpipe driver level, of the PRI messages being sent and received on the physical line. This is a good way to indicate if you or the remote side is sending wrong information over the line. The pcap trace can then be analyzed through a program called ","type":"text"},{"text":"wireshark","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.wireshark.org/"}}]},{"text":". The syntax for the pcap trace is below: ","type":"text"}]},{"type":"paragraph","content":[{"text":"CPE Mode:","type":"text","marks":[{"type":"strong"}]},{"text":" -> wanpipemon -i wXg1 -pcap -pcap_file isdn.pcap -prot ISDN -full -systime -c trd","type":"text"},{"type":"hardBreak"},{"text":"NET Mode:","type":"text","marks":[{"type":"strong"}]},{"text":" -> wanpipemon -i wXg1 -pcap -pcap_file isdn.pcap -prot ISDN -pcap_isdn_network -full -systime -c trd","type":"text"}]},{"type":"paragraph","content":[{"text":"Replace 'X' in 'wXg1' with the wanpipe of your choice. If you are connected directly to the telco, then use \"CPE Mode\". Run the command in a separate linux command line and let run until enough packets have been captured, and then complete the trace by pressing . The file created is called ","type":"text"},{"text":"isdn.pcap ","type":"text","marks":[{"type":"em"}]},{"text":"and is saved in your local directory. Then analyze the trace in wireshark or send to ","type":"text"},{"text":"Sangoma Technical Support","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:teckdesk@sangoma.com"}}]},{"text":" with a brief description of the issue.","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"9)If you are still having problems then please send the following to ","type":"text"},{"text":"techdesk@sangoma.com","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:techdesk@sangoma.com"}}]},{"text":" along with a brief description of the problem:","type":"text"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"-log all output from the Asterisk console to a file:","type":"text"},{"type":"hardBreak"},{"text":" =>open up the file /etc/asterisk/logger.conf","type":"text"},{"type":"hardBreak"},{"text":" =>look for the line \"messages=> notice,warning ...\" and add this one line below \"sangoma => notice,warning,error,event,verbose\"","type":"text"},{"type":"hardBreak"},{"text":" =>save the file and restart Asterisk","type":"text"},{"type":"hardBreak"},{"text":"-increase the verbosity of Asterisk using \"set verbose 10\"","type":"text"},{"type":"hardBreak"},{"text":"-the output from \"pri show span X\" from the Asterisk console, where X is the span having problems (i.e. 1,2,3,4,etc)","type":"text"},{"type":"hardBreak"},{"text":"-run \"pri intense debug span X\" from the Asterisk console so that Asterisk captures debug information, where X is the span having problems (i.e. 1,2,3,4,etc)","type":"text"},{"type":"hardBreak"},{"text":"-make a call out to reproduce the problem or leave the system running until it occurs","type":"text"},{"type":"hardBreak"},{"text":"-turn off Asterisk logging to the file /var/log/asterisk/sangoma by:","type":"text"},{"type":"hardBreak"},{"text":" =>open up the file /etc/asterisk/logger.conf","type":"text"},{"type":"hardBreak"},{"text":" =>look for the line \"sangoma => notice,warning,error,event,verbose\", and either remove it or uncomment it","type":"text"},{"type":"hardBreak"},{"text":" =>save the file and restart Asterisk","type":"text"},{"type":"hardBreak"},{"text":"-send in the /var/log/asterisk/sangoma","type":"text"},{"type":"hardBreak"},{"text":"-send in the support logger as shown at ","type":"text"},{"text":"https://sangomakb.atlassian.net/wiki/spaces/TC/pages/52858083/Support+Logger?search_id=9188d7f8-8cb5-4541-a92a-1843bf145f15","type":"text","marks":[{"type":"link","attrs":{"href":"https://sangomakb.atlassian.net/wiki/spaces/TC/pages/52858083/Support+Logger?search_id=9188d7f8-8cb5-4541-a92a-1843bf145f15"}}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"***To turn of the debugging in Asterisk run \"pri no debug span X\", where X is the span in question***","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Hang-up Detection","type":"text"}]},{"type":"paragraph","content":[{"text":"This section describes terminology, tips and settings that might aid in troubleshooting hangup detection issues most notably within applications using analogue phones. Hangup signals are generate by a FXS interface and are used to signal an FXO that the line has been hung up on the FXS end. Note in the opposite case the FXO would indicate a hangup by bringing the line to the on-hook voltage level (this section is to help with configuring the former).","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Disconnect Supervision","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Refers to opening/closing the 2-wire circuit (as in hanging up a telephone), and in some cases, reversing tip/ring (48 volt polarity change)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It is something your telco should be providing to you","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Complain to your telco about them not giving you \"disconnection supervision\" on your line","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Kewlstart signalling","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Under Asterisk, the term used to describe Remote Disconnect Supervision","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To enable - put \"","type":"text"},{"text":"signalling=fx","type":"text","marks":[{"type":"strong"}]},{"text":"[","type":"text"},{"text":"s","type":"text","marks":[{"type":"strong"}]},{"text":"/","type":"text"},{"text":"o","type":"text","marks":[{"type":"strong"}]},{"text":"]","type":"text"},{"text":"_ks","type":"text","marks":[{"type":"strong"}]},{"text":"\" in /etc/asterisk/chan_dahdi.conf","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Is by far the most reliable method of telling Asterisk that the line has been disconnected","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Try asking your Telco if they can supply you with Kewlstart or Forward Disconnect Supervision on your line","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"what it does - momentarily reverses the polarity on the line to indicate that the line has been disconnected","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"CPC (Calling Party Control)","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an open circuit (0 V) signal sent from most modern electronic COs to indicate that the \"Calling Party\" has hung up","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"DAHDI Settings (EXAMPLES ONLY)","type":"text"}]},{"type":"paragraph","content":[{"text":"The following settings can be adjusted in the file ","type":"text"},{"text":"/etc/asterisk/chan_dahdi.conf","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"NOTE* These values are examples and must be set according to your Telco's requirements and provided services","type":"text"},{"type":"hardBreak"},{"text":"( source: ","type":"text"},{"type":"inlineCard","attrs":{"url":"http://www.voip-info.org/wiki/view/chan_dahdi.conf"}},{"text":" )","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"busydetect=yes","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"On trunk interfaces (FXS) and E&M interfaces (E&M, Wink, Feature Group D etc, it can be useful to perform","type":"text"},{"type":"hardBreak"},{"text":"busy detection either in an effort to detect hangup or for detecting busies. ","type":"text"},{"type":"hardBreak"},{"text":"This enables listening for the beep-beep busy pattern.","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"busycount=6","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If busydetect is enabled, it is also possible to specify how many busy tones to wait for before hanging up. ","type":"text"},{"type":"hardBreak"},{"text":"The default is 3, but it might be safer to set to 6 or even 8. Mind that the higher the number, the more","type":"text"},{"type":"hardBreak"},{"text":"time that will be needed to hangup a channel, but lowers the probability that you will get random hangups.","type":"text"}]},{"type":"paragraph","content":[{"text":"busypattern=500,500","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If busydetect is enabled, it is also possible to specify the cadence of your busy signal. In many countries,","type":"text"},{"type":"hardBreak"},{"text":"it is 500msec on, 500msec off. Without busypattern specified, we'll accept any regular sound-silence pattern","type":"text"},{"type":"hardBreak"},{"text":"that repeats times as a busy signal. If you specify busypattern, then we'll further check the","type":"text"},{"type":"hardBreak"},{"text":"length of the sound (tone) and silence, which will further reduce the chance of a false positive.","type":"text"}]},{"type":"paragraph","content":[{"text":"answeronpolarityswitch=yes","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Use a polarity reversal to mark when a outgoing call is answered by the","type":"text"},{"type":"hardBreak"},{"text":"remote party. In some countries, a polarity reversal is used to signal the","type":"text"},{"type":"hardBreak"},{"text":"disconnect of a phone line.","type":"text"}]},{"type":"paragraph","content":[{"text":"hanguponpolarityswitch=yes","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If the hanguponpolarityswitch option is selected, the call will be considered ","type":"text"},{"type":"hardBreak"},{"text":"\"hung up\" on a polarity reversal.","type":"text"}]},{"type":"paragraph","content":[{"text":"callprogress=yes","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"progzone=uk","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Few zones are supported at the time of this writing, but may be selected","type":"text"},{"type":"hardBreak"},{"text":"with \"progzone\". Progzone also affects the pattern used for buzydetect (unless","type":"text"},{"type":"hardBreak"},{"text":"busypattern is set explicitly). The possible values are: ","type":"text"},{"type":"hardBreak"},{"text":" us (default)","type":"text"},{"type":"hardBreak"},{"text":" ca (alias for 'us')","type":"text"},{"type":"hardBreak"},{"text":" cr (Costa Rica)","type":"text"},{"type":"hardBreak"},{"text":" br (Brazil, alias for 'cr')","type":"text"},{"type":"hardBreak"},{"text":" uk","type":"text"}]},{"type":"paragraph","content":[{"text":"This feature can also easily detect false hangups. The symptoms of this is","type":"text"},{"type":"hardBreak"},{"text":"being disconnected in the middle of a call for no reason.","type":"text"}]},{"type":"paragraph","content":[{"text":"tonezone = 0 ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Set the tonezone. Equivalent of the defaultzone settings in","type":"text"},{"type":"hardBreak"},{"text":"/etc/dahdi.conf . This sets the tone zone by number.","type":"text"},{"type":"hardBreak"},{"text":"Note that you'd still need to load tonezones (loadzone in dahdi.conf).","type":"text"},{"type":"hardBreak"},{"text":"The default is -1: not to set anything. 0 is US.","type":"text"}]},{"type":"paragraph","content":[{"text":"ringtimeout=8000","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"FXO (FXS signalled) devices must have a timeout to determine if there was a","type":"text"},{"type":"hardBreak"},{"text":"hangup before the line was answered. This value can be tweaked to shorten","type":"text"},{"type":"hardBreak"},{"text":"how long it takes before DAHDI considers a non-ringing line to have hungup.","type":"text"},{"type":"hardBreak"},{"text":"ring timeout will not update on a reload.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Wanpipe Settings","type":"text"}]},{"type":"paragraph","content":[{"text":"The following settings can be adjusted in the file ","type":"text"},{"text":"/etc/wanpipe/wanpipeX.conf","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"NOTE* Try to fix hang up detection issues using DAHDI settings first !","type":"text"}]},{"type":"paragraph","content":[{"text":"RM_BATTTHRESH = 3","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This value determines the level which the line voltage must be strictly less then in order for the line to be in a \"battery removed\" state. ","type":"text"}]},{"type":"paragraph","content":[{"text":"RM_BATTDEBOUNCE = 4 - 16 ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This value defines the time period the wanpipe driver will wait for voltage level changes to settle on the line.","type":"text"},{"type":"hardBreak"},{"text":"So if the far end sends a battery debounce (e.g. drops/reverses the line voltage level to indicate a hangup) or a battery removal, this variable determines how long the driver will wait before making conclusions about the final battery state / voltage level on the line.","type":"text"},{"type":"hardBreak"},{"text":"The value is decremented once every 4 interrupt periods (1 ms interrupts) and therefore determines the settling time with the simple relation:","type":"text"}]},{"type":"paragraph","content":[{"text":"settling time (ms) = RM_BATTDEBOUNCE * 4","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"External Resources","type":"text"}]},{"type":"paragraph","content":[{"text":"http://www.voip-info.org/wiki/index.php?page=Asterisk+Disconnect+Supervision","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.voip-info.org/wiki/index.php?page=Asterisk+Disconnect+Supervision"}}]},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"http://www.voip-info.org/wiki/view/Australia+Asterisk+Details"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Caller ID","type":"text"}]},{"type":"paragraph","content":[{"text":"If there is a caller ID issue then, first insure that telco is sending the CID by using a normal analog phone on the line. Next after you know telco is sending caller id then go to the following URLS, and see if the suggestions there help resolve the issue.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"http://www.voip-info.org/wiki-Asterisk+config+zapata.conf#CallerIDOptions"}},{"text":" ","type":"text"},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"http://www.voip-info.org/wiki/view/Asterisk+and+UK+Caller+ID"}},{"text":" ","type":"text"},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"http://www.voip-info.org/wiki/view/Asterisk+and+Australian+Caller+ID"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE:","type":"text","marks":[{"type":"strong"}]},{"text":" If caller ID is disabled on the line from the telco you can add \"usecallerid=no\" to stop Asterisk from waiting for the caller id. This decreases the time the call takes to enter the dial plan to be routed. ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Software Echo Canceler Debugging","type":"text"}]},{"type":"paragraph","content":[{"text":"Here are a few steps we have used to debug echo.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find out if the Echo canceler is even ON. Sometimes the EC stays off for some reason.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Set echocancel = no, and make a call to a number that you know has bad echo.","type":"text"},{"type":"hardBreak"},{"text":"Then make it with echocancel = yes. You should notice a _BIG_ difference. If you have to think about it, then there is no real difference and echo cancellation was off both times. The difference should be dramatic.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can confirm by placing a call and using \"zap show channel x\" or \"dahdi show channel x\" to see the echo cancellation state. If you see that echo cancellation is set to zero taps, then somehow echo cancellation is not enabled. If you see echo cancellation set to 128, 64 or 32 taps, then the global echo cancellation is enabled.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the EC is working play with the gains.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The software echo cancellers are quite good at reducing echo about 25dB, but you will often have a little echo remaining. This echo residual can be reduced a lot by playing with the tx and rx gains. Try txgain=rxgain=-10 to start. It should have a dramatic effect on the residual echo, at the expense of volume. You can adjust the attenuation and will usually find a setting with reasonable volume and acceptable echo.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Limitations of the software EC: The EC in zaptel/dahdi has been optimized for the lowest system load, so there have been several compromises made. Firstly the training sequence is run much less frequently than in a hardware EC, so training takes 10-15 seconds rather than about 1/4 second. So you will hear echo for the first 10-15 seconds, after which it will largely fade. There is nothing you can do about that in s/w, except use the echotraining feature.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The other problem is that the non-linear processor is missing entirely from the s/w EC so that there is always residual echo that has to be manipulated with the gains.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Try decreasing your txgain and rxgain in zapata.conf or chan_dahdi.conf, and increase the volume on your handsets. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can try a different software echo canceller. ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In your zaptel source. modify your zconfig.h file. ","type":"text"},{"type":"hardBreak"},{"text":"Look for #define ECHO_CAN and try a different echo canceller.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If all other methods of reducing echo have failed, Asterisk also has an option in the zconfig.h to makethe echo cancellation more aggressive. You can enable it by uncommenting the following line:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" #define AGGRESSIVE_SUPPRESSOR","type":"text"}]},{"type":"paragraph","content":[{"text":" Note that aggressive echo cancellation can create a walkie-talkie, half-duplex effect. This should be enabled only if all above methods have failed.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"You will get better performance from good carrier-grade hardware EC such as used on our \"d\" models.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Hardware Echo Canceler Debugging","type":"text"}]},{"type":"paragraph","content":[{"text":"How to confirm that your hardware echo canceler is running and active on your Zap/Dahdi calls.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Confirm that you have a hardware echo canceler:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" After the Wanpipe drivers are installed, type \"wanrouter hwprobe\" it should say: ","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"},{"text":"1. AFT-AXX-SH : SLOT=X : BUS=X : IRQ=X CPU=A: PORT=X : ","type":"text","marks":[{"type":"em"}]},{"text":"HWEC= 32 ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": V=X","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" HWEC values should be:","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A200d : 32","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A101d : 32","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A102d : 64","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A104d : 128","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A108d : 256","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A500d : 64 ","type":"text","marks":[{"type":"em"}]},{"text":" If it says HWEC=0, and you ordered a \"d\" model card then this card needs to be replaced so if you purchased this card from a reseller, contact your reseller. If you purchased this card directly from Sangoma, then please contact our ","type":"text"},{"text":"RMA department","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:rma@sangoma.com"}}]},{"text":".","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you have a hardware echo canceller, confirm that:","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You have Wanpipe-2.3.4 or newer","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You have the parameter \"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"TDMV_HWEC = YES","type":"text","marks":[{"type":"strong"}]},{"text":"\" in your /etc/wanpipe/wanpipe*.conf","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You have the parameter \"echocancel=yes\" in your /etc/asterisk/zapata.conf or /etc/asterisk/chan_dahdi.conf","type":"text"}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run \"wanrouter start\" to start our drivers then run \"wan_ec_client wanpipe1 stats\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If you do not see any output, contact Sangoma Tech Support and attach /var/log/messages to the email.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"You should see: ","type":"text"},{"type":"hardBreak"},{"text":"wanpipe1: Running Get stats command to Echo Canceller device... Done!","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"***** Echo Canceller Chip Get Stats wanpipe1 *****","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"wanpipe1: Number of channels currently open 32","type":"text","marks":[{"type":"em"}]},{"text":" This confirms that the WANPIPE drivers can communicate with the hardware echo canceller chip properly. 4. Make a call through Asterisk. While the call is active type \"zap show channel N\" or \"Dahdi show channel N\" (N being the zap/Dahdi channel number) in the Asterisk CLI. In the output it should say \"echocancel: 128 TAPS, currently ON\" if it does not say \"currently ON\", check your /etc/asterisk/zapata.conf or /etc/asterisk/chan_dahdi.conf , if you are bridging TDM to TDM, and you want echo canceling to be performed, then you should also have \"echocancelwhenbridged=yes\"","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"If it says \"currently ON\" then check if the hardware EC is enabled or not, by running the command \" wanpipemon -i -c ehw \"","type":"text"},{"type":"hardBreak"},{"text":"For example:","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"#> wanpipemon -i w1g1 -c ehw","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"Sangoma HW echo canceller active on channel N","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"where N is your active channel.","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"With wanpipe-3.2.x and wanpipe-2.3.4-5 or later, we have persistent hardware EC means hardware EC is enabled all the times, therefore you should see following for all the voice channels","type":"text"},{"type":"hardBreak"},{"text":"#> wanpipemon -i w1g1 -c ehw","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"Sangoma HW Echo Canceller is enabled for channel N ( N: is your channel number)","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Software DTMF Detection ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit your /etc/asterisk/zapata.conf or /etc/asterisk/chan_dahdi.conf and change set \"relaxdtmf=yes\" then restart Asterisk.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go into the Asterisk CLI \"asterisk -r\" and run \"zap show channel X\" or \"dahdi show channel X\" (x being the zap/Dahdi channel in question) and this will tell you if relaxdtmf is enabled. Place some test calls and see if the issue has been resolved. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the issue remains then go into your /etc/asterisk/zapata.conf or /etc/asterisk/chan_dahdi.conf and increase your rxgain value. You can apply this change with just the command reload from the Asterisk CLI.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the issue are still remaining then check the quality of the line and insure there is no echo or noise issues. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If there is no noise issues then please upgrade and try our ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"hardware DTMF","type":"text","marks":[{"type":"link","attrs":{"href":"http://sangoma.editme.com/wanpipe-linux-asterisk-appendix#asterisk_hwdtmf"}}]},{"text":", instructions for this can be found at","type":"text"},{"text":" Appendix --> Asterisk & Sangoma Hardware DTMF.","type":"text","marks":[{"type":"link","attrs":{"href":"http://sangoma.editme.com/wanpipe-linux-asterisk-appendix#asterisk_hwdtmf"}}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Hardware DTMF Detection","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE: You need a hardware echo canceler. To see if you have a HWEC run the command \"wanrouter hwprobe\" and it should say:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"1. AFT-AXX-SH : SLOT=X : BUS=X : IRQ=X CPU=A: PORT=X : ","type":"text","marks":[{"type":"em"}]},{"text":"HWEC= 32 ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": V=X","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" HWEC values should be:","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A200d : 32","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A101d : 32","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A102d : 64","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A104d : 128","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A108d : 256","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" A500d : 64 ","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Insure that your line has no noise issues. If you have noise issues then check \"ifconfig\" for overruns.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade to the latest Beta driver which can be found at ","type":"text"},{"text":"http://wiki.sangoma.com/wanpipe-linux-drivers#beta","type":"text","marks":[{"type":"link","attrs":{"href":"http://sangoma.editme.com/wanpipe-linux-drivers#beta"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit your /etc/wanpipe/wanpipe*.conf file and change \"TDMV_HW_DTMF = YES\" to \"TDMV_HW_DTMF = NO\" and then stop asterisk and run \"Wanrouter restart\" and then start asterisk back up and see if this resolves the issue.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ether way if the hardware DTMF did not work then please send an email to ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"techdesk@sangoma.com","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:techdesk@sangoma.com"}}]},{"text":" along with the following information and a brief description of the issue.","type":"text"}]},{"type":"paragraph","content":[{"text":"-the output from \"wanrouter version\"","type":"text"},{"type":"hardBreak"},{"text":"-the output from \"wanrouter restart\" (asterisk needs to be turned off for this so it may need to be done after hours)","type":"text"},{"type":"hardBreak"},{"text":"-the file /var/log/messages (the entire file containing a wanrouter restart)","type":"text"},{"type":"hardBreak"},{"text":"-the output from \"wanrouter hwprobe verbose\"","type":"text"},{"type":"hardBreak"},{"text":"-the output from â??wanrouter statusâ?","type":"text"},{"type":"hardBreak"},{"text":"-the file(s) /etc/wanpipe/wanpipeX.conf (where X is the wanpipe number)","type":"text"},{"type":"hardBreak"},{"text":"-the file /etc/zaptel.conf (Zaptel/Asterisk ONLY)","type":"text"},{"type":"hardBreak"},{"text":"-the file(s) /etc/asterisk/zapata*.conf (Zaptel/Asterisk ONLY)","type":"text"},{"type":"hardBreak"},{"text":"-the file /etc/dahdi/system.conf (Dahdi/Asterisk ONLY)","type":"text"},{"type":"hardBreak"},{"text":"-the file(s) /etc/asterisk/chan_dahdi.conf (Dahdi/Asterisk ONLY)","type":"text"},{"type":"hardBreak"},{"text":"-the output from \"ifconfig\", (re run a couple of times with a second or so delay in between each run)","type":"text"},{"type":"hardBreak"},{"text":"-the output from \"cat /proc/interrupts\" (re run a couple of times with a second or so delay in between each run)","type":"text"},{"type":"hardBreak"},{"text":"-the output from \"wanpipemon -i wXg1 -c Ta\" (where X is the interface number 1,2,3,etc) for each interface","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":" Checking the DTMF received","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can simply go into the Asterisk CLI with the command asterisk -rvvvvvv and then pick up the channel you want to debug and you will see the output below.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"-- Starting simple switch on 'Zap/1-1'","type":"text","marks":[{"type":"em"}]}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once you see the output above simply run the command debug channel Zap/1-1 or debug channel Dahdi/1-1 to start the debugging.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Note: ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"the channel has to be in use before running the debug command.","type":"text","marks":[{"type":"em"}]}]},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Then press DTMF digits and you will see the following output, note the digit that was pressed is highlighted in red.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"<< [ TYPE: Null Frame (5) SUBCLASS: N/A (0) ] [Zap/1-1]","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"<< [ TYPE: DTMF End (1) SUBCLASS: ","type":"text","marks":[{"type":"em"}]},{"text":"1","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" (49) ] [Zap/1-1]","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"<< [ TYPE: Null Frame (5) SUBCLASS: N/A (0) ] [Zap/1-1]","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"<< [ TYPE: DTMF End (1) SUBCLASS: ","type":"text","marks":[{"type":"em"}]},{"text":"2","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" (50) ] [Zap/1-1]","type":"text","marks":[{"type":"em"}]}]},{"type":"orderedList","attrs":{"order":4},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can also try our dial plan which plays back the DTMF digits to you.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"DTMF_Dial_Plan.rar","type":"text","marks":[{"type":"link","attrs":{"href":"http://sangoma.editme.com/files/wanpipe-linux-asterisk-debugging/DTMF_Dial_Plan.rar"}}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Analog Caller ID Issues","type":"text"}]},{"type":"paragraph","content":[{"text":"Sangoma Hardware does not interpret or interfere with caller ID on the line and simply passes this information up to the software stack (ie. Dahdi/FreeTDM). If you wish to troubleshoot Caller ID issues, the following steps may help:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"A Caller ID issue could be caused by several factors. This section explores the possibility that the issue could be located at the telco or by noise on the lines.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect an analog phone to the demarcation point. In telephony, the demarcation point is the point at which the telephone company network ends and connects with the wiring at the customer premises.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Place a call -- using another line or mobile phone -- from the PSTN to the analog phone connected at the demarcation point and check if the phone displays Caller ID. If the Caller ID information is not being shown by the phone, please contact your telco and ask them how to enable this feature. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Otherwise, please disconnect the phone and plug it to the line that is directly connected or closest to your Asterisk server and repeat the test call.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If the analog phone shows the CallerID on every call, we could potentially be facing a misconfiguration of your Asterisk server. The following section will discuss how Caller ID detection works in Asterisk and the different options that you have avaialble. ","type":"text"}]},{"type":"paragraph","content":[{"text":"In Asterisk, the CallerID detection is done by the chan_dahdi module. Normally its configuration file is located on ","type":"text"},{"text":"/etc/asterisk/chan_dahdi.conf ","type":"text","marks":[{"type":"em"}]},{"text":"and there are three variables that control how the feature works:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"usecallerid:","type":"text","marks":[{"type":"strong"}]},{"text":" Sets whether to use caller ID, \"yes\" or \"no\" are the only available options","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"cidsignalling: ","type":"text","marks":[{"type":"strong"}]},{"text":"Determine type of caller ID signaling in use. The Caller ID signaling types supported by Asterisk are:","type":"text"}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"bell","type":"text","marks":[{"type":"em"}]},{"text":": bell202 as used in US (default)","type":"text"},{"type":"hardBreak"},{"text":"v23","type":"text","marks":[{"type":"em"}]},{"text":": v23 as used in the UK","type":"text"},{"type":"hardBreak"},{"text":"v23_jp","type":"text","marks":[{"type":"em"}]},{"text":": v23 as used in Japan ","type":"text"},{"type":"hardBreak"},{"text":"dtmf","type":"text","marks":[{"type":"em"}]},{"text":": DTMF as used in Denmark, Sweden and Netherlands","type":"text"},{"type":"hardBreak"},{"text":"smdi","type":"text","marks":[{"type":"em"}]},{"text":": Use SMDI for caller ID. Requires SMDI to be enabled","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"cidstart: ","type":"text","marks":[{"type":"strong"}]},{"text":"Determine signals the start of caller ID. The options supported by Asterisk are:","type":"text"}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"ring","type":"text","marks":[{"type":"em"}]},{"text":": A ring signals the start (default)","type":"text"},{"type":"hardBreak"},{"text":"polarity","type":"text","marks":[{"type":"em"}]},{"text":": Polarity reversal signals the start","type":"text"},{"type":"hardBreak"},{"text":"polarity_IN","type":"text","marks":[{"type":"em"}]},{"text":": Polarity reversal signals the start, DTMF dialtone detection in India","type":"text"},{"type":"hardBreak"},{"text":"dtmf","type":"text","marks":[{"type":"em"}]},{"text":": DTMF Caller ID spill begins only with DTMF, at various times before the ring. This causes Asterisk to constantly listen for DTMF CallerID signals on the specified channels","type":"text"},{"type":"hardBreak"},{"text":"If ","type":"text"},{"text":"cidstart","type":"text","marks":[{"type":"em"}]},{"text":" is configured to use dtmf, the energy level on the line may need to be tuned to properly identify the DTMF tones. This tuning is done with the ","type":"text"},{"text":"dtmfcidlevel ","type":"text","marks":[{"type":"em"}]},{"text":"configuration option. The specified value is compared to the average over a packet of audio level of the absolute value of 16 bit signed linear samples. The default is set to 256, but this is completely arbitrary. It must be set high enough to prevent false detections, while low enough to ensure no dtmf spills are missed.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"dtmfcidlevel=256","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are unsure how to set up these variables. Please contact your telco for more information about the type of signal that the use on the Caller ID (cidsignalling)and when their switches send it (cidstart) ","type":"text"}]},{"type":"paragraph","content":[{"text":"And example of the default configuration of Asterisk is:","type":"text"}]},{"type":"paragraph","content":[{"text":"file: chan_dahdi.conf ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"[trunkgroups]","type":"text"},{"type":"hardBreak"},{"text":"...","type":"text"},{"type":"hardBreak"},{"text":"[channels]","type":"text"},{"type":"hardBreak"},{"text":"...","type":"text"},{"type":"hardBreak"},{"text":"usecallerid=yes","type":"text"},{"type":"hardBreak"},{"text":"cidsignalling=bell","type":"text"},{"type":"hardBreak"},{"text":"cidstart=ring","type":"text"},{"type":"hardBreak"},{"text":"...","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: \"...\" means that other configuration unrelated to Caller ID could be there. Please take into consideration that chan_dahdi controls more aspects than the Caller ID. Please do not delete the other variables if you are not sure what those do.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"P.S. We have seen at least once where a telco disabled Caller ID by attenuating the Caller ID signal. This disables it for Asterisk and DAHDI, but a plain old telephone service (POTS) handset with Caller ID display can still show Caller ID information in this scenario. If you're sure you have the chan_dahdi.conf settings correct for your location, and you're still not getting Caller ID, be sure to contact the provider and make sure they actually have Caller ID enabled on the line.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"(all the above information was taken from ","type":"text"},{"text":"this link.","type":"text","marks":[{"type":"link","attrs":{"href":"http://kb.digium.com/articles/Troubleshooting/How-to-troubleshoot-CallerID-issues-on-a-FXO-or-QuadFXO-module?retURL=%2Fapex%2FknowledgeProduct&popup=false"}}]},{"text":" )","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"dahdi_monitor audio recording","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text","marks":[{"type":"strong"}]},{"text":"dahdi_monitor","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" to record a Dahdi Channel if you are experiencing these symptoms:","type":"text","marks":[{"type":"strong"}]},{"text":"?","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Echo/noise?","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DTMF issues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"one-way audio issues","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Below is a diagram of how ","type":"text"},{"text":"dahdi_monitor","type":"text","marks":[{"type":"em"}]},{"text":" is used:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":317,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":190,"id":"7832e618-b3f5-4cdf-864e-708bf59fd195","collection":"contentId-52134452","type":"file","height":369}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"As seen in the diagram above, the result of audio recordings from ","type":"text"},{"text":"dahdi_monitor","type":"text","marks":[{"type":"em"}]},{"text":" will indicate from which direction the bad audio/issue is coming from.","type":"text"}]},{"type":"paragraph","content":[{"text":"Establish a call that has an echo, noise, dtmf, or one-way audio problem ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Determine the call channel number by running \"show channels\" on Asterisk CLI:","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c6817228-e598-43ff-9a0a-3ca2d66f5f78"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"CLI> core show channels","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":" 2. Now use the dahdi recording command :","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6026afc3-8ba3-4b01-a0dd-6083f3136b0d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"dahdi_monitor -r output_rx.raw -t output_tx.raw","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"this command will initiate an audio recording on the specific channel in the ","type":"text"},{"text":"Tx","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Rx","type":"text","marks":[{"type":"strong"}]},{"text":" direction and place the audio data into separate .raw files","type":"text"}]},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When done capturing the audio, press ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"ctrl + c","type":"text","marks":[{"type":"strong"}]},{"text":" to end the recording","type":"text"}]},{"type":"orderedList","attrs":{"order":4},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Convert the raw audio streams into WAVE files using the sox program:","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c92fb2d3-d8ef-4c6a-980b-8ca4add00274"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"sox -t raw -r 8000 -s -2 -c 1 ","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"(You can use Audacity: ","type":"text"},{"type":"inlineCard","attrs":{"url":"http://audacity.sourceforge.net/"}},{"text":" if you know what you're doing - import with a bit depth = 16)","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"NOTE* If ","type":"text","marks":[{"type":"strong"}]},{"text":"output_tx.raw","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" has bad audio, the issue is coming from either the Asterisk layer, or your sip network (Sangoma technical support may not be able to help you resolve this scenario)","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If your Sangoma hardware has a hardware echo cancellor, its best practice to take a ","type":"text"},{"text":"hardware echo canceller recording","type":"text","marks":[{"type":"link","attrs":{"href":"http://sangoma.editme.com/Wanpipe-How-To#audio_recording"}}]},{"text":" ","type":"text"},{"text":"at the same time","type":"text","marks":[{"type":"strong"}]},{"text":" you run ","type":"text"},{"text":"dahdi_monitor ","type":"text","marks":[{"type":"em"}]},{"text":"recordings. This will give you a complete picture of the audio (highlevel and low level) and determine where the audio issue is generated from ","type":"text"}]}],"version":1}

Browser not supported