{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Important Note Regarding FreeSwitch® and FreeTDM® Support","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Support for FreeSwitch and FreeTDM for Sangoma telephony card products are no longer provided by Sangoma. All FreeSwitch drivers and applications are provided as-is with no warranty. ","type":"text","marks":[{"type":"strong"}]}]}]},{"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":"false"}},"macroMetadata":{"macroId":{"value":"2af7f87c-d36e-40c7-a4b3-064ffd9266be"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"917549c8-87e2-4b49-9214-0b0746cc021c"}},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Sangoma was previously involved in the FreeTDM project, but has refocused its development efforts primarily on Asterisk-based platforms including FreePBX. The information on this page and other FreeSwitch-related pages on the Sangoma Wiki has been retained for historical and reference purposes, but should not be relied upon as reflecting Sangoma's current development efforts or support policies.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"When using FreeSWITCH with FreeTDM, there are certain scenarios where installation is required to use ","type":"text"},{"text":"FreeSWITCH DAHDI mode","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Install the Sangoma hardware in FreeSWITCH DAHDI mode only if any of the following scenarios apply:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"-> USBFXO (U100) installation","type":"text"},{"type":"hardBreak"},{"text":"-> AFT analog card without Hardware echo cancellation and you require software echo cancellation","type":"text"},{"type":"hardBreak"},{"text":"-> T1 RBS protocol support","type":"text"}]},{"type":"paragraph","content":[{"text":"This means that Dahdi must be installed over the Wanpipe driver, in order for FreeSWITCH to communicate with the Sangoma hardware below. ","type":"text"},{"text":"DAHDI mode","type":"text","marks":[{"type":"em"}]},{"text":" is most likely compatible with ","type":"text"},{"text":"Zaptel mode","type":"text","marks":[{"type":"em"}]},{"text":", but Zaptel is deprecated. This mode depends on \"ftmod_zt.so\", which is always compiled, regardless of whether you have DAHDI or Zaptel.","type":"text"}]},{"type":"paragraph","content":[{"text":"On runtime, FreeTDM will try to determine (checking the existence of /dev/zap/ctl or /dev/dahdi/ctl) which one you have. In a typical DAHDI installation, the freetdm.conf file will be a basic mirror of the contents /etc/dahdi/system.conf (or /etc/zaptel.conf if using zaptel), but you still need them because they are used by dahdi_cfg or ztcfg to configure the hardware.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"DAHDI and Wanpipe Installation","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DAHDI Installation","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Download Dahdi into an arbitrary directory (i.e. /usr/src) and untar it.","type":"text"},{"type":"hardBreak"},{"text":"-> ","type":"text"},{"text":"tar xvfz dahdi-","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"-> cd dahdi-","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"-> make ","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"-> make install","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wanpipe Driver Installation","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Download the Wanpipe Driver ","type":"text"},{"type":"hardBreak"},{"text":"Untar wanpipe release in arbitrary directory (i.e. /usr/src/):","type":"text"},{"type":"hardBreak"},{"text":"-> tar xvfz wanpipe-.tgz","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"-> cd wanpipe-","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"-> ","type":"text","marks":[{"type":"em"}]},{"text":"./Setup dahdi","type":"text"},{"type":"hardBreak"},{"text":"----","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]},{"type":"hardBreak"},{"text":"Proceed with installation ","type":"text"},{"text":"Select \"Y\"","type":"text","marks":[{"type":"strong"}]},{"text":" for each option.","type":"text"},{"type":"hardBreak"},{"text":"Setup will auto-detect dahdi sources in /usr/src","type":"text"},{"type":"hardBreak"},{"text":"select 'm' to manually specify dahdi source directory]","type":"text"}]},{"type":"paragraph","content":[{"text":"Proceed with Defaults for the rest of the compilation.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Last step in installation will ask you: \"Would you like to configure wanpipe devices for DAHDI? (y/n)\"","type":"text"},{"type":"hardBreak"},{"text":"-> SELECT ","type":"text"},{"text":"NO","type":"text","marks":[{"type":"underline"},{"type":"strong"}]},{"type":"hardBreak"},{"text":"--","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Confirm Successful Wanpipe/Zaptel Installation","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"Run the following command to confirm that the Wanpipe driver has been installed successfully:","type":"text"},{"type":"hardBreak"},{"text":"-> wanrouter hwprobe","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"You should have an output similar to the example below:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"--->Example (from usbfxo install):","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"wanrouter hwprobe\n-------------------------------\n | Wanpipe Hardware Probe Info |\n -------------------------------\n1 . U100 : BUSID=4-1 : V=00\n \n Card Cnt: A101-2=0 A104=0 B700=0 U100=1 B600=0","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"FreeSWITCH Installation","type":"text"}]},{"type":"paragraph","content":[{"text":"Download FreeSWITCH into your /usr/src/ directory","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy and paste the below line into your Linux command line to automatically start downloading FreeSWITCH","type":"text"},{"type":"hardBreak"},{"text":"-> git clone -b v1.6 ","type":"text"},{"text":"https://github.com/signalwire/freeswitch","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/signalwire/freeswitch"}}]}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This command will download FreeSWITCH using Git the Git online repository. If you do not have Git on your system, you will need to download it first before running the above command.","type":"text"},{"type":"hardBreak"},{"text":"If you need to download Git on CentOS, simply type 'yum install git-all', or 'apt-get install git-all' for ubuntu","type":"text"}]}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After the download is complete, you will notice a new directory called 'freeswitch'. You can verify this by typing 'ls' in your Linux command line.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate inside this new 'freeswitch' directory by typing the following in your Linux command line:","type":"text"},{"type":"hardBreak"},{"text":"-> cd freeswitch","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type the following command to prepare the freeswitch system:","type":"text"},{"type":"hardBreak"},{"text":"-> ./bootstrap","type":"text"}]},{"type":"paragraph","content":[{"text":"This will take a few minutes to complete.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable mod_freetdm which will enable the FreeTDM signaling stack inside FreeSWITCH","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" Open the ","type":"text"},{"text":"modules.conf ","type":"text","marks":[{"type":"em"}]},{"text":"file by typing the following:","type":"text"},{"type":"hardBreak"},{"text":"-> vi modules.conf","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"un-comment the following line by removing the '#' character from the beginning:","type":"text"}]},{"type":"paragraph","content":[{"text":"-> #../../libs/freetdm/mod_freetdm","type":"text"}]},{"type":"paragraph","content":[{"text":"So your result should look like:","type":"text"},{"type":"hardBreak"},{"text":"-> ../../libs/freetdm/mod_freetdm","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"save and exit ","type":"text"},{"text":"modules.conf","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure your FreeSWITCH system by typing the following command:","type":"text"},{"type":"hardBreak"},{"text":"-> ./configure","type":"text"}]},{"type":"paragraph","content":[{"text":"(This will make the freeswitch working directory: /usr/local/freeswitch)","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If you would like the working directory of freeswitch to be anything different than /usr/local/freeswitch you can indicate this by typing the following command, instead of './configure':","type":"text"},{"type":"hardBreak"},{"text":"-> ./configure --prefix=","type":"text"}]}]},{"type":"orderedList","attrs":{"order":7},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Compile and Install FreeSWITCH","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type the following command to compile FreeSWITCH:","type":"text"},{"type":"hardBreak"},{"text":"-> make","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type the following command to install FreeSWITCH:","type":"text"},{"type":"hardBreak"},{"text":"-> make install","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"FreeSWITCH is now Installed ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To configure your Sangoma card(s), run the following command in your Linux command line:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"-> ","type":"text"},{"text":"wancfg_fs","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This command will configure all your Sangoma cards in your system.","type":"text"}]},{"type":"paragraph","content":[{"text":"Simply follow the prompts and answer all the questions. ","type":"text"}]},{"type":"paragraph","content":[{"text":" After running the wancfg_fs configuration tool, the following files will have been created:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Physical layer ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/etc/wanpipe/wanpipeX.conf","type":"text","marks":[{"type":"em"}]},{"text":" (x represents each port of your card. For analog cards, you will only see 1 for the entire card)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/etc/wanpipe/wanrouter.rc","type":"text","marks":[{"type":"em"}]},{"text":" (The Sangoma driver looks into this file to begin loading each port for your card(s)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"FreeTDM Signaling layer ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/usr/local/freeswitch/conf/freetdm.conf","type":"text","marks":[{"type":"em"}]},{"text":" (b and d channels)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"FreeSWITCH related files","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/usr/local/freeswitch/conf/autoload_configs/freetdm.conf.xml","type":"text","marks":[{"type":"em"}]},{"text":" (channel details for your Sangoma card)","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type: ","type":"text"},{"type":"hardBreak"},{"text":"->","type":"text"},{"text":" wancfg_dahdi","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"This is a Wanpipe script that will create the necessary DAHDI configuration files:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"-> /etc/dahdi/system.conf","type":"text"},{"type":"hardBreak"},{"text":"-> /etc/wanpipe/wanpipeX.conf (X represents a digit)","type":"text"}]},{"type":"paragraph","content":[{"text":"When prompted with:","type":"text"}]},{"type":"paragraph","content":[{"text":" Would you like to generate /etc/asterisk/chan_dahdi.conf?","type":"text"},{"type":"hardBreak"},{"text":" -> SELECT ","type":"text"},{"text":"NO","type":"text","marks":[{"type":"underline"}]},{"text":" (since chan_dahdi.conf will not be used here)","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It is important to note that the Sangoma hardware will be a span of type \"zt\" in FreeSWITCH. When configured in ZT mode, there is no span number in the channel configuration (Channel numbers are global).","type":"text"},{"type":"hardBreak"},{"text":"Please follow the applicable steps below:","type":"text"}]}]}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are using FreeSWITCH DAHDI mode to provide software echo cancellation to your Analog card","type":"text","marks":[{"type":"strong"}]},{"text":" (w/o hardware echo cancellation), edit:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"-> /usr/local/freeswitch/conf/freetdm.conf","type":"text"},{"type":"hardBreak"},{"text":" change ","type":"text"},{"text":"all ","type":"text","marks":[{"type":"em"}]},{"text":"the span ] tags ","type":"text"},{"text":"[span wanpipe wp1]","type":"text","marks":[{"type":"em"}]},{"text":"to ","type":"text"},{"text":"[span zt wp1]","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"---","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are using FreeSWITCH DAHDI mode for USBFXO installation:","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Copy and paste the samples below as the only context of /conf/freetdm.conf and /conf/autoload_configs/freetdm.conf.xml. Make sure the channel numbers are correct if you have other DAHDI devices in the system.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ab22f18b-d0b8-4b1d-a5d3-288743240232"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"freetdm.conf\n[span zt usbfxo]\nname => usbfxo\ntrunk_type => fxo\ngroup => 1\nfxo-channel => 1\nfxo-channel => 2","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d60d84e5-18ae-403b-a140-66becd1dadf4"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"freetdm.conf.xml\n \n\n\n\n\n\n\n\n \n\n\n \n\n\n\n\n\n \n","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Make certain that is the same name in freetdm.conf (span zt=xxxx)","type":"text"},{"type":"hardBreak"},{"text":"---","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are using T1 RBS protocol with FreeSWITCH:","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Copy and paste the samples below as the only context of /conf/freetdm.conf and /conf/autoload_configs/freetdm.conf.xml:","type":"text"}]},{"type":"codeBlock","content":[{"text":"freetdm.conf\n[span zt wp1]\ntrunk_type => EM\nem-channel => 1-24","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"freetdm.conf.xml\n\n \n \n \n \n \n\n","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All configuration options for ftmod_zt are typically located at:","type":"text"}]},{"type":"paragraph","content":[{"text":"-> /usr/local/freeswitch/conf/zt.conf (dependent on freeswitch install directory)","type":"text"}]},{"type":"codeBlock","content":[{"text":" sample:\n \n[defaults]\ncodec_ms => 20\nwink_ms => 150\nflash_ms => 750\necho_cancel_level => 64\nrxgain => 0.0\ntxgain => 0.0","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"-----","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At this point, all the configuration files are complete and are listed below:","type":"text"}]},{"type":"paragraph","content":[{"text":"-> /etc/wanpipe/wanpipeX.conf","type":"text"},{"type":"hardBreak"},{"text":"-> /etc/dahdi/system.conf","type":"text"},{"type":"hardBreak"},{"text":"-> /usr/local/freeswitch/conf/freetdm.conf","type":"text"},{"type":"hardBreak"},{"text":"-> /usr/local/freeswitch/conf/autoload_configs/freetdm.conf","type":"text"},{"type":"hardBreak"},{"text":"---------","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" Start wanpipe and configure DAHDI spans","type":"text"},{"type":"hardBreak"},{"text":"-> wanrouter start","type":"text"},{"type":"hardBreak"},{"text":"-> dahdi_cfg (if not automated by wanpipe startup)","type":"text"},{"type":"hardBreak"},{"text":"----","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}}]}]},{"type":"paragraph","content":[{"text":"Start FreeSWITCH, you are ready to go :)","type":"text"}]}]}]}],"version":1}

Browser not supported