Astribank User Manual
Contents
1. wv D zoo am RN18 RNIT erido e i LIT a Uo v w Zz so Ter zm je ano E lt va e o SA tipp n 4 Lea n v oi V v c o E o 5 To HE 9 UO 48 o tum E mm 7 LT EL LLLI T E pem mcum fi na LI az LI Loud Eee a cis RN mu e ii 9 rani F errore s D E iac WE 9 TOT TY l m L sd Lg Los 40 UTA U16 111111311 UT SHIT bh PE TTTEU TE el o a d 10004018L NS Mr co no L8L0Vd oh Figure 3 FXS Module with I O Ports Astribank User Manual 8 Port FXO The 8 port FXO 1s normally used for a PSTN connection XORCOM FXO module PN PBO130 syed CTP i mur IL iP R3 aD is LU f Ji Rs 1 z 4 n ie U uU UJ o C O 2 0 o O e O C C e o re e 0O00 O eo o o o o o o o o ol e e e e e ogo i 2 piOLO OLELNS c0 no LELOV Figure 4 FXO Module 6 FXS 2 FXO ports This module expands the Astribank s flexibility J u20 1 u14 pitri ASRRRRRRED pres E E SECEDE ELE zonou i LZZOV Figure 5 6 FXS plus 2 FXO Module System Overview 5 ORCOM Digital Modules Following are pictures of the Astribank BRI and E1 T1 modules B rivus a areh trh stie Tia ver pos resass soa MM apr OQOO000000 005 loooooooocoOOQ cu 02. port address port type The port address and the port type are explained in the following sections Configuring an Astribank E1 T1 21 Xorcom 22 Port Address The port address may be presented by using either the Astribank XPP protocol logical XBUS number or the physical USB connector number When using the logical XBUS numbers in the port address expression use the following syntax NUM XBUS mm XPD nn The value for mm is the XBUS number and the value for nn 1s the XPD number see Troubleshooting Terminology on page 44 When using a physical USB connector number 1n the lt port_address gt expression use the following syntax CONNECTOR usb XPD nn The value for usb is the USB connector identification and the value for nn is the XPD number You can get the USB connector identification from verbose output of the zaptel hardware utility when the Zaptel drivers are loaded For example zaptel hardware v usb 004 004 xpp_usb e4e4 1152 Astribank multi FPGA firmware LABEL usb 0000108 CONNECTOR usb 0000 00 03 3 4 XBUS 00 XPD 00 E1_TE Span 1 ZAPTEL SYNC XBUS 00 XPD 01 EI TE Span 2 XBUS 00 XPD 10 FXS Span 3 XBUS 00 XPD 20 FXS Span 4 Port Type The port type is the port mode and port function group separated by a comma for example E1 TE or r1 wr Please note that port mode and the function group may be written in any order For example the following will provide the same result 11
3. LED Selection The LED selection is made based on the timing source value in the span parameter that is defined in the etc dahdi system conf file The general span parameter format is the following span lt span num gt lt timing source line build out LBO framing coding yellow Table 13 The span should not recover clock from the line This is typical NT side equipment behavior Therefore the yellow LED of the upper socket NT will be active Timing source equals 0 The span should recover clock from the line This is typical TE side equipment behavior Therefore the green LED of the lower socket TE will be active Timing source is greater than 0 Astribank User Manual Xorcom Installing Astribank Drivers on Linux Distributions Astribank drivers are available in binary code packages for some popular platforms and source code We constantly update the drivers add more features and add more supported platforms Please check the Support section in our Web site www xorcom com for the latest drivers and packages Linux and Asterisk distributions change from time to time We recommended checking the Support section of our Web site www xorcom com for updates Astribank drivers are part of Zaptel packages that are maintained by Digium Inc To build Asterisk and Zaptel by yourself download the appropriate source packages from www asterisk org and compile them according to instructions in the Readme
4. gt 200 n Hangup 203 say extension number will only work if caller ID is properly set in zapata conf zapata channels conf exten 203 1 Answer exten gt 203 n wait 1 exten gt 203 n SayNumber CALLERID num exten gt 203 n Hangup Context for FXS auxiliary input ports astbank 1nput exten gt S 1 Set ZAP CHAN 1CUT CHANNEL 1 exten gt S n Set ZAP CHAN S CUT ZAP CHAN 2 11 is the number of the first input port At least in the sample configuration below exten gt s n SetCINPUT_NUM ZAP_CHAN 11 The sample below just logs the signal exten gt s n NoOp Got signal from Zaptel Channel ZAP_CHAN P Alternatively exten s n System run something No we did not forget the context astbank outputs The FXS auxiliary output ports may only accept calls from the PBX Therefore they don t need a context of their own But assigning them to a dedicated context makes zap show channels in the CLI provide more useful outputs Run the following command to reload the configuration files asterisk rx reload 36 Astribank User Manual Xorcom Step 5 Checking the Installation l List your Zaptel hardware with the command zaptel hardware Review the currently configured Zaptel channels by using command Iszaptel Dial 9 lt NUMBER gt to make outbound call through the first available BRI TE port Make an inbound call via the BRI port Ins
5. 39 T III III IT E mens A cida A ttl da Pi E aoBRRARRRERERRRERARRAD T EEETTTTTTTIITITITIIS TEL Se em er AAAhRhAhhhnAaM SS RARA SEDCETEETITEITITITILITT oe pe o LEGS PS ema CRNT gt PTT I CR ET in it ai 421 a T dh MMC dh MEC WU ME io de DA Ei noteine 9 px UT20795 05TS UT20795 05TS UT20795 05TS e UT20795 05TS ECL S MEL zl me Foo amp 5 FE 3 tm Y Z Q 9 paaangne Son 8 EPIDMIDACBETTI S2 vagananaass CRN K T p da T E dy IMC T Eis A pao334 ENN UT20795 05TS UT20795 05TS UT20795 05TS UT20795 05TS 2 i Rev 03 EMA 0819 dB 2E 178 dE 4 moowm nnmnnmoawmmmeoemmest a pz aii ted m vw ttt ttt 512 US u Caer LLL MN TITTTITHTTTITTIT A d a a N 9 gt uJ o c w o hieeeeaeanne HN LH amp huma CRER E E800 PPPs PRERERER APPR Poe Ann A RANA m L a gt m Ld B 5 ERER 2233 LULLTLL LES P N PBO330 z E F SM T EOL D 180055558 M ve Es OO ME E isso PRET ETLEEEETEEE ES senecuna IL LITTTTITI 1333333338 itii stijiiiiii ao 4 m mus 6 Astribank User Manual XORCOM Examples of Astribank Analog Units The analog Astribank line is available in a standard 19 inch 1U unit that supports 8 16 24 and 32 ports Figure 7 Astribank with 8 FXO Ports Figure 8 Astribank with 32 FXS Ports 2 Output Ports and 4 Input Ports
6. In order to register the spans manually run the following command zt registration on 2 In order to check the existing Zaptel channels configuration status run 1szaptel command For example for Astribank 8 FXS you will get where Iszaptel THER Span FXS FXS FXS FXS FXS FXS FXS FXS Output Output Input Input Input Input FXOLS FXOLS FXOLS FXOLS FXOLS FXOLS FXOLS FXOLS FXOLS FXOLS FXOLS FXOLS FXOLS FXOLS In In In In In In In In In In In In In In use use use use use use use use use use use use use use 1 XBUS 00 XPD 00 Xorcom XPD 400 00 Fxs column 1 channel number in Zaptel You can use this number to reference the Zaptel channel in the Asterisk dialing plan configuration extensions conf column 2 type of the port e g FXS FXO etc column 3 signaling type for the channel defined in zapata configuration The sig naling type is displayed only when the span 1s registered 1n Zaptel and configured ztcfg was performed column 4 indicates whether the channel is used by Asterisk or not Astribank User Manual Xorcom Check the Astribank Device Status on the Asterisk Level To see the Zaptel channel information available on the Asterisk application level run asterisk rx zap show channels Chan Extension Context Language MOH Interpret pseudo from internal en default 1 from internal en default 2 from internal en
7. files included in the packages Xorcom Ltd participates in the maintenance process of binary Zaptel packages for Debian Linux distribution www debian org and cooperates with many Asterisk dis tribution vendors in order to assist them in providing the updated Astribank drivers with their products For example Elastix PaloSanto Solutions Tribox CE Fonality Inc and DRUID VoiceRoute usually have the updated versions of Astribank drivers You can also use the Xorcom Rapid Live CD for Astribank testing and learning pur poses The Live CD image is available for downloading from the Support iDown loads section of our Web site www xorcom com To install an Astribank BRI device the BRIstuff package must be installed The BRIstuff package includes several patches for Zaptel Asterisk and libpri The patches provide some necessary features that are absent in the standard Digium pack ages for example the point to multipoint ISDN mode support Please note that DAHDI is not currently supported in the BRI stuff package To Windows users You will need SSH access to your Asterisk computer A popular free downloadable SSH client is called Putty To paste text with Putty right click the mouse Ctrl v does not work To download Putty go to http www chiark greenend org uk sgtatham putty download html Installing on trixbox CE These instructions are applicable for trixbox CE v 2 6 x only We recommend checking the Support sectio
8. General Troubleshooting The l The The ON light is off Make sure that the power supply cables are connected to the main power supply and to the Astribank Make sure that the wall power outlet is active If the first two are positive swap the power supply 1f you have additional units to isolate the problem ON light is on but the SYNC light is not blinking Make sure that the USB cable is connected Use the Xorcom Rapid Live CD to make sure that there is no hardware problem with the Astribank If using the Xorcom Rapid distribution run Hardware Detection Note that this will run over the current configuration If using another distribution or to avoid running over the current configuration check the Asterisk configuration When using a BRI connection make sure that the PSTN is synchronizing the system continuously The problem is that very frequently the BRI line is auto matically deactivated after a pre defined period of inactivity To keep the BRI line continuously active it must be configured for point to point mode and not for point to multipoint This configuration modification must be done by your local telephone company Note that the BRI status LED should blink slowly and continuously indicating a layer 2 connection yellow Phone LED is on or blinking fast This 1s normal and indicates that telephony voltage for analog telephones or ISDN telephones is available The LED 1s activated aft
9. Introduction Astribank TM 1s a channel bank that was specially developed for the Asterisk Open Source IP PBX An Astribank is connected to the Asterisk server via a USB 2 0 con nection It supports analog telephone sets analog lines a PSTN connection ISDN PRI and BRI lines El R2 lines and ISDN BRI telephone sets Astribank drivers are included in the official DAHDI and Zaptel packages The latest information about Astribank drivers 1s available in the Support section of the Xorcom Web site Multiple Astribank units can be connected to a single Asterisk server If the PC does not have enough USB ports to support additional Astribank units add a USB 2 0 hub The total number of supported ports 1s determined by the Asterisk server perfor mance A simple single processor Pentium 4 3 GHz PC can support hundreds of ports For more information about large Astribank setups please contact us at info xorcom com System Overview The Astribank comes in different configurations and is based on 8 port modules Table 1 Astribank Configurations 8 FXS without I O ports Analog 8 Port 8 FXS with I O ports Modules 8 FXO ports 6 FXS 2 FXO ports BRI Modules 2 4 and 8 ports EI TI Modules 1 2 and 4 ports Each E1 T1 or BRI port can be configured as either TE or NT In addition each port of the E1 T1 module can be configured as El or TI 2 Astribank User Manual XORCOM Main Board Each Astribank telephony module is connec
10. TE and rE T1 Now you can define XPP PRI SETUP CONNECTOR Uusb 0000 00 03 3 4 XPD 00 T1 TE The following wild card characters can be used in the port address expression o matches zero or more characters e matches one character e xyz any of x y or z Configuration Examples To define all PRI ports for T1 with TE CPE function groups XPP PRI SETUP NUM T1 TE To define the first port to be El TE and the second port to be El NT XPP PRI SETUP NUM XBUS 00 XPD 00 E1 TE NUM XBUS 00 XPD 01 E1 NT Astribank User Manual Xorcom Configuring in a DAHDI Environment The following table shows where each Astribank E1 T1 port parameter is configured Table 12 Astribank E1 T1 Port Parameter Configuration in DAHDI environment Configuration File Configuration Parameter EI TI selection etc dahdi xpp conf Clock source framing type and etc dahdi system conf span see Asterisk documentation line encoding LED selection green LED on lower socket or etc dahdi system conf yellow LED on upper socket timing source of the span param eter E1 T1 Selection If the pri protocol parameter is not defined then all of the Astribank E1 T1 ports are considered as El ports The pri protocol parameter may be defined in the following formats e pri protocol El T1j defines port type globally for all of E1 T1 Astribank devices connected e pri protocol xbus nn xpd mm e pri protocol connector lt USB c
11. an Astribank BRI In order to compile and install the Astribank BRI drivers you have to install the BRIstuff The BRIstuff is a distribution for installing and or patching Asterisk Zaptel and libpri with features written and maintained by Junghanns NET Gmbh Actually the package consists of patches for Asterisk and its component along with some scripts Please note that you have to use the BRIstuff packages from the Xorcom repository rather than the original packages from http www junghanns net Step 1 Download and Unpack the BRIstuff Package For Asterisk 1 2 wget http updates xorcom com astribank bristuff bristuff current tgz tar xvzf bristuff current tgz For Asterisk 1 4 wget http updates xorcom com astribank bristuff 1 4 bristuff current tgz tar xvzf bristuff current tgz Step 2 Install the Prerequisites l Make the newly created folder to be the current directory Note that the exact folder name depends on the package version and may differ from the name used in the example below cd bristuff 0 3 0 1y j xr2 2 Install the prerequisite packages The script prereq sh will do this on Debian and CentOS prereq sh install 3 Carefully review the packages installation results Make sure that you did not have a problem with Linux kernel headers installation 4 Ifyou are using CentOS 5 then you also have to install package fx load rpm Uvh http updates xorcom com astribank fxload fxload 2002 04 11 5xr i386 rpm St
12. default 3 from internal en default 4 from internal en default 5 from internal en default 6 from internal en default 7 from internal en default 8 from internal en default 9 output en default 10 output en default 11 input en default 12 input en default 13 input en default 14 input en default If the channel table contains only pseudo channel see the first line in the table above then it means that you didn t configure any Zaptel channels in file zapata conf If you get the error message Unable to connect to remote asterisk then it means that the Asterisk is not running It is possible that Asterisk has failed to start due to mis configured zapata conf or whatever reason Check var log asterisk messages or var log asterisk full logs If you get the error message No such command zap show then it means that chan zap so is not loaded There are two reasons for such problem a chan zap so is not even built Check if the file exists Usually the Asterisk modules are located in folder usr lib asterisk modules as it 1s defined in file etc asterisk asterisk conf parameter astmoddir Is 1 usr lib asterisk modules chan_zap so b thechan zap so file exists but it is not loaded Try to load it manually asterisk rx load module chan zap so How to Discover the Astribank Module Corresponding to a Particular Zaptel Span You can use the xpp blink utility to cause the particular Astribank device or Astribank
13. from http ftp digium com pub zaptel If you use the Astribank BRI you must build the drivers according to the instructions that appear below Step 1 Install the Required Packages In order to build the Zaptel packages you have to have the following packages installed on your system e the kernel source package e newt to build zttool e libusb to build the Astribank firmware loader If you run a kernel package from your distribution the distribution will typically pro vide a package with a partial compiled kernel tree Complete the procedure below that matches your Linux distribution Then install the required packages To see what packages you need to install run install_prereq test To install them run install_prereq install This should work at least on Debian and on CentOS 4 5 Alternatively use the fol lowing instructions to install the prerequisites e Debian 4 0 Etch apt get install linux headers uname r build essential libnewt dev libusb dev RHELA CentOS 4 CentOS 5 a Install the following non kernel related packages yum install y gcc newt devel libusb devel If using CentOS 5 also install the package fx1oad wget http updates xorcom com astribank fxload fxload 2002 04 11 5xr 1386 rpm rpm i fxload 2002 04 11 5xr 1386 rpm b Ifthe following command produces no error skip steps c d and e and go directly to Step 2 Build Zaptel on page 31 Is lib modules uname r build confi
14. ASTRIBANK USER MANUAL XORCOM Asterisk based PBX Solutions Document Information This document ZPM0003 1s Revision 5 5 and was released March 2009 Trademarks Astribank and the Xorcom logo are trademarks of Xorcom Asterisk 1s a registered trademark of Digium Inc All other product and brand names may be trademarks or registered trademarks of their respective owners Contact Information Xorcom Ltd a contributing member of the Asterisk community develops software and hardware for the open source Asterisk PBX environment Our goal 1s to make Asterisk a friendly easy to install and easy to use system enabling fast and simple installation and configuration of PBXs of all sizes Visit our Web site at http www xorcom com Contact us at info xorcom com support xorcom com Table of Contents Ouick Start aodio sad Rana aaa saga 1 WMCP OUUCHIONS au scasesssactcodesceescuusasecsacseedscasesenssacstusesecunervesendesstacesensiacstastecoessasscueseses 2 Arredo secina asia iassiads tona ai adsl au e ado dai bsb au atas edeustsdvateccsetceceus 2 ADO ARO ideia ne oa oa dt d aud 3 Analo Module S s di sates tee e a PURSE ett qu doubled rial da 3 Digital MOUIE S cose Ha ect Eae Mauer ques de Sa iniquae Ames quests 6 Examples of Astribank Analog Units eeee errar T Package Contents eie eoe oe EE eie erede irs oe iUnd cede De lasuas 8 System Requirements 6 doit EE Ra eee HH ite 8 Power Supply and Groundi
15. Analog Phones to the Astribank The Astribank FXS module supports e Any standard analog phone e DTMF and pulse dialing e Caller ID e Message Waiting Indicator MWD A signal that activates the message light indicator available on some telephone sets when a message 1s available Note MWI support is disabled by default in the Astribank FXS Refer to the General Troubleshooting topic on p 46 for instructions on enabling MWI All Astribank units with 8 FXS ports or more have a Telco connection option This option includes a special connector on the rear panel The Telco connection enables the use of a single cable to connect all the FXS ports up to 32 to the patch panel without having to assign an RJ 11 cable for each FXS port At the same time all the front panel LED indicators for each channel are available and the RJ 11 connectors on the front panel enable easy access for each port Figure 17 Telco Connection Rear Panel Connecting Analog Lines to Astribank A The Astribank FXO module supports standard PSTN lines WARNING When connecting the Astribank to PSTN lines ensure that the lines are protected Use standard lightning protection devices such as gas discharge units or similar solid state high energy protection devices Analog lines need to be tuned in order to adjust the port impedance to the telephone line impedance Adjusting impedances can substantially reduce the echo that is gen erated by the inter
16. B Level 48 Check the Astribank Device Status on the Zaptel Level 49 Check the Astribank Device Status on the Asterisk Level 51 How to Discover the Astribank Module Corresponding to a Particular Zaptel Pallas asas dad diu Dea da o uo d dE ad 51 How to Check Define the Astribank Synchronization Source 52 DATING e E E 53 Information Usually Requested by Xorcom Technical Support 53 Astribank BRI Board Revisions esccoccooossooosssssessescccceseosooooossssssssssseseceeeeee 54 Cables Pin Ot EA EE EE E EE E EE A 55 1V This page is intentionally blank Astribank User Manual Quick Start A Quick Start Xorcom In only 3 minutes your Asterisk and Astribank can be up and running l Connect your Astribank s to the USB 2 0 port of a computer 2 Connect the Astribank to the power supply 3 Insert the Xorcom Rapid Live CD and restart the computer When the menu 1s displayed your Asterisk and Astribank s are running Notes The computer boots from the Live CD The content of the computer s hard drive 1s not affected at all Do not forget to connect your Astribank to the main power supply Use USB 2 0 ports only Otherwise Astribank either will not work at all or the voice quality will be poor See Troubleshooting on page 44 for instructions on how to check if your computer 1s equipped with a USB 2 0 controller If your c
17. I DTMF or ETSI FSK method is used configure the Astribank driver and Asterisk in a special way as described below First it is necessary to tell to the Astribank FXO driver xpd fxo when it must start to forward the received PCM to the Zaptel DAHDI The caller 1d style parameter of xpd fxo is used for that purpose 46 Astribank User Manual Xorcom Table 15 Forwarding PCMs caller id style Description Astribank starts to forward received PCM after the first RING signal Astribank starts to forward received PCM after the polarity reversal 1s detected Astribank continuously forwards and monitors the received PCM to the Zaptel DAHDI When the driver detects a dras tic change in the PCM amplitude it simulates the polarity reversal signal detection for Zaptel DAHDI in order to trig ger the Asterisk CallerID detection mechanism The caller 1d style parameter may be defined in the xpp file that you should create in the etc modprobe d folder For example options xpd fxo caller 1d style 2 You also should define the cidstart and cidsignalling parameters in the etc asterisk zapata conf for Zaptel or in the etc asterisk chan dahdi conf for DAHDI Following is an excerpt from the zapata conf file usecallerid yes Type of caller ID signalling in use bell bell202 as used in US V23 v23 as used in the UK v23 jp v23 as used in Japan dtmf DTMF as used in Denmark Sweden and Netherlands smdi Use SMD
18. I for callerid Requires SMDI to be enabled usesmdi cidsignalling bell What signals the start of caller ID rig a ring signals the start polarity polarity reversal signals the start cidstart ring Troubleshooting 47 Xorcom On the FXO lines with polarity reversal enabled the incoming call is termi nated immediately after FXO port answers the call off hook the line This happens when the PSTN switch makes polarity reversal when Asterisk answers the call If the event occurs when timeout is defined in the po larityonanswerde lay parameter then Asterisk disconnects the call The solution is to increase that timeout value For example polarityonanswerdelay 1000 or 1200 the default is 600 ms When a user after a conversation places the receiver on hook and then imme diately takes the receiver off hook in order to make a new call then Asterisk doesn t disconnect the previous call and initiates a three way conference instead This problem occurs because Asterisk mistakenly considered the on hook event as the hook flash signal In order to fix the problem you need to decrease the flash length parameter by reducing the rxf lash parameter value in the Zapata conf file The default value of the rxflash is 1250 ms We suggest rxflash 850 When a user presses the hook flash button in order to initiate a three way con ference or to start the call transfer procedure the Asterisk disconnects the call The problem occurs be
19. ID installation 3 Install the usbutils package yum install usbutils y Installing Astribank FXS F XO PRI on Elastix Elastix generally has the updated drivers and necessary system packages for Astribank FXS FXO PRI You can install the Freepbx module zapauto package and perform the automatic Zaptel configuration procedure exactly as it 1s described for trixbox CE above Installing Astribank FXS FXO BRI PRI on Debian Etch To install Astribank on Debian Etch l1 Edit etc apt sources list and add the following line any place in the file deb http updates xorcom com rapid etch main 2 Runthese commands on the command line apt get update apt get install xorcom archive keyring apt get update apt get install asterisk asterisk bristuff zaptel zaptel modules uname r Note Ifyou do not have an Astribank BRI use this command instead apt get install asterisk asterisk classic zaptel zaptel modules uname r 3 Configure Astribank in Asterisk Installing Astribank Drivers on Linux Distributions 29 Xorcom Building Astribank FXS FXO PRI Drivers from Source 30 As of version 1 2 4 the Astribank driver xpp 1s now part of Zaptel packages How ever Xorcom also maintains a development snapshot of the driver The snapshots are required for the newest modules and often contain fixes not available on the offi cial code released by Digium We update Digium as soon and as often as possible You can download Zaptel
20. Module Admin entry The Module Administration page is displayed vi Enable at least the modules core and Zaptel configuration vii Click Process gt Confirm viii If needed click Apply Configuration Changes This reloads the page ix Navigate to the Setup page x Choose Zaptel configuration and follow the instructions When finished all the FXS extensions will be configured with numbers starting from 401 xi Click Apply Configuration Changes To review the configuration of the extensions from the FreePBX navigation pane click Extensions The following files will be created in the etc asterisk directory zapata channels conf Includes description of all trunks FXO and BRI channels Note that those trunks are assigned to group O That allows you to make outgoing calls by using FreePBX s Astribank User Manual Xorcom predefined route 9 outside To see this from the FreePBX navigation pane click Outbound Routes zapata additional conf Includes description of all Zaptel extensions FXS channels Note that FreePBX recreates this file after a change 1s made in Extensions Installing Astribank FXS FXO PRI on DRUID DRUID OSE and UCS have the updated Astribank FXS FXO PRI drivers Astribank BRI is not currently supported by DRUID The usbutils package pro vides useful utilities To install the package 1 Connect to DRUID with an SSH client 2 Log in as user root and the password defined during the DRU
21. Note Each octet of analog ports is marked either FXS or FXO as illustrated in this picture ON Li ACTIVE L3 SYNC t5 HW U e Ly E L 0P I 12 ORI t4 OPI t6 OPIV 18 System Overview 7 Xorcom Package Contents Please ensure that in addition to the Astribank box the package also contains the fol lowing e External desk top power supply e Power cord e USB cable e CD ROM that includes the following e Live CD based on Xorcom Rapid Asterisk distribution e Astribank drivers e PDF version of this manual e Product line information e Demo videos e Warranty and registration activation information Support hardware for 19 cabinet for 19 full size units only System Requirements You may install Asterisk on various types of servers starting from Pentium 2 units up to top of the line multiple CPU computers The computer should be tested to determine if it can perform the tasks you want it to perform IMPORTANT Ensure that the host supports USB 2 0 8 Astribank User Manual Xorcom Power Supply and Grounding The Astribank uses 110V 220V desktop power Make sure to place the power supply unit and the Astribank box in the open air N WARNING Never cover the power supply unit or the Astribank box WARNING Never use a power supply unit that was not supplied with the Astribank box Connecting other power supply units may damage the Astribank permanently and void the warranty WARNING The unit is
22. SI ES 203 021 2 V2 1 2 and ETSI ES 203 021 5 V2 1 2 specifications Connecting Analog Lines to Astribank 41 Xorcom Running Fxotune Fxotune is a software program that reduces the echo generated in any digital to analog telephony conversion Fxotune thereby improves the voice quality To optimize FXO operation use the fxotune program Note Fxotune ceases the dial tone by dialing a single number default number is 4 and then generating tones in different frequencies while measuring the echo During the test different sets of impedance parameters are used The set that provides the best results that is the lowest echo is chosen for the port The PSTN will allow a certain amount of time between the dialing of the first digit and the second digit Most PSTNs will generate a busy tone if the second number 1s not dialed a few seconds after dialing the first digit You can measure this time by picking up the phone dialing one digit and measuring the time before the PSTN generates the busy tone The default parameter in fxotune 1s 18 seconds In Asterisk version 1 4 this number can be modified Increasing the number will shorten the tuning time If however after a period of time the PSTN sends a busy tone that 1s shorter than the programmed time the fxotune will not complete success fully N WARNING When connecting the Astribank to PSTN lines ensure that a grounding tab is properly affixed and the line is equipped wi
23. Termination J13 NT array 1 4 Off Left 5 6 On Right 7 8 Off Left J22 TE array 1 8 On Right Port 3 in NT mode with 100 Ohm Line Termination and Power Feeding J16 NT array 1 4 On Right 5 6 On Right 7 8 On Right J25 TE array 1 8 Off Left Astribank User Manual Xorcom Connecting ISDN Telephone Sets To connect an ISDN telephone set to one of the Astribank BRI ports you have to power the port The ISDN telephone set 1s powered by the BRI telephone line To activate ISDN telephone sets ensure that the BRI board revision is at least version PB0260 Astribank BRI Board Revi sions on page 54 the port is configured for NT mode switches 7 8 of the corresponding NT DIP switch array are set On Right N WARNING Never power a BRI line unless it is connected to an ISDN telephone set or to equipment that is designed to get the power from the BRI line BRI Line Termination The ISDN S T bus must have 100 Ohm termination on both ends The following status are possible In the case of Point to Point bus both NT and TE ports must have the termina tion In the case of Point to Multipoint bus the NT port and the last TE port must have the termination In cases where there are TE ports on the ends of the bus and the NT port is connected to the middle bus point the termination must be enabled for the two TE ports that are last on the bus The following examples illustrate the thre
24. The following files will be created in the etc asterisk directory zapata channels conf Includes description of all trunks FXO PRI and BRI channels Note that those trunks are assigned to group 0 That allows you to make outgoing calls by using FreePBX s predefined route 9 outside To see this from the FreePBX navigation pane click Outbound Routes zapata additional conf Includes description of all Zaptel extensions FXS channels Note that FreePBX recreates this file after a change 1s made in Extensions Installing Astribank BRI on trixbox CE Version 2 6 x Complete the following procedure if you are going to connect at least one Astribank device that has BRI ports 1 Ensure that the Astribank devices are disconnected from the trixbox CE com puter and switched off 2 Connect to your trixbox CE with an SSH client and log in as user root and with the password defined during the trixbox installation 3 Stop Asterisk amportal stop 4 Install the fxload package rpm Uvh http updates xorcom com astribank fxload fxload 2002 04 11 5xr i386 rpm 5 Install the freepbx module zapauto rpm Uvh http updates xorcom com astribank elastix repo freepbx module zapauto lt version gt noarch rpm 6 Install the patch package yum install patch 7 Make the newly created folder the current directory Please note that the exact folder name depends on the package version and may differ from the example used below cd bristuff 0 4 0 tes
25. XTEN 1 1 EXTEN 2 from internal The context of FXS ports analog phones They are allowed to dial to all other phones include gt phones zap They are also allowed to call through the trunk include trunk Some simple tests include gt astbank test from pstn Calls from the PSTN enter here Redirect calls to an IVR or a default extension in the s context here In this case we redirect calls to Zaptel channel 1 exten gt s 1 Dial Zap 1 Alternatively the following will redirect you to the demo IVR from the sample extensions conf of Asterisk include gt demo An extra context with some simple tests astbank test 200 echo test exten 200 1 Answer exten gt 200 n wait 1 Astribank User Manual ORCOM exten gt 200 n Echo exten gt 200 n Hangup 203 say extension number will only work if caller ID is properly set in zapata conf zapata channels conf exten gt 203 1 Answer exten gt 203 n wait 1 exten gt 203 n SayNumber fCALLERID num 1 exten gt 203 n Hangup Context for FXS auxiliary input ports Lastbank input exten gt s 1 Set ZAP_CHAN CUT CCHANNEL L exten gt s n Set ZAP_CHAN CUT ZAP CHAN 2 11 is the number of the first input port At least in the sample configuration below exten gt s n SetCINPUT_NUM ZAP_CHAN 11 The sample below just logs the signal exten gt s n NoOp Got si
26. a welcome message will be heard 6 Ifan FXS module is not available connect the FXO port to PSTN after running the hardware detection and make a phone call to the PSTN line A welcome message will be heard The Message Waiting LED is not blinking on a telephone handset MWI support is disabled by default in the Astribank FXS driver This is because when a mailbox contains VM messages Asterisk periodically sends FSK encoded message to the channel This means that the FXS driver must always analyze the PCM coming from the Asterisk even when the FXS extension is in the on hook state To enable MWI the vmwineon parameter must be defined for xpd fxs driver To do this add the following line to the etc modprobe d xpp file options xpd fxs vmwineon 1 After that restart Asterisk and Zaptel DAHDI Caller ID is not detected for inbound calls to the FXO ports There are several Caller ID transmission methods that are different form country to country Please note that CallerID is detected and decoded by Asterisk itself The function of the Astribank driver 1s to provide PCM received from the line as exact as possible By default the Astribank FXO driver starts to forward received PCM only after the RING signal is detected on the line This 1s acceptable for the lines where the Bellcore method of CallerID transmission is used In this method the CallerID is sent by the PSTN between the first and second rings In countries where either the ETS
27. cause Asterisk mistakenly considered the hook flash signal as the on hook event In order to fix the problem you need to increase the flash length parameter by increasing the rxflash parameter value in the zapata conf file We suggest rxflash 850 Troubleshooting Tips 48 Check the Astribank Device Status on the USB Level Il In order to see if an Astribank is connected to the computer run the 1susb utility lsusb grep e4e4 Bus 005 Device 012 ID e4e4 1152 Check the USB Product ID the second number after e4e4 It may appear in one of three formats e 11x2 means that the device is connected and the firmware is completely loaded e Ix means that the device is connected but the firmware loading process is not completed It is possible that you will see this Product ID for some time after the device was connected to the system But if 11x1 appears forever then it means that either the firmware loading has failed or you don t have the fpga load utility installed Make sure you have prerequisite package Astribank User Manual Xorcom libusb dev el installed before you start to build Zaptel e 11x0 means that the device is connected but the firmware is not loaded at all Try to disconnect and the connect the device again If it doesn t help then check that usr share zaptel folder contains the Astribank firmware files USB hex and FPGA hex 2 Inorder to see if an Astribank is connected to the system and the correspon
28. channel 20 etc exten gt 6XXX 1 Dial ZAP EXTEN 1 Useful for trunks debugging will potentially allow users to bypass context limitations exten gt _6XXX 1 Dial ZAP EXTEN 1 3 EXTEN 4 trunk A number that begins with 9 dial it through a trunk we put FXO channels and BRI TE channels in group 0 The leading 9 is stripped exten gt _9 1 Dial Zap g0 EXTEN 1 dialing a number that begins with 81 will dial it through Span 1 etc The two leading digits are stripped Each digital span is also added to group 10 span number exten gt _8X 1 Dial Zap g1 EXTEN 1 1 EXTEN 2 from internal The context of FXS ports analog phones They are allowed to dial to all other phones include gt phones zap They are also allowed to call through the trunk include gt trunk Some simple tests include gt astbank test Installing Astribank Drivers on Linux Distributions 35 Xorcom from pstn Calls from the PSTN enter here Redirect calls to an IVR or a default extension in the s context here In this case we redirect calls to Zaptel channel 1 exten gt s 1 Dial Zap 1 Alternatively the following will redirect you to the demo IVR from the sample extensions conf of Asterisk include demo An extra context with some simple tests astbank test 200 echo test exten 200 1 Answer exten gt 200 n wait 1 exten gt 200 n Echo exten
29. d disable 100 Ohm line termination for each port Starting from board revision PB0260 see Astribank BRI Board Revisions on page 54 it is also possible to provide power feeding on NT ports As a result it is possible to connect the Astribank to ISDN phones devices starting from January 2009 all ports are factory configured for the TE mode Configuring Ports as NT or TE Connections To change the default setting change the DIP switch settings To change a DIP switch setting 1 Remove the six screws that secure the Astribank cover Figure 14 Removing the Six Screws two on the far side are not pictured Note The cover of a compact unit is secured by only 2 screws Configuring an Astribank BRI 15 ORCOM 2 Remove the cover Figure 15 Removing the Cover 3 As illustrated in Figure 16 each RJ 45 port has two DIP switch arrays To configure a port as either an NT or a TE connection the switches in both arrays must be set Table 7 lists the correlation between ports and DIP switch arrays Table 8 and Table 9 list the alignment of switches when configuring a port to be either an NT or a TE connection TELE mim 1 TM p Vini WORE EEL FTTYYF YE F YIEFES EU amp nA i CELL ee ee ee ee oe et e rn zu up Ar uM eee AM E E mm me e 5 m h M Eon me me ES oe lm m l i O oS acq M M Tg M RT We T EC ENTE B LIO TA Figure 16 Changing Port Settings na to TE pm Vic
30. designed for indoor use only For safety reasons if the wiring exits the building it 1s essential to use the grounding tab Connect a grounding tab to the grounding screw on the rear panel Then using 12 16 gauge wire connect the grounding tab to a reliable ground Que 12V DC POWER e E Figure 9 Grounding Screw on Rear Panel Power Supply and Grounding 9 Xorcom LED Indicators The LED sets on the front panel of an ISDN Astribank are configured differently than the LED sets on the front panel of an analog Astribank In both cases the LED sets include e 4LED indicators that indicate device status e LEDs that indicate line status e A green LED for each analog line port e ISDN BRI and EI TI ports have 2 LEDs for each line port Note Analog ports also have a red LED but this LED is never used to show line activity Analog Unit LEDs 10 This subsection describes the LEDs on an analog Astribank unit Device Status LEDs Figure 10 shows the status LEDs on analog Astribank units A B C D LL ON t1 ACTIVE L3 SYNC L5 OP 12 OP t4 OP L6 OPIV L8 AUX PORTS Figure 10 Analog Unit Device Status LEDs Table 2 Analog Unit Device Status LEDs Indicates that the unit is powered by the external power supply B ACTIVE that at least one Astribank line either FXS or FXO is Blinks when the Astribank is synchronized with the host Asterisk computer and or the other Astribank units t
31. device module LEDs blinking depending on specified parameters xpp blink f on off bzzt span number xpd bus num xpd num where on start LEDs blinking off stop LEDs blinking Troubleshooting 51 Xorcom 22 bzzt cause the LEDs to blink for 1 second span number LEDs corresponding to the specified span will blinking bus number XBUS number Specifies whole Astribank device xpd number XPD number Specifies a module in an Astribank device For example there is an Astribank 32 FXS device connected to the system Zzaptel hardware usb 005 015 e4e4 1152 xpp usb usb 0000 00 10 4 2 XBUS 00 XPD 00 FXS Span 1 XBUS 00 XPD 10 FXS Span 2 XBUS 00 XPD 20 FXS Span 3 XBUS 00 XPD 30 FXS Span 4 e order to cause all LEDs of Astribank device connected to XBUS O to blink for second xpp blink bzzt xpd O e In order to cause the LEDs of third module of Astribank connected to XBUS 0 blinking during 1 seconds xpp blink bzzt xpd O 2 e norder to cause the LEDs of module configured as Zaptel Span 1 blinking dur ing seconds xpp blink bzzt span 1 Using XBUS 00 XPD 00 connected via usb 0000 00 10 4 2 channels 123456789 10 11 12 13 14 As you can see when the LEDs blinking for a span is requested then xpp blink also prints information about XBUS XPD and Zaptel channel numbers related to the specified span How to Check Define the Astribank Synchronization Source The xpp sync uti
32. ding driver 1s loaded run the zaptel hardware utility In example below you can see the zaptel hardware output when Astribank 32 FXS is connected and initial ized zaptel hardware usb 005 012 e4e4 1152 xpp usb Cusb 0000 00 10 4 2 XBUS 00 XPD 00 FXS Span 1 XPP SYNC XBUS 00 XPD 10 FXS Span 2 XBUS 00 XPD 20 FXS Span 3 XBUS 00 XPD 30 FXS Span 4 In contrast when the Astribank 32 FXS is connected to the system and the firm ware is completely loaded but the driver is not loaded then you will see zaptel hardware usb 005 012 e4e4 1152 Check the Astribank Device Status on the Zaptel Level 1 In order to check if the Astribank spans are registered in Zaptel run the zt registration utility zt registration XBUS 00 usb 0000 00 10 4 2 XBUS 00 xPD 00 on Span 1 XBUS 00 xPD 10 on Span 2 XBUS 00 XPD 20 on Span 3 XBUS 00 XPD 30 on Span 4 Note that the utility produces output only when the device is initialized and the corre sponding drivers are loaded It lists all Astribank modules XPDs along with their registration status If the registration status 1s off then it means that the span has not been registered in Zaptel and therefore can not be used by Asterisk yet zt registration XBUS 00 usb 0000 00 10 4 2 XBUS 00 XPD 00 off XBUS 00 XPD 10 off XBUS 00 XPD 20 off XBUS 00 XPD 30 off The registration in Zaptel is usually performed as a part of etc init d zaptel start Troubleshooting 49 Xorcom 50
33. e ie LS 2 If the switches are covered with brown transparent adhesive tape remove it carefully 16 Astribank User Manual XORCOM WARNING Usea toothpick to move switches A screwdriver may break the switch Table 7 Correlation Between Ports and DIP Switches Note In the following two tables right means moving the DIP switch to the right as you face the front panel Table 8 Switch Description for TE Arrays J22 J29 On Right sets TE mode Switches in the corresponding NT array must be set accordingly see Off Left Table 9 Sets NT mode Configuring an Astribank BRI 17 Xorcom 18 Table 9 Switch Description for NT Arrays J13 J20 Sm Gem e Examples On Right Sets NT mode Switches in the corresponding TE array must be set accordingly see Off Left Sets TE mode Table 8 On Right Enables 100 Ohm line termina tion Off Left Disables 100 Ohm line termi nation This option 1s only applicable for ports configured to NT On Right mode Enables power feeding on the line If the port 1s configured as a TE connection set these Off Left switches to Off Disables power feeding on the This option is implemented in line boards starting from rev PB0260 see Astribank BRI Board Revisions on page 54 The following examples illustrate configuration of the DIP switch arrays Table 10 Examples of Configured DIP Switch Arrays Port 2 in TE mode with 100 Ohm Line
34. e possible statuses Note Ifyou are not sure about your wiring we suggest that you enable the 100 Ohm termination for all Astribank ports Configuring an Astribank BRI 19 Xorcom Astribank TE Port Connected to NT Device via Point to point Bus Point to Point Bus Astribank TE Port NT Device e NT device usually has the termination e Termination for the Astribank TE port must be enabled Astribank TE Port Connected to NT Device via Point to Multi point Bus Including Other TE Devices e e e mures Point to Multi point Bus Astribank TE Port TE Device NT Device In this example the Astribank is the outermost device connected to the bus e NT device usually has the termination e Termination for the Astribank TE port must be enabled TE n Device Astribank TE Port TE Device NT Device In this example the Astribank is connected to a middle point of the bus e NT device usually has the termination e Termination for the Astribank TE port should not be enabled e Termination for the outermost TE device TE n must be enabled Astribank Connected to TE ISDN Devices for example ISDN telephones via Point to Multi point Bus Astribank NT Port ISDN Telephone TE 2 Device TE n Device In this example the Astribank is connected to TE ISDN devices e Termination for the Astribank NT port must be enabled e Termination for the TE n device must be enabled 20 Astribank User Manual Xorcom Configuring a
35. ep 3 Asterisk and its Components Download compile and install the corresponding Asterisk and its components 1nstall sh If you want just to repeat the build process you should run compile sh instead Astribank User Manual ORCOM The following command config sh will write over your current Asterisk configuration The original configuration files in folder etc asterisk will be saved with extension old If you have not installed Asterisk and Zaptel on your computer then run config sh Step 4 Generate Asterisk Configuration optional Connect your Astribank device s to the computer Then we suggest using the utility named genzaptelconf It automatically detects the installed hardware and creates the files etc asterisk zapata channels conf and etc zaptel conf There you can find the detected Zaptel channels that you can use for extensions configuration genzaptelconf svdM Alternately you can include the automatically generated zapata channels conf to your zapata conf and after that configure the extensions conf accordingly echo include zapata channels conf gt gt etc asterisk zapata conf The following Is an example of etc asterisk extensions conf In this example the user must dial 9 and the call the destination number in order to make an outgoing call via a BRI TE port Calls incoming from the BRI TE port will be routed to Zap 1 channel phones zap 6001 will dial to channel 1 6020 to zaptel
36. equested by Xorcom Technical Support Output of the following commands provides information about the used software versions and status of the Astribank devices uname a cat proc cpuinfo modinfo zaptel modinfo xpp grep version grep Id usr share zaptel hex zaptel hardware v Iszaptel asterisk rx zap show channels asterisk rx core show version Troubleshooting 53 54 Xorcom Astribank BRI Board Revisions To check the Astribank BRI board revision open the device see Configuring Ports as NT or TE Connections on page 15 Then check the board Part Number that 1s printed either in the lower right corner or in the upper right corner of the board L a a a AT im nein m T me Em z 1 Brit s Aah ak D FER dun uw E ani it s is TIBERI Board revision PB0110 Astribank User Manual Xorcom Cables Pin Out RJ 45 8 Position RJ 45 8 Position 87654321 12345678 Modular Plug Modular Port RJ 45 Pin Auxiliary Input Port RJ 45 Pin BRITE Ports Not Connected Not Connected E E E 008 CE EE 5 Comes Na mesi RUP Functon Rimen feni 3 Ww e fue l i i Vi RJ 11 6 Position Plug RJ 11 6 Position Port Cables Pin Out 55
37. er the Astribank firmware was suc cessfully loaded For models that have a Red H W LED this indicator turns on or blinks if the Astribank is faulty No dial tone on FXS ports l Z oF Troubleshooting Check that the Astribank unit is on If not see above Make sure that the USB cable is connected Make sure that drivers are loaded You can use the zaptel hardware utility for this See step 2 of Check the Astribank Device Status on the USB Level on page 48 Make sure that Asterisk is running Check the Asterisk configuration You can use the Iszaptel utility for this See step 2 of Check the Astribank Device Status on the Zaptel Level on page 49 Test the unit with the Xorcom Rapid Live CD To do this continue with step 2 in the FXO line does not operate properly procedure below For further details see Live CD Quick Start at http www xorcom com downloads live cd quick start html 45 Xorcom FXO line does not operate properly l Complete steps 1 6 from No dial tone on FXS ports above 2 Connect Astribank with FXS and FXO unit to a PC that runs the Live CD or connect another Astribank that has FXS ports to the same PC 3 Run hardware detection 4 Connect one of the FXS ports to one of the FXO ports using a standard RJ 11 cable 5 Dial from one of the FXS ports to the FXS port that is connected to the FXO port The FXO s Green LED will blink and the FXO will take the call and
38. face of a digital 4 wire system to an analog 2 wire system Although Asterisk has an integral echo cancellation algorithm reducing the gener ated echo will enhance the quality of the call Connecting Analog Phones to the Astribank 39 Xorcom Country Specific Settings 40 Country Specific Setting for Zaptel Define parameter opermode lt country gt in the Zaptel default settings file etc default zaptel on Debian Ubuntu etc etc sysconfig zaptel on RedHat CentOS etc For example opermode AUSTRALIA will configure the FXO ports for Australian parameters Country Specific Setting for DAHDI Define parameter opermode lt country gt in the etc dahdi xpp conf file By default the Astribank FXO ports are configured for USA PSTN lines electrical parameters For example opermode AUSTRALIA will configure the FXO ports for Australian parameters Table 14 List of Supported Countries FCC AUSTRALIA BELGIUM CANADA COLOMBIA CZECH EGYPT FRANCE GUAM ICELAND IRELAND JAPAN KUWAIT LUXEMBOURG MALTA NETHERLANDS NORWAY Astribank User Manual Xorcom Table 14 List of Supported Countries PERU PHILIPPINES POLAND PORTUGAL ROMANIA RUSSIA SAUDIARABIA SLOVENIA SPAIN SYRIA UK SINGAPORE SLOVAKIA SOUTHAFRICA SOUTHKOREA TAIWAN THAILAND USA YEMEN SWEDEN SWITZERLAND Note The FCC setting is the same as USA TBR21 defines parameters for FXO port configuration needed to fulfill the European ET
39. g c Check your kernel version uname r grep smp Astribank User Manual Xorcom If the above command produces any output 1t means that you have a Symmet ric Multi Processing SMP kernel and you must run the command described in step d Otherwise you have to run the command described in step e d Install the SMP kernel development package yum install kernel smp devel uname r e Install the non SMP kernel development package yum install kernel devel uname r If the kernel version installed on your system is too old it is possible that the corresponding kernel development package doesn t exist in the CentOS4 repository In that case you will need to upgrade your kernel to a newer version In case of an SMP kernel run yum install kernel smp kernel smp devel In case of a regular kernel run yum install kernel kernel devel Reboot your computer once you have a new kernel installed At this point you have all prerequisites installed on your system and you can start the Zaptel building process Step 2 Build Zaptel For Zaptel 1 2 make make install specific to the Astribank make C xpp utils install make config For Zaptel 1 4 or later configure make make install make config Step 3 Build Asterisk The Asterisk building process is not covered here Refer to the Readme file in the Asterisk sources directory tree Step 4 Configure Asterisk We suggest using the utility named genzaptelconf It aut
40. gnal from Zaptel Channel ZAP_CHAN P Alternatively exten gt s n System run something No we did not forget the context astbank outputs The FXS auxiliary output ports may only accept calls from the PBX Therefore they don t need a context of their own But assigning them to a dedicated context makes zap show channels in the CLI provide more useful outputs though Run the following command to reload the configuration files asterisk rx reload Step 5 Checking the Installation 1 List you Zaptel hardware with the command zaptel hardware 2 Review the currently configured Zaptel channels by using command Iszaptel 3 Pickup a telephone connected to an FXS port and make sure that you hear the dial tone signal Dial 200 to hear your extension number Dial that number from a telephone connected to another FXS port Dial 203 for an echo test Dial 9 NUMBER to make outbound call through the first available FXO port E M a Installing Astribank Drivers on Linux Distributions 33 Xorcom Building Astribank BRI Drivers from Source 34 To use at least one Astribank BRI in your system complete the procedures described in this topic You will compile and install both the Astribank BRI and the Astribank FXS FXO PRI drivers Therefore you will not need to complete the topic Building Astribank FXS FXO PRI Drivers from Source on page 30 if you are going to use analog or PRI Astribank devices along with
41. hat are connected to C SYNC a the same Asterisk server For information about synchronization see Astribank Synchronization for Fax and Modem on page 43 Daw Indicates hardware failure Astribank User Manual Xorcom Analog Line Status LEDs The green LED on each RJ 11 port indicates analog line status Figure 11 LEDs on RJ 11 Analog Ports Table 3 Green Analog Line Status LEDs The port 1s active that 1s off hook Blinkin Ringing that is either ring generation for FXS ports or ring S detection for FXO ports LED Indicators 11 Xorcom ISDN BRI Unit LEDs This subsection describes the LEDs on an ISDN BRI Astribank unit Device Status LEDs Figure 12 shows the device status LEDs on Astribank ISDN models and combined ISDN and analog models P1 P2 P3 NT B TE NT B3 TE NT B5 TE p k i PHONE D sync O ACTIVE D on O Figure 12 Astribank ISDN Device Status LEDs Table 4 Astribank ISDN Device Status LEDs A yellow LED that lights up or blinks rapidly 1f the unit sup PHONE plies the correct telephony voltage needed for analog or ISDN phones It indicates normal hardware operation A green LED that blinks when the Astribank is synchronized with the host Asterisk computer and or the other Astribank SYNC units that are connected to the same Asterisk server For more information about synchronization see Astribank Synchroni zati
42. lity can be used for checking defining the Astribank device s syn chronization source fxpp sync auto host nn where auto automatically selects the best Astribank device to be the synchronization source host defines the device synchronization from the xpp driver timer nn XBUS number of the device to be used as the clock synchronization source For example in order to check the current synchronization source in the system Zxpp sync Current sync 02 Best Available Syncers XBUS 02 FXS 3 FXO Cusb 0000 00 1d 7 3 Astribank User Manual XORCOM XBUS 04 FXS 4 Cusb 0000 00 1d 7 1 XBUS 03 FXS 4 Cusb 0000 00 1d 7 2 XBUS 01 FXS 4 Cusb 0000 00 1d 7 4 XBUS 00 FXS 4 Cusb 0000 00 1d 7 5 XBUS 05 FXS 4 usb 0000 00 1d 7 6 DAHDI Notes The troubleshooting tips described above are relevant also for DAHDI The table below shows names of DAHDI utilities that correspond to the Zaptel utilities Table 16 DAHDI Utilities Show connected DAHDI devices dahdi hardware zaptel hardware Show list of DAHDI channels Isdahdi Handle registration of Astribank l l l Default location of Astribank firmware files and the usr share dahdi usr share zaptel xpp fxloader utility Asterisk CLI command to see sta iusta Ple DANDI channels dahdi show channels zap show channels Utility for DAHDI hardware detection and configuration build dahdi genconf genzaptelconf ing Information Usually R
43. n Astribank E1 T1 Each Astribank E1 T1 port may be configured to work as El or Tl TE or NT by changing the Astribank driver and Asterisk software parameters Configuring in the Zaptel Environment The following table shows where each Astribank ISDN E1 T1 port parameter is con figured Table 11 E1 T1 Port Parameter Configuration in a Zaptel Environment Port Parameter Configuration File Configuration Parameter E1 T1 selection Zaptel Init Configura ypp PRI SETUP tion File Clock source framing a Zaptel Init Configura XPP PRI SETUP tion File signalling found in the in b zapata conf zapata conf file For more information on these topics see the Asterisk documentation The Zaptel Init Configuration File 1s either e etc default zaptel on Debian Ubuntu etc e etc sysconfig zaptel on RedHat CentOS etc Function group NT or TE The information defined in this file is used by Zaptel and some Zaptel utilities For example utility genzaptelconf uses information from XPP PRI SETUP for auto matic Asterisk and Zaptel configuration building Also the Astribank PRI driver ini tializes the ports for El or T1 functionality according to the XPP PRI SETUP parameter If parameter XPP PRI SETUP is not defined then each PRI port is assumed to be of default type El TE CPE Format of the XPP PRI SETUP The format of the XPP PRI SETUP parameter is the following XPP PRI SETUP lt port address port type
44. n of our Web site www xorcom com for information about support for newer trixbox CE versions If you have Astribank FXS FXO PRI then you only need to install e the fxload package that is needed for uploading of Astribank firmware e the freepbx module zapauto package that may be used for automatic channels configuration Installing Astribank Drivers on Linux Distributions 235 Xorcom 26 However to install Astribank BRI you must also install BRIstuff and then recompile Asterisk Zaptel and libpri from the source Installing Astribank FXS FXO PRI on trixbox CE l Ensure that the Astribank devices are disconnected from the trixbox computer and turned off Connect to your trixbox CE with an SSH client and log in as user root and with the password defined during the trixbox CE installation Install the fx load package rpm Uvh http updates xorcom com astribank fxload fxload 2002 04 11 5xr i386 rpm Install the freepbx module zapauto rpm Uvh http updates xorcom com astribank elastix repo freepbx module zapauto lt version gt noarch rpm If Asterisk PRI port configuration is not the default EI TE then define the parameter XPP PRI SETUP in file etc sysconfig zaptel or etc default zaptel depending on your Linux distribution See Configuring an Astribank EI TI on page 21 Connect the Astribank devices to the trixbox computer Run the Zaptel automatic hardware detection procedure By default the auto matic Za
45. ng eee ee ecce eee eee ee ee eere eret eee eese soos nos 9 LED III ee 10 aloe Un b EDS spas ion tas dona E Spb a p Rub Mug tuni in Mc eRLIb dC ERES 10 Device Status LEDS ue ene on PR ol dea dise mtd as edet 10 Amalop Eine ids LEDS arm e e 11 ISDN BRI Unit EBDS 35 epit AS Mats a iu bed edidit 12 Device Status LEDS coc etn En cete unum 12 ISDN BRI Cine Stats EEDS zac t a aa Laisa OLA 13 ET LEDS assar tpe ends te adit ndi ads 14 DEVICE Status LEDS gorrei tine a ateeto piti iem aeter ater 14 ETIE StU LEDS cais etatis ttai cti Ea 14 Configuring an Astribank BRI eee e eee eee eee eene ee eee tette etes eee aas 15 Configuring Ports as NT or TE Connections cccccccccccceeeeeeeeeeeeeeeeeees 15 Examples oce utet fuus hen pedo RR O tussim idee PR 18 Connecting ISDN Telephone Sets sanidade E 19 BRI Lane TertomiattOTk oues ute to dI SU UU TS a ioe 19 Configuring an Astribank ET T1 eee eee e cec cce een 21 Configuring in the Zaptel Environment eseeeeeeeeeeee 21 Format ot tie XPP PRE SEV UP cen vien n ID iEn en 2 POr A dOS Sepp nt rr re ia 22 POG De asian ns Raia Cd ay a 22 Contibutadom B X AIM PICS eei ppc dad 22 Configuring in a DAHDI Environment esee 23 ET TI SeleeHODE itn tsi Mta aee riser nner ee o tue aeq 23 LED SSS CUO seen ad Uuudd 24 Installing A
46. nology These terms are used in the troubleshooting span Zaptel DAHDI breaks the channels it knows about to logical units called spans A port in a EI TI ISDN card 1s usually a span A whole analog card is also a span You can see the list of spans as the list of files under proc zaptel directory or in the output of the zttool utility XBUS Denotes an Astribank device XPD Basically this is a logical unit of an Astribank device It will be registered in Zaptel DAHDI as a single span This can be either an analog FXS or FXO module or a single port in case of a BRI or a PRI module Directory proc xpp After the main Astribank driver module xpp 1s loaded the directory proc xpp can be opened and reviewed For each Astribank device discovered there will be one or more folders proc xpp xBUs nn where nn is a number staring with 00 One XBUS folder is created for each Astribank unit Each XBUS nn folder contains one or more XPD mm sub folders One XPD sub folder 1s created for each 8 ports analog module one ISDN PRI or one ISDN BRI port For example in a case where there are two Astribank devices connected one with three modules and the second with two modules the proc xpp sub tree will looks like the following ls proc xpp XBUS XPD grep XBUS proc xpp XBUS 00 XPD 00 proc xpp XBUS 00 XPD 10 proc xpp XBUS 00 XPD 20 proc xpp XBUS 01 XPD 00 proc xpp XBUS 01 XPD 10 44 Astribank User Manual Xorcom
47. omatically detects the installed hardware and creates the files etc asterisk zapata channels conf and etc zaptel conf There you can find the detected Zaptel channels that you can use for extensions configuration genzaptelconf svdM Installing Astribank Drivers on Linux Distributions 31 Xorcom 32 Alternately you can include the automatically generated zapata channels conf to your zapata conf and after that configure the extensions conf accordingly echo Zinclude zapata channels conf gt gt etc asterisk zapata conf Following is an example of etc asterisk extensions conf In this example the user must dial 9 and the call the destination number in order to make an outgoing call via an FXO port Calls incoming from an FXO port will be routed to Zap 1 channel phones zap 6001 will dial to channel 1 6020 to zaptel channel 20 etc exten gt _6XXX 1 Dial ZAP EXTEN 1 Useful for trunks debugging will potentially allow users to bypass context limitations exten gt _6XxXX 1 Dial ZAP EXTEN 1 3 EXTEN 4 trunk A number that begins with 9 dial it through a trunk we put FXO channels and TE channels in group 0 The leading 9 is stripped exten gt _9 1 Dial Zap g0 EXTEN 1 dialing a number that begins with 81 will dial it through Span 1 etc The two leading digits are stripped Each digital span is also added to group 10 span number exten gt _8X 1 Dial Zap g1 E
48. omputer does not boot from the CD change the BIOS settings One of the BIOS options configures the computer to try booting first from the CD The Xorcom Rapid Live CD also detects and installs Digium and other Zaptel DAHDI devices To log in to the Asterisk s web interface from any other computer simply enter the Asterisk computer s IP address or name into your browser Then access the FreePBX setup screen and enter the default user name and password The default user name 1s admin and the default password 1s admin Use the console or remote terminal Ajax Term to access the root or the Xorcom Rapid menus The default user name is user and the default password 1s live To open the Xorcom Rapid menu type rapid menu To work as root after you have logged in type sudo i Connect analog telephones to FXS ports analog PSTN lines to FXO ports ISDN BRI PSTN lines to BRI TE green LED ports and ISDN BRI PBX lines to BRI NT yellow LED ports For ISDN BRI you can connect the TE ports to the NT ports using a regular LAN cable for a loop back test Read the Live CD documentation to perform effective tests to check your Astribank and to explore Asterisk WARNING The Live CD is for tests and demonstrations and should not be used as an operational PBX All configuration changes made on the system will be saved only in the RAM and will be erased upon reboot For an operational PBX please use an Asterisk installation version Xorcom
49. on for Fax and Modem on page 43 This is used only when the Astribank is equipped with analog ACTIVE modules It is a red LED that indicates that at least one Astrib ank analog port 1s active A green LED that indicates that the unit 1s powered by the ON external desktop power supply 12 Astribank User Manual Xorcom ISDN BRI Line Status LEDs ISDN BRI ports use 2 LEDs for each port Green LED and Yellow LED P1 P2 P3 NT BI TE NT H3 TE NT 85 TE f PHONE D sync O i ACTIVE O NT B2 Tt NT B4 TE NT B6 TE Figure 13 LEDs on ISDN BRI Ports Analog Modules Table 5 ISDN BRI Line Status LEDs Two fast green blinks Two fast yellow blink Indicates that ISDN TE layer 2 1s active and that there 1s some Layer 2 message exchange However it does not necessarily mean that the Layer 2 connection has been established One green blink Indicates that ISDN NT layer 2 is active and that there 1s some Layer 2 message exchange However it does not necessarily mean that the Layer 2 connection has been established One yellow blink LED Indicators 13 Xorcom E1 T1 Unit LEDs 14 This subsection describes the LEDs on an Astribank E1 T1 unit Device Status LEDs The Astribank E1 T1 unit has the same set of device status LEDs as the Astribank BRI unit These are illustrated in Figure 12 and Table 4 E1 T1 Line Status LEDs The Astribank E1 T1 module has two RJ 45 socke
50. onnector number gt xpd mm e pri protocol label lt Astribank label gt xpd mm where e mm is the XBUS number e the value for nn is the XPD number see Troubleshooting Terminology on page 44 You can get the USB connector number and the Astribank label from verbose output of the dahdi hardware utility when the DAHDI drivers are loaded dahdi hardware v usb 004 004 xpp usb e4e4 1152 Astribank multi FPGA firmware LABEL usb 0000108 CONNECTOR usb 0000 00 03 3 4 XBUS 00 XPD 00 E1 Span 1 DAHDI SYNC XBUS 00 XPD 01 E1 Span 2 XBUS 00 XPD 10 FXS Span 3 XBUS 00 XPD 20 FXS Span 4 usb 004 007 xpp usb e4e4 1152 Astribank multi FPGA firmware LABEL usb 0000150 CONNECTOR usb 0000 00 03 3 6 Configuring an Astribank E1 T1 23 Xorcom 24 XBUS 01 XPD 00 FXS Span 5 XBUS 01 XPD 10 FXO Span 6 Following are examples of possible pri protocol parameter values for an Astribank device that you could see in the dahdi hardware output described above Example 1 Define T1 port type for all connected Astribank devices pri protocol TI Example 2 Define the second port to be T1 by using XBUS and XPD numbers The first port will be configured as El by default pri protocol xbus 00 xpd 01 TI Example 3 Define the second port to be T1 by using USB connector number pri protocol connector usb 0000 00 03 3 4 xpd 01 T1 Example 4 Define the second port to be T1 by using Astribank label pri protocol label usb 0000108 xpd 01 T1
51. ot the Sync Master the blink and the pause are the same that 1s 500 milliseconds on and 500 milliseconds off When a device attempts to be a Sync Master but is not the unit with the highest pri ority for example an FXO Astribank in a system that has a BRI PSTN TE con nection as well the synchronization LED will blink two short blinks and then pause for 750 milliseconds This indicates a normal status that enables standard usage of the Astribank unit but excludes use of a fax or modem Therefore connect a fax or a modem to an Astribank unit with synchronization states A or B In Figure 18 the synchronization states are A Synchronized as Master B Synchronized but not as Master C Synchronized not as Master when unit 1s capable of serving as master do not connect fax or modem to this unit A HH NH HEN B HH OS NENNEN C HE HN EE E E 1 second Figure 18 Synchronization states If the SYNC LED does not blink the unit is not synchronized See Trouble shooting on page 44 Astribank Synchronization for Fax and Modem 43 Xorcom Troubleshooting Please send your suggestions and wish list to info xorcom com and we will be glad to contact you and discuss your needs For additional support and updated information visit our Web site As well you may contact our support department at support xorcom com To accelerate the process please complete the technical support form on our Web site Troubleshooting Termi
52. ptel configuration will assign consecutive extension numbers starting with 401 to each Zaptel extension it detects If those numbers are already in use by non Zaptel extensions auto configuration will fail to work properly You can define a new starting extension number in variable ZAP FIRST CHANNEL in the etc amportal conf file Either e run the var lib asterisk bin detect zap script or e configure freePBX to recognize the extensions available from your Astribank s as follows i On the trixbox Web interface click the link switch in the right upper corner This switches the application to System Administration mode ii Enter the user name and password The default user is maint and the default password is password ii Navigate to Asterisk gt FreePBX The FreePBX configurator 1s displayed iv Expand the Tools menu v Select the Module Admin entry The Module Administration page 1s displayed vi Enable at least the modules core and Zaptel configuration vii Click Process gt Confirm Astribank User Manual Xorcom viii If needed click Apply Configuration Changes This reloads the page ix Navigate to the Setup page x Choose Zaptel configuration and follow the instructions When finished all the FXS extensions will be configured with numbers starting from 401 xi Click Apply Configuration Changes To review the configuration of the extensions from the FreePBX navigation pane click Extensions
53. stribank Drivers on Linux Distributions 25 Installinp On IxDOX C E queens teste a ete qut eus ue sium tud un Ov R te ouis hi 25 Installing Astribank FXS FXO PRI on trixbox CE 26 Installing Astribank BRI on trixbox CE Version 2 6 X cccceecceeeeeeeees 27 Installing Astribank FXS FXO PRI on DRUID s sseeeeees 29 Installing Astribank FXS FXO PRI on Elastix esses 29 Installing Astribank FXS FXO BRI PRI on Debian Etch 29 Building Astribank FXS FXO PRI Drivers from Source 30 Building Astribank BRI Drivers from Source ccc ceseeeseeeeeeseeeeeeeeens 34 Updating Astribank Drivers uei ioo ae eo Coco otto eo Cose eta o Sae saa eeraa 38 Connecting Analog Phones to the Astribank ee eere eee eee een 39 Connecting Analog Lines to Astribank eeeeeee eee eee eee eee eee reete 39 Country Specie SEHI S a neetstebt e etat eR Reese io EU ERE ON ER o assa 40 FUG BOLIC araca mcus te int unte S ado bcne Uta ved dedi cue e IU notti 42 il Astribank User Manual Astribank Synchronization for Fax and Modem ccce 43 Eroubleshoo no cc 44 Troubleshooting Termtolo9y suriros aine an 44 General Trouble SHOOLIg 3 copied e E E dte beet ids 45 TroubleshoOUdle IPS usse ntu E LE a 48 Check the Astribank Device Status on the US
54. t6 xr2 8 Install the required packages prereq sh install Installing Astribank Drivers on Linux Distributions 27 Xorcom 28 10 11 12 Install the BRIstuff The procedure will include downloading compiling and installation of several components such as Asterisk Zaptel and libpri Please note that you will need to press the Enter key three times during the installation Jinstall sh Start Asterisk amportal start Connect the Astribank devices to the trixbox computer and switch them on Run the Zaptel automatic hardware detection procedure By default the auto matic Zaptel configuration will assign consecutive extension numbers starting with 401 to each Zaptel extension it detects If those numbers are already in use by non Zaptel extensions auto configuration will fail to work properly You can define a new starting extension number in variable ZAP FIRST CHANNEL in the etc amportal conf file Either e run the var lib asterisk bin detect zap script or configure freePBX to recognize the extensions available from your Astribank s as follows i On the trixbox web interface click the link switch in the right upper corner This switches the application to System Administration mode ii Enter the user name and password The default user is maint and the default password is password ii Navigate to Asterisk gt FreePBX The FreePBX configurator is displayed iv Expand the Tools menu v Select the
55. talling Astribank Drivers on Linux Distributions 37 Xorcom Updating Astribank Drivers Two pieces of software are used for Astribank Linux kernel modules drivers and the microcode firmware which can be uploaded The firmware 1s not reloaded automatically during a Zaptel DAHDI restart that usually takes place after Zaptel DAHDI upgrade As a result it 1s possible that the Astribank device will not be able to communicate with the host computer because the previous firmware version is still loaded in the device and it is not compatible with the newer drivers version To avoid this problem reset the connected Astribank devices after you have updated the Zaptel DAHDI drivers There are two ways to do this First Method to Reset Astribanks after Updating Zaptel DAHDI Drivers l Connectto the Asterisk server via SSH and login as user root 2 Stop Asterisk and Zaptel DAHDI 3 Switch off on the Astribank devices 4 Start Zaptel DAHDI and Asterisk Second Method to Reset Astribanks after Updating Zaptel DAHDI Drivers 1 Connect to the Asterisk server via SSH and login as user root 2 Stop Asterisk and Zaptel DAHDI 3 Reset the Astribank For Zaptel usr share zaptel xpp fxloader reset For Dahdi usr share dahdi xpp_fxloader reset 4 Wait until the new firmware will is loaded cat proc xpp XBUS 0 9 wa1tfor xpds 2 gt dev nul 5 Start Zaptel DAHDI and Asterisk 38 Astribank User Manual XORCOM Connecting
56. ted to an Astribank main board Sarg Thesm wr AL LI i y ftt di 7 Jie Jn 7 y Figure 1 The Main Board Analog Modules Following are pictures of the Astribank analog modules 8 ports FXS without Input and Output Ports U tepteittittittit a 13 Co Re See MS sas Ih 7 j ta EX 55 iit icu i is 5 Sa at aw Rel TA E FE pres I5 dA J ZEE F T ad RE a 5 3 VT R60 is x pa on c R62 a o iB Tn fe 5 r s J EET E t eae t 9 Pangggige Ci u12 Siz seve i cz z E i e ces d 11111111 39 eee U1 ttenni A13MTHIT R err RTOS L Sie laa 26 gt gt 33 14 4 ect 3 al 3 4 t tem M z we x o a i pm i A3 TTE NEN A Cad araras Rc p E aus E jv M ic hed sem oe LE Eus SEDA E SARERA E GZ0 040L20 NS 306 M co ASA XROCOM 03 wu Do pru o ay J m me N o O PN PB0020 H Ports FXS Module EN a e Figure 2 FXS Module without I O Ports System Overview PXORCOM 8 Port FXS with Input and Output Ports This module is always located on the far left in any Astribank that has FXS ports This module supports e 8 telephone sets 2 relay activated changeover dry contact output ports to activate auxiliary equipment like gates or electronic appliances 4 dry contact activated input ports to allow auxiliary equipment like fire or burglar alarms to start emergency calls
57. th protection devices See Power Supply and Grounding on page 9 To run fxotune 1 Ensure that a grounding tab is properly affixed See Power Supply and Grounding on page 9 2 Ensure that all the PSTN lines are connected to the FXO connectors Note If you switch connections you must rerun fxotune Stop Asterisk 4 From the Linux command line run fxotune 1 4 Note that the number 4 can be replaced with any number that stops the dial tone 5 Restart Asterisk 42 Astribank User Manual Xorcom Astribank Synchronization for Fax and Modem The Astribank 1s designed with a unique built in Phase Locked Loop PLL that syn chronizes it with the Asterisk server PCI telephony cards and other Astribank units Synchronization ensures PCM integrity which is essential in fax and modem calls Note PCM is the digitized voice data stream Xorcom drivers automatically determine per configuration which unit should be the Sync Master All other devices are synchronized to the Sync Master The synchroni zation algorithm chooses a Sync Master according to the following priority l PRI connection 2 BRI connection 3 Astribank that has at least one FXO module 4 Astribank FXS When the Astribank is synchronized the SYNC indicator LED blinks The Sync Master will blink briefly and then pause that 1s on for about 250 milliseconds and pause for about 750 milliseconds When an Astribank unit is synchronized but is n
58. ts for each port e The bottom socket provides typical TE CPE side wiring e Rx pins 1 2 e Tx pins 4 5 e The top socket provides typical NT Network side wiring e Rx pins 4 5 e Tx pins I 2 Both sockets are permanently active and can be used with any configuration parame ters The green led of the lower socket indicates the line status when the port is config ured as TE The yellow LED of the upper socket shows the line status when the port is configured as NT Table 6 ISDN E1 T1 Line Status LEDs Indicates that ISDN PRI R2 layer 2 is active and that there is some Layer 2 message exchange However it does not necessarily mean that the Layer 2 connection has been established One green blink Indicates that ISDN PRI R2 layer 2 is active and that there is some Layer 2 message exchange However it does not necessarily mean that the Layer 2 connection has been established One yellow blink Astribank User Manual Xorcom Configuring an Astribank BRI The Astribank BRI comes in 2 4 and 8 port configurations Each port can be config ured either as an NT connection or a TE connection Note NT Network settings are the PSTN telephony provider settings Use these settings to connect the Astribank to PBX or ISDN telephone sets TE Terminal equipment settings are the PBX or ISDN telephone settings This setting should be used to connect the Astribank to the PSTN In addition it is possible to enable an
Download Pdf Manuals
Related Search