{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"63d255ac-6e1d-415b-81c5-086dc79a5435"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"96c2aa5a-94b2-401d-b989-2f384e454094"}},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"This general configuration information shows the zaptel.conf, zapata.conf, and wanpipe1.conf files for a A101 Sangoma card. This is attached to a T1/PRI line:","type":"text"}]},{"type":"paragraph","content":[{"text":"Digium cards run on the zaptel drivers and only require setup of zaptel.conf and zapata.conf.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Zaptel.conf","type":"text"}]},{"type":"paragraph","content":[{"text":"trixbox Pro: Configure this file ONLY with the web interface (unless it does not support cards.)","type":"text"}]},{"type":"codeBlock","content":[{"text":"loadzone=us\ndefaultzone=us\n\nspan=1,1,0,esf,b8zs\nbchan=1-23\nhardhdlc=24","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Zapata.conf","type":"text"}]},{"type":"paragraph","content":[{"text":"trixbox Pro: Configure this file ONLY with the web interface (unless it does not support cards.)","type":"text"}]},{"type":"codeBlock","content":[{"text":"[channels]\ncontext=incoming\nswitchtype=national\nsignalling=fxs_ks\nrxwink=300 ; Atlas seems to use long (250ms) winks\nusecallerid=yes\nhidecallerid=no\ncallwaiting=yes\nusecallingpres=yes\ncallwaitingcallerid=yes\nthreewaycalling=yes\ntransfer=yes\ncancallforward=yes\ncallreturn=yes\nechocancel=1\nechocancelwhenbridged=yes\nechotraining=0\nrxgain=0\ntxgain=0\ngroup=1\ncallgroup=1\npickupgroup=1\nimmediate=no\n\n\nswitchtype=national\npridialplan=unknown\nsignalling=pri_cpe\ncontext=incoming\ngroup=2\nchannel => 1-23","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE: If the card has HWEC (Hardware Echo Cancellation) echocancel must be enabled in zapata for it to work. In other words, echocancel should be turned on in almost all cases, regardless of whether the card is hardware or software EC. The drivers decide what type of echo cancellation to apply. ","type":"text"},{"text":"[reference]","type":"text","marks":[{"type":"link","attrs":{"href":"https://sangomakb.atlassian.net/wiki/spaces/TC/pages/52134452/Asterisk+Debugging#Hardware-Echo-Canceler-Debugging"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Wanpipe Drivers","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"wanpipe1.conf","type":"text"}]},{"type":"paragraph","content":[{"text":"Configure this file ONLY with the wancfg utility or the web interface (comments from file left out.)","type":"text"}]},{"type":"paragraph","content":[{"text":"Steps on how to do this:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type ","type":"text"},{"text":"wancfg","type":"text","marks":[{"type":"code"}]},{"text":" from the command line","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the \"Please note:\" screen, just hit enter","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"Edit\" or \"Create\" as needed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Down for \"Create a new Configuration File\" & enter","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter to create a new wanpipe1 or down to make a new wanpipeX.conf","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter to \"Select from detected cards list\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Down/Up to choose the card/interface and press enter","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter for \"Edit existing Configuration File\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Down/up to choose the wanpipe file to edit & enter","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"... to be completed...","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"[devices]\nwanpipe1 = WAN_AFT_TE1, Comment\n\n[interfaces]\nw1g1 = wanpipe1, , TDM_VOICE, Comment\n\n[wanpipe1]\nCARD_TYPE = AFT\nS514CPU = A\nCommPort = PRI\nAUTO_PCISLOT = NO\nPCISLOT = 4\nPCIBUS = 20\nFE_MEDIA = T1\nFE_LCODE = B8ZS\nFE_FRAME = ESF\nFE_LINE = 1\nTE_CLOCK = NORMAL\nTE_REF_CLOCK = 0\nTE_HIGHIMPEDANCE = NO\nLBO = 0DB\nFE_TXTRISTATE = NO\nMTU = 1500\nUDPPORT = 9000\nTTL = 255\nIGNORE_FRONT_END = NO\nTDMV_SPAN = 1\nTDMV_DCHAN = 24\n\n[w1g1]\nACTIVE_CH = ALL\nTDMV_ECHO_OFF = NO\nTDMV_HWEC = YES","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Misc PRI Info","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Reading PRI Debug Output","type":"text"}]},{"type":"paragraph","content":[{"text":"You can enable PRI debugging with the asterisk CLI command","type":"text"}]},{"type":"codeBlock","content":[{"text":"pri debug span X","type":"text"}]},{"type":"paragraph","content":[{"text":"To disable debugging, do","type":"text"}]},{"type":"codeBlock","content":[{"text":"pri no debug span X","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"When you enable ","type":"text"},{"text":"pri debug","type":"text","marks":[{"type":"strong"}]},{"text":" within the FONcore console, every line of output of debug info will be marked with either a ","type":"text"},{"text":"<","type":"text","marks":[{"type":"strong"}]},{"text":" sign or a ","type":"text"},{"text":">","type":"text","marks":[{"type":"strong"}]},{"text":" sign. These symbols are very important:","type":"text"}]},{"type":"paragraph","content":[{"text":">","type":"text","marks":[{"type":"strong"}]},{"text":" information transmitted on the PRI FROM FONcore.","type":"text"}]},{"type":"paragraph","content":[{"text":"<","type":"text","marks":[{"type":"strong"}]},{"text":" information transmitted on the PRI FROM the Provider.","type":"text"}]},{"type":"paragraph","content":[{"text":"Making a mental note of which way the arrow faces helps us quickly determine which side of the PRI 'conversation' is talking. ","type":"text"}]},{"type":"paragraph","content":[{"text":"A frequent problem that arises on PRI circuits is that FONcore tries to initiate a connection to the Provider, but FONcore does not receive any reply.","type":"text"}]},{"type":"paragraph","content":[{"text":"Within the pri debug output, you will see a ","type":"text"},{"text":"SABME","type":"text","marks":[{"type":"strong"}]},{"text":" bit transmitted (Set Asynchronous Balanced Mode Extended).","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"SABME","type":"text","marks":[{"type":"strong"}]},{"text":" bit is the PRI card's way of saying, \"Hello, I'm here. Connect to me.\"","type":"text"}]},{"type":"paragraph","content":[{"text":"FONcore waits for the ","type":"text"},{"text":"ACK","type":"text","marks":[{"type":"strong"}]},{"text":" bit to the SABME (Acknowledge). If the ACK bit doesn't come - FONcore retransmits the SABME bit. Infinitely...","type":"text"}]},{"type":"paragraph","content":[{"text":"After the ACK to the initial SABME, FONcore transmits an ","type":"text"},{"text":"RR","type":"text","marks":[{"type":"strong"}]},{"text":" (Receiver Ready) bit to the Provider. The provider (should) reply with an RR bit of it's own. At this point, both sides of the PRI 'conversation' are ready to commence transmission. The PRI \"comes up\" and you will see ","type":"text"},{"text":"Provisioned, Up, Active","type":"text","marks":[{"type":"strong"}]},{"text":" when you run ","type":"text"},{"text":"pri show span 1","type":"text","marks":[{"type":"strong"}]},{"text":" from the FONcore console.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Auto-Response","type":"text"}]},{"type":"paragraph","content":[{"text":"Send the follow to customers who will be using T1/PRI service:","type":"text"}]},{"type":"paragraph","content":[{"text":"The following information is needed to configure T1/PRI. You must give Fonality Support this information in order to avoid missing your turn up appointment with your provider.","type":"text"}]},{"type":"paragraph","content":[{"text":"The information provided below are the common settings:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provider:","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PBXtra Server ID:","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Framing: ESF","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Encoding: B8ZS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Signaling: ISDN PRI","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Switch Type: NI2 “National” ISDN","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DNIS Digits: 10 (Use 4 if 10 not available)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"You can get the information above from your provider. Please forward this information to us as soon as you have it. Fonality Support can configure the PBXtra in advance of your turn up date.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is not a requirement of Fonality that a Support Engineer participate in the turn up. However, some providers do require a \"PBX technician\" to be available. If that is the case, you must request a T1/PRI Turn Up Appointment.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Dial in reverse order","type":"text"}]},{"type":"paragraph","content":[{"text":"If you would like Asterisk to dial OUT on a PRI in ","type":"text"},{"text":"reverse","type":"text","marks":[{"type":"em"}]},{"text":" order (i.e. 23, 22, 21, etc.), you can make this happen by changing the 'g' in trunk.conf to 'G'.","type":"text"}]},{"type":"paragraph","content":[{"text":"So:","type":"text"}]},{"type":"codeBlock","content":[{"text":"[trunklocal]\n;\n; Local seven-digit dialing accessed through trunk interface\n;\n\nexten => _9NXXXXXX,1,GotoIf($[\"${CENTREX}\" = \"1\"]?20);\nexten => _9NXXXXXX,2,Set(EXTENSION=${CALLERID(number)});\nexten => _9NXXXXXX,3,AGI(fon://localhost:4574);\nexten => _9NXXXXXX,4,Dial(Zap/g2/1200${EXTEN:1});\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Becomes:","type":"text"}]},{"type":"codeBlock","content":[{"text":"[trunklocal]\n;\n; Local seven-digit dialing accessed through trunk interface\n;\n\nexten => _9NXXXXXX,1,GotoIf($[\"${CENTREX}\" = \"1\"]?20);\nexten => _9NXXXXXX,2,Set(EXTENSION=${CALLERID(number)});\nexten => _9NXXXXXX,3,AGI(fon://localhost:4574);\nexten => _9NXXXXXX,4,Dial(Zap/G2/1200${EXTEN:1});","type":"text"}]},{"type":"paragraph","content":[{"text":"Other valid options are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"g: select the lowest-numbered non-busy Zap channel (aka. ascending sequential hunt group).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"G: select the highest-numbered non-busy Zap channel (aka. descending sequential hunt group).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"r: use a round-robin search, starting at the next highest channel than last time (aka. ascending rotary hunt group).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"R: use a round-robin search, starting at the next lowest channel than last time (aka. descending rotary hunt group).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"PRI not receiving CID Info","type":"text"}]},{"type":"paragraph","content":[{"text":"If a customer complains of not receiving CID name when they know CID name is passed, check the logs for a specific CID number that did not pass a name. You may see something like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":" dialparties.agi: Caller ID name is 'unknown' number is '2392678162'","type":"text"}]},{"type":"paragraph","content":[{"text":"There are times where you can do a PRI debug and see the CID information being passed through","type":"text"}]},{"type":"codeBlock","content":[{"text":" < Protocol Discriminator: Q.931 (8) len=70\n < Call Ref: len= 2 (reference 3/0x3) (Originator)\n < Message type: SETUP (5)\n < [04 03 90 90 a2]\n < Bearer Capability (len= 5) [ Ext: 1 Q.931 Std: 0 Info transfer capability: 3.1kHz audio (16)\n < Ext: 1 Trans mode/rate: 64kbps, circuit-mode (16)\n < Ext: 1 User information layer 1: u-Law (34)\n < [18 03 a9 83 83]\n < Channel ID (len= 5) [ Ext: 1 IntID: Implicit, PRI Spare: 0, Exclusive Dchan: 0\n < ChanSel: Reserved\n < Ext: 1 Coding: 0 Number Specified Channel Type: 3\n < Ext: 1 Channel: 3 ]\n < [1c 1c 9f 8b 01 00 a1 16 02 01 01 02 01 00 80 0e 42 41 52 54 45 4c 4c 20 54 48 4f 4d 41 53]\n < Facility (len=30, codeset=0) [ 0x9f, 0x8b, 0x01, 0x00, 0xa1, 0x16, 0x02, 0x01, 0x01, 0x02, 0x01, 0x00, 0x80, 0x0e, 'BARTELL', 0x20, 'THOMAS' ]\n < [1e 02 82 83]\n < Progress Indicator (len= 4) [ Ext: 1 Coding: CCITT (ITU) standard (0) 0: 0 Location: Public network serving the local user (2)\n < Ext: 1 Progress Description: Calling equipment is non-ISDN. (3) ]\n < [6c 0c 21 83 32 33 39 34 36 36 32 30 36 31]\n < Calling Number (len=14) [ Ext: 0 TON: National Number (2) NPI: ISDN/Telephony Numbering Plan (E.164/E.163) (1)\n < Presentation: Presentation allowed of network provided number (3) '2394662061' ]\n < [70 05 a1 37 30 30 30]\n < Called Number (len= 7) [ Ext: 1 TON: National Number (2) NPI: ISDN/Telephony Numbering Plan (E.164/E.163) (1) '7000' ]\n -- Making new call for cr 3\n -- Processing Q.931 Call Setup\n -- Processing IE 4 (cs0, Bearer Capability)\n -- Processing IE 24 (cs0, Channel Identification)\n -- Processing IE 28 (cs0, Facility)\n Handle Q.932 ROSE Invoke component\n -- Processing IE 30 (cs0, Progress Indicator)\n -- Processing IE 108 (cs0, Calling Party Number)\n -- Processing IE 112 (cs0, Called Party Number)\n > Protocol Discriminator: Q.931 (8) len=10\n > Call Ref: len= 2 (reference 3/0x3) (Terminator)\n > Message type: CALL PROCEEDING (2)","type":"text"}]},{"type":"paragraph","content":[{"text":"The bold section above shows where CID name information is present.","type":"text"}]},{"type":"paragraph","content":[{"text":"One thing that works is this instant is editing the extension.conf in /etc/asterisk/","type":"text"}]},{"type":"codeBlock","content":[{"text":" vi /etc/asterisk/extensions.conf","type":"text"}]},{"type":"paragraph","content":[{"text":"Search for ","type":"text"},{"text":"[from-zaptel]","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":" [from-zaptel]\n exten => _X.,1,Set(DID=${EXTEN})\n exten => _X.,n,Goto(s,1)\n exten => s,1,NoOp(Entering from-zaptel with DID == ${DID})\n ; Some trunks _require_ a RINGING be sent before an Answer.\n exten => s,n,Ringing()","type":"text"}]},{"type":"paragraph","content":[{"text":"And edit it to look like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":" [from-zaptel]\n exten => _X.,1,Wait(2)\n exten => _X.,n,Set(DID=${EXTEN})\n exten => _X.,n,Set(CALLERID(name)=${CALLERID(name)})\n exten => _X.,n,Goto(s,1)\n exten => s,1,NoOp(Entering from-zaptel with DID == ${DID})\n ; Some trunks _require_ a RINGING be sent before an Answer.\n exten => s,n,Ringing()","type":"text"}]},{"type":"paragraph","content":[{"text":"This adds enough of a delay for the PRI that Asterisk can pick up the CID name information being passed.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: ","type":"text"},{"text":"Stay on the phone with the customer and ensure that they are not having any problems receiving calls. Test at least 5 calls with them.","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"An alternative solution:","type":"text"},{"type":"hardBreak"},{"text":"In ","type":"text"},{"text":"/etc/asterisk/zapata.conf","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Find line ","type":"text"},{"text":"context=from-zaptel","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Change to ","type":"text"},{"text":"context=from-mypri","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"In ","type":"text"},{"text":"extensions_custom.conf","type":"text","marks":[{"type":"strong"}]},{"text":" add:","type":"text"}]},{"type":"codeBlock","content":[{"text":" [from-mypri]\n exten => _.,1,Noop(CALLERID: ${CALLERID(all)})\n exten => _.,n,Wait(1)\n exten => _.,n,Noop(CALLERID: ${CALLERID(all)})\n exten => _.,n,Goto(from-pstn,${EXTEN},1)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"D4/AMI Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Most T1 lines are set to use ESF/B8ZS as the framing & encoding type, but once in a while you will stumble across a server that is set to use D4/AMI. Several things need to be adjusted in order to agree with this:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"wancfg settings - while editing wanpipeX.conf","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the \"Hardware Setup\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose \"Advanced Physical Medium Configuration\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change \"Line Decoding\" to AMI","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change \"Framing\" to D4","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go back twice","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose the \"Interface Setup\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose the only interface available","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure that \"TDM PRI HW-HDLC TIMESLOT\" is set to \"0 Not Used\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Back all the way out and save changes","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"zaptel.conf - an example:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"span=1,1,0,d4,ami\nfxsls=1-24 # can be set to fxsls, e&m, or potentially something else, but not b-chan","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"zapata.conf - an example:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"signalling=fxs_ls # match zaptel as always\ncontext=incoming\nbusydetect=yes\nrelaxdtmf=yes\ngroup=2\nchannel => 1-16","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}],"version":1}

Browser not supported