Home

Dialogic® AG 2000C CompactPCI Media Board Installation and

1. TNV3 level keys J5 hb Telephony I O Els connects to rear panel I O H 110 connector connects to H 110 bus 2 a 2 Strawberry red key aS 38 o Status indicator ra 1 LEDs i m EE NNNEE NNN Brilliant blue key Hot y Swap LED I9 UM PCI bus connector EE L er TNV3 level keys communicates with host Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following illustration shows the rear I O transition board TNV3 level keys 7 35 J3 RJ 21 ale li 2 TNV3 level keys J Rear I O transition board Software components AG 2000C boards require the following software components e Natural Access development environment that provides services for call control voice store and forward switching and other functions e NMS OAM Operations Administration and Maintenance software and related utilities e Configuration files that describe how the board is set up and initialized e Runtime software that controls the AG 2000C board e One or more trunk control programs TCPs that enable applications to communicate with the telephone network using the signaling schemes protocols used on the trunk Dialogic Corporation
2. Software Natural Access for Windows UNIX or Red Hat Linux The AG 2000C board has indicators LEDs on the end bracket of the board as shown in Status indicator LEDs H 110 compliant interface e Flexible connectivity between line interfaces DSPs and H 110 bus e Switchable access to any of 4096 H 110 timeslots e H 110 clock master or clock slave software selectable e Compatible with any H 110 compliant telephony interface Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Host interface Feature Specification Electrical CompactPCI bus designed to CompactPCI PICMG specification revision 2 1 Mechanical Designed to the CompactPCI PICMG specification revision 2 1 for 6U style cards Bus speed 33 MHz 32 bit master or slave Memory 128 K on board interface memory Environment Feature Description Operating temperature 0 to 50 degrees C Storage temperature 20 to 70 degrees C Humidity 59 to 8096 non condensing Power requirements AG 2000C 24 12V 200 mA 12V 250 mA 5 V 1 5 A 400 MIPS 3 3V O0 5A 112 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Common electrical specifications United States version Specification Connectors Return loss ref 600 Ohms 2 2 uF standard 4 to 2 wire gain Tolerance 4 to 2 wire gain range 2 to 4 wire gain Tolerance 2 to 4 wire gain range Frequency
3. 28 Dialogic Corporation 5 Configuring the board Adding board configurations to the NMS OAM database Each board that NMS OAM configures and starts must have a separate set of configuration parameters Each parameter value is expressed as a keyword name and value pair for example AutoStart NO You can use NMS OAM to retrieve parameters for any component These parameters set through board keywords can be added modified or deleted Before using NMS OAM make sure that the Natural Access Server ctdaemon is running For more information about the Natural Access Server ctdaemon refer to the Natural Access Developer s Reference Manual The following utilities are shipped with NMS OAM Utility Description oamsys Configures and starts up boards on a system wide basis Attempts to start all specified boards based on system configuration files you supply 1 EE oamcfg Provides greater access to individual NMS OAM configuration functions I r oaminfo Displays keywords and settings for one or more components Can also set individual keywords Refer to the NMS OAM System User s Manual for more information about oamsys and oamcfg An application can control NMS OAM using OAM service functions For more information about the OAM service functions and about oaminfo refer to the NMS OAM Service Developer s Reference Manual Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual C
4. The following table describes the pinouts for the RJ 21 connector Trunk Ring pin Tip pin 1 2 10 11 12 1 2 10 11 12 26 27 28 29 30 31 32 33 34 35 36 37 Trunk Ring pin Tip pin 13 14 15 16 17 18 19 20 21 22 23 24 13 14 15 16 17 18 19 20 21 22 23 24 Note Pins 25 and 50 are not used Ferrite block 38 39 40 41 42 43 44 45 46 47 48 49 The AG 2000C board is shipped with a ferrite block P N 33210 Attach the ferrite block to the RJ 21 cable with one loop as shown in the following illustration The AG 2000C board passes FCC Part 15 Class A without this ferrite block Ferrite block Dialogic Corporation Ferrite block Loop wire once around the lower section of the ferrite block 27 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Developer s cable kit To help you get started NMS provides an optional developer s cable kit P N 80659 The kit contains two 10 foot RJ 21 cables and two breakout boxes Each breakout box connects one RJ 21 to 24 standard RJ 11 POTS jacks for individual phones You can use the cables to connect to the breakout boxes or to standard 66 or 110 blocks All components of the developer s cable kit sold by NMS are also commercially available from telephone product distributors such as Graybar and Anixter These distributors can provide variations in cable lengths
5. system configuration file 32 ctatest 45 47 D debugging information 69 default connections 51 demonstration programs 47 DLMFiles x 82 Driver BoardID 63 Driver Name 63 DSP processing power 119 126 DSP C5x Lib 83 DSP C5x Loader 84 DSP C5x x Files y 85 DSP C5x x Image 88 DSP C5x x Os 89 E echo cancellation 42 echo canceller reference stream keywords 90 91 Echo AutoSwitchingRefSource 90 Echo EnableExternalPins 90 Eeprom AssemblyRevision 62 Eeprom BoardSpecific 62 Eeprom BusClkDiv 62 Eeprom CheckSum 62 Eeprom CPUSpeed 62 Eeprom DRAMSize 62 Eeprom DSPSpeed 62 Eeprom Family 62 Eeprom MFGWeek 62 Eeprom MFGYear 62 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Eeprom MSBusType 62 Eeprom NumDSPCores 62 Eeprom SerialNum 62 Eeprom SoftwareCompatibility 62 Eeprom SRAMSize 62 Eeprom SubType 62 EMC 115 environment 112 F ferrite block 25 H H 110 streams 49 hardware specifications 111 board features 13 cable kit 27 electrical 113 environment 112 LEDs 43 Hot Swap 24 I incta 47 installing 23 AG driver software 19 connecting to the telephone network 25 summary 19 system requirements 20 verifying board installation 44 K keying 20 keywords 59 AG plug in 63 board information 82 92 93 97 99 101 105 board keyword files 30 board location 94 95 clocking 74 76 77 78 79 80 81 136 configuring debugging information 69 configuring DSPs 83 84 85 88 89 102
6. echo m54 where x the next available index 2 Set the appropriate ADI service parameters in your application and in your system Refer to the ADI Service Developer s Reference Manual for information about configuring echo cancellation on the AG 2000C board 42 Dialogic Corporation 6 Verifying the installation Status indicator LEDs The AG 2000C board has indicators LEDs on the end bracket of the board as shown in the following illustration CompactPCl O DIAG HBAT LBAT O Hot Swap LEDs on the end bracket The following table describes each of the LEDs LED Description DIAG The LED is on after the board is booted HBAT LED on verifies 48 V DC is available to the board from the external power supply for future use LED on verifies 30 V DC is available to the board from the external power supply for future use Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual LED Hot Swap Description Illuminates when it is safe to remove the AG 2000C board from the system The LED illuminates under one of the following conditions e If the board is fully inserted when the backplane is powered up the blue LED momentarily flashes This is a normal part of the initialization process e After opening the handles during the extraction process the LED illuminates to indicate that it is safe to remove the board Do not
7. 108 109 configuring memory 72 73 96 configuring switching 103 104 echo canceller reference stream 90 91 editable 61 informational 62 migration changes 132 plug in 63 QSLAC file 98 read write 61 read only 62 retrieving values 60 setting values 60 stopping or starting a board 66 67 L leo files 34 line gain configuration 54 LoadFile 92 LoadSize 93 local streams 49 Location PCI Bus 94 Location PCI Slot 95 Location Type 62 loop start 127 ctatest with a loop start board 46 receive signaling 129 recording and caller ID mode 114 transmit signaling 128 M managing resources 117 MaxChannels 96 memory keywords 72 73 96 migration 131 MIPS usage 119 126 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual N Name 97 Natural Access 16 NetworkInterface Analog x ConfigFile 98 NMS OAM 131 Number 99 0 OAM 131 oamcfg 29 oamgen 32 oamsys 30 32 33 outcta 47 P parameters 34 board keyword files 30 configuration file location 34 physical slot location 30 pinouts 25 plug in keywords 63 power requirements 112 Product 62 Products x 100 prt2prt 47 Q QSLAC files 35 114 R regulatory certification 115 RJ 21 connectors 25 RunFile 101 runtime software 18 S safety 115 sample configuration files 30 32 SignalIdleCode 102 signaling 127 loop start receive signaling 129 loop start transmit signaling 128 Dialogic Corporation signal
8. 15 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following illustration shows how these software components relate to one another Host Application ERES Natural Access NMS OAM Other ADI NCC OAM configuration services service service service database tea nee gt K x ADI commands and Natural Call Control board events commands and board events API commands and NMS OAM configuration board events commands information and board events AG board driver TCP Runtime Software components Natural Access Natural Access is a complete software development environment for voice applications It provides a standard set of functions grouped into logical services Each service has a standard programming interface For more information about standard and optional Natural Access services refer to the Natural Access Developer s Reference Manual NMS OAM NMS OAM manages and maintains telephony resources in a system These resources include hardware components including AG boards and low level board management software modules such as clock management Using NMS OAM you can e Create delete and query the configuration of a component e Start stop and test a component e Receive notifications from components 16 Dialogic Corporation Dialogic AG 2000C CompactPCI Media
9. Details The Supervisor keyword AutoStartEnabled enables or disables the autostart feature If AutoStartEnabled is set to YES the Supervisor starts each board whose AutoStart keyword is set to YES when ctdaemon is started If AutoStartEnabled is set to NO no boards are started automatically regardless of the setting of the AutoStart keyword For more information refer to the NMS OAM System User s Manual See also AutoStop 66 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual AutoStop Specifies whether the board automatically stops when ctdaemon is stopped Syntax AutoStop setting Access Read Write Type String Default NO Allowed values YES NO Example AutoStop NO Details The Supervisor keyword AutoStopEnabled enables or disables the autostop feature If AutoStopEnabled is set to YES the Supervisor stops each board whose AutoStop keyword is set to YES when ctdaemon is stopped If AutoStopEnabled is set to NO no boards are stopped automatically regardless of the setting of the AutoStop keyword For more information refer to the NMS OAM System User s Manual See also AutoStart Dialogic Corporation 67 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Boards x Specifies the name of the board object that is managed by the AG plug in Syntax Boards x boardname x the index of the Board array keyword Ac
10. Dialogic encourages all users of its products to procure all necessary intellectual property licenses required to implement any concepts or applications and does not condone or encourage any intellectual property infringement and disclaims any responsibility related thereto These intellectual property licenses may differ from country to country and it is the responsibility of those who develop the concepts or applications to be aware of and comply with different national license requirements Any use case s shown and or described herein represent one or more examples of the various ways scenarios or environments in which Dialogic products can be used Such use case s are non limiting and do not represent recommendations of Dialogic as to whether or how to use Dialogic products Dialogic Dialogic Pro Brooktrout Diva Cantata SnowShore Eicon Eicon Networks NMS Communications NMS stylized Eiconcard SIPcontrol Diva ISDN TruFax Exnet EXS SwitchKit N20 Making Innovation Thrive Connecting to Growth Video is the New Voice Fusion Vision PacketMedia NaturalAccess NaturalCallControl NaturalConference NaturalFax and Shiva among others as well as related logos are either registered trademarks or trademarks of Dialogic Corporation or its subsidiaries Dialogic s trademarks may be used publicly only with permission from Dialogic Such permission may only be granted by Dialogic s legal department at 9800 Cavendish Blvd 5th Floor Mont
11. PURPOSE MERCHANTABILITY OR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHT OF A THIRD PARTY Dialogic products are not intended for use in medical life saving life sustaining critical control or safety systems or in nuclear facility applications Due to differing national regulations and approval requirements certain Dialogic products may be suitable for use only in specific countries and thus may not function properly in other countries You are responsible for ensuring that your use of such products occurs only in the countries where such use is suitable For information on specific products contact Dialogic Corporation at the address indicated below or on the web at www dialogic com It is possible that the use or implementation of any one of the concepts applications or ideas described in this document in marketing collateral produced by or on web pages maintained by Dialogic may infringe one or more patents or other intellectual property rights owned by third parties Dialogic does not provide any intellectual property licenses with the sale of Dialogic products other than a license to use such product in accordance with intellectual property owned or validly licensed by Dialogic and no such licenses are provided except pursuant to a signed agreement with Dialogic More detailed information about such intellectual property is available from Dialogic s legal department at 9800 Cavendish Blvd 5th Floor Montreal Quebec Canada H4M 2V9
12. adapt values used for the echo canceller and MIPS consumption DSP file echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 122 Filter length ms Adapt time ms MIPS 2 2 100 200 400 800 100 200 2 75 2 38 2 25 2 13 3 13 2 63 Dialogic Corporation DSP file echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 Filter length ms Adapt time ms MIPS 4 0 0 0 ADI ADI Oo o A NIN eleme eB le eB ee Oo 0 00 0 OocOO o o N o 20 24 24 24 24 32 32 32 32 40 40 40 Dialogic Corporation 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 2 38 2 25 3 50 2 88 2 63 2 50 3 88 3 13 2 88 2 75 4 25 3 50 3 00 2 88 5 25 4 25 3 63 3 38 5 63 4 50 3 88 3 38 8 56 6 13 4 88 4 25 10 75 7 56 5 94 5 13 13 00 9 00 7 00 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual 123 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DSP file echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 e
13. annaia a aaa aa aa 50 Signaling modules and logical timeslots sees 51 Default connections iet ioter ye wae np eae o i er Re ae E Poux e XU ERR Y ERE I ts 51 Chapter 8 Configuration parameters ee eee esee eene nennen nnn 53 Using the Switching Service ier meten tnn a Een na E x e RR n d n oes x Ra a 53 Function informatioH o seeders naa su ti ree e Pai e Y eure DEREN Ra RR E Vie ra Cu ia 53 Line gain config rationz siete coeds ene ng ad etx ene ec a n S A a Cn 54 Getting the lire galri masaren niy nina exe ee rr er e a a Fe atn 54 Setting the lire gallico reset dexter bre rene mere xinh ra RR 3x Rua Ere DUX nr eb Fra Rd tees 56 Chapter 9 Keyword summary ee eeeese nennen enne enne hne anna nna u nana nana 59 Using Keywords ete rx irre pe de sie AER RRAPPPERUER REFER ME EREEMHERYAER rae 59 Setting Keyword Values 4 cera eye borne n t ex a d XA tenance mentees 60 Retrieving keyword values cce cece eee eee eee eee semen 60 Editable Keywords sitse nera ERR aere ERA E RARE UNMEK ERE TRO Ru RE REN FERRE E 61 Informational keywords c esses EE EE nnne nnn 62 Retrieving board information csssssssssssssssessessemme me eene 62 Retrieving EEPROM information cssssssssssessese memet 62 Retrieving board driver information sssssseessesssese meme 63 Plug iti keyWwOEdS sace tene rae bhIe REIP R ti er derat e na ERR DEA M dera
14. base address e aaaah option switch selected and aaaah coprocessor crashed after updating SRAM base address 2 Verifies the board type 2 1 3 Checks the DRAM size and BUSCLK 3 1 programmed in the EEPROM and sets up the part accordingly if valid EEPROM choice Tests DSP control and status registers Tests DRAM Tests DSPs Serial port test e Failed internal loopback test Wrote a 49h and received something else back 9 HMIC tests Refer to the following tables for an explanation of the error number e Failed I O test 9 5 1 e Failed register test 9 5 1 e Failed CAM test 9 5 2 e Failed local connections test 9 5 3 12 DSP HPI tests 12 4 70 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following information is reported back to the host when there is a diagnostic failure Additional data a EE 1 None EEPROM board type EEPROM DRAM size word written read masked by Oxfh address lo address hi written 7 5 DSPs booted Number test ID expected 8 2 written read 9 5 See the following table for more information 12 4 00 HPIA test DSP number Written 01 HPI memory test read memory failed Error WORD1 WORD2 WORD3 WORD4 code address Read WORD5 contents of failed address The following information is reported back to the host for error code 9 when there is a diagnostic failure 4 WDS HMI
15. fax or VoIP AG 2000C 16 16 Call control switching IVR and fax or conferencing AG 2000C 24 24 Call control and switching IVR is defined as play or record and DTMF detection e CompactPCI bus connectivity Each AG 2000C board is designed to reside in a single CompactPCI bus slot Each board contains a 5 volt CompactPCI bus interface compliant with the CompactPCI Specification PICMG 2 0 R2 1 The CompactPCI interface is a 33 MHz 32 bit target device e H 110 bus connectivity The AG 2000C board fully supports the H 110 bus specification The H 110 bus enables boards to share data and signaling information with other boards on the H 110 bus For example you can connect two or more AG 2000C boards for applications that perform trunk to trunk switching You can add additional DSP resources analog station interfaces or loop start line interfaces using other AG boards You can also use H 110 compatible products from other manufacturers with the AG 2000C board e Telephony bus switching Switching for the AG 2000C board is implemented with the T8100A chip The T8100A is a single chip that offers full support for the H 110 bus within the H 110 architecture providing access to all 4096 slots On the AG 2000C board switch connections are allowed for up to 128 full duplex connections between local devices and the H 110 bus Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Loop start line interface signali
16. for AG 2000C TCP files are shipped with the AG CAS sub package of Natural Access Be sure that you installed the protocols that are specified below before trying to start a board with this configuration file TCPFiles 0 nocc tcp Wr igo ErUNk ICON CrO MMP TrOCOCOI TCPFiles 1 lpos0 tep AG CAS Loopstart protocol The SLAC file controls the line impedance This is the SLAC file for U S installations NetworkInterface Analog 0 23 ConfigFile a2usals6 slc This configures the board as stand alone see documentation for options to use when the board needs to connect to the H 110 bus Clocking HBus ClockSource OSC Clocking HBus ClockMode STANDALONE DSP m54 files to link in DSP C5x 0 3 Files callp m54 dtmf m54 mf m54 ptf m54 signal m54 tone m54 voice m54 XLaw MU LAW Runtime loadable modules DLMFiles 0 gtp leo DLMFiles 1 voice leo DLMFiles 2 svc leo For general information about NMS OAM board keyword files refer to the NMS OAM System User s Manual Dialogic Corporation 31 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Creating a system configuration file for oamsys When your board keyword files are complete create a system configuration file describing all of the boards in your system oamsys creates the records and then directs NMS OAM to start the boards configured as specified The system configuration file is typically named oamsy
17. number must be unique Values returned by pciscan Values returned by pciscan For information about creating a custom board keyword file refer to Changing configuration parameter settings on page 34 You can specify more than one file after the File keyword File mya cfg myb cfg myc cfg Alternatively you can specify the File keyword more than once File mya cfg File myb cfg File mere Board keyword files are applied in the order in which they are listed The value for a given keyword in each file overrides any value specified for the keyword in earlier files Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Sample system configuration file The following system configuration file describes two AG 2000C boards both to be configured for the United States First AG 2000C Product AG 2000C Number 0 Bus 0 Slot 15 File agpi2000c cfg Second AG 2000C Product AG 2000C Number 1 Bus 0 Slot 16 File agpi2000c cfg Running oamsys To run oamsys enter the following command oamsys f filename where filename is the name of an NMS OAM system configuration file Note If you invoke oamsys without command line options NMS OAM searches for a file named oamsys cfg in the paths specified in the AGLOAD environment variable When you invoke oamsys with a valid file name oamsys performs the following tasks e Checks the syntax
18. response 300 Hz 3200 Hz Reference to 1 kHz Trans hybrid loss Signal overload level CMRR T R input impedance 300 3200 Hz Idle channel noise through connection Crosstalk transmit to receive channels T R isolation to SELV Off hook detect Operating loop current Loop current and polarity detect Ring detection Dialogic Corporation Description RJ 21x 20 dB min ERL 1 dB 6 to 6 dB 1 dB 6 to 6 dB 1 dB 17 dB min 300 Hz 3 0 KHz into 600 Ohms 2 2 uF 3 dBm at 0 dB gain gt 80 dB Voice band 600 Ohms 2 2 uF standard lt 20 dB rnC lt 70 dB 1 kHz gt 1500Vkrms Guaranteed Detect Current gt 10 mA Guaranteed No Detect Current lt 3 3 mA 18 mA to 70 mA Single bit indicates if the current is flowing from Tip to Ring or Ring to Tip Guaranteed Detect 30 VRMS 17 33 Hz US version Guaranteed No Detect No detect lt 15 VRMS 0 5 kHz 113 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual High impedance recording and caller ID mode The loop start interface can be used in applications to record live telephone calls such as emergency calls or financial transactions Special regulations require that parties be notified that they are being recorded Check with authorities in the locality where the application is to be installed to determine what is permitted in that area The system cannot generate tones in this mode The notifica
19. runs on a DSP consumes MIPS If the total MIPS consumption for all the requested functions on all the ports of a given board exceeds the total MIPS available for that board an error event occurs If MIPS intensive functions are required you can reduce the total number of ports on a board which makes more MIPS per port available The following table shows the MIPS usage for all the available functions shipped with Natural Access DSP file adsir m54 adsix m54 callp m54 dtmf m54 dtmf m54 dtmf m54 gsm ms m54 gsm ms m54 gsm mspl m54 gsm mspl m54 ima m54 ima m54 ima m54 ima m54 Function ADSI receiver ADSI transmitter Call progress DTMF only Post and pre tone silence DTMF post and pre tone silence MS GSM Play 8 kHz MS GSM Record 8 kHz MS GSM Play limit 8 kHz MS GSM Record 8 kHz IMA DVI ADPCM Play 6 kHz IMA DVI ADPCM Play 8 kHz IMA DVI ADPCM Record 6 kHz IMA DVI ADPCM Record 8 kHz Dialogic Corporation MIPS Related API function 3 13 1 13 1 06 1 94 0 69 1 94 4 44 2 82 4 44 2 06 1 81 2 00 Related arguments adiStartReceivingFSK adiStartSendingFSK adiStartCallProgress adiStartDTMFDetector adiStartEnergyDetector adiStartProtocol adiStartPlaying encoding ADI_ENCODE_GSM adiStartRecording encoding ADI_ENCODE_GSM adiStartPlaying encoding ADI_ENCODE_GSM adiStartRecording encoding ADI_ENCODE_GSM ad
20. specific board Operating Procedure system Windows Use pciscan to associate the PCI bus assignment to a physical board by flashing an LED on the board To flash the LED on a board call pciscan with the PCI bus and PCI slot locations UNIX Use blocate to associate the PCI bus assignment to a physical board by flashing an LED on the board To flash the LED on a board call blocate with the PCI bus and PCI slot locations For information about pciscan and blocate refer to the NMS OAM System User s Manual Using board keyword files A board keyword file contains a list of parameters and values to configure a board The board keyword file for each board is assigned to the board in another file called a system configuration file When oamsys runs it creates a record for each board in the NMS OAM database and stores the parameters and values of the board It then starts the board configured as described in the database A sample set of board keyword files are installed by the Natural Access installation You can copy these files and modify them The sample board keyword files are located in the ag cfg subdirectory under the Natural Access installation directory 30 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following sample board keyword file agpi2000c cfg shows the set of board keywords necessary to configure and start an AG 2000C board AG Plug in Config File
21. the ADI Service Developer s Reference Manual Trunk control programs TCPs AG 2000C boards are compatible with a variety of signaling schemes called protocols To program an AG board for a specific protocol a trunk control program TCP is loaded on the board The TCP performs all of the signaling tasks to interface with the protocol used on the line Several different protocol standards are used throughout the world These standards differ considerably from country to country For these reasons different TCPs are supplied with Natural Access for various protocols and country specific variations You can load more than one TCP at a time for applications that support multiple protocols simultaneously TCPs are specified in the configuration file and are downloaded to the board by oamsys TCPs run on the board relieving the host computer from the task of processing the protocol directly For more information about TCPs refer to the NMS CAS for Natural Call Control Developer s Manual 18 Dialogic Corporation Installing the hardware Installation summary The following table summarizes the procedure for installing the hardware and software components Step Description 1 Ensure that your PC system meets the system requirements on page 20 2 Install the board into one of the computer s CompactPCI bus slots 3 Install Natural Access which also installs the AG 2000C board driver and runtime software and NMS CAS protoco
22. the echo canceller reference It enables cancellation of echoes that occur on line 0 from energy originating on line 1 90 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Echo EnableExternalPins Determines if the echo canceller reference and output can be switched Syntax Echo EnableExternalPins setting Access Read Write Type String Default NO Allowed values NO YES Example Echo EnableExternalPins NO Details Setting this keyword to YES enables the echo canceller reference input and the echo canceller output to be switched They appear on output stream 34 and reference stream 35 See also Echo AutoSwitchingRefSource Dialogic Corporation 91 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual LoadFile Specifies the boot loader for the board Syntax LoadFile filename Access Read Write Type File name Default ag2000 lod Allowed values A valid file name Example Windows LoadFile c nms ag load ag2000 lod UNIX LoadFile opt nms ag load ag2000 lod See also LoadSize 92 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual LoadSize Indicates the coprocessor software download specified in the system configuration file Syntax LoadSize size Access Read Write AG plug in level Type Integer Default 0x7500 Allowe
23. violate local telecommunications regulations The following table describes the two signaling directions The transmit signal is used to control the line or phone Signaling Description type T Transmit The signaling that the board sends out onto the phone line through the line interface H L mn EE Receive This signaling comes from the phone line through the line interface to the board An application can monitor this signal to detect loop current or ringing The line interfaces on the board convert the signaling into the line condition appropriate for the loop start line They also convert incoming information into digital signals recognizable by AG 2000C based applications Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Loop start transmit signaling With loop start interfaces the transmitted signaling A bit in the signaling timeslot causes the interface to seize the line go off hook or release the line go on hook If the A bit is set to 1 the line goes off hook If the A bit is set to O the line goes on hook Bits B C and D are reserved and should be set to O The following illustration shows transmit signaling for loop start line interfaces A B CD eee Reserved set to 0 Reserved Line state IB EAE Loop start transmit signaling This table summarizes the transmit signaling for loop start line interfaces Bit He
24. 000C boards your system must have e Natural Access installed e A CompactPCI chassis with an H 110 compliant backplane and an available CompactPCI bus slot Note The AG 2000C board can power up and function only in a chassis with a telephony backplane e A grounded chassis with a three prong power cord NMS recommends an uninterruptable power supply UPS for increased system reliability The UPS does not need to power the PC video monitor except in areas prone to severe lightning storms Keying the chassis An AG 2000C has several mechanical interlocks called keys that prevent the board from being inserted in an incompatible chassis Keying protects the board and other devices in the chassis from damage by ensuring that you will not accidentally insert an incompatible board in the chassis Before you install AG 2000C boards configure the keying of your chassis to be compatible with the AG 2000C keying For detailed information on CompactPCI chassis keying refer to the CompactPCI Computer Telephony Specification PICMG 2 5 R1 0 to Keying of CompactPCI Boards and Backplanes PICMG 2 10 R1 0 and to the JEEE 1101 10 Warning To protect yourself and your equipment use only qualified personnel to install keying The personnel must be familiar with the CompactPCI Computer Telephony Specification PICMG 2 5 R1 0 document Note An AG 2000C board does not function in a chassis that does not have a telephony backplane
25. 13 0 63 5 63 5 81 Related API function adiStartPlaying adiStartRecording adiStartRecording adiStartRecording adiStartPlaying adiStartPlaying adiStartPlaying adiCommandRecord adiStartRecording adiCommandRecord adiStartRecording adiCommandRecord adiStartRecording adiStartDial adiStartPulse nccPlaceCall adiStartProtocol adiStartSignalDetector adiStartDial adiStartDTMF adiStartTones adiStartPlaying adiStartPlaying adiStartPlaying adiStartPlaying adiStartPlaying adiStartPlaying Related arguments encoding ADI_ENCODE_PCM8M16 encoding ADI_ENCODE_MULAW encoding ADI_ENCODE_ALAW encoding ADI_ENCODE_PCM8M16 encoding ADI_ENCODE_MULAW encoding ADI_ENCODE_ALAW encoding ADI_ENCODE_PCM8M16 encoding ADI_ENCODE_MULAW encoding ADI_ENCODE_ALAW encoding ADI_ENCODE_PCM8M16 encoding ADI ENCODE NMS 16 maxspeed 100 encoding ADI ENCODE NMS 24 maxspeed 100 encoding ADI ENCODE NMS 32 maxspeed 100 encoding ADI_ENCODE_NMS_64 maxspeed 100 encoding ADI ENCODE NMS 16 maxspeed 150 encoding ADI_ENCODE_NMS_24 maxspeed 150 121 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DSP file voice m54 voice m54 voice m54 voice m54 voice m54 voice m54 voice m54 voice m54 voice m54 voice m54 wave m54 wave m54 wa
26. 20 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following illustration shows how the AG 2000C board keys are configured TNV3 level keys 5 Keyed as shown below Rl Chamber C B A Oma ND Position 2 1 1 lo J4 Contains a female strawberry red key as shown below This setting is compatible El only with CompactPCI chassis with telephony 567 backplanes Ti Ji Contains a female brilliant blue key as shown below This setting is compatible PE only with CompactPCI chassis with 5 0V signaling y TNV3 level keys Keyed as shown below Chamber F E Position 1 1 AG 2000C key configuration Dialogic Corporation 21 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following illustration shows the keying chambers in a CompactPCI chassis that you must configure or verify for an AG 2000C board You must also key rear panel keying chambers A through F that are not shown Backplane connector strawberry red keys P4 Front panel keying HPE SW chambers A B and C iain ae Za 25 BE B ig 4 B a E Hh p E Backplane connector Pobrilliant blue key
27. 24 9 24 25 25 L 26 9 26 I 27 3 27 4 28 gt 28 29 39 29 I 30 30 31i 9 31 0 1 2 Local bus 3 4 ee M 6 3 2 L Signaling H bsp f Signaling Voice reso rc s 4 Voice Signaling Analog Signaling line 4 TE Voice interfaces orce Local devices AG 2000C switch model Lucent T8100A switch blocking Switching on the AG 2000C board is implemented by the Lucent T8100A chip HMIC The Lucent T8100A chip can perform local bus to local bus switching in full non blocking fashion The number of H 110 connections is limited to a maximum of 128 full duplex or 256 simplex or half duplex connections in any combination from either e H 110 bus to the local bus or e H 110 bus to H 110 bus There are no restrictions on local switching Any local device can be connected to any other local device 50 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Signaling modules and logical timeslots On AG 2000C boards each signaling module is hardwired to a specific logical timeslot on the local bus Each signaling module supports four ports of telephone network connectivity and is permanently connected to four pairs in the RJ 21 connector Each pair is therefore bound to a corresponding timeslot on the local bus The following illustration shows the relationship between signaling modu
28. 40 40 48 48 48 48 64 64 64 64 Dialogic Corporation 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 6 938 6 188 5 813 5 625 10 375 7 938 6 750 6 125 12 625 9 375 7 813 7 000 14 813 10 875 8 875 7 875 17 063 12 313 9 938 8 750 21 500 15 188 12 000 10 438 125 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual AG 2000C board processing In most applications all DSP functions can run on all DSPs on the board Complex functions such as WAVE speech echo cancellation and variable speech rates can result in reduced number of ports Use the following table as a guideline for determining board functionality There are additional constraints such as memory and queue sizes in determining required MIPS AG board Total MIPS per Operating system overhead per DSP Available DSPs DSP MIPS MIPS AG 4 100 10 360 2000C 400 AG 2000C boards can run six ports of 16 bit 11 kHz PCM ADI ENCODE PCM11M16 per available DSP 126 Dialogic Corporation 1 3 Loop start signaling Signaling overview This section describes how to interpret signaling to and from the AG 2000C loop start board The telephony protocol embodied by a TCP running on the AG 2000C board automatically controls and monitors the line signaling bits This information is provided for reference only Controlling the signaling bits manually may
29. 5 0 23 local 4 0 23 2 local 1 0 23 local 2 0 23 2 local 7 0 23 local 6 0 23 2 local 3 0 23 You can control switching using the Natural Access Switching service Refer to the Switching Service Developer s Reference Manual for more information 52 Dialogic Corporation Configuration parameters Using the Switching service Local device configuration on the AG 2000C board is controlled by the Switching service The Switching service provides functions for accessing device configuration parameters defined by the underlying hardware and device driver swiConfigLocalTimeslot and swiGetLocalTimeslotInfo enable applications to configure a device on a given local stream and timeslot by specifying a particular parameter and providing a data structure specific to that parameter The prototypes for these functions are repeated here for convenience For more information about the Switching service refer to the Switching Service Developer s Reference Manual Function information The syntax of swiConfigLocalTimeslot and swiGetLocalTimeslotInfo is Prototype DWORD swiConfigLocalTimeslot SWIHD swihd SWI LOCALTIMESLOT ARGS args void buffer unsigned size DWORD swiGetLocalTimeslotInfo SWIHD swihd SWI LOCALTIMESLOT ARGS args void buffer unsigned size Argument Description swihd Switch handle returned by swiOpenSwitch args Pointer to a SWI LOCALTIMESLOT ARGS structure This structure indicates th
30. Board Installation and Developer s Manual NMS OAM maintains a database containing records of configuration information for each component as shown in the following illustration This information consists of parameters and values Configuration database NMS OAM Board plug in NMS OAM components Software components Each parameter and value is expressed as a keyword name and value pair for example AutoStart NO You can query the NMS OAM database for keyword values for any component Keywords and values can be added modified or deleted To use NMS OAM or any related utility ensure that the Natural Access Server ctdaemon is running For more information about ctdaemon refer to the Natural Access Developer s Reference Manual For more information about NMS OAM refer to the NMS OAM System User s Manual AG board plug in NMS OAM uses the AG board plug in software module to communicate with AG boards The name of the AG plug in is agp ugin bpi This file must reside in the nms bin directory or opt nms lib for UNIX for NMS OAM to load it when it starts up Configuration files NMS OAM uses two types of configuration files File type Description System Contains a list of boards in the system and the name of one or more board configuration keyword files for each board Board keyword Contains parameters to configure the board These settings are expressed as keyword n
31. CID Error number Address 5 0 1 5aa5 5 0 1 Register number 5 0 2 CAM address 5 0 3 Local connections address Dialogic Corporation Write Write Write Write Write Read Read Read Read Read 71 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Buffers x Num Specifies the number of buffers available for play and record Buffers 2 Num is required for NMS Fusion systems Syntax Buffers x Num buffercount x 0 2 Access Read Write Type Integer Default Index O large Index 1 medium Index 2 small 48 0 96 Allowed values Based on the available board memory Details By default two buffers are allocated per channel For simultaneous play and record you must configure four buffers per channel Example Buffers 0 Num 16 See also Buffers x Size MaxChannels 72 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Buffers x Size Specifies the size in bytes of buffers used for play and record Syntax Buffers x Size size Access Read Write Type Integer Default Index Default value 0 16400 1 1024 2 92 Allowed values O 1000000 Example Buffers 0 Size 16400 Details The default buffer size is 16400 Buffers 1 Size affects ISDN and some NMS Fusion systems The default is 1024 Small buffers index 2 cannot be configured See also Buffers x Num Dialogic Corporat
32. ClockRef setting in the ag cfg file If the ClockRef setting was H100 or MVIP set to SLAVE If the ClockRef setting was not H100 or MVIP set to MASTER_A There is no migration for the MASTER_B option If IdleCode number use this number for both SignalIdleCode and for VoiceIdleCode If IdleCode is equal to two numbers use the first number for VoiceIdleCode and use the second number for SignalIdleCode If IdleCode string set Xlaw as follows AG NMS OAM Mu LAW MU LAW A LAW A LAW x 1 x 1 x the analog port number supplied with the Qslac keyword or 0 23 if no port number was specified X DLM file number x 2 x TCP number 133 Index A AG board plug in 17 AG driver software 19 AutoStart 66 AutoStop 67 B board information keywords 82 92 93 97 99 101 105 board location keywords 94 95 board physical slot location 30 boardinf 44 Boards x 68 BootDiagnosticLevel 69 Buffers x Num 72 Buffers x Size 73 C clocking 36 Clocking HBus AutoFallBack 74 Clocking HBus ClockMode 76 Clocking HBus ClockSource 77 Clocking HBus FallBackClockSource 78 Clocking HBus NetRefSource 79 Clocking HBus NetRefSpeed 80 Clocking HBus Segment 81 compliance 115 configuring 30 leo files 34 adding configurations 29 board clocking 36 board keyword files 30 boardinf 44 configuration file location 34 default connections 51 echo cancellation 42 line gain 54 local devices 53 parameter settings 34
33. Dialogic Making Innovation Thrive Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual October 2009 64 0489 01 www dialogic com Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Copyright and legal notices Copyright 2001 2009 Dialogic Corporation All Rights Reserved You may not reproduce this document in whole or in part without permission in writing from Dialogic Corporation at the address provided below All contents of this document are furnished for informational use only and are subject to change without notice and do not represent a commitment on the part of Dialogic Corporation or its subsidiaries Dialogic Reasonable effort is made to ensure the accuracy of the information contained in the document However Dialogic does not warrant the accuracy of this information and cannot accept responsibility for errors inaccuracies or omissions that may be contained in this document INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH DIALOGIC PRODUCTS NO LICENSE EXPRESS OR IMPLIED BY ESTOPPEL OR OTHERWISE TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT EXCEPT AS PROVIDED IN A SIGNED AGREEMENT BETWEEN YOU AND DIALOGIC DIALOGIC ASSUMES NO LIABILITY WHATSOEVER AND DIALOGIC DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY RELATING TO SALE AND OR USE OF DIALOGIC PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR
34. Info to query the input or output line gain Set the arguments for this function as follows Argument Field Value swihd Handle returned by swiOpenSwitch args localstream 0 or 1 Refer to the AG 2000C switch model on page 49 localtimeslot 0 23 Refer to the AG 2000C switch model on page 49 deviceid MVIP95 ANALOG LINE DEVICE parameterid MVIP95 INPUT GAIN or MVIP95 OUTPUT GAIN buffer Points to the NMS LINE GAIN PARMS structure size Size of buffer in bytes The NMS LINE GAIN PARMS structure is typedef struct INT32 gain NMS LINE GAIN PARMS The value returned in the gain component of NMS LINE GAIN PARMS represents the gain in dB multiplied by 1000 For example if the input gain on a particular network timeslot is currently set to 3 dB after calling swiGetLocalTimeslotInfo for parameter MVIP95 INPUT GAIN the gain field is 3000 54 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following sample code shows how to retrieve line gain applied to a signal received from the network include swidef h CT Access Switching service 57 include mvip95 h MVIP 95 definitions rA include nmshw h NMS hardware specific definitions a DWORD myGetReceiveGain SWIHD swihd SWI TERMINUS terminus INT32 gain dB SWI_LOCALTIMESLOT_ARGS args NMS_LINE_GAIN_PARMS device DWORD mou args localstream terminus stream args localtimeslot terminus
35. Integer Default If Xlaw If Xlaw A LAW default Oxd5 Allowed values 0x00 OxFF Example VoiceIdleCode 0xd5 Details MU LAW default Ox7f In general a DSP is considered to be idle when no application is using it On digital trunks the idle code is determined by local regulations and should not be altered See also SignalIdleCode 108 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Xlaw Defines the switch idle codes Syntax Xlaw compandmode Access Read Write Type String Default MU LAW Allowed values A LAW MU LAW Example XLaw MU LAW See also DSP C5x x Files y SignalIdleCode VoiceIdleCode Dialogic Corporation 109 1 1 Hardware specifications General hardware specifications This topic describes e Mechanical specifications e H 110 compliant interface e Host interface e Environment e Power requirements Mechanical specifications The AG 2000C board has e 64K x 16 of SRAM e A T8100A which provides CT bus switching e 4MB of DRAM e 100 MIPS C549 parts e NS486SXL 25 TDM bus Features one complete H 110 bus interface _DSP processing power Four Texas Instruments TMS320VC549GGU 100 DSPs at 100 MIPS Microprocessor One 25 MHz 80486 compatible embedded processor Board weight Main board 80 Ib 36 kg Daughterboard 05 Ib 02 kg Rear transition board 35 Ib 16 kg
36. MASTER B SLAVE STANDALONE Example Clocking HBus ClockMode MASTER A Details Valid entries for the keyword include Value Description MASTER A The board is used to drive the CT bus A clock based on the timing information derived from a clocking source MASTER B The board is used to drive the CT bus B clock based on the timing information derived from a clocking source SLAVE The board acts as a clock slave deriving its timing from the primary bus master Note Connections are allowed to the board s CT bus timeslots STANDALONE The board references its timing signal from its own oscillator and does not drive any CT bus timing signal clocks Note Connections are not allowed to the board s CT bus timeslots in standalone mode For more information refer to Default connections on page 51 See also Clocking HBus AutoFallBack Clocking HBus ClockSource 76 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Clocking HBus ClockSource Specifies the clock reference origin For information about setting up CT bus clocking and rules and restrictions for configuring CT bus clocking refer to Configuring board clocking on page 36 Syntax Clocking HBus ClockSource clock source Access Read Write Type String Default OSC Allowed values OSC A CLOCK B CLOCK Example Clocking HBus ClockSource OSC Details Valid entries for the keyword include Value Desc
37. N API Dialogic NaturalAccess ISDN Messaging API Dialogic NaturalAccess ISDN API Supplementary Services Dialogic NaturalAccess ISDN Management API Dialogic NaturalAccess NaturalConference API Dialogic NaturalAccess NaturalFax API Dialogic NaturalAccess Universal Speech Access API Dialogic NaturalAccess SIP API Dialogic MD1 RJ 45 interface Dialogic MD1 RJ 21 interface Dialogic MD1 Mini RJ 21 interface Dialogic MD1 Mini RJ 21 to MD1 RJ 21 cable Dialogic MD1 RJ 45 to two 75 ohm BNC splitter cable Dialogic Signal Entry Panel Dialogic Corporation 3 Overview of the AG 2000C board AG 2000C board features The AG 2000C board is part of the Alliance Generation family of telephony boards It provides 8 16 or 24 analog loop start interfaces with call control and switching in a single CompactPCI slot Refer to the NMS web site www nmscommunications com for a list of available AG 2000C board configurations for a list of countries where NMS has obtained approval for the AG 2000C board and for product updates An AG 2000C board contains the following main features e DSP resources Each board has four high performance digital signal processors DSPs The following table provides information about the different AG 2000C models Model Ports Capabilities AG 2000C 8 8 Eight universal ports Call control IVR fax and VoIP Note Conferencing can be substituted for
38. NDALONE then default local connections between the DSP resources and the line interfaces are nailed up as described in Default connections on page 51 To experiment with output and input functions simultaneously execute two instances of ctatest Use the swish MakeConnection command to make quad connections between two ports one bound to each ctatest instance Refer to the Switching Service Developer s Reference Manual for information about swish For example to interactively experiment with tone generation and detection start a tone detector in the first ctatest instance and a tone generator in the second ctatest instance Using swish for a standalone board No default connections are made for a standalone board if CT bus connectivity is enabled in the board keyword file Use swish to connect the local network interface to the local DSP resource You can use swish interactively or create a script in a flat text file The following example of swish commands nails up the voice and signaling streams for all 24 line interfaces of an AG 2000C board that has been configured as board 0 openswitch ag2000C agsw 0 resetswitch ag2000C make voice and signaling connections makeconnection ag2000C 10cal 0 0 23 to 10cal 5 0 23 QUAD closeswitch ag2000C exit Dialogic Corporation 45 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Using ctatest with an AG 2000C loop start board Connect a loop s
39. NMS boards refer to the ADI Service Developer s Reference Manual For more information about loading and running TCP files refer to the NMS CAS for Natural Call Control Developer s Manual or to the NMS ISDN for Natural Call Control Developer s Manual Note The TCPFiles x keyword is required for configurations that run CAS signaling protocols Dialogic Corporation 105 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Version Major Specifies the major version number of the AG plug in The Version Major number is incremented if a change is made to the plug in Syntax Version Major number Access Read only AG plug in level Type Integer Allowed values Not applicable See also Version Minor 106 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Version Minor Specifies the minor version number of the AG plug in The Version Minor value is changed when a change is made to the AG plug in Syntax Version Minor number Access Read only AG plug in level Type Integer Allowed values Not applicable See also Version Major Dialogic Corporation 107 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual VoiceldleCode Sets the voice bit pattern transmitted by an idle DSP or to an unconnected line interface Syntax VoiceIdleCode voice idlecode Access Read Write Type
40. R 20 Installing the board sssssssssssssse mmn heme messen senes 23 Using the Hot Swap features iex hr exe exa Y er exu n Rh Dex ra s 24 Connecting to the telephone network ssssesssssssssssenm emnes 25 Ferrite DIOGK uu i rore RE terno xo ERE AERRAANERUERERRVESERNEEERXSEE RR ERR EE RN ESAE EIERAR 27 Developer s cable kit iei eem coves ven ex es eed CY REY VUEN 28 Chapter 5 Configuring the board s ss sss s 29 Adding board configurations to the NMS OAM database eee 29 Configuring and starting the system with oamsys sss 30 Using board keyword files iret re rhe eee EO ERE YR LA RE ROGA E 30 Creating a system configuration file for oamsys sssssssssssssrrrrsrnrrnrrsrerrnnnseeren 32 Sample system configuration file esses nmm n nnns 33 Rurininig OalTiSyS s oiu ix xu vh aar Veg Y XXX EXVRREEYKRAXRCAR E ERIX FR X E Nac KIA Va aa 33 Changing configuration parameter settings sesssssssseeene 34 NOn UP ETE 34 Specifying configuration file locations esses mme 34 QSLAC files and trunk control programs csse enne 35 Naming conventions for QSLAC files 0c ccee eect eee reece mmm 35 Trunk control programs ci eere xut ea a xxx eine eed ri al PY Y BEER d 36 QSLAC files and TCPs for loop start ssssssssssesseen nnnm nnns 36 Configuring board ClOCKING ccecee cece
41. S wis Een 89 Echo AutoSwitchingRefSource ccceecee cece erence eee eee eee menses nennen 90 6 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Echo EnableExternalPins ce RR ER D ten b EE law dienes 91 lord rsen 92 irem 93 Eocation PGCI BUS ae RD BEER best ERRARE ae ae EHE REA 94 Location n GA Ec o REEL 95 MaxGhaninels ier iieiea M a 96 Name 28 2 EIER 97 NetworkInterface Analog x COnfigFile cccccee eee cnet cence eee teen e teeta eee eeee eae 98 MIiTasisrzl e 99 PrOCUECES Xi eis HIM 100 RUMP tvcstetccsres ti sacrteaet neve deen in er a qvi Ri IQ iP eres dcl A TREPE DINERO ck nig ieu IY Ee ARE 101 SiGMalldleCOd c E 102 SwitchConnections cc cce tree ee ae tek UE d ere Eust YAT de ees 103 SwitchConnectMOde6e ies zic ipotesi teste cese oboe eye pe PRI AE LI pA Tr ni Po REDE es 104 edu ipapaeC N 105 Version MaJOT s irre ERR ER ET AU Uu ed nace NR X ERR KR REA pA Fee PR ng CENE DE 106 VErSION Doro PETIT wmm 107 VoicelTdleCOdE iesiri iaia 108 KAW waka cee ek dt we E E S 109 Chapter 11 Hardware specifications eere eee eene nnn nnn nnn 111 General hardware specifications ccceecceeceee teen ee eee eee nennen nen nnns 111 Mechanical specifi
42. Unlike the clockdemo application which allows you to specify several boards to take over mastery of the clock when another board fails the board keyword method allows you to specify only a single secondary clock master For this reason the board keyword method is best used to implement clock fallback in your system or in test configurations where clock reliability is not a factor The board keyword method does not create an autonomous clock timing environment If you implement clock fallback using this method an application must still intervene when clock fallback occurs to reset system clocking before other clocking changes occur If both the primary and secondary clock masters stop driving the clocks and an application does not intervene the boards default to standalone mode Choose only one of these configuration methods across all boards on the CT bus Otherwise the two methods can interfere with one another and board clocking may not operate properly Configuring AG 2000C boards using board keywords AG 2000C board keywords enable you to configure the board in the following ways e System primary clock master e System secondary clock master e Clock slave e Standalone mode You can also use board keywords to establish clock fallback sources The following sections describe how to use board keywords to specify the clocking role of each AG 2000C board in a system Dialogic Corporation 39 Dialogic AG 2000C Compac
43. a Eri 63 Chapter 10 Keyword reference eee eee ese eee eene eene a nean annua a n nnn 65 Using the keyword referencCe ccccecee cece eee eee eee ee enna neta eee e messen eene 65 AUtOStart salted ae iste AAAA EEE ban task da we cea a dg POR ea isa ese dealer e TE tales a eu POR 66 AUtoStOop xe ta Oa e e ea 67 Boards else desee eere est dur mx Ene exta daB are en bad dx ede E xr rex ERE 68 BootDiagnosticbevel eec rt na o i e ANNE I RERO KE RR eR Ead 69 Butters gt lt NUM seeds Een ere aE rts radi sese ule id ra Ia ge Uere ODE EU ORE Pa DE Ce E i 72 B ffers x SIZe i eerte ean ex EA ERI ERR wea a E ddrH Vesna ees 5 73 Glocking HbBus AutoFallBack iir ret tx errand cane Yea t ua TR 74 Clocking HBus clockMode oer re eee eet ix Fe mule xeu Dae ERR avr dX 76 Clocking HBuS CIOCKSOUPCE 2 ccc n a a ene eme nemen eme messen seen 77 Clocking HBus FallBackClockSource cecceee cece e nee eee eee teeta tena mme 78 Clocking HBus NetRefSource naninira nania eee ee ene senses senses 79 Clocking HBus NetRefSpeed 20 cece eee eee eee eee ene eese sese mense sene 80 Clocking HBS Segment rrr etr her Re Rr x xxm e eg xx e ie i kia 81 IBN d ELE 82 bbiideodhHm LEE 83 Ibici re i Sepia 84 DSP C5xX lt q RIlES Y iioii cette sort eene rv Ere iv tee ober eren E PR Sese v Edd COE De tat Ge neas 85 DSP Cb5x x Image servet on rhe Rx rre ex E wean Nisan nuke ENDUX ER aed dk d ata 88 DSP CSX X O
44. al information on NMS OAM configuration files refer to the VMS OAM System User s Manual Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Keyword changes The statements used in configuration files have also changed Most configuration statements are specified in the board keyword file They are expressed in keyword name and value pairs Keywords have type definitions for example some keywords can take integer values whereas others take string values Some keywords represent arrays of values or structures of other keywords or arrays The following table lists agmon keywords and NMS OAM board keyword equivalents For details on AG specific keywords and values refer to Using keywords on page 59 For more general information on NMS OAM keywords refer to the NMS OAM System User s Manual Old keyword AG2DSP Lib AG2DSP Loader AG2DSP OS AG2DSPFile AG2DSPImage AG2TaskProcessor Buffers BufferSize ClockRef ConnectMode Diagnostics DriveSec8K DSP_OS 132 New keyword DSP C5x Lib DSP C5x Loader DSP C5x x Os DSP C5x x Files y DSP C5x x Image DSP C5x x Files y Buffers x Num Buffers x Size Clocking HBus ClockSource SwitchConnectMode BootDiagnosticLevel Clocking HBus NetRefSource DSP C5x x Os Notes x the number specified in the AG2DSP OS keyword x running count of files from the Common section and from the board specific sectio
45. ame and value pairs Dialogic Corporation 17 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Several sample board keyword files are installed with Natural Access Each of these files configures the board to use a different protocol for example Wink Start or Off Premises Station You can reference these files in your system configuration file or modify them When you run the NMS OAM oamsys utility it creates NMS OAM database records based on the contents of the specified system configuration file and board keyword files oamsys directs NMS OAM to start the boards and configure them according to the specified parameters For more information refer to Configuring and starting the system with oamsys on page 30 Runtime software The runtime software consists of runfiles and DSP files The runfile is the basic low level software that an AG board requires to operate DSP files enable the AG on board digital signal processors to perform certain tasks such as DTMF signaling voice recording and playback Several runfiles and DSP program files are installed with Natural Access Specify the files to use for your configuration in the board keyword file Refer to Using board keyword files on page 30 for more information When NMS OAM boots a board the runfiles and DSP program files are transferred from the host into on board memory For more information about the DSP files shipped with Natural Access refer to
46. artPlaying adiStartPlaying Related arguments encoding ADI_ENCODE_OKI_24 maxspeed 100 encoding ADI_ENCODE_OKI_32 maxspeed 100 encoding ADI_ENCODE_OKI_24 maxspeed 150 encoding ADI_ENCODE_OKI_32 maxspeed 150 encoding ADI_ENCODE_OKI_24 maxspeed 200 encoding ADI_ENCODE_OKI_32 maxspeed 200 encoding ADI_ENCODE_OKI_24 encoding ADI_ENCODE_OKI_32 encoding ADI_ENCODE_G726 encoding ADI ENCODE G726 precmask 0 encoding ADI_ENCODE_MULAW encoding ADI_ENCODE_ALAW Dialogic Corporation DSP file rvoice m54 rvoice m54 rvoice m54 rvoice m54 rvoice vad m54 rvoice vad m54 rvoice vad m54 rvoice vad m54 rvoice vad m54 rvoice vad m54 signal m54 signal m54 tone m54 voice m54 voice m54 voice m54 voice m54 voice m54 voice m54 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Function WAVE Play 8 kHz 16 bit mu law Record A law Record WAVE Record 8 kHz 16 bit mu law Play A law Play WAVE Play 8 kHz 16 bit mu law Record A law Record WAVE Record 8 kHz 16 bit Pulse Bit Detector Tone Generator NMS Play 16 Kbit s NMS Play 24 Kbit s NMS Play 32 Kbit s NMS Play 64 Kbit s NMS Play 16 6 kHz 1 5X NMS Play 24 6 kHz 1 5X Dialogic Corporation MIPS 0 63 0 63 0 63 0 63 0 63 0 63 0 63 0 88 0 88 0 88 0 38 0 44 0 75 3
47. ary timing reference when the first source goes into an alarm state If the primary source returns the board s timing reference switches back to the primary source The showclks utility program can be used to determine what timing reference the board is actively using For an AG board configured as a secondary clock master or as a clock slave this keyword enables the board to switch to an alternative timing reference when the first source goes into an alarm state The board does not return to the first timing reference if the timing reference recovers The host application must perform any further clock configuration operations For more information about clock fallback refer to the Switching Service Developer s Reference Manual 74 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual To support clock fallback on an AG board refer to the NMS web site www nmscommunications com for application notes and other updates Dialogic Corporation 75 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Clocking HBus ClockMode Specifies the board s control of the H 110 clock For information about setting up CT bus clocking and rules and restrictions for configuring CT bus clocking refer to Configuring board clocking on page 36 Syntax Clocking HBus ClockMode clockmode Access Read Write Type String Default STANDALONE Allowed values MASTER A
48. board driver information Keyword Type Driver BoardID String Driver Name String SwitchDriver Name String Plug in keywords Description Board driver ID for the current board Each board accessed by a driver has a unique ID However two boards accessed by different drivers can have the same driver ID number Operating system independent root name of the driver for example ag Operating system independent root name of the switching driver Expected value is AGSW The AG plug in keywords are e Boards x e LoadSize e Products x e Version Major e Version Minor Dialogic Corporation 63 1 O0 Keyword reference Using the keyword reference The keywords are presented in detail in the following topics Each keyword description includes Syntax The syntax of the keyword Access Read write or read only Type The data type of the value string integer or file name Default Default value Allowed values A list of all possible values Example An example of usage Details A detailed description of the keyword s function See also A list of related keywords Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual AutoStart Specifies whether the board automatically starts when ctdaemon is started or the board is Hot Swap inserted Syntax AutoStart setting Access Read Write Type String Default NO Allowed values YES NO Example AutoStart NO
49. cations eesseesseesseseeen nemen EEE EEE n n nn 111 H 110 compliant interface ccccec veia eee nese eee e eee AAE nene 111 HOStANTEMHACE aces CP EET 112 Ervirofiment sire Rr eM RYr ARR RREDO ATA RU REDDE bes YRDESAPRDe RT gar tens 112 POWER requireimients oec dx ker xr vxx es vue dx een Ra xx tech lx tices 112 Common electrical specifications United States version eeseeesses 113 High impedance recording and caller ID mode seseeseeseesses 114 QSLAC files and impedances iii eaii E ee EERE EE EEE nenne nnns 114 Compliance and regulatory certification ccceccceee eee eee ee eeee esas eaeeeneeeeeeeneaes 115 EMG sere duse vex E came EUR OR ERUCRERRIRKED ex Ep ERR ex ERA KU E RU EIE RENNES 115 Safety citta uted Ones c toed b dux eei ei o gl deme eh pd e LE ee 115 TELECON neoan onae a aa E yvba Livece tvs beian Sunsets deustee le a aaa 115 EU R amp TTE statemoent i ie ARK E ONE LANA EE AAE EAA I EA ANAE EAAS 115 Chapter 12 Managing resources ccccseeeeseeeeeeeeeeeeeeeeeeuaeeeuaeeeuaeeeuaeeeuaneauags 117 Functions for managing resources ssssssssssssssssm me emen 117 Default functions ico ot ilenires eats amet elntpete rip un eds IER EoI EPA RIEF DIU RII ee 117 Custom FUNCTIONS soi evecoex oorr RR RR E UE RE EROR VR EREF RERO RAN TT qr uk 118 DSP task processor files and processing power een 119 AG 2000C board processing ssssssssssssssse
50. cess Read only AG plug in level Type String Allowed values Not applicable Details The contents of the Products x keyword in the AG plug in and all other installed plug ins are added to the Supervisor array keyword Products x at startup You can retrieve the values in the Supervisor keyword Products x to determine all products supported by all installed plug ins See also Name 100 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual RunFile Specifies the runtime software to be transferred to the board Syntax RunFile filename Access Read Write Type File name Default ag2000 cor Example RunFile ag2000 cor Details The RunFile is the core file that is used with module extension files specified by DLMFiles x RunFile is not mandatory Dialogic Corporation 101 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual SignalIdleCode Specifies the signal bit patterns transmitted by an idle DSP or to an unconnected line interface In general a DSP is considered to be idle when no application is using it Syntax SignalIdleCode signal idlecode Access Read Write Type Integer Default 0 Allowed values 0x00 OxFF Example SignalIdleCode 0xd See also VoiceIdleCode Xlaw 102 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual SwitchConn
51. cess Read only AG plug in level Type String Allowed values Any board name See also Name Number 68 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual BootDiagnosticLevel Specifies the level of diagnostics during initialization of the board Syntax BootDiagnosticLevel level Access Read Write Type Integer Default 2 Allowed values 0 1 213 Example BootDiagnosticLevel 2 Details This value takes precedence over the corresponding value of the BootDiagnosticLevel keyword set in the system configuration file The valid values for level are 0 1 2 and 3 Zero 0 indicates that no diagnostics are performed and 3 is the maximum level The trade off for higher levels of diagnostics is the increased time needed to initialize each AG board at load time If a test fails the test number is reported back as the error code Some tests can pass back more than one error code depending on the options selected the mode of failure or both Some tests report additional information Dialogic Corporation 69 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following tests are performed during the boot diagnostics Test Description Error Error number number code WDS 1 Coprocessor booted by writing 11h to SRAM base address e Coprocessor never booted at all 1 e Coprocessor booted but crashed after lih writing to SRAM
52. cho v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v3 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 124 Filter length ms Adapt time ms MIPS 40 48 48 48 48 64 64 64 64 A Oo 0 OW WD ADI ADI Oo o A e a ec oe rejl re re Di in na O 0 0 O a 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 100 200 400 800 6 00 15 25 10 44 8 06 6 88 19 69 13 31 10 19 8 56 4 125 3 938 3 875 3 813 4 438 4 188 4 063 4 000 4 750 4 438 4 313 4 188 5 063 4 688 4 500 4 438 5 375 4 938 4 750 4 625 6 313 5 688 5 375 5 188 Dialogic Corporation DSP file echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 echo v4 m54 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Filter length ms Adapt time ms MIPS 20 20 20 20 24 24 24 24 32 32 32 32 40 40
53. contains the FSK data receiver _j is the V 23 variant Contains the FSK data transmitter _j is the V 23 variant Contains voice and tone detectors used for call progress detection Use for any outgoing or two way trunk protocol and for call progress analysis Contains the DTMF receiver energy and silence detector and precise tone filter typically used for cleardown A variant of dtmf m54 optimized for use with the echo canceller echo m54 It yields better talk off resistance but requires the echo canceller to achieve the best cut through performance Note You must use the echo canceller with this function Dialogic Corporation 85 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DSP file echo m54 echo v3 m54 echo v4 m54 g726 m54 gsm_ms m54 gsm mspl m54 ima m54 mf m54 ptf m54 oki m54 rvoice m54 rvoice vad m54 signal m54 86 Description Contains the echo cancellation function The echo canceller removes reflected transmit channel energy from the incoming signal which improves DTMF detection and voice recognition while playing NMS echo functions are characterized by two parameters tail length and adaptation rate Tail length represents the maximum duration of the echo that can be cancelled in ms The adaptation rate specifies the percentage of the echo canceller filter coefficients that are adapted every period The echo function has an adapt perio
54. d file either with additional keywords or keywords whose values override earlier settings Specify parameter settings using the oamcfg utility Refer to the NMS OAM System User s Manual for information about oamcfg Specify the settings using OAM service functions Refer to the NMS OAM Service Developer s Reference Manual for more information To set board keywords specify the board name in the system configuration file or on the oamcfg command line To set AG plug in level keywords specify the AG plug in name agplugin bpi Note Keyword values take effect after the board is rebooted Retrieving keyword values To retrieve the values of read write and read only keywords 60 Run the oaminfo sample program On the command line specify the board using either its name with the option or number with the option oaminfo n boardname oaminfo b boardnum To access AG plug in level keywords specify the AG plug in name on the command line oaminfo n agplugin bpi oaminfo returns a complete list of keywords and values For more information about oaminfo refer to the NMS OAM Service Developer s Reference Manual Use the OAM service Refer to the NMS OAM Service Developer s Reference Manual for more information Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Editable keywords The following table summarizes the keywords that you can change If you wan
55. d of 2 ms Therefore an echo function with a 20 ms tail length and 100 rate adapts all the coefficients in 2 ms while the same function with a 2596 rate adapts in 8 ms Contains an improved echo cancellation function This echo canceller presents a higher performance than the one in echo m54 It also has a maximum tail length of 64 ms Note Substitute dtmfe m54 for dtmf m54 when using this echo canceller Contains the improved echo cancellation functions available in echo v3 m54 and also provides comfort noise generation and tone disabling features Contains ITU G 726 ADPCM play and record functions G 726 is a standard for 32 kbit s speech coding These functions require considerably more DSP processing time than the functions in voice m54 g6726 m54 is required if you start play and record with an encoding type of ADI ENCODE G726 Contains MS GSM play and record functions The 13 kbit s full rate GSM speech codec is in Microsoft formatted frames Contains identical play and record functions as gsm ms m54 except that the maximum output power of the play function is limited Contains IMA ADPCM play and record functions IMA is a standard for 32 kbit s speech encoding Contains the multi frequency receiver which is required for any trunk protocol TCP that uses MF signaling and required by the MF detector Contains precise tone filters Typically used for CNG CED or custom tone detection Contains play and record functio
56. d s current configuration Read only keywords cannot be informational modified This topic describes e Setting keyword values e Retrieving keyword values Note To learn how to use NMS OAM utilities such as oamsys and oamcfg refer to the NMS OAM System User s Manual To learn about setting and retrieving keywords using OAM service functions refer to the NMS OAM Service Developer s Reference Manual AG plug in keywords exist in a separate record in the NMS OAM database They indicate certain board family level information A keyword has the general syntax keyword value Keywords are not case sensitive except where operating system conventions prevail for example file names under UNIX All values are strings or strings that represent integers An integer keyword can have a fixed numeric range of legal values A string keyword can support a fixed set of legal values or can accept any string Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Setting keyword values There are several ways to set the values of read write keywords Use or modify one of the sample board keyword files corresponding to your country and board type Specify the name of this new file in the File statement in oamsys cfg and run oamsys again Refer to the NMS OAM System User s Manual for information about the syntax of board keyword files Note Using oamsys reboots all boards in the system Create a new board keywor
57. d values 0 OxFFFF Example LoadSize 0x7500 See also LoadFile Dialogic Corporation 93 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Location PCI Bus Specifies the PCI logical bus location of the board Syntax Location PCI Bus busnum Access Read Write Type Integer Default 0 Allowed values 0 255 Example Location PCI Bus 0 Details Every PCI slot in the system is identified by a unique PCI logical bus and slot number A CompactPCI board is identified in the system configuration file by specifying its logical bus and slot number This statement along with the Location PCI Slot keyword assigns the board number to the physical board Use pciscan to determine the PCI logical bus and slot assigned for all NMS PCI boards in the system For more information refer to the NMS OAM System User s Manual 94 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Location PCI Slot Defines the logical slot location of the board on the PCI bus Syntax Location PCI Slot slotnum Access Read Write Type Integer Default 0 Allowed values 0 255 Example Location PCI Slot 1 Details Every PCI slot in the system is identified by a unique PCI bus and slot number A CompactPCI board is identified in the system configuration file by specifying its bus and slot number This statement along with Location PCI Bus assig
58. ds If an AG 2000C board exists and is properly initialized its configuration is displayed and its DSP port addresses are displayed as one or more timeslot ranges To run boardinf Step 1 2 44 Action Ensure that the AG 2000C boards were initialized Open a command window Enter the following command boardinf boardinf displays the configuration information for each AG 2000C board in the system that has been loaded and initialized If no boards are detected verify that the AG 2000C board s is loaded and initialized and repeat the command If the AG 2000C configuration information is not as expected review the board keyword file Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Interactive test program ctatest ctatest is a menu driven interactive program Enter one and two letter commands to execute Natural Access and ADI service functions Some commands prompt the user for additional input For example running a tone generator requires the user to specify frequencies and amplitudes For more information about ctatest refer to the Natural Access Developer s Reference Manual ctatest can execute more than one asynchronous function concurrently For example you can run a tone detector zr and record voice RF simultaneously You can abort any function by entering the respective stop command pt and rs for tone and record If Clocking HBus ClockMode STA
59. e specific parameter to be configured on the device indicated by localstream and localtimeslot typedef struct DWORD localstream DWORD localtimeslot DWORD deviceid DWORD parameterid SWI LOCALT IMESLOT ARGS buffer Pointer to a structure that is specific to the parameterid size Size of buffer in bytes Return Values SUCCESS or an error code from ctaerr h or swidef h Details Applications using swiConfigLocalTimeslot and swiGetLocalTimeslotInfo must open the Switching service Refer to the Natural Access Developer s Reference Manual for more information about opening services Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Line gain configuration The AG 2000C supports input and output gain configuration on network voice ports timeslots from 6 dB to 6 dB in one dB increments Input gain is applied to the signal received from the network Output gain is applied to the signal transmitted to the network The default value for both input line gain and output line gain on the AG 2000C loop start board is nominal 0 dB This topic describes e Getting the line gain e Setting the line gain Caution Increasing gain can also increase noise echo and possibly cause oscillations on the telephone network There also may be regulatory authority implications Use gain with caution Decreasing gain may reduce echo and other noise Getting the line gain Use swiGetLocalTimeslot
60. ead Write Type File name Default dspos2f k54 on all DSPs Allowed values A valid file name Example DSP Cbx 1 Os dspos2f k54 Dialogic Corporation 89 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Echo AutoSwitchingRefSource Determines if the on board switching manager performs automatic switching of the echo canceller reference stream Syntax Echo AutoSwitchingRefSource setting Access Read Write Type String Default NO Allowed values NO YES Example Echo AutoSwitchingRefSource NO Details Echo EnableExternalPins must be set to YES to use the Echo AutoSwitchingRefSource keyword Automatic switching occurs when a connection is made to a line from another line or any other source and when the destination line is also connected to a DSP that has echo cancellation enabled For example using swish swish gt openswitch b agsw 0 swisb makeconnection b local 0 0 to localtri7r0 line 0 to DSP swish gt makeconnection b local 0 0 to local 1 1 duplex line 0 to from line 1 The first connection connects DSP O to listen to line 0 The second connection connects lines 0 and 1 together The remote parties on line 0 and line 1 are able to talk to each other DSP 0 is still monitoring line O This configuration is referred to as tromboning The switching manager automatically makes the following connection loeals0s1 gt Local 35 0 This connects line 1 to
61. ections Specifies whether or not to nail up default connections Syntax SwitchConnections setting Access Read Write Type String Default Auto Allowed values Yes No Auto Example SwitchConnections Yes Details Valid entries include the following values Setting Description Yes Nails up connections independent of the Clocking HBus ClockMode setting No Does not nail up connections Auto Nails up connections automatically if Clocking HBus ClockMode STANDALONE When running the Point to Point Switching service set SwitchConnections No Use the ppx cfg file to define default connections For more information refer to the Point to Point Switching Service Developer s Reference Manual See also SwitchConnectMode Dialogic Corporation 103 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual SwitchConnectMode Specifies the HMIC switch connect mode Syntax SwitchConnectMode setting Access Read Write Type String Default ByChannel Allowed values ByChannel AllDirect AllConstantDelay Example SwitchConnectMode AllConstantDelay Details Valid entries include the following values Option Description ByChannel The mode for each board connection depends on whether the connection is made using swiMakeConnection or swiMakeFramedConnection AllDirect For all board connections data is transferred directly from the source timeslot to the destinati
62. eee en m memes seen 36 AG 2000C clocking capabilities oett corren ere ese e nena 37 Clock configuration methods sri smirene a E E E nnn 39 Configuring AG 2000C boards using board keywords sees 39 Multiple board system CXAMPle cccccccce cece ete eee ee ee nnn EE REE EEE EEE 41 Enabling echo cancellation esses emnes nee 42 Chapter 6 Verifying the installation eeeseeeeeeseeeeee enne 43 Status indicator LEDS irre eret er beer ter rage geese ex rk RARE ARE EX ERAT UAR VERA E PX VAR a 43 Verifying board installation sssssesssessessen meme memes memes enne 44 Retrieving AG board configuration information boardinf ceeeeeeeeeeeese 44 Interactive test program Ctate St cece eee nn nnn 45 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Using swish for a standalone board ssssessssssse m 45 Using ctatest with an AG 2000C loop start board sssseeeeenen nne 46 Demonstration programs eren dene ht e ERR FR A ARR ATA dd EAR Ex aa eves 47 Chapter 7 AG 2000C switching eeeeeeeeseseese nenne unen anna annua nana 49 A 3 2000C switch model ri teer td RE TR UT ELA IRR Ra ba ea TAa 49 Ht T0 Sstreams Rx RE Der uer Rea TALI EIE de UE 49 Local streams i ener nerd Rr ra ERI EDE a SENETA Rae aT aTa 49 SWiteh model iaiia EE 50 Lucent T8100A switch blocking rr rninsrn venninna
63. er to www dialogic com for product updates and for information about support policies warranty information and service offerings Dialogic Corporation Table Of Contents Chapter 1 Introduction e eseeeeeeeeee eene nn enne nennen neun annum annus u n u n 9 Chapter 2 Terminology oeeseeee eee ese enne nenne nenne h neun annum unu nana 11 Chapter 3 Overview of the AG 2000C board eere nnns 13 AG 2000C board features oce RR RR HER RURRRAR ER RR e RE REN RE YMRR ce HERRERA TE ERN 13 Software components 2 eee eene nnne nnne nnn nn 15 Nat ral ACCeSS x3 ice stasiouva bien sandaa Ee ASEE AERE va tuaalanidhs Nn FA RAT RUF 16 NMS OAM irinin EEE EAEE AAEE cad ccthewe rebar tide can consumed 16 Configuration files cies eiit tente iaar ai rE Gat cena e raa ERE 17 Runtime soft Ware id d reae ek ek ERR UE RR EROR XI RR RU C E ARD A REO ETE RE 18 Trunk control programs TCPs cececceee eee eee eee eee eee eee eee memet 18 Chapter 4 Installing the Nardware ccccsceeeeeeeeeeeeeeeeeeeeeeeeeeaeeeeeeeaeeeeeueeennae 19 Installation summary rix Lex cela Re RR Wann ERR DURER INR XRR CORPER REPRE TR ERE REX RE bende e 19 AG driver SoftWare ei oth nh R eR RRRKRRARRI ARRRRRARRRERRERRRERXERREXN BRAKE ARERK ME ERA 19 System requlrermernts oco ya taxa e NX E eX VERE ERR AR YVTRR YR RRRYVA ARA VAR YER xA 20 Keying the chassis iin teen RC er E ER RR EUER AMORE ORE XR ERU X UR D ER EXE
64. g values of ADI_LENCODE_NMS_16 ADI ENCODE NMS 24 ADI ENCODE NMS 32 or ADI ENCODE NMS 64 Contains play and record functions for PCM speech in formats commonly used in WAVE files including 8 and 16 bit 11 kHz sampling Refer to Functions for managing resources on page 117 for information about the DSP resources a vailable on each board and the DSP requirements for each ADI service function Refer to DSP task processor files and processing power on page 119 to estimate the DSP requiremen ts for your application and for instructions for re configuring DSP resources if necessary Dialogic Corporation 87 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DSP C5x x Image Specifies the DSP image file for the processor Syntax DSP C5x x Image filename x 0 3 Access Read Write Type File name Default None Allowed values A valid file name Example DSP C5x 1 Image ag2fax c54 Details Specifies a pre linked DSP image file for AG boards used by developers to develop their own DSP images The naming convention for DSP image files is filename c54 Setting DSP C5x x Image NULL leaves the specified DSP s in an unbooted state 88 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DSP C5x x Os Defines the different operating systems per DSP Syntax DSP C5x x Os filename x 0 3 Access R
65. hassis AG 2000C board installed with a rear I O transition board Using the Hot Swap features Hot Swap operates only if the Hot Swap Driver and Hot Swap Manager are started To learn how to start these modules refer to the NMS OAM System User s Manual Under Windows you must also install additional drivers to enable NMS Hot Swap drivers to interact properly with Windows Plug and Play functionality These drivers are available with Natural Access Once the Hot Swap Driver and Hot Swap Manager are started boards defined in the NMS OAM database may be booted extracted and reinserted Boards inserted into a PCI bus and slot for which no logical board definition exists in the database are not recognized For more information about configuring Hot Swap refer to the NMS OAM System User s Manual 24 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Connecting to the telephone network This topic provides instructions for connecting to the telephone network Warning Important safety notes for telephony connections e Allow only qualified technical personnel to install this board and associated telephone wiring e Make sure the PC chassis is grounded through the power cord or by other means before connecting the telephone line e Never install telephone wiring during a lightning storm e Never install telephone jacks in we
66. hat was sold by NMS Communications Corporation NMS to Dialogic Corporation Dialogic on December 8 2008 Accordingly certain terminology relating to the product has been changed Below is a table indicating both terminology that was formerly associated with the product as well as the new terminology by which the product is now known This document is being published during a transition period therefore it may be that some of the former terminology will appear within the document in which case the former terminology should be equated to the new terminology and vice versa Former terminology CG 6060 Board CG 6060C Board CG 6565 Board CG 6565C Board CG 6565e Board CX 2000 Board CX 2000C Board AG 2000 Board AG 2000C Board AG 2000 BRI Board NMS OAM Service NMS OAM System NMS SNMP Natural Access Natural Access Service Fusion ADI Service CDI Service Digital Trunk Monitor Service MSPP Service Natural Call Control Service NMS GR303 and V5 Libraries Dialogic terminology Dialogic CG 6060 PCI Media Board Dialogic CG 6060C CompactPCI Media Board Dialogic CG 6565 PCI Media Board Dialogic CG 6565C CompactPCI Media Board Dialogic CG 6565E PCI Express Media Board Dialogic CX 2000 PCI Station Interface Board Dialogic CX 2000C CompactPCI Station Interface Board Dialogic AG 2000 PCI Media Board Dialogic AG 2000C CompactPCI Media Board Dialogic AG 2000 BRI Media Board Dialogic Natura
67. he current working directory NMS OAM searches for the file in the search path defined by the AGLOAD environment variable 34 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual QSLAC files and trunk control programs The QSLAC files quad subscriber line audio processing circuit on an AG 2000C board control e The 2 wire impedance matching e Frequency response and equalization e Trans hybrid balancing Each port on the AG 2000C board can be configured separately The configuration is contained in a QSLAC file Each QSLAC file is customized for a specific line interface signaling module and for a certain country s two wire return loss requirements Refer to Line gain configuration on page 54 for information on controlling the gain Naming conventions for QSLAC files All QSLAC files have an extension of s c and adhere to the following naming convention pp cty ss i slc Where Represents the For example pp Two character NMS product field a2 AG 2000C board cty Three character ISO country code or region code ss Two character signaling type Is loopstart i One character line impedance field 6 short 600 Ohm lines 9 short 900 Ohm lines n lines longer than 2000 feet C complex used in some international markets For example a2usals6 slc represents the AG 2000C board USA loop start 600 Ohm line QSLAC file Natural Access configures the system fo
68. iStartPlaying encoding ADI_ENCODE_IMA_24 adiStartPlaying encoding ADI_ENCODE_IMA_32 adiStartRecording encoding ADI_ENCODE_IMA_24 adiStartRecording encoding ADI_ENCODE_IMA_32 119 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DSP file mf m54 mf m54 mf m54 mf m54 mf m54 oki m54 oki m54 oki m54 oki m54 oki m54 oki m54 oki m54 oki m54 g726 m54 g726 m54 ptf m54 ptf m54 rvoice m54 rvoice m54 120 Function Forward detect backward compelling Backward detect forward compelling MF detection MF forward detection MF backward detection OKI Play 6 kHz OKI Play 8 kHz OKI Play 6 kHz 1 5X OKI Play 8 kHz 1 5X OKI Play 6 kHz 2 0X OKI Play 8 kHz 2 0X OKI Record 6 kHz OKI Record 8 kHz G 726 Play G 726 Record 2 single freq or 1 tone pair 4 single freq or 2 tone pair mu law Play A law Play MIPS 2 56 2 56 1 81 1 81 1 81 3 63 5 50 4 81 2 25 2 00 7 44 7 00 1 25 1 81 0 63 0 63 Related API function adiStartMFDetector adiStartMFDetector adiStartMFDetector adiStartMFDetector adiStartMFDetector adiStartPlaying adiStartPlaying adiStartPlaying adiStartPlaying adiStartPlaying adiStartPlaying adiStartRecording adiStartRecording adiStartPlaying adiStartRecording adiStartToneDetector adiStartCallProgress adiSt
69. ice by entering PM You should hear Hello World and ctatest displays Event VCEEVN PLAY DONE Finished msec 3820 Quit the test program by entering Q Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Demonstration programs The following demonstration programs are provided with Natural Access and can be used to verify that the AG 2000C board is operating correctly Program Demonstrates ctatest Natural Access functions incta Handling inbound calls outcta Establishing outbound calls prt2prt Transferring calls from an incoming line to an outgoing line and using the Switching service to make connections and to send patterns vceplay Using the Voice Message service to play messages in voice files vcerec Recording one or more messages to a voice file Note Executables for incta outcta and prt2prt are in the respective sub directories under nms ctaccess demos To run these demonstration programs on the AG 2000C board specify the slot number of the local DSP resource on which to run the program If Clocking HBus ClockMode STANDALONE then default switching connections between the on board DSP resources and signaling modules are initialized as described in Default connections on page 51 To run ctatest on DSP port 0 enter Graces a0 To run ctatest on DSP port 2 enter ctatesb 52 Switching connections must be made between DSP resources and signaling module
70. imary clock master Clocking HBus ClockMode MASTER A Clocking HBus ClockSource OSC Clocking HBus AutoFallBack NO 1 Secondary clock master Clocking HBus ClockMode MASTER B Clocking HBus ClockSource A_CLOCK Clocking HBus AutoFallBack YES Clocking HBus FallBackClockSource OSC 2 Clock slave Clocking HBus ClockMode SLAVE Clocking HBus ClockSource A_CLOCK Clocking HBus AutoFallBack YES Clocking HBus FallBackClockSource B_CLOCK In this configuration Board 0 is the primary clock master and drives A_CLOCK All slave boards on the system use the A clock as their first timing reference Board 0 references its timing from its local oscillator If the clocking signal used by Board 0 fails then Board 0 stops driving A_CLOCK The secondary clock master Board 1 then falls back to a timing reference based on its local oscillator and uses this signal to drive B_CLOCK B_CLOCK then becomes the timing source for all boards that use B_CLOCK as their backup timing reference Note For this clock fallback scheme to work all clock slaves must specify A_CLOCK as the clock source and B_CLOCK as the clock fallback source Enabling echo cancellation Echo cancellation improves the input signal to noise ratio during play which improves the performance of operations such as tone detection and speech recognition To enable echo cancellation Step Action 1 Include the following statement in the board keyword file DSP C5x x Files
71. in bytes sizeof device 56 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following sample code shows how to configure line gain applied to a signal transmitted to the network include swidef h include mvip95 h include ff nmshw h DWORD mySetTransmitGain SWI_LOCALTIMESLOT_ARGS NMS_LINE_GAIN_PARMS args args args args plO allsite localtim deviceid paramete device gain eam eslot will gain dB CT Access Switching service Ey MVIP 95 definitions w NMS hardware specific definitions SWIHD swihd SWI TERMINUS terminus INT32 gain dB args device terminus stream terminus timeslot MVIP95 ANALOG LINE DEVICE MVIP95 OUTPUT GAIN T0900 E return swiConfigLocalTimeslot CT Access switch handle swihd target device and config item amp args Dialogic Corporation buffer defined by parameterid void amp device buffer size in bytes sizeof device 57 9 Keyword summary Using keywords The keywords for an AG 2000C board describe that board s configuration Some keywords are read write others are read only Keyword type Description Read write Determines how the board is configured when it starts up Changes to these editable keywords become effective after the board is rebooted Read only Indicates the boar
72. ing modules and logical timeslots 51 software components 15 specifications 111 compliance and regulatory certification 115 electrical 113 system requirements 20 standalone mode 41 State 62 stopping or starting a board 66 67 streams 49 swish 45 switch model 49 SwitchConnections 103 SwitchConnectMode 104 SwitchDriver Name 63 switching keywords 103 104 Switching service 51 53 system configuration file 32 system requirements 20 T T8100A switch blocking 50 task processor files 119 TCPFiles x 105 Telecom 115 telephone network connection 25 temperature 111 tromboning 90 91 trunk control programs TCPs 18 V vceplay 47 vcerec 47 verifying board installation 44 board configuration information 44 ctatest 45 demonstration programs 47 LEDs 43 137 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual swish 45 Ww Version Major 106 weight 111 Version Minor 107 X VoiceIdleCode 108 Xlaw 109 138 Dialogic Corporation
73. ion 73 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Clocking HBus AutoFallBack Enables or disables clock fallback on the board For information about setting up CT bus clocking and rules and restrictions for configuring CT bus clocking refer to Configuring board clocking on page 36 Syntax Clocking HBus AutoFallBack mode Access Read Write Type String Default NO Allowed values YES NO Example Clocking HBus AutoFallBack YES Details When set to YES this keyword specifies whether or not the board automatically switches between the two clock timing references specified by the Clocking HBus ClockSource and Clocking HBus FallBackClockSource keywords The Clocking HBus AutoFallBack keyword applies for all modes specified by the Clocking HBus ClockMode keyword The fallback timing reference clock is selected by the Clocking HBus FallBackClockSource keyword Both of the physical timing references specified by the Clocking HBus ClockSource and Clocking HBus FallBackClockSource keywords must be present and not in alarm when the board s clocking is set up NO indicates that the system does not fallback to the backup timing reference Specify the primary clock and fallback clock with the Clocking HBus ClockSource and Clocking HBus FallBackClockSource keywords If the board is configured as the primary master or in standalone mode this keyword enables the board to switch to the second
74. ions com Safety US UL Std No 60950 3rd Ed Canada CSA C22 2 No 60950 00 3rd Ed EU countries EN 60950 1992 Amendments 1 to 4 Other countries Refer to the NMS web site www nmscommunications com Telecom US FCC Part 68 Canada ISC CS 03 EU countries TBR 21 and EG 201 121 Other countries Refer to the NMS web site www nmscommunications com EU R amp TTE statement This equipment has been approved in accordance with Council Decision 1999 5 EC R amp TTE for pan European single terminal connection to the public switched telephone network PSTN However due to differences between the individual PSTNs provided in different countries the approval does not of itself give an unconditional assurance of successful operation on every PSTN network termination point In the event of problems contact your equipment supplier A copy of the R amp TTE Declaration of Conformity is shipped with the board Dialogic Corporation 115 1 2 Managing resources Functions for managing resources Most Natural Access functions implicitly use processes that run on the DSP resources For example adiStartToneDetector starts the tone detector function running on a DSP adiStartRecording starts one of many voice compression functions running on a DSP AG boards are shipped with default configurations that make the most commonly used functions available Note It is not feasible or practical to make every possible function
75. ious utilities One of these utilities oamsys effectively takes the place of the agmon configuration and booting function It loads a configuration file into the NMS OAM database and then starts the boards Another utility oammon takes the place of the agmon monitoring function After running oamsys you can run oammon to monitor board errors and other board level events For details on using these utilities to configure the AG system refer to Configuring and starting the system with oamsys on page 30 For more information about loading configuring and monitoring boards in an NMS OAM system refer to the NMS OAM System User s Manual For more information about the OAM service refer to the NMS OAM Service Developer s Reference Manual Configuration file changes agmon used a single configuration file ag cfg that contained configuration information for each board Each board was referenced using a board number oamsys uses a system configuration file that assigns each board e A board name used to refer to the board in software e A board number used to refer to the board in legacy software e A board keyword file containing the configuration information for the board The internal structure of the system configuration file and the board keyword file is very different from agmon configuration files For details on creating a file for your system refer to Configuring and starting the system with oamsys on page 30 For more gener
76. k 0 No loop current detected current detector 1 Current detected Loop start receive signaling The following table summarizes the receive signaling for loop start line interfaces Bit Hex bitmask If line is off hook If line is on hook A bit 0x08 Detects loop current A bit toggles with ring frequency 0 No loop current IDE State o 0x08 Current is flowing B bit 0x04 Loop current direction 0 0 Tip positive with respect to ring 0x04 Tip negative with respect to ring C bit N A Reserved should be ignored Reserved should be ignored D bit N A Reserved should be ignored Reserved should be ignored Dialogic Corporation 129 1 4 Natural Access migration Migration overview This section describes migration from earlier versions of AG software With the 2000 1 release of Natural Access changes were made in the configuration and monitoring aspects of AG software including e The introduction of NMS OAM e Configuration file changes e Keyword changes NMS OAM NMS OAM performs configuration monitoring and testing functions across the telephony resources including the AG boards NMS OAM manages a central database of configuration information Every board in the system has a record in the database describing its configuration NMS OAM can start boards based on the information in the database You can control NMS OAM using functions from the OAM service You can also control it using var
77. lAccess OAM API Dialogic NaturalAccess OAM System Dialogic NaturalAccess SNMP API Dialogic NaturalAccess Software Dialogic NaturalAccess Service Dialogic NaturalAccess Fusion VoIP API Dialogic NaturalAccess Alliance Device Interface API Dialogic NaturalAccess CX Device Interface API Dialogic NaturalAccess Digital Trunk Monitoring API Dialogic NaturalAccess Media Stream Protocol Processing API Dialogic NaturalAccess NaturalCallControl API Dialogic NaturalAccess GR303 and V5 Libraries Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Former terminology Point to Point Switching Service Switching Service Voice Message Service NMS CAS for Natural Call Control NMS ISDN NMS ISDN for Natural Call Control NMS ISDN Messaging API NMS ISDN Supplementary Services NMS ISDN Management API NaturalConference Service NaturalFax SAI Service NMS SIP for Natural Call Control NMS RJ 45 interface NMS RJ 21 interface NMS Mini RJ 21 interface NMS Mini RJ 21 to NMS RJ 21 cable NMS RJ 45 to two 75 ohm BNC splitter cable NMS signal entry panel 12 Dialogic terminology Dialogic NaturalAccess Point to Point Switching API Dialogic NaturalAccess Switching Interface API Dialogic NaturalAccess Voice Control Element API Dialogic NaturalAccess CAS API Dialogic NaturalAccess ISDN API Dialogic NaturalAccess ISD
78. les timeslots and the connector for AG 2000C boards AG 2000C board Rear I O transition board Timeslots Timeslots 4 7 12 15 Seta ed a Timeslots 16 19 Timeslots Timeslots 0 3 8 11 RJ 21 connector Logical timeslots signaling modules and RJ 21 connector Default connections Refer to the following table to determine how default connections occur on the AG 2000C board If Clocking HBus ClockMode STANDALONE SLAVE MASTER_A MASTER_B If SwitchConnections Yes Yes Yes Yes No No No No Auto Yes No No If SwitchConnections Yes default connections are made regardless of the Clocking HBus ClockMode setting If SwitchConnections No default connections are not made regardless of the Clocking HBus ClockMode setting If SwitchConnections Auto and Clocking HBus ClockMode STANDALONE default connections are made Dialogic Corporation 51 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual If SwitchConnections Auto and Clocking HBus ClockMode SLAVE MASTER A or MASTER B default connections are not made The following default local connections are nailed up at board initialization Switch connection Full duplex connection between line interface voice information and DSP resources Full duplex connection between line interface signaling information and DSP resources MVIP 95 local 0 0 23 2 local
79. llback timing references A CLOCK Yes B CLOCK Yes OSC Yes The board is not synchronized until the application reconfigures the clock Other clocking capabilities Capability Yes No Comments Drive NETREF Yes Drive NETREF2 No This board does not support NETREF2 Operate in standalone mode Yes 38 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Clock configuration methods You can configure clocking in your system in one of two ways Method Using clockdemo application model Using board keywords with or without application intervention Description Create an application that assigns each board a clocking mode monitors clocking changes and reconfigures clocking when clock fallback occurs A sample clocking application clockdemo is provided with Natural Access clockdemo provides a robust fallback scheme that suits most system configurations clockdemo source code is included allowing you to modify the program if your clocking configuration is complex For more information about clockdemo refer to the NMS OAM System User s Manual Note Most clocking applications including clockdemo require that all boards on the CT bus be started in standalone mode For each board on the CT bus set the board keywords to determine the board s clocking mode and to determine how each board behaves if clock fallback occurs This method is described in this topic
80. ls Select the country where NMS CAS protocols is installed This configures loop start products for local compliance For more information refer to the NMS CAS for Natural Call Control Developer s Manual 4 Add configuration information for each board to the NMS OAM database For more information refer to the NMS OAM System User s Manual 5 Direct the OAM service to start the boards For more information refer to Configuring and starting the system with oamsys on page 30 and to the NMS OAM System User s Manual 6 Verify that the installation is operational Note If your system is powered down you can install the board before you install the software It does not matter if you install the board or the software first The BootDiagnosticLevel keyword in the board keyword file determines the type of board diagnostic tests that take place when you boot the board If a test fails the test number is reported back as an error code You must be running oammon to view diagnostic results For more information about board level error messages refer to the NMS Board and Driver Errors Manual AG driver software The following drivers for operating AG boards are installed with Natural Access software Operating system Driver names Windows aghwwin2k agwin2k UNIX aghw agsw ag95sw agmx Red Hat Linux aghw o Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual System requirements To install and use AG 2
81. mance interfacing to long lines gt 2000 feet Other QSLAC files are used in other parts of the world Natural Access configures the correct files for the countries that are supported For European countries that are not supported in the installation use the a2eurlsc slc file when connecting to the PSTN Refer to the NetworkInterface Analog x ConfigFile keyword for more information about QSLAC files Refer to the NMS CAS for Natural Call Control Developer s Manual for information on changing network tone descriptions The following table lists the TCPs that are applicable to AG 2000C loop start boards Trunk control program Description nocc tcp No call control IpsO tcp Loop start on AG 2000C Configuring board clocking When multiple boards are connected to the CT bus you must set up a bus clock to synchronize timing between them In addition you can configure alternative or fallback clock sources to provide the clock signal if the primary source fails This topic describes e AG 2000C clocking capabilities e Clock configuration methods e Configuring board clocking using keywords e Example To create a robust clocking configuration you must understand basic clocking concepts such as clock mastering and fallback This topic assumes that you have a basic understanding of CT bus clocking For a complete overview of CT bus clocking refer to the NMS OAM System User s Manual 36 Dialogic Corporation Dialogic AG 2000C Co
82. me Im a eaa diea anii 126 Chapter 13 Loop start signaling ueeeseeee seen e nennen 127 Signaling overview ssssssssssesses e I memessesse seme es ense ee es nnn 127 Eoop start transmit sigriallng itr rrt t Te tur ee e Rr RA Ru ANEKA 128 Loop start receive signaling tek eR RR ERE REX RR TERRE A A ERR 129 Chapter 14 Natural Access migration eeeseeeee sene eene nnn 131 Migration OVervieW sisisse tide eene ra nmi seh EE ru ERR sae eee x ene seed eue a creed es 131 Mhalcwop v PEU E E A A A 131 Configuration file changes ceret AE AAA a ENEE TE a d 131 Keyword change6s 22r eei rata etuer EA AAA PADE EAE A Pin eee E ra NARA eia S 132 Dialogic Corporation 7 1 Introduction The Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual explains how to configure and install an AG 2000C board and how to verify that it has been installed correctly and is operating correctly It also provides general information about developing an application that uses the AG 2000C board This manual targets developers of telephony and voice applications who are using the AG 2000C board with Natural Access This manual defines terms where applicable but assumes that readers are familiar with telephony concepts switching and the C programming language Terminology Note The product to which this document pertains is part of the NMS Communications Platforms business t
83. mpactPCI Media Board Installation and Developer s Manual AG 2000C clocking capabilities This topic describes the rules and limitations that apply to setting up CT bus clocking on AG 2000C boards When an AG 2000C board is configured as the system primary clock master the boards s first timing reference must be set to OSC Clock fallback should be disabled Warning If there is a digital T1 or E1 board in the system configure one of the digital boards as the master and configure the AG 2000C board as the slave Refer to the NMS OAM System User s Manual for information about assessing clocking priorities in a mixed board system When an AG 2000C board is configured as the system secondary clock master e The board s first timing reference must be the system s primary clock master e The board s fallback timing reference must be set to OSC When an AG 2000C board is configured as a clock slave e The board s first timing reference must be the system s primary clock e The board s fallback timing reference must be the system s secondary clock e If there is no secondary clock master for the system the board s fallback timing reference must be set to OSC In this case if clock fallback occurs the board is not synchronized with the system until you reconfigure the board s clocking The following tables summarize the CT bus clocking capabilities of AG 2000C boards Note NETREF refers to NETREF1 on the H 110 bus Clocking capabilities a
84. n Ensure that this list contains callp dtmf signal ptf mf and tone x the number specified in the AG2DSPImage keyword If a DSP processor range is specified then it converts to x Otherwise it applies to all processors from 0 to number of DSPs AG NMS OAM osc OSC H100 A CLOCK SEC8K NETREF MVIP C4 AG NMS OAM FRAMED AllConstantDelay UNFRAMED AllDirect All boards If DriveSec8K OSC set Clocking HBus NetRefSource OSC If DriveSec8K is set to NONE omit Clocking HBus NetRefSource Dialogic Corporation Old keyword EnableMVIP IdleCode LoadFile MaxChannels MedBuffers MedBufferSize PCIbus PCIslot Qslac RunFile RunModule SmallBuffers TCP Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual New keyword Clocking HBus ClockMode SignalIdleCode VoicelIdleCode Xlaw LoadFile MaxChannels Buffers x Num Buffers x Size Location PCI Bus Location PCI Slot NetworkInterface Analog x ConfigFile RunFile DLMFiles x Buffers x Num TCPFiles x Notes If there is no EnableMVIP setting in agmon refer to the ClockRef value If ClockRef is equal to either H100 or MVIP set Clocking HBus ClockMode SLAVE If ClockRef is equal to a value other than H100 or MVIP set Clocking HBus ClockMode STANDALONE If EnableMVIP was set to NO in agmon set Clocking HBus ClockMode STANDALONE If EnableMVIP YES determine the
85. n about the e Board e EEPROM e Board driver Retrieving board information EEEEEEEEEMEEEEISRXAT Keyword Type Description Location Type String Host system s bus type Product String At the board level the product type of the board m State String State of the physical board Expected values are IDLE BOOTED or TESTING Retrieving EEPROM information Keyword Type Description Eeprom AssemblyRevision Integer Hardware assembly level Eeprom BoardSpecific Integer Board specific data Eeprom BusCIkDiv Integer Bus speed is equal to 2 x CPU speed busclkdiv Eeprom CheckSum Integer EEPROM checksum Eeprom CPUSpeed Integer Coprocessor speed in MHz Eeprom DRAMSize Integer DRAM size in kilobytes EEprom DSPSpeed Integer DSP processor speed in MHz EEprom Family Integer Board family Eeprom MFGWeek Integer Week of the last full test Eeprom MFGYear Integer Year of the last full test Eeprom MSBusType Integer Media stream bus type H 110 1 Eeprom NumDSPCores Integer Total number of DSP cores on the motherboard Eeprom SerialNum Integer Serial number unique to each board This number is factory configured Eeprom SoftwareCompatibility Integer Minimum software revision level Eeprom SRAMSize Integer SRAM size in kilobytes Eeprom SubType Integer AG family variant information 62 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Retrieving
86. n as follows Argument Field Value swihd Handle returned by swiOpenSwitch args localstream 0 or 1 Refer to the AG 2000C switch model on page 49 localtimeslot 0 23 Refer to the AG 2000C switch model on page 49 deviceid MVIP95 ANALOG LINE DEVICE parameterid MVIP95 INPUT GAIN or MVIP95 OUTPUT GAIN buffer Points to the NMS LINE GAIN PARMS structure size Size of buffer in bytes The NMS LINE GAIN PARMS structure is typedef struct CNT 32 Gain NMS_LINE_GAIN_PARMS Multiply the desired gain setting in dB by 1000 For example to set the input line gain on a network voice port to 4 dB set the gain field of NMS LINE GAIN PARMS to 4000 The following sample code shows how to configure gain applied to a signal received from the network include swidef h CT Access Switching service E include mvip95 h MVIP 95 definitions g include nmshw h NMS hardware specific definitions DWORD mySetReceiveGain SWIHD swihd SWI_TERMINUS terminus INT32 gain_dB SWI LOCALT IMESLOT ARGS args NMS LINE GAIN PARMS device terminus stream terminus timeslot MVIP95 ANALOG LINE DEVICE MVIP95 INPUT GAIN args localstream args localtimeslot args deviceid args parameterid cevice gain gain ci 1000 z return swiConfigLocalTimeslot CT Access switch handle swihd target device and config item amp args buffer defined by parameterid void amp device buffer size
87. nce The board cannot make switch connections to the CT bus Multiple board system example The following example assumes a system configuration where three AG 2000C boards reside in a single chassis The boards are configured in the following way using board keywords Board Configuration Board 0 System primary bus master driving the A clock Board 1 System secondary bus master driving the B clock Board 2 Clock slave clock fallback enabled This configuration assigns the following clocking priorities Priority Timing reference First Board 0 local oscillator Second Board 1 local oscillator The following illustration shows a multiple board system with a primary and secondary clock master CT bus A CLOCK A CLOCK B CLOCK B CLOCK NETREF NETREF Board 0 Primary clock master Drives A CLOCK from local oscillator Board 1 Secondary clock master Drives B CLOCK references A CLOCK falls back to local oscillator Board 2 Clock slave References A CLOCK falls back to B CLOCK P Driving clock Clock source Clock fallback source Sample board clocking configuration Dialogic Corporation 41 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The following table shows board keywords used to configure the boards according to the configuration shown in the preceding illustration Board Role Clocking keyword settings 0 Pr
88. ng modules The AG 2000C board has two to six loop start line interface signaling modules which are circuits that connect a bidirectional transmission channel to separate receive and transmit channels Each line interface signaling module has four ports This allows you to monitor and control at least 8 channels of signaling information The loop start line interface signaling module replaces a telephone modem or fax machine at the end of a standard telephone line or PBX extension The loop start interface can also be a trunk interface to the telephone network With loop start trunks you may want to segregate incoming calls from outgoing calls to avoid collisions between the two Changing the interface model has no impact on applications that you have already written The loop start interface e Has very high tolerance to common mode power line interfaces e Detects loop current reversals and interruptions in the off hook mode e Receives called party identification in some countries e Records calls in on hook mode where permitted by regulations Do not change any of the settings on the line interface signaling modules or attempt to remove the modules These settings are factory installed and tested The following illustration shows where various components are located on an AG 2000C board 14 T8100A switch makes connections for H 110 streams and local streams
89. ns for OKI ADPCM speech encoding at 24 kbit s or 32 kbit s used to play and record compatible voice files Contains PCM play and record functions rvoice m54 is required to play or record with an encoding of ADI ENCODE MULAW ADI ENCODE ALAW or ADI ENCODE PCM8M16 Contains PCM play and record functions Record functions can enable the voice activity detection VAD capability rvoice vad m54 is required to play or record with an encoding of ADI ENCODE MULAW ADI ENCODE ALAW or ADI ENCODE PCM8M16 Contains signaling ring detector and pulse functions These are out of band functions which typically operate on the MVIP signaling stream This file is required for e Any trunk protocol except NOCC e The signal detector e Sending a pulse Dialogic Corporation DSP file tone m54 voice m54 wave m54 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Description Contains the tone generation function This file is required for any trunk protocol except NOCC It is also required for generating tones generating DTMF tones MF tones initiating dialing and for generating a beep tone with any second record function Contains NMS ADPCM play and record functions The compressed speech is in a framed format with 20 milliseconds of data per frame Speech is compressed to 16 24 or 32 kbit s or stored as uncompressed mu law or A law 64 kbit s This file is required to play or record with encodin
90. ns the board number to the physical board Use pciscan to determine the PCI bus and slot assigned for all NMS PCI boards in the system For more information refer to the NMS OAM System User s Manual Dialogic Corporation 95 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual MaxChannels Specifies the maximum number of channels to allocate on the board Syntax MaxChannels numChannels Access Read Write Type Integer Default 24 Allowed values 1 255 Example MaxChannels 128 Details The number of channels affects memory requirements If Buffers 0 Num is not configured two buffers are allocated per channel See also Buffers x Num 96 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Name Specifies the name of the board Syntax Name boardname Access Read Write Type String Default None Allowed values Not applicable The name can be up to 64 characters long Example Name AG 2000C See also Number Dialogic Corporation 97 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual NetworkInterface Analog x ConfigFile Specifies the country specific file for AG 2000C loop start boards Refer to QSLAC files and trunk control programs on page 35 for more information Syntax NetworkInterface Analog x ConfigFile 2 filename X line number 0 23 Access Read Write T
91. of the system configuration file to make sure that all required keywords are present oamsys discards any unrecognized keywords and reports any syntax errors it finds oamsys verifies the file syntax of configuration files but not of board keyword files e Checks for uniqueness of board names board numbers and boad bus and slot numbers e Shuts down all boards recognized by NMS OAM if any e Deletes all board configuration information currently maintained for the recognized boards if any e Sets up the NMS OAM database and creates all records as described in the system configuration file e Attempts to start all boards as specified in the system configuration file and the board keyword files it references The Natural Access Server ctdaemon must be running for oamsys to operate For more information about the Natural Access Server refer to the Natural Access Developer s Reference Manual Dialogic Corporation 33 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Changing configuration parameter settings When you run oamsys the utility starts all boards according to the configuration parameters specified in their associated board keyword files To change a parameter e Use of modify one of the sample board keyword files corresponding to your country and board type Specify the name of this new file in the File statement in oamsys cfg and run oamsys again Refer to the NMS OAM System User
92. on timeslot For forward connections from lower numbered timeslots to higher numbered timeslots data is transferred in the same time frame For backward connections from higher numbered timeslots to lower numbered timeslots data is transferred in the next frame AllConstantDelay Data is delayed so that the destination timeslot is always in the next frame regardless of whether it is a forward connection This keyword is used for configurations that transfer non voice data in multiple timeslots for example HDLC in TDM For more information refer to swiMakeConnection and swiMakeFramedConnection in the Switching Service Developer s Reference Manual See also SwitchConnections 104 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual TCPFiles x Specifies a trunk control program for the current boards Syntax TCPFiles x filename x the number of the TCP file Access Read Write Type String Default None Allowed values A valid file name Example TCPFiles 0 nocc tcp Details Trunk control programs perform all signaling tasks necessary to interface with the telephony protocol used on the line or trunk TCPs are loaded onto an NMS board during initialization After a TCP is loaded applications must start the protocol before they can use the TCP to perform call control on specific ports For more information about starting protocols on
93. onfiguring and starting the system with oamsys To configure and start a system using the oamsys utility Step Action 1 Install the boards and software as described in the installation summary on page 19 2 Determine which board keyword file you will use or edit one of the sample AG 2000C board keyword files to specify appropriate configuration information for each board For more information refer to Using board keyword files on page 30 3 Determine the PCI bus and slot locations of the boards using the pciscan utility pciscan identifies the NMS PCI boards installed in the system and returns each board s bus slot interrupt and board type 4 Create a system configuration file or edit a sample system configuration file to point to all the board keyword files for your system Specify a unique name and board number for each board 5 Start oammon to monitor the NMS OAM system and all NMS boards For more information about oammon refer to the NMS OAM System User s Manual Start oammon before running oamsys Keep oammon running to see the status of all boards in your system and to view error and tracing messages 6 Use oamsys to start all of the installed boards ctdaemon must be running when you use oamsys according to the configuration information specified in the system configuration file and any associated board keyword files For more information refer to Running oamsys on page 33 To determine the physical slot location of a
94. oper s Manual Clocking HBus NetRefSource Specifies a source to drive the NETREF timing signal on the CT bus For information about setting up CT bus clocking and rules and restrictions for configuring CT bus clocking refer to Configuring board clocking on page 36 Syntax Clocking HBus NetRefSource source Access Read Write Type String Default STANDALONE Allowed values OSC STANDALONE Example Clocking HBus NetRefSource OSC Details Value Description OSC The clock uses the board s local oscillator for diagnostics only STANDALONE The NETREF clock is not driven by this board See also Clocking HBus NetRefSpeed Dialogic Corporation 79 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Clocking HBus NetRefSpeed Indicates the speed of the NETREF timing signal on the CT bus For information about setting up CT bus clocking and rules and restrictions for configuring CT bus clocking refer to Configuring board clocking on page 36 Syntax Clocking HBus NetRefSpeed speed Access Read Write Type String Default 8K Allowed values 8K Example Clocking HBus NetRefSpeed 8K See also Clocking HBus NetRefSource 80 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Clocking HBus Segment Specifies the CT bus segment into which the board is connected In most cases the chassis contains only one
95. r the QSLAC file that is intended for your country Do not change the configuration unless you are confident that a change is required and is allowed by the regulatory agencies For more information about QSLAC files refer to the NMS CAS for Natural Call Control Developer s Manual If the default file is not used an entry is made in the error log file at boot time If echo cancellation is enabled there is no benefit in changing from the default QSLAC file For example add the following statement to the board keyword file to load a QSLAC file NetworkInterface Analog 0 23 ConfigFile a2usals9 slc Dialogic Corporation 35 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Trunk control programs Trunk control programs TCPs perform all the signaling tasks necessary to interface with the telephony protocol used on the line or trunk TCPs are loaded onto an AG 2000C board at board initialization After a TCP has been loaded to the AG 2000C board the application must start up its protocol before it can use the TCP to perform call control on a specific port QSLAC files and TCPs for loop start The following table lists the QSLAC files for loop start that can be selected for the United States and Canada File Description a2usals6 slc This is the default file that is used when you have a 600 Ohm PBX a2usals9 slc Optimizes performance interfacing to a 900 Ohm PBX a2usalsn slc Optimizes perfor
96. real Quebec Canada H4M 2V9 Any authorized use of Dialogic s trademarks will be subject to full respect of the trademark guidelines published by Dialogic from time to time and any use of Dialogic s trademarks requires proper acknowledgement Windows is a registered trademark of Microsoft Corporation in the United States and or other countries The names of actual companies and product mentioned herein are the trademarks of their respective owners This document discusses one or more open source products systems and or releases Dialogic is not responsible for your decision to use open source in connection with Dialogic products including without limitation those referred to herein nor is Dialogic responsible for any present or future effects such usage might have including without limitation effects on your products your business or your intellectual property rights 2 Dialogic Corporation Revision History Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Revision 9000 60089 10 9000 60089 11 9000 60089 12 9000 60089 13 9000 60089 14 9000 60089 15 9000 60089 16 64 0489 01 Release date June 2001 August 2001 November 2001 May 2002 November 2002 April 2003 April 2004 October 2009 Last modified September 12 2009 Notes SRG SRG MVH NBS Natural Access 2002 1 MVH Natural Access 2003 1 Beta MVH Natural Access 2003 1 SRG Natural Access 2004 1 LBG NaturalAccess R9 0 Ref
97. remove the board until the LED illuminates This occurs only if Hot Swap software is present e If the LED remains illuminated during insertion of a board the board failed to successfully perform its primary hardware initialization While it is safe to remove the board this condition indicates a problem For more information about Hot Swap refer to the NMS OAM System User s Manual Verifying board installation Complete the following steps to verify that the board is installed correctly Step 1 Action Create a board keyword file to boot an AG 2000C board by copying or editing one of the sample board keyword files to match your specific configuration Refer to Configuring and starting the system with oamsys on page 30 for more information For example use the agpi2000c cfg file to configure the board for the loop start protocol Run oammon to monitor the status of all boards Use pciscan to determine the bus and slot number For more information about pciscan refer to the NMS OAM System User s Manual Edit the oamsys cfg file to reflect the board locations in your system Boot the board using the command oamsys Retrieving AG board configuration information boardinf boardinf is a program that reports the board number address type number of ports memory and DSP timeslot assignments for each AG board in a system boardinf opens the AG driver and retrieves the configuration information for up to 16 AG 2000C boar
98. ription OSC Uses the on board oscillator as a reference A_CLOCK Causes the board to act as a clock slave to the H 110 bus A clock by deriving the local clock from the bus Another H 110 board or H 100 board must drive the clock on the bus B_CLOCK Causes the board to act as a clock slave to the H 110 bus B clock by deriving the local clock from the bus Another H 110 board or H 100 board must drive the clock on the bus Dialogic Corporation 77 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Clocking HBus FallBackClockSource Specifies the alternate clock reference to use when the master clock does not function properly For information about setting up CT bus clocking and rules and restrictions for configuring CT bus clocking refer to Configuring board clocking on page 36 Syntax Clocking HBus FallBackClockSource clock source Access Read Write Type String Default OSC Allowed values OSC A CLOCK B CLOCK Example Clocking HBus FallBackClockSource OSC Details If the Clocking HBus AutoFallBack keyword is set to NO this keyword is ignored For more information about clock fallback refer to the Switching Service Developer s Reference Manual To support clock fallback on an AG board refer to the NMS web site www nmscommunications com for application notes and other updates 78 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Devel
99. s P1 Front panel keying chambers D E and F i Te Keying chamber locations on chassis front and backplane Chambers A D E and F are defined by backplane wiring and network signaling levels Chambers B and C are manufacturer specific Configure keying in the chassis as described in the following table Keying chambers on chassis Configuration A B and C Configure as shown in this illustration Front and rear panels p A B C 1 1 2 D E and F Configure as shown in this illustration Front and rear panels Chamber Position Chamber D E Position 1 1 P1 and P4 are installed by the backplane vendor 22 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Installing the board Caution The AG 2000C board is shipped in a protective anti static container Leave the board in its container until you are ready to install it Handle the board carefully and hold it only by its handles NMS recommends that you wear an anti static wrist strap connected to a good earth ground whenever you handle the board Complete the following steps to initially install an AG 2000C board Step Action 1 Turn off the computer and disconnect it from the power source This step is suggested for new configurations Note If you are replacing a board that is currently in the system refer to the NMS OAM System User s Manual for any restrictions 2 Choose a cha
100. s using the Natural Access Switching service or the swish utility Refer to the AG 2000C switching section for more information Refer to the Natural Access Developer s Reference Manual for details about Natural Access demonstration programs Dialogic Corporation 47 AG 2000C switching AG 2000C switch model This topic describes e The specific use of each stream as shown for H 110 streams and local streams e Anillustration of the AG 2000C switch model e Lucent T8100A switch blocking H 110 streams H 110 streams H 110 bus Streams clocked at 8 MHz timeslots 0 127 for all 32 streams Local streams Local stream Line interface voice in and out Streams 0 and 1 timeslot 0 7 0 15 or 0 23 Line interface signaling in and out Streams 2 and 3 timeslot 0 7 0 15 or 0 23 DSP voice in and out Streams 4 and 5 timeslot 0 7 0 15 or 0 23 DSP signaling in and out Streams 6 and 7 timeslot 0 7 0 15 or 0 23 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Switch model The following illustration shows the AG 2000C switch model H 110 bus CT DO 31 2 3 2 3 3 3 4 3 4 I 5 5 6 3 6 7 H 110 bus 7 L 8 9 8 10 10 iih a 12 I
101. s Manual for information about the syntax of NMS OAM board keyword files e Specify parameter settings with oamcfg Refer to the NMS OAM System User s Manual for information about oamcfg e Create a new board keyword file either with additional keywords or with keywords whose values override earlier settings e Specify the settings using OAM service functions Refer to the NMS OAM Service Developer s Reference Manual for more information You can oamsys to e Change which software module files are downloaded to the board at startup Refer to Specifying configuration file locations on page 34 for more information e Specify board switching e Configure CT bus clocking leo files A leo loadable extensible object file is a run module a modular extension to the core file The core file and the run modules make up the software that runs on the board s coprocessor The following eo files are included with AG 2000C File Description svc leo DSP function manager gtp leo Trunk protocol engine voice leo Play and record manager Specifying configuration file locations Files to be downloaded to the AG boards are specified with keywords in the AG board s keyword file For example DLMFiles 0 filename If filename contains a path specification NMS OAM searches for the file in the specified directory Otherwise NMS OAM searches for the file in the current working directory of ctdaemon If the file does not exist in t
102. s cfg By default oamsys looks for a file with this name when it starts up Refer to the NMS OAM System User s Manual for specific information on the syntax and structure of this file Note You can use the oamgen utility included with the NMS OAM software to create a sample system configuration file for your system The system configuration file created by oamgen may not be appropriate for your configuration You may need to make further modifications to the file before running oamsys to configure your boards based on the file For more information about oamgen refer to the NMS OAM System User s Manual The following table describes the AG board specific settings to include in the system configuration file for each AG board Keyword Description name Product Number Bus Slot File 32 Name of the board to be used to refer to the board in the software The board name must be unique Name of the board product Board number you use in the Natural Access application to refer to the board PCI bus number The bus slot location for each board must be unique PCI slot number The bus slot location for each board must be unique Name of the board keyword file containing settings for the board Several board keyword files are installed with the AG software one for each country or region Allowed values for AG boards Any string in square brackets AG 2000C Any integer from 0 to 31 Each board s
103. s primary master Capability Yes No Comments Serve as primary master Yes Use this board as a master only if no boards with digital trunks are present on the CT bus Drive A_CLOCK Yes Drive B_CLOCK Yes Available primary timing references Local trunk No Only digital trunks carry timing reference signals NETREF No This board cannot use NETREF as a timing reference NETREF2 No This board does not support NETREF2 OSC Yes Fallback to secondary timing No There is no timing reference to fallback to reference Slave to secondary master if No both references fail Dialogic Corporation 37 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Clocking capabilities as secondary master Capability Yes No Comments Serve as secondary Yes Use this board as a master only if no boards with digital trunks are master present on the CT bus Drive A CLOCK Yes If the primary master drives B CLOCK the secondary master drives A CLOCK Drive B CLOCK Yes If the primary master drives A CLOCK the secondary master drives B CLOCK Available secondary timing references Local trunk No Only digital trunks carry timing reference signals NETREF No This board cannot use NETREF as a timing reference NETREF2 No This board does not support NETREF2 OSC Yes Clocking capabilities as slave Capability Yes No Comments Serve as slave Yes Slave to Yes A CLOCK Slave to Yes B CLOCK Available fa
104. segment Syntax Clocking HBus Segment number Access Read Write Type Integer Default 1 Allowed values Non zero integer Example Clocking HBus Segment 1 Dialogic Corporation 81 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DLMFiles x Specifies a runtime component modular extension to the core file to be transferred to the board by the configuration file Syntax DLMFiles x filename x 0 63 Access Read Write Type String Default None Allowed values A valid file name Example DLMFiles 0 ag2fax leo Details A leo loadable extensible object file is a type of run module For AG boards the software that runs on the board coprocessor consists of the core file and any run modules The following eo files are included with and need to be configured with AG 2000C boards File name Description svc leo DSP function manager gtp leo Trunk protocol engine voice leo Play and record manager To use NaturalFax you must specify the NaturalFax run module to be downloaded to the board DLMFiles x is required for AG 2000C boards See also RunFile 82 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DSP C5x Lib Specifies the DSP library file for all DSPs on the board Syntax DSP C5x Lib filename Access Read Write Type File name Default ag2liba r54 if XQlaw A LAW ag2lib
105. simultaneously available to an application This topic lists default functions and custom functions available for AG 2000C boards Default functions The following functions are available in the default configuration files shipped with AG 2000C boards e DTMF detection e MF tone detection e Tone detection e Cleardown detection e Signal detection e NMS speech e Call progress detection e Tone generation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Custom functions The following functions can be loaded on AG 2000C boards with NMS OAM Caller ID Echo cancellation ADSI NMS speech normal NMS speech 1 5X NMS speech 2 0X OKI speech normal OKI speech 1 5X OKI speech 2 0X IMA DVI speech WAVE speech G 726 speech MS GSM speech The following functions can also reduce the board s standard port count of 24 118 Echo cancellation NMS speech 1 5X NMS speech 2 0X OKI speech 1 5X OKI speech 2 0X G 726 speech MS GSM speech Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DSP task processor files and processing power The binary code for running functions is contained in DSP files One or more functions are contained in each file NMS boards differ in the total number of DSPs they contain and the speed of their DSPs on the board DSP speed is measured in millions of instructions per second MIPS Each function that
106. ssis slot for the AG 2000C board Remove the access panels to the chassis slot both rear and front 3 Verify that the chassis slot has the appropriate keying 4 Slide the rear I O transition board into the rear of the chassis Warning Some older CompactPCI chassis may not have a rear I O connector alignment feature The rear I O transition board requires this feature to allow insertion Contact the chassis manufacturer to find out if your chassis supports this rear alignment feature Use caution when inserting the board into the backplane mating connector 5 Seat the rear I O transition board by rotating the top and bottom handles 6 Fasten the board to the chassis with the screws on the upper and lower handles 7 Slide the AG 2000C board into the corresponding slot in the front of the chassis 8 Seat the board into the backplane by rotating the top and bottom handles toward each other 9 Fasten the board to the chassis with the screws on the upper and lower handles Refer to the following illustration for a view of how the AG 2000C board and the rear I O transition board sit in the chassis 10 Replace the covers and connect the computer to its power source if you turned it off in Step 1 Dialogic Corporation 23 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Rear I O transition board AG 2000C board Backplane Trunks 5 8 Front Back of the TENE of the 17 20 chassis c
107. t locations e Telephone companies provide primary lightning protection for their telephone lines However if a site connects to private lines that leave the building make sure that external protection is provided As shown in the following illustration the end bracket on the AG 2000C rear I O transition board has an RJ 21 connector The connector has 25 pair interfaces RJ 21 connector TM Bo RJ 21 connector Dialogic Corporation 25 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual The connector is designed to accommodate a 25 pair cable As shown in the following illustration this cable is commonly wired to a punch down block or breakout box AG 2000C rear transition 2 bl 66 or 110 punch down block pair cable or breakout box Connecting the board The RJ 21 connector on the cable must be the 180 degree design The common 90 degree RJ 21 connector is not compatible with the AG 2000C board 90 RJ 21 connector 180 RJ 21 not compatible connector with AG 2000C compatible with boards AG 2000C boards 90 degree versus 180 degree RJ 21 connector The following illustration shows the pin locations for the RJ 21 connector on an AG 2000C rear I O transition board PEA 50h ius See RR Pin Pin 25 7 223 Pin 1 Connector pinout 26 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual
108. t to Specify whether the board is started or stopped automatically Specify the board location Specify information about the board Change the QSLAC file Set up test level information Modify memory allocation Set up clocking information Configure clock automatic fallback Set up information specific to NETREF Set up switching information Control switching on the echo canceller reference stream Configure DSPs Dialogic Corporation Use these keywords AutoStart AutoStop Location PCI Bus set in the oamsys cfg file Location PCI Slot set in the oamsys cfg file LoadFile LoadSize Name set in the oamsys cfg file Number set in the oamsys cfg file DLMFiles x RunFile TCPFiles x NetworkInterface Analog x ConfigFile BootDiagnosticLevel Buffers x Num Buffers x Size MaxChannels Clocking HBus ClockMode Clocking HBus ClockSource Clocking HBus Segment Clocking HBus AutoFallBack Clocking HBus FallBackClockSource Clocking HBus NetRefSource Clocking HBus NetRefSpeed SwitchConnections SwitchConnectMode Echo AutoSwitchingRefSource Echo EnableExternalPins DSP C5x x Image DSP C5x Lib DSP C5x Loader DSP C5x x Os DSP C5x x Files y SignalIdleCode VoicelIdleCode Xlaw 61 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Informational keywords You cannot edit the keywords listed in this topic Use these keywords for retrieving informatio
109. tPCI Media Board Installation and Developer s Manual Primary clock master Use the following board keywords to configure an AG 2000C board as a primary clock master Keyword Description Clocking HBus ClockMode Specifies the CT bus clock that the board drives This keyword must reference either A clock MASTER A or B clock MASTER B Clocking HBus ClockSource Specifies the source from which this board derives its timing Set this keyword to OSC Clocking HBus AutoFallBack Set this keyword to NO Note If the primary master s first source fails and then returns the board s timing reference and consequently the references for any slaves switches back to the first timing source This is not true for the secondary timing master Secondary clock master Use the following board keywords to configure an AG 2000C board as a secondary clock master Keyword Description Clocking HBus ClockMode Specifies the CT bus clock that the secondary master drives This keyword must reference the clock MASTER A or MASTER B not driven by the primary clock master Clocking HBus ClockSource Specifies the source from which this board derives its timing Set this keyword to the clocks driven by the primary clock master For example if the primary master drives A clock set this keyword to A CLOCK Clocking HBus AutoFallBack Enables or disables clock fallback on the board Set this keyword to YES Clocking HBus FallBackClockSource Specifies
110. tart line from a PBX or the public network as a test line to your System so you can call the test line from a telephone connected to another line To use ctatest Step 1 10 11 46 Action Make sure that the board keyword file includes the following statement for the board that you will be using TCPFiles x lpsO tcp where x the next available index If necessary edit the board keyword file Start ctatest The initial ctatest menu appears Enter oP to create a context and open the ADI service CTAEVN OPEN SERVICES DONE is displayed on your screen Start a protocol by entering SP The following message appears Enter protocol name nocc Enter the loop start protocol 1ps0 The following message appears Event NCCEVN START PROTOCOL DONE CTA REASON FINISHED Place a call to the line connected to the AG 2000C board The following message appears Event NCCEVN INCOMING CALL Initiate answering the call by entering AC The following message appears Number of rings 1 Press Enter You should hear a single ring tone The following messages appear Event NCCEVN ANSWERING CALL Event NCCEVN CALL CONNECTED NCC CON ANSWERED Begin recording to memory by entering RM You should hear a beep on the handset Say Hello World and wait The following message appears on the screen you may see a different number of bytes Event VCEEVN RECORD DONE Voice End msec 3820 Play back your vo
111. the alternate timing reference to use when the master clock does not function properly Set this keyword to OSC Note If the primary master s timing reference recovers the secondary master continues to drive the clock referenced by all clock slaves in the system until the application intervenes Clock slave Use the following board keywords to configure an AG 2000C board as a clock slave Keyword Description Clocking HBus ClockMode Specifies the CT bus clock from which the board derives its timing Set this keyword to SLAVE to indicate that the board does not drive any CT bus clock Clocking HBus ClockSource Specifies the source from which this clock derives its timing Set this keyword to reference the clock driven by the primary clock master Clocking HBus AutoFallBack Enables or disables clock fallback on the board Clocking HBus FallBackClockSource Specifies the alternate clock reference to use when the master clock does not function properly For clock slaves set this keyword to reference the clock A CLOCK or B CLOCK driven by the secondary clock master 40 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Standalone mode To configure an AG 2000C board in standalone mode so the board references its own clocking information set Clocking HBus ClockMode to STANDALONE and set Clocking HBus ClockSource to OSC The board then uses its own oscillator as a timing signal refere
112. timeslot args deviceid MVIP95 ANALOG LINE DEVICE args parameterid Jane JONES CXNXIUN GB rc swiGetLocalTimeslotInfo CT Access switch handle swihd target device and config item amp args buffer defined by parameterid void amp device buffer size in bytes sizeof device gain_dB device gain 1000 return rc The following sample code shows how to retrieve line gain applied to a signal transmitted to the network include swidef h CT Access Switching service anf include mvip95 h MVIP 95 definitions a include nmshw h NMS hardware specific definitions DWORD myGetTransmitGain SWIHD swihd SWI TERMINUS terminus INT32 gain_dB SWI_LOCALTIMESLOT_ARGS args NMS_LINE_GAIN_PARMS device DWORD EG m args localstream terminus stream args localtimeslot terminus timeslot args deviceid MVIP95 ANALOG LINE DEVICE args parameterid SSMUS IO USO CASE rc swiGetLocalTimeslotInfo CT Access switch handle swihd target device and config item amp args buffer defined by parameterid void amp device buffer size in bytes sizeof device gain_dB device gain 1000 ESCU TCS Dialogic Corporation 55 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Setting the line gain Use swiConfigLocalTimeslot to set the the input or output line gain Set the arguments for this functio
113. tion must be verbal DC tip to ring resistance gt 1 M Ohms Audio tip to ring impedance 10 k Ohms Typical receive audio loss 11 dB 0 dB line gain and 600 termination The impedance of the agent s telephone and length of loop cable will affect the audio loss QSLAC files and impedances The QSLAC files that start with the characters a2usa provide an input impedance of 600 Ohms 2 2 uF However a selection of files is provided to permit applications that do not use echo cancellation to reduce echo The default file is sufficient for most applications For more information refer to Configuring and starting the system with oamsys on page 30 114 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Compliance and regulatory certification In addition to the approval obtained by NMS for the board and its associated software some countries require a system level approval before connecting the system to the public network To learn what approvals you require contact the appropriate regulatory authority in the target country This topic describes the following compliance and regulatory information e EMC e Safety e Telecom e EU R amp TTE statement EMC US FCC Part 15 Subpart J Class A with unshielded cable Canada IECS 003 Class A with unshielded cable EU countries EN 55022 1998 EN 55024 1998 Other countries Refer to the NMS web site www nmscommunicat
114. u r54 if Xlaw MU LAW Allowed values A valid file name Example DSP C5x Lib ag2liba r54 See also DSP C5x x Os Dialogic Corporation 83 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual DSP C5x Loader Specifies the module to load DSP functions for boards Syntax DSP C5x Loader filename Access Read Write Type File name Default ag2boot b54 Allowed values A valid file name Example DSP C5x Loader special b54 Details The naming convention for DSP loader files is filename b54 See also DSP C5x Lib 84 Dialogic Corporation DSP C5x x Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Files y Specifies the name or the ID of a DSP file that targets a specific DSP Syntax DSP C5x x Files y filename x 0 3 y file number Access Read Write Type File name Default None Allowed values A valid file name Example DSP Cos 0 ae Files 0 callp m54 Details These files are automatically distributed among the various DSPs by the AG plug in according to internal rules The naming convention for files is filename m54 The following DSP files are available DSP file adsir _j m54 adsix _j m54 callp m54 dtmf m54 dtmfe m54 Description Contains the caller ID function that decodes the modem burst that occurs between the first and second rings on a loop start line In addition it
115. ve m54 wave m54 Function NMS Play 32 6 kHz 1 5X NMS Play 64 6 kHz 1 5X NMS Play 16 6 kHz 2 0X NMS Play 24 6 kHz 2 0X NMS Play 32 6 kHz 2 0X NMS Play 64 6 kHz 2 0X NMS Record 16 Kbit s NMS Record 24 Kbit s NMS Record 32 Kbit s NMS Record 64 Kbit s WAVE Play 11 kHz 8 bit WAVE Play 11 kHz 16 bit WAVE Record 11 kHz 8 bit WAVE Record 11 kHz 16 bit MIPS 5 81 2 31 7 19 7 50 7 44 2 81 3 38 3 38 3 38 0 63 1 56 1 44 1 5 1 13 Related API function adiStartPlaying adiStartPlaying adiStartPlaying adiStartPlaying adiStartPlaying adiStartPlaying adiStartRecording adiStartRecording adiStartRecording adiStartRecording adiStartPlaying adiStartPlaying adiStartRecording adiStartRecording Related arguments encoding ADI ENCODE NMS 32 maxspeed 150 encoding ADI_ENCODE_NMS_ 64 maxspeed 150 encoding ADI ENCODE NMS 16 maxspeed 200 encoding ADI ENCODE NMS 24 maxspeed 200 encoding ADI ENCODE NMS 32 maxspeed 200 encoding ADI_ENCODE_NMS_ 64 maxspeed 200 encoding ADI ENCODE NMS 16 encoding ADI ENCODE NMS 24 encoding ADI_ENCODE_NMS_32 encoding ADI ENCODE NMS 64 encoding ADI ENCODE PCM11M8 encoding ADI ENCODE PCM11M16 encoding ADI ENCODE PCM11M8 encoding ADI_ENCODE_PCM11M16 The following table shows the correspondence between the filter and
116. x bitmask To take line off hook To put line on hook A bit 0x08 0x08 0 If you reset the switch all bits are set to O 128 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Loop start receive signaling Depending on how the transmitted signaling A bit is set the line has been placed on hook or off hook Depending on the hook state the received signaling A bit acts either as a ring signal detector or a loop current indicator When the line is on hook monitoring the A bit tells you if the line is ringing When the line is off hook monitoring the A bit indicates whether there is loop current flowing The B bit indicates the polarity of tip and ring If the B bit is set to 1 the loop current direction is reverse Bits C and D are reserved and should be ignored Regulations require that loop start equipment must function regardless of idle state polarity The B bit normal state is undefined The information in the B bit is in the change of state The following illustration shows receive signaling for loop start line interfaces A B C D Reserved Should be ignored Reserved Loop r 0 Tip positive with respect to ring current 1 Ti ti ith t to ri direction ip negative with respect to ring Line is on hook r 0 No ringing detected ring detector 1 Ringing detected Line status Line is off hoo
117. ype Filename Default Filename Where used a2usals6 sic Default Loop start for 600 Ohm PBXs in North America and South America a2canls6 slc Loop start for 600 Ohm PBXs in Canada a2jpnls6 slc Loop start for 600 Ohm PBXs in Japan a2usals9 slc Loop start for 900 Ohm PBXs in North America and South America a2canls9 slc Loop start for 900 Ohm PBXs in Canada a2jpnls9 slc Loop start for 900 Ohm PBXs in Japan a2usalsn slc PSTN connections in North America and South America a2canlsn slc PSTN connections in Canada a2jpnlsn slc PSTN connections in Japan a2eurlsc slc PSTN connections in the EU countries a2auslsc slc PSTN connections for Australia Allowed values Valid QSLAC file name Example NetworkInterface Analog 0 23 ConfigFile a2usals9 slc 98 Dialogic Corporation Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Number Specifies the logical board number for this board Syntax Number xxx Access Read Write Type Integer Default 0 Allowed values 0 31 Example Number 0 Details NMS OAM creates a board number that is guaranteed to be unique within a chassis You can override this value See also Name Dialogic Corporation 99 Dialogic AG 2000C CompactPCI Media Board Installation and Developer s Manual Products x At the AG plug in level indicates the product types supported by the plug in Syntax Products x product type Ac

Dialogic® AG 2000C CompactPCI Media Board Installation and

Contents

Download Pdf Manuals

Related Search

Related Contents

Dialogic&reg; AG 2000C CompactPCI Media Board Installation and

Contents

Download Pdf Manuals

Related Search

Related Contents

Dialogic® AG 2000C CompactPCI Media Board Installation and