- Dialogic
Contents
1. T1 trunk 5 23 B channels 1 D channel for trunks in NFAS group 2 If your application uses NMS ISDN software in a channelized configuration all trunks in an NFAS group must be on the same board An NFAS group cannot contain trunks from multiple boards This restriction does not apply to the ACU or LAPD configurations 34 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual NFAS groups with hot swap configurations If an NFAS group spans multiple boards in a Hot Swap system and you remove or insert a board while the system is running the NMS ISDN protocol stacks on the other boards are not affected If you remove a board containing only B channels the stack on the D channel board does not sense that the board is missing It is the application s responsibility to sense this change and take appropriate action to not access B channels on that board Specifying NFAS groups in board keyword files To group T1 trunks into NFAS groups your board keyword file must contain information regarding the NFAS specific tasks the trunks will perform To accomplish this add the keywords described in this topic to your board keyword file for the trunk that carries the primary D channel When you set up NFAS groups make sure to correctly set the NetworkInterface T1E1 x SignalingType keyword for each trunk as described in Configuring data routing on page 32 Note These keywords are required on2. oki play 24 150 oki play 24 200 Y oki ree 32 amp Ola Play 39 100 oki play 39 1359 oki play 32 299 ima rec 24 amp ima play 24 ima rec 32 amp ima pllay 32 gsm ms frgsm rec amp gsm ms frgsm play N g726 rec_32 g726 play 32 DebugMask 0x0 Sample configuration for a single AG 4000 board The following sample board keyword file describes a single AG 4000 board configured for the AT amp T 4ESS ISDN variant on a T1 trunk using extended superframe format ESF The application is designed to access ISDN services in a channelized configuration using Natural Call Control Originally created from input file agi4tl cfg Detailed board settings for Product AG_4000_4T1 aoe eee re emma aa eee ie S S ILL TCPFiles 0 nocc tcp no trunk control protocol TCPFiles 1 isd0 tcp DLMFiles 0 gtp leo DLMFiles 1 voice leo DLMFiles 2 svc leo Uncomment the appropriate leo file DLMFiles 3 isdn4ess leo use with AT amp T 4ESS DLMFiles 3 isdn5ess leo use with AT amp T 5ESS DLMFiles 3 isdndms leo use with Northern Telecom DMS100 DLMFiles 3 isdnhkt leo use with Hong Kong Telephone DLMFiles 3 isdnntt leo use with Nippon Telegraph Telephone DLMFiles 3 isdnni2 leo use with US National ISDN 2 DLMFiles 3 isdntwn leo use with Taiwanese Operator DLMFiles 4 imgt leo required if using IMGT service XLaw MU LAW Cloc
3. ISDN NFAS Member 1 Trunk 3 NetworkInterface T1E1 2 ISDN NFAS Member 1 NAI 6 DSIPACosaO s SET ede MU LAW DSP 2CSs 0 Piles qtsignal DSP Gos LT 511 ET 18s voice tone dtmf echo rvoice callp ptf wave oki ima gsm ms g726 mf Resource 0 Name RSC1 Resource 0 Size 120 Resource 0 TCPs nocc isd0 FEAE HE a aH EH HE aE HE HE aE AE HE FE FE aE aE EE aE EE aE aE aE EE aE EEE EE EE Before modifying this resource definition string refer to the CG6000 Installation and Developers Manual HH HH HH HE FE EH AE HE FE FE TE HE a EE EH HE EE EE aE EE EE EE E E E E EEE EH Resource 0 Definitions chemi cet cull amp eono IZ cyu75 amp iit Cle 2E amp tone gen amp callp gne amp ptf det 4f amp rvoice rec mulaw amp rvoice play mulaw rvoice rec alaw amp rvoice play alaw Dialogic Corporation 27 Dialogic NaturalAccess ISDN Software Installation Manual rvoice rec lin amp rvoice play lin voice tee le voice Pilay JG 100 voice mlay 16 359 voice elay 36 29999 voice rec 24 amp voice play 24 100 voice play 24 150 voice play 24 200 voice stee _32 amp voice allay 32_100 voice miley 32 150 voice mlay 32 200 voice rec_64 amp voice play 64 100 voice play 64 150 voice play 64 200 wave rec 11 16b amp wave play 11 16b wave rec 11 8b amp wave play 11 8b oki ree_24 amp oki play 24 100
4. 39 After you create and edit these files load them into the NMS OAM configuration database by running the oamsys utility Running oamsys describes this step The following illustration shows the process by which configuration files are sent to oamsys to create the NMS OAM configuration database System configuration file Keyword file oamsys cfg filea cfg Board A TCPFILE 0 isd0 ds E NM Number Bus 0 Slot 20 File filea cfg Country USA NMS OAM oamsys configuration Board B database Product CG6000 QUAD Keyword file ber 2 fileb cfg Bus 0 Slot 21 TCPFILE 0 isd0 Country USA File fileb cfg Supervisor Aut artEnabled Yes utoStopEnabled Yes Dialogic Corporation 21 Dialogic NaturalAccess ISDN Software Installation Manual After oamsys creates records in the NMS OAM configuration database it starts and configures boards in your system according to the information now present in the database Creating board keyword files A board keyword file contains a list of parameters and values used to configure a board One board keyword file is assigned to each board When oamsys runs it creates a record for each board in the NMS OAM database NMS ISDN and Natural Access install a set of example board keyword files To create a board keyword file for your setup edit the appropriate example file installed on the sy
5. BRI channel This setting routes D channel information on the trunk to the HDLC controllers and routes B channel information to DSP resources Trunk does not RAW carry D channel This setting routes B channel information only If MVIP switching is enabled routing does not take place regardless of the NetworkInterface T1E1 x SignalingType setting Instead your application must make the appropriate MVIP switch settings as described in the NMS ISDN for Natural Call Control Developer s Manual and NMS ISDN Messaging API Developer s Reference Manual Setting up NFAS groups In systems with multiple T1 ISDN trunks a non facility associated signaling NFAS configuration can be used This topic describes e Non facility associated signaling NFAS e NFAS groups with hot swap configurations e Specifying NFAS groups in board keyword files e D channel backup 32 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual Data on a T1 trunk is transmitted in channels For primary rate ISDN T1 carries 24 channels With primary rate ISDN e 23 of the 24 channels carry voice audio data and video signals These channels are called bearer channels B channels e Ona Tl trunk one channel carries signaling for all B channels This is called the D channel On T1 trunks the D channel is typically carried in channel 24 See the following illustration T1 trunk 0 23 B channels 1 D channel for these c
6. DEH Natural Access 2005 1 SP 1 LBG NaturalAccess R9 0 Refer to www dialogic com for product updates and for information about support policies warranty information and service offerings Table Of Contents Chapter 1 Introduction ccccsscseeseeseesseeeeeeeeeeeeeeeeeneeeeeaeeeseaseaseaseaseasessenseenenees 7 Chapter 2 Terminology eeeeeeee eee een enne nn enne nne n nenne unum u nana nuu unn 9 Chapter 3 Overview of NMS ISDN neeseseesese unen annuae annua uan 11 NMS ISDN software OVErViCW c cece cece eee eter eee eee eee sene enne 11 NMS ISDN software components cceecce cece eee ee eee ee nennen nennen 12 readme TG ccacay Mn 12 NMS ISDN function libraries eirca err ra eer eh en entr cane vee vts 12 Header 4 MI IM 13 Downloadable object modules sssssssssssssess enm 13 Demonstration programs ccccee cece emnes n sees nennen nn n nnn 14 Trunk control program TCP ccceee eee e eee e ee eee eee esee enses ensem 14 Parameter TIES eM TEES 15 Related products eere RR REX EHE XR dea RERO RI REVUE aa DENN ERERRUE TN RE MERE Kei eee 16 Natural ACCESS TB 16 NMS OAM enia E ENAA E AEE ET E EN 16 NMS OAM and the configuration files ssssssssssssssssrnrrsrerrnrrnrsrrnrnnrnnerrnnnneran 17 Steps for developing an NMS ISDN application sssssssssessssssrnsrrrrrrrrrrrrrrrrrrsrrss 19 Chapter 4 Preparing the system for ISDN development 2
7. E FE FE FE FE HE FE FE FE TE FE FE E FE FE FE TE HE FE E FE TE FE FE HE FE EFE E H HEHEHE HEE Before modifying this resource definition string refer to the CG6000 Installation and Developers Manual HERE FE AE FE TE HE FE E FE HERES HEE FE E FE FE FE TE HE EEE HEE HE HERE EEE EEE TREE Resource 0 Definitions cimi cet alll amp echo Lm20 apt amp joer CeT 2 amp COne gen i callp gne amp ptf det 4f amp rvoice rec mulaw amp rvoice play mulaw rvoice rec alaw amp rvoice play alaw rvoice rec lin amp rvoice play lin voice rec 16 amp voice play 16 100 voice play 16 150 voice play 16 200 voXce rec 24 amp voice play 24 100 l l voice play 24 150 voice play 24 200 voice ree 32 Voice olay 32 100 L2 e A E Dialogic Corporation 23 Dialogic NaturalAccess ISDN Software Installation Manual voice play_32_150 voice play 32 200 N voice rec_64 amp voice play_64_100 voice play 64 150 N voice play 64 200 wave rec_11_16b amp wave play_ iit 69 wave rec_ HE _8b amp wave play_11 _8b oki rec 24 T oki play 24 100 oki play 24 150 oki play 24 200 N Ola eee atomi MENO Oli jollesy 32 150 Oli play Sg 200 ima rec_24 amp ima play 24 ima rec_32 amp ima play 32 gsm_ms frgsm rec amp gsm ms frgsm play gue cerecE SA NEP ME NN DLMFiles 0 cg6krun DLMFiles 1 isdnetsi
8. Station Interface Board Dialogic AG 2000 PCI Media Board Dialogic AG 2000C CompactPCI Media Board Dialogic AG 2000 BRI Media Board Dialogic NaturalAccess 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 NaturalAccess ISDN Software Installation 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 10 Dialogic terminology Dialogic NaturalAccess Point to Point Switching API Dialogic NaturalAccess Switching Interface API Dialogic NaturalA
9. This method is often useful if the board configurations are identical except for one or two parameters such as clocking information If you need to determine configuration information for the boards use the pciscan utility This utility identifies the NMS Communications PCI boards installed in the system and returns each board s bus slot interrupt and board type For more information about pciscan refer to the NMS OAM System User s Manual The system configuration file you create must be named oamsys cfg This is the file name oamsys looks for by default Sample system configuration file The following sample system configuration file describes a CG 6000C board and an AG 4000C board My_CG_Board Product CG_6000C_QUAD Number 0 Bus 0 SIOE 15 File c nms cg cfg mycgbrd cfg Clocking HBus ClockMode MASTER_A Clocking HBus ClockSource OSC My 4000 Board Product AG 4000C 2T1 Number 1 Bus 0 SIOE 16 File c nms ag cfg my40brd cfg Clocking HBus ClockMode SLAVE Clocking HBus ClockSource A_CLOCK The CG 6000C board is assigned board number 0 and is located at bus O slot 15 It is assigned a keyword file named mycgbrd cfg It is set up as the primary H 100 bus clock master using its on board oscillator as its timing reference Dialogic Corporation 39 Dialogic NaturalAccess ISDN Software Installation Manual The AG 4000C board is assigned board number 1 and is located at bus 0 slo
10. binary parameter files pf files for the target country must be in one of the directories specified with the AGLOAD environment variable nccxisdn pf must also be in this directory When you install NMS ISDN the installation program asks you to specify a default country It creates copies of the country specific parameter files for that country renames them and places them in the AGLOAD path as follows These files In this operating Are copied to system nccxadicty pf Windows nms ag cfg nccxadi pf nccxadicty par nms ctaccess cfg nccxadi par ted is the code for the default UNIX opt nms ag cfg nccxadi pf opt nms ctaccess cfg nccxadi par nccstartcty pf Windows nms ag cfg nccstart pf nccstartcty par nms ag ctaccess nccstart par UNIX opt nms ag cfg nccstart pf opt nms ctaccess cfg nccstart par necxisdn pf Windows nms ag cfg nccxisdn pf nccxisdn par nms ctaccess cfg nccxisdn par UNIX opt nms ag cfg nccxisdn pf opt nms ctaccess cfg nccxisdn par Dialogic Corporation 15 Dialogic NaturalAccess ISDN Software Installation Manual Ensure that only one set of files is copied to the AGLOAD directory If the directory contains two sets or parameter files the parameters will not load Changing parameter values To change parameter values in a pf file modify the value in the corresponding par file Then load the changes as follows Step Action 1 Parse the par file 2 Set parameters in one of the follow
11. keywords DLMFiles isdnqsig DLMFiles isdn5ess DLMFiles isdndms DLMFiles isdnni2 DLMFiles isdnhkt DLMFiles isdnntt DLMFiles isdntwn DLMFiles 2 imgt DebugMask 0x0 Sample configuration involving NFAS groups The following sample board keyword file describes an CG T1 board configured for AT amp T 4ESS ISDN variant on a T1 trunk using ESF The application is designed to access ISDN services in a channelized configuration using Natural Call Control There are two NFAS groups Group 5 contains trunks 0 and 1 Group 3 contains trunks 2 and 3 Trunk O carries the D channel for Group 5 Trunk 2 carries the D channel for Group 3 This file configures the board to run ISDN with NFAS for CG 6000 board TCPFiles nocc isd0 DLMFiles 0 cg6krun For USA ISDN configurations uncomment one of the DMSFile 1 keywords DLMFiles 1 isdn4ess DLMFiles 1 isdnqsig DLMFiles 1 isdnSess DLMFiles 1 isdndms DLMFiles 1 isdnni2 Required if using IMGT service DLMFile 2 imgt Clocking HBus ClockMode STANDALONE Clocking HBus ClockSource OSC Clocking HBus ClockSourceNetwork 1 Dialogic Corporation 25 Dialogic NaturalAccess ISDN Software Installation Manual DSPStream VoiceIdleCode 0 3 Ox7F DSPStream SignalldleCode 0 3 0x00 There are 3 HDLC controller cores per network interface PRI configurations use only one of the three HDLC cores on each network interface For PRI configure Hd
12. 1 Installing NMS ISDN software sssssssesrrrrsserrnrnsrurrrnnnrurrnrnnnnrnnnnnunrrnnnnunnrrnnne 21 Running the system with NMS OAM ssssssse memes senes 21 Creating board keyword fileS sriissise srs cece eee a a a a R a 22 Sample board keyword files ccceeceee eee eee eee emnes mene 23 Sample configuration for a CG 6000C E1 DOA eee cee eee eee tees tees nnn 23 Sample configuration for a CG 6000C T1 DOAF cece cee eee esse tees mnn 24 Sample configuration involving NFAS groups seessem 25 Sample configuration for a single AG 4000 board eceeee cece eee ee teat ee eee eee 28 Sample configuration for an AG 2000 BRI board cc ceeceesee ee eeeeeneeeeeeeaeeeas 29 Configuring on board software for NMS ISDN cceeeeeee eee e eee ee nesses eeeeaeeae ees 30 DSPC5x x Files 1 er AEE E E RRSEERED CENE OQOUC OUR EB ERE UK RU Te YR URREA e 30 s BRulsi bdsPcImc ERR 30 TCP ld E I TL 32 Configuring data routing erri rent t hm ex Rn UR RO RR AU i LR RR RR 32 Setting Up NFAS groups ciae reme nire ntu gag s n era ex vega Edad ri gn 32 Non facility associated signaling NFAS ccceceeeee eee eee ee ee seen ee eea nena ened 34 NFAS groups with hot swap configurations ceeceeeeee ee eee teeta emm 35 Specifying NFAS groups in board keyword files ccceccceee eee e eee eeee eee eeeeeaeeens 35 D channel backup eii crier ce din nua aaa Edna ives cede Vu CENAA 37 C
13. 11 components 12 configurations 12 demonstration programs 14 developing applications 19 downloadable object modules 13 function libraries 12 header files 13 parameter files 15 readme file 12 specifications 45 45 variants 30 45 45 Oo OAM 16 21 39 47 Dialogic NaturalAccess ISDN Software Installation Manual oamsys 40 board keyword file 22 running oamsys 40 running the system with NMS OAM 21 system configuration file 39 P parameter settings 41 parameter values 15 PRI run modules 31 PRI variants and specifications 45 R related products 16 run modules 30 48 running the system with OAM 21 S sample board keyword files 23 setting up NFAS groups 32 specifications 45 45 46 system configuration file 39 T TCPFiles x 31 trunk control program TCP 14 U utilities 21 39 V variants 30 45 45 verifying the installation 43 Dialogic Corporation
14. 11 Write the application e NMS ISDN for Natural Call Control Developer s Manual e NMS ISDN Messaging API Developer s Reference Manual e NMS ISDN Management API Developer s Reference Manual e The Natural Access documentation set Dialogic Corporation 19 Preparing the system for ISDN development Installing NMS ISDN software Install NMS ISDN software from a package downloaded from the NMS Communications web site www nmscommunications com To install the software this way follow the instructions on the web site to download and decompress the package Running the system with NMS OAM To be configured and started correctly each board you install must have a separate set of configuration parameters and values entered into the NMS OAM configuration database See NMS OAM on page 16 for details Parameters and their assigned values are expressed as a keyword name and value pair for example Encoding MU LAW These configuration settings are specified in two types of files File type Description Board keyword NMS OAM board keyword files contain parameters to configure the board These settings are expressed as keyword name and value pairs See Creating board keyword files on page 22 r T System NMS OAM system configuration files contain a list of boards in the system and the configuration name of one or more board keyword files for each board See Creating a system configuration file for oamsys on page
15. Dialogic Making Innovation Thrive Dialogic NaturalAccess ISDN Software Installation Manual October 2009 64 0507 01 www dialogic com Copyright and legal notices Copyright 2000 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 PURPOSE MERCHANTABILITY OR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHT OF A THIRD PARTY
16. Dialogic NaturalAccess ISDN Software Installation Manual Parameter files NMS ISDN software includes several files that contain parameters and values to configure the NMS ISDN TCP Some of these parameters are country specific different values are supplied for them depending upon the target country Country specific parameter files are useful only if you are configuring the NMS ISDN software in channelized configuration For more information see the NMS ISDN for Natural Call Control Developer s Manual Three types of parameter files are installed with each NMS ISDN package for use with the NCC service File type and name Description nccxadicty pf Binary parameter files containing a set of country nccstartcty pf specific values for NCC service parameters Note Most of the values in these files should not be changed Changing certain values may affect the regulatory approvals in the target country cty is the three character code of the target country For example the code for Australia is aus Thus the versions of these files for Australia are nccxadiaus pf and nccstartaus pf nccxisdn pf A binary parameter file containing a set of NMS ISDN parameters and default values These values can safely be changed without affecting the regulatory approvals in the target country nccxadicty par ASCII versions of the binary files nccstartcty par nccxisdn par For Natural Access to load the binary parameter file both of the
17. 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 Dialogic encourages all users of its products to procure all necessary intellectual property licen
18. FAS is used the reliability of the signaling performance for the ISDN interfaces controlled by the D channel can be improved by creating a standby D channel the D channel backup The D channel backup feature transfers most of the signaling information to the backup D channel enabling continued access to the ISDN network if the primary D channel fails The backup D channel must exist on a different trunk than the primary D channel as shown in the following illustration T1 trunk 0 24 B channels member of NFAS group 1 T1 trunk 1 24 B channels member of NFAS group 1 T1 trunk 2 24 B channels member of NFAS group 1 CG board T1 trunk 3 24 B channels member of NFAS group 1 T1 trunk 4 24 B channels member of NFAS group 1 AG 4000 board T1 trunk 5 CG board 23 B channels 1 D channel for trunks in NFAS group 1 T1 trunk 6 24 B channels member of NFAS group 1 T1 trunk 7 24 B channels member of NFAS group 1 T1 trunk 8 23 B channels backup D channel for trunks in NFAS group 1 At any point in time only one D channel conveys B channel signaling information The other D channel remains in a standby mode and is only active at the LAPD layer layer 2 While the backup D channel is on standby any layer 3 messages received on it are ignored Neither D channel can serve as a B channel while designated as a b
19. For other ISDN configurations uncomment one of the DMSFile 1 keywords DLMFiles 1 isdnvn6 DLMFiles 1 isdnqsig DLMFiles 1 isdnausl DLMFiles 1 isdnkor DebugMask 0x0 Sample configuration for a CG 6000C T1 board The following sample board keyword file describes a single CG 6000C T1 board using the NOCC protocol cqi6tl cfq CG 6000 configuration file This file configures the board to run NMSVoice with NOCC Clocking HBus ClockMode STANDALONE Clocking HBus ClockSource OSC Clocking HBus ClockSourceNetwork 1 TCPFiles nocc isd0 DSPStream VoiceIdleCode 0 3 Ox7F DSPStream SignalldleCode 0 3 0x00 stelle E07 3 6 9 c1Srexoxe YES Heeler OS Co lle omejteseimesols 23 Hdlc 0 3 6 9 Comet RxTimeSlot 23 NetworkInterface TY3ET 0 3 Type T1 NetworkInterface T1E1 0 3 Impedance DSX1 NetworkInterface T1E1 0 3 LineCode B8ZS NetworkInterface T1E1 0 3 FrameType ESF NetworkInterface T1E1 0 3 SignalingType PRI NetworkInterface T1E1 0 3 D Channel ISDN DSP CSA TONTONEN aw MU_LAW DSP C5x 1 31 Files voice tone dtmf echo rvoice callp ptf wave oki ima gsm ms g726 mf DSP C5x 0 Files qtsignal tone dtmf echo NULL NULL NULL Resource 0 Name RSC Resource 0 Size 120 Resource 0 TCPs noce 38d HEHEHE EE EHEHHE HH FEFE AE HE FE FE FE TE HE FE E FE FE FE FE HE FE FE FE TE HE FE FE FE FE FE FE HE FE E FE TE HE FE EEE Before modifying this resource definition string refer to
20. NTT Dialogic Corporation Specification ETS 300 102 1 December 1990 and Amendment ETS 300 102 1 A2 October 1993 CSE P 10 21A June 1994 INS NET 64 March 1993 45 Dialogic NaturalAccess ISDN Software Installation Manual Other common channel signaling protocols Network protocol variant Specification BTNR 188 Issue 6 January 1995 46 Dialogic Corporation Index A AG 4000 board 28 AGLOAD environment variable 15 40 B bearer B channel 37 board keyword files 23 AG 2000 BRI 29 AG 4000 28 and NFAS groups 25 CG 6000C E1 23 CG 6000C T1 24 creating 22 data routing 32 relation to NMS OAM 17 BRI run modules 31 BRI variants and specifications 45 C CG 6000C board 23 24 configuration parameter settings 41 configuring data routing 32 configuring on board software for NMS ISDN 30 D D channel backup 37 data routing configuration 32 dectrace 14 demonstration programs 14 43 developing an NMS ISDN application 19 DLMFiles x 30 DPNSS specifications 46 DSP C5x x Files 30 I imgtdemo 14 Dialogic Corporation installation overview 21 installation verification 43 ISDN NMS 11 12 isdncta 14 isdndemo 43 43 isdnncc 14 itrace 14 K keyword file samples 23 L lapddemo 14 N NAI numbers 36 Natural Access 16 network access identifier number 36 NFAS groups 32 described 34 specifying in board keyword files 35 with hot swap configurations 35 NMS ISDN 11 compatible boards
21. These sample files are similar to the files provided with your software This topic includes the following sample board keyword files e CG 6000C E1 board e CG 6000C T1 board e NFAS groups e AG 4000 board e AG 2000 BRI board Sample configuration for a CG 6000C E1 board The following sample board keyword file describes a single CG 6000C E1 board that is using the NOCC protocol cgi6el cfg CG 6000 configuration file This file configures the board to run NMSVoice with NOCC Clocking HBus ClockMode STANDALONE Clocking HBus ClockSource OSC Clocking HBus ClockSourceNetwork 1 TCPFiles nocc isd0 DSPStream VoiceIdleCode 0 3 0x54 DSPStream SignalldleCode 0 3 0x09 ine Op Spo Ell EGO YES Hdlce 0 3 6 9 Comet TxTimeSlot 16 Hdlce 0 3 6 9 Comet RxTimeSlot 16 NetworkInterface T1E1 0 3 Type El NetworkInterface T1E1 0 3 Impedance ECHO SEIFAONOHM NetworkInterface T1E1 0 3 LineCode HDB3 NetworkInterface TIET 0 3 FrameType CEPT NetworkInterface T1E1 0 3 SignalingType PR NetworkInterface T1E1 0 3 D Channel ISDN DIS Sc O 5 Sl BESSEREN cg6kliba DS Pe Cosa TON S TNT SETA A LAW DSP C5x 1 31 Files voice tone dtmf echo rvoice callp ptf wave oki ima gsm ms g726 mf DSP C5x 0 Files gtsignal tone dtmf echo NULL NULL NULL Resource 0 Name RSC Resource 0 Size 120 Resource 0 TCPs nocc isd0 FEFE AE HE FE FE FE TE HE FE E FE TE FE FE HE FE FE FE TE HE FE
22. ackup D channel Each primary backup D channel pair provides signaling only for the set of B channels within a specific NFAS group and cannot backup any other D channels in a different group When both D channels are out of service the first D channel has priority as the channel to carry call control signaling If the first D channel cannot be established the backup D channel is chosen Dialogic Corporation 37 Dialogic NaturalAccess ISDN Software Installation Manual To configure D channel backup edit the board keyword file as described in Configuring data routing on page 32 Then set the keywords as follows For Set Set trunk s NetworkInterface T1E1 x D CHANNEL NetworkInterface T1E1 x SignalingType with to to Primary ISDN PRI or BRI D channel Backup D ISDN_NONE PRI or BRI channel Only B ISDN_NONE RAW channels Both primary and backup D channels must be defined on the same board and belong to the same NFAS group Set NetworkInterface T1E1 x ISDN SignalingType to PRI or BRI where applicable for both D channels Set the Networkinterface T1E1 x ISDN D_Channel_Backup_Trunk keyword to enable D channel backup For example NetworkInterface T1E1 x ISDN D_Channel_ Backup Trunk trunkno where trunkno is the number of the trunk to perform D channel backup When you start ISDN with Natural Access you must enable option t309 in the ISDN_PROTOCOL_PARMS_Q931CC or ISDN_PROTOCOL_PARMS_CHANNELIZED structure w
23. alia 31 Dialogic NaturalAccess ISDN Software Installation Manual TCPFiles x The TCPFiles x keyword specifies a TCP to be downloaded to the board For NMS ISDN installations specify one of the following TCPs according to the layer from which the application accesses ISDN services Specify this TCP If isdO tcp NMS ISDN protocol stack runs in channelized configuration nocc tcp NMS ISDN protocol stack runs in ACU or LAPD configuration nocc tcp sets up your system for call control to be handled by the host application instead of by the TCP Because this keyword applies to all boards in an NMS ISDN system specify this value in each board keyword file For more information about the ISDN TCP file see Trunk control program TCP on page 14 Configuring data routing Use the NetworkInterface T1E1 x SignalingType where x is the number of a trunk keyword to configure routing of voice and signaling information between trunks and DSPs Set this keyword as follows e If you are not setting up NFAS groups set NetworkInterface T1E1 x SignalingType to PRI or BRI if applicable for each board in your system This setting routes D channel information on each trunk to the HDLC controllers and routes B channel information to DSP resources e If you are setting up NFAS groups set NetworkInterface T1E1 x SignalingType as follows If the Set NetworkInterface T1Ei1 x SignalingType to Trunk carries D PRI or
24. and other operations using Natural Call Control NCC For more information about this configuration see the NMS ISDN for Natural Call Control Developer s Manual ACU The application accesses ISDN services at the ACU SAP using the NMS ISDN Messaging service This configuration enables the application to perform a wide range of Q 931 ISDN D channel functions For more information about this configuration see the NMS ISDN Messaging API Developer s Reference Manual LAPD The application accesses ISDN services at the data link layer layer 2 using the NMS ISDN Messaging service This setup enables the application to send and receive I frame data in LAPD messages This data typically consists of Q 931 messages For more information about this configuration see the NMS ISDN Messaging API Developer s Reference Manual Choose a method for accessing ISDN services when you initialize the NMS ISDN protocol stack The access methods are described in both the NMS ISDN Messaging API Developer s Reference Manual and the NMS ISDN for Natural Call Control Developer s Manual Dialogic Corporation 11 Dialogic NaturalAccess ISDN Software Installation Manual NMS ISDN software components ISDN is implemented in different ways around the world For this reason NMS Communications provides several variants of its NMS ISDN software for different regions The package for a variant contains the software modules you need to enable an AG or CG board to comm
25. ation 7 Terminology Note The product to which this document pertains is part of the NMS Communications Platforms business that 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 Corporation 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
26. ccess Voice Control Element API Dialogic NaturalAccess CAS API Dialogic NaturalAccess ISDN API Dialogic NaturalAccess ISDN 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 Overview of NMS ISDN NMS ISDN software overview NMS ISDN protocol software enables you to write Natural Access applications that communicate on T1 E1 or BRI trunks to perform voice processing functions and call control using ISDN common channel signaling CCS protocols Use NMS ISDN with one or more AG or CG boards which provide the physical interface to trunk lines Most of these boards also feature on board digital signal processing DSP resources that can perform call control and voice processing functions You can configure NMS ISDN software to access ISDN services in any of the following ways Configuration Description Channelized The application performs call control
27. ed on 23 ports Started 23 threads Enter program test loop aS 0 Dialogic Corporation 43 Variant specifications PRI variants and specifications The following table lists variants and specifications for the PRI interface Network protocol variant AT amp T 4ESS AT4 AT amp T 5ESS10 E10 Northern Telecom DMS 100 DMS Bellcore National 2 NI2 France Telecom Euro ISDN and Euro Numeris VN6 NTT INS 1500 NTT Hong Kong HKT Korea KOR Taiwan TWN Australia AUS Signaling at the Q ANSI T1 607 ANSI reference point QSIG Specification TR 41459 June 1999 PRI or BRI only Custom now edited by LUCENT AT amp T 235 900 342 January 1996 PRI or BRI NIS A211 1 Standard 08 01 PRI or BRI SR 3887 November 1996 PRI or BRI ETS 300 102 1 December 1990 Addendum ETS 300 103 1 A2 October 1993 CSE P 10 21A June 1994 French deltas INS NET 64 March 1993 HKTA 2015 Issue 1 1996 Similar to ETS There is no Korean specification but ETSI specifications have been implemented in NMS ISDN with some changes requested by Korean Samsung ME 0200 2 May 1997 edited by Chunghwa Telecom Co Ltd TS 013 1 1990 and TS 014 2 1990 ECMA 143 June 1997 T1 607 2000 BRI variants and specifications The following table lists variants and specifications for the BRI interface Network protocol variant Euro ISDN France Telecom VN6 NTT INS 1500
28. ese files contain information such as country specific settings that must be tailored to describe your hardware and software setup When you set up your system specify configuration information for all boards in your system with configuration files and board keyword files These files specify e Whether a board performs MVIP switching e Which board is the MVIP clock master e The software modules to transfer to the AG or CG board s memory on startup including the TCPs to load Dialogic Corporation 17 Dialogic NaturalAccess ISDN Software Installation Manual The NMS ISDN software includes several sample files that describe configurations for different boards Running the system with NMS OAM describes how to use the sample NMS OAM configuration files to create a file that configures your NMS ISDN software To initialize your boards based on the information in the configuration files run the oamsys utility oamsys transfers all software modules specified in the file to each board and performs other needed configuration activities Run oammon to monitor boards for errors and other events Use oamcfg to change system information or board parameters while the system is running oamsys oamcfg and oammon are installed with NMS OAM For more information see the NMS OAM System User s Manual 18 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual Steps for developing an NMS ISDN application To c
29. espect 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 Revision history Revision Release date 9000 60010 10 July 2000 9000 60010 11 September 2000 9000 60010 12 March 2001 9000 60010 13 April 2001 9000 60010 14 August 2001 9000 60010 15 November 2001 9000 60010 16 May 2002 9000 60010 17 November 2002 9000 60010 18 April 2003 9000 60010 19 April 2004 9000 60010 20 October 2005 64 0507 01 October 2009 Last modified September 8 2009 Notes EPS SJC support for Fusion 4 0 SJC for CT Access 4 0 SJC for NACD 2000 2 SJC for NACD 2001 1 Beta SJC for NACD 2001 1 SJC for NACD 2002 1 Beta LBG NACD 2002 1 LBG Natural Access 2003 1 Beta MCM Natural Access 2003 1 SRR Natural Access 2004 1
30. hannels T1 trunk 1 23 B channels 1 D channel for these channels CG board T1 trunk 2 23 B channels 1 D channel for these channels T1 trunk 3 23 B channels 1 D channel for these channels Dialogic Corporation 33 Dialogic NaturalAccess ISDN Software Installation Manual Non facility associated signaling NFAS In an NFAS configuration trunks are grouped into one or more NFAS groups One of the trunks in each group has a D channel carrying the signaling for all of the B channels on all of the trunks in the group up to 20 trunks per group This leaves channel 24 free on all other trunks in the NFAS group This extra channel can be used as another B channel as shown in the following illustration T1 trunk 0 23 B channels 1 D channel for all 4 trunks T1 trunk 1 24 B channels CG board T1 trunk 2 24 B channels T1 trunk 3 24 B channels A single NFAS group can contain trunks from multiple boards as shown in the following illustration T1 trunk 0 24 B channels member of NFAS group 2 MVIP bus T1 trunk 1 AG 4000 24 B channels member of NFAS group 2 board T1 trunk 2 AG 4000 23 B channels 1 D channel for trunks in NFAS group 1 board T1 trunk 3 24 B channels member of NFAS group 1 CG board T1 trunk 4 24 B channels member of NFAS group 1
31. hich appears as follows WORD t309 T309 in use flag To enable this option set this parameter to 1 in your application When enabled active calls are preserved while switching to the backup D channel when the primary D channel fails For more information on this feature refer to the NMS ISDN Messaging API Developer s Reference Manual 38 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual Creating a system configuration file for oamsys When you finish creating the board keyword files create a system configuration file The system configuration file lists the type and location of each of the boards and assigns a board keyword file to each board oamsys uses this file to create records in the OAM database for each of the boards The following table describes the settings to include in the file for each board Keyword Description name Name used to refer to the board in software This name must be unique Product Name of the board product for example CG_6000C_QUAD Number Board number you use in the Natural Access application to refer to the board Bus PCI bus number The bus slot location for each board must be unique Slot PCI slot number The bus slot location for each board must be unique File Name of the board keyword file containing settings for the board You can also specify keyword and value pairs directly in the system configuration file instead of in separate board keyword files
32. ing ways e Call ctaSetParmByName for each parameter specified in the file to set a new default value For an example see the DemoLoadParameters function in the demonstration library supplied with Natural Access e Call ctaLoadParameterFile from within your application You can also use the ctdaemon program to set the parameters on a system wide basis See the Natural Access Developer s Reference Manual for more information on this method Parameter modification must take place before nccStartProtocol is called to start the TCP When you call this function specify parameters to configure the TCP For more information about parameters in the nccxidsn pf parameter file see the NMS ISDN for Natural Call Control Developer s Manual Related products In addition to the NMS ISDN software you need the following components to build an ISDN protocol application e One or more AG or CG boards with one or more trunk interfaces e Natural Access e NMS OAM e oamsys and oammon the board loading and monitoring programs Natural Access Natural Access is a complete development environment for voice applications It provides a standard set of functions grouped into logical services Each service has a standard programming interface For general information about installing and using Natural Access see the Natural Access documentation NMS OAM NMS Operations Administration and Maintenance OAM manages and maintains the tele
33. king HBus ClockMode STANDALONE Clocking HBus ClockSource NETWORK Clocking HBus ClockSourceNetwork 1 DSP C5x 0 15 Files callp ptf tone dtmf voice NetworkInterface T1E1 0 3 Type T1 NetworkInterface T1E1 0 3 SignalingType PRI NetworkInterface T1E1 0 3 FrameType ESF Extended SuperFrame NetworkInterface T1E1 0 3 LineCode AMI NetworkInterface T1E1 0 3 D_Channel ISDN 28 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual Sample configuration for an AG 2000 BRI board The following sample board keyword file describes the configuration for an AG 2000 BRI board using the NOCC protocol AG Plug in Config File for AG 2000 BRI TCP files are shipped with the NMS CAS sub package of Natural Access Be sure to install the protocols that are specified below before trying to start a board with this configuration file TEPFiles 0 nocc tcp no trunk control protocol TCPFiles 1 isd0 tcp ISDN protocol DSP m54 files to link in DSP C5x DSPFiles callp m54 dtmf m54 mf m54 ptf m54 signal m54 tone m54 voice m54 DLMFiles 0 gtp leo DLMFiles 1 voice leo DLMFiles 2 svc leo DLMFiles 3 isdnbri leo use with Euro ISDN with major ETSI variants XLaw A LAW A Law silence idle signaling bit code RunFile ag2bri cor Clocking HBus ClockSource NETWORK Clocking HBus ClockMode STANDALONE Dialogic Corporation 29 Dialogic Natu
34. lc x where x is network interface 3 Egidio GPS BOO YES Hadle x settings for EI Hdlc 0 3 6 9 Hardware TxTimeSlot 16 Hdlc 0 3 6 9 Hardware RxTimeSlot 16 Hole x settings for 2l Hdlc 0 3 6 9 Hardware TxTimeSlot 23 Hdlc 0 3 6 9 Hardware RxTimeSlot 23 NetworkInterface T1E1 0 3 Type T1 NetworkInterface T1E1 0 3 Impedance DSX1 NetworkInterface T1E1 0 3 LineCode B8ZS NetworkInterface T1E1 0 3 FrameType ESF NFAS group information is associated with the trunk on which the primary D channel is located A unique number must be assigned to each NFAS group for reference NetworkInterface T1E1 x ISDN NFASGroup group number For each NFAS group member including primary D channel following configuration information should be specified NetworkInterface T1E1 x ISDN NFAS_ Member y Board board number NetworkInterface T1El x ISDN NFAS Member y Trunk trunk number from 0 NetworkInterface Tl1El x ISDN NFAS Member y NAI assigned NAI number unique within group Note x trunk number for primary D channel y NFAS member number starting with 0 without any gaps in numbering Group 5 D channel on trunk 0 Members 0 NAI 4 Trunk O this board number 0 WAT 6 Wie i ells looexacl mimoen C Signaling settings for trunk with D channel NetworkInterface T1E1 0 D_ Channel ISDN NetworkInterface T1E1 0 SignalingType PRI Signaling settings for trunk without D cha
35. ly if you are setting up NFAS groups NetworkInterface T1Ei1 x ISDN NFAS Group This keyword specifies the NFAS group number as follows NetworkInterface T1E1 x ISDN NFAS Group group no where x is the trunk that carries the primary D channel and group no is the NFAS group number There is a maximum of 16 groups This keyword must be accompanied by one or more groups of NetworkInterface T1E1 x ISDN NFAS_Member y Board and NetworkInterface T1E1 x ISDN NFAS Member y Trunk statements to specify the board and trunk numbers for each member of this NFAS group NetworkInterface T1Ei1 x D Channel This keyword specifies the trunk that carries the primary D channel as follows NetworkInterface T1E1 x D_Channel ISDN where x is the trunk that carries the primary D channel In each NFAS group only one trunk x can carry the D channel unless D channel backup is used Refer to D channel backup on page 37 If this keyword is set to ISDN for a trunk the NetworkInterface T1E1 x SignalingType keyword described in Configuring data routing on page 32 must be set to PRI or BRI for that trunk If a trunk is part of an NFAS group but does not carry a D channel NetworkInterface T1E1 x SignalingType must be set to RAW for that trunk Specify the backup D channel using the keyword NetworkInterface T1E1 x ISDN D Channel Backup Trunk where x is the trunk that carries the primary D channel NetworkInterface T1Ei1 x ISDN NFAS Member y Boa
36. nnel NetworkInterface T1E1 1 D_ Channel ISDN_NONE NetworkInterface T1E1 1 SignalingType RAW Assigning group number to D channel trunk 26 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual NetworkInterface T1E1 0 ISDN NFASGroup 5 Configuring group members NetworkInterface T1E1 0 ISDN NFAS Member 0 Board 0 NetworkInterface T1E1 0 ISDN NFAS Member 0 Trunk NetworkInterface T1E1 0 ISDN NFAS Member 0 NAI 4 Il NetworkInterface T1E1 0 ISDN NFAS Member 1 Board 0 NetworkInterface T1E1 0 ISDN NFAS Member 1 Trunk 1 NetworkInterface T1E1 0 ISDN NFAS Member 1 NAI 6 Group 3 D channel on trunk 2 Members WAL A muewweUs 2 eld loyeyenacl impimcxese 0 E a NAL Gye eunin S CNIS poard i number 0 Signaling settings for trunk with D channel NetworkInterface TIE1 2 D Channel ISDN NetworkInterface T1E1 2 SignalingType PRI Signaling settings for trunk without D channel NetworkInterface T1E1 3 D Channel ISDN NONE NetworkInterface T1E1 3 SignalingType RAW Assigning group number to D channel trunk NetworkInterface T1E1 2 ISDN NFASGroup 3 Configuring group members NetworkInterface T1E1 2 ISDN NFAS Member 0 Board 0 NetworkInterface T1E1 2 ISDN NFAS Member 0 Trunk 2 NetworkInterface T1E1 2 ISDN NFAS Member 0 NAI 4 NetworkInterface T1E1 2 ISDN NFAS Member 1 Board 0 NetworkInterface T1E1 2
37. phony resources in a system These resources include hardware components such as AG or CG boards and low level board management software modules Using NMS OAM you can e Create edit delete and query the configuration of a component e Start stop and test a component e Receive notifications from components 16 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation 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 SSE vite Configuration database Board plug in Software components Boards Each NMS OAM database parameter and value is expressed as a keyword name and value pair for example Encoding MU_LAW You can query the NMS OAM database for keyword values for any component Keywords and values can be added modified or deleted Note Before using NMS OAM or any of its related utilities ensure that the Natural Access Server ctdaemon is running For more information about ctdaemon refer to the Natural Access Developer s Reference Manual For general information about NMS OAM and its utilities refer to the NMS OAM System User s Manual NMS OAM and the configuration files The NMS OAM system configuration file and referenced board keyword files contain information that oamsys reads to determine how to configure a board Th
38. ralAccess ISDN Software Installation Manual Configuring on board software for NMS ISDN To configure the NMS ISDN software with the boards include the following keywords in each board keyword file e DSP C5x x Files e DLMFiles x e TCPFiles x DSP C5x x Files This statement specifies the DSP program files to be loaded to the board The following files must be assigned through this keyword for all NMS ISDN installations e dtmf xxx or dtmf a xxx for A law configurations Note Substitute dtmfe xxx or dtmfe a xxx if you are using echo cancellation e callp xxx or callp a xxx for A law configurations e tone xxx or tone a xxx for A law configurations where xxx is the three letter file extension the board requires Board File extension AG 2000 C AG 4000 C and AG 4040 C m54 CG family f54 To run the demonstration programs supplied with Natural Access and with your NMS ISDN software specify voice xxx or voice a xxx for A law configurations Because these keyword statements apply to all boards in an NMS ISDN system specify these DSP file assignments in each board keyword file DLMFiles x This statement specifies the run module to be downloaded to the board Run modules are specific to the protocol variant and country Because the DLMFiles x keyword applies to all boards in an NMS ISDN system specify this value in each board keyword file See Variant specifications on page 45 for more information about
39. rd This keyword specifies the board number of a member trunk of an NFAS group Specify one of these statements for every NFAS member y on every trunk x that carries a primary D channel This field must be set in the board keyword file for the board where the D channel resides The board number must match the board number specified in the OAM system configuration file oamsys cfg Dialogic Corporation 35 Dialogic NaturalAccess ISDN Software Installation Manual NetworkInterface T1E1 x ISDN NFAS_Member y NAI This keyword identifies the network access identifier NAI of a member trunk of an NFAS group as follows NetworkInterface T1E1 2 ISDN NFAS Member 1 NAI nai where nai is the NAI of the trunk and ranges from 0 to 127 The NAI of each trunk in an NFAS group must be unique Specify one of these statements for every NFAS member y on every trunk x that carries a primary D channel This field must be set in the board keyword file for the board where the D channel resides NetworkInterface T1Ei1 x ISDN NFAS Member y Trunk This keyword specifies the trunk number of a member trunk of an NFAS group Specify one of these statements for every NFAS member y on every trunk x that carries a primary D channel This field must be set in the board keyword file for the board where the D channel resides 36 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual D channel backup When N
40. reate an NMS ISDN application follow these steps Step Action Where step is documented 1 Install AG or CG boards and any other boards you The hardware installation manual need for the application in the system 2 Install Natural Access The Natural Access installation booklet 3 Install NMS ISDN software for each country or region The Natural Access installation booklet where your application will be used 4 Create the board keyword file for each board in the e Creating board keyword files on system page 22 e The hardware installation manuals e NMS OAM System User s Manual 5 Configure on board software for NMS ISDN on the Configuring on board software for NMS board keyword files ISDN on page 30 6 Configure data routing on the board keyword files e Configuring data routing on page 32 e The hardware installation manuals 7 Set up NFAS groups on the board keyword files e Setting up NFAS groups on page 32 e The hardware installation manuals 8 Create an OAM system configuration file that e Creating a system configuration file describes all boards in the system for oamsys on page 39 e The hardware installation manuals e NMS OAM System User s Manual 9 Run the omasys utility to set up the NMS OAM e Running oamsys on page 40 database e The hardware installation manuals e NMS OAM System User s Manual 10 Test the hardware installation e Verifying the installation on page 43 e The hardware installation manuals
41. reating a system configuration file for oamsys cseeseeeeee nnm nenn 39 Sample system configuration file ssssssessseseeeeeen nnm nnn 39 Senat 40 Changing configuration parameter settings ssssssssseemene 41 Chapter 5 Verifying NMS ISDN installation eere 43 Verifying the installation iei ERR RE REIR ERR REX REX ERKRRAY RR ERAN n ERN MERE a 43 Running ISGCNAEMO cece eee ne messen sense EENE eee nemen 43 Dialogic Corporation 5 Dialogic NaturalAccess ISDN Software Installation Manual Chapter 6 Variant specifications Le eee eee esee eene nennen nnn nnns 4D PRI variants and specifications TIT 45 BRI variants and specifications ice cece eee renee ene enn ne ene etna etn EEE Eas 45 Other common channel signaling protocols sss 46 Dialogic Corporation 1 Introduction The Dialogic NaturalAccess ISDN Software Installation Manual describes how to install NaturalAccess ISDN Software on your system This software enables boards to connect to a T1 E1 or BRI trunk using primary PRI or basic BRI rate ISDN This document is intended for telephony and voice application developers who are using NaturalAccess This manual defines telephony terms where applicable but assumes that you are familiar with telephony concepts It also assumes that you are familiar with the C programming language Dialogic Corpor
42. ses 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 Montreal Quebec Canada H4M 2V9 Any authorized use of Dialogic s trademarks will be subject to full r
43. stem Operating system Example file location Windows nms ag cfg cfg nms cg cfg cfg UNIX opt nms ag cfg cfg opt nms cg cfg cfg The sample board keyword files are named yyygixzzpi cfg except for BRI and NFAS configurations where e y isthe board family a if an AG board c if a CG board c61 if a CG 6100C board c65 if a CG 6500C board e xis the board type 4 if an AG 4000 board 6 if a CG 6000 board e Zzisthe line type el or t1 The following table lists some of the sample board keyword files Filename For use with agidelpi cfg AG 4000 E1 and AG 4040 F1 agi4tipi cfg AG 4000 T1 and AG 4040 T1 cgi6el cfg CG 6000 E1 cgi6t1 cfg CG 6000 T1 aginfas cfg NFAS support for all AG T1 boards cginfas cfg NFAS support for all CG T1 boards agpi2bri cfg AG 2000 BRI You can use the same board keyword file for multiple boards if the boards configurations are identical for example both are CG 6000C T1 boards Sample board keyword files for the CG 6100C board and the CG 6500C board start with c61 and c65 respectively For more information about board keyword files refer to the NMS OAM System User s Manual 22 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual Sample board keyword files This topic presents sample board keyword files for NMS ISDN configurations Use these sample files to better understand the format of and information in a board keyword file
44. stem User s Manual Dialogic Corporation 41 Verifying NMS ISDN installation Verifying the installation After you install and configure the NMS ISDN software verify that the software is operational before you continue When running the NMS ISDN verification procedure it is assumed that e Natural Access is properly installed e Your boards are installed e Your configuration files have been edited to reflect your configuration To verify your installation run the isdndemo demonstration program supplied with your NMS ISDN software Running isdndemo Perform the following steps to run isdndemo and verify the NMS ISDN installation Step Action 1 Create an NMS OAM system configuration file and board keyword files specific to the installation J 2 Invoke oamsys to initialize the board Note oammon should be left running at all times to capture hardware errors T 3 Change to the directory containing isdndemo Windows nms ctaccess demos isdndemo UNIX opt nms ctaccess demos isdndemo 4 Run isdndemo by entering the following command at the command line isdndemo p variant where variant is the protocol variant to run For example isdndemo p 23 isdndemo responds with a message similar to the following ISDN Multiple Thread Demo V 9 Nov 14 1999 T3 board 0 found Protocol AT amp T 5E10 Number of inbound ports Number of outbound ports 24 ports opened NOCC protocol start
45. t 16 It is assigned a keyword file named my40brd cfg It is set up as a slave to the primary master the CG 6000C board Running oamsys After you create all necessary configuration files you are ready to use the oamsys utility To run oamsys enter the following command from the command line oamsys options where Option Description f Specifies the file name and path if necessary of a system configuration file to load If filename you invoke oamsys without this option it searches for a file named oamsys cfg in the current directory and then in the paths specified in the AGLOAD environment variable If you specify a file name without an extension oamsys assumes the extension to be cfg host Loads the configuration file on the specified resource host host is an IP address or machine name If unspecified the operations are performed on the host on which the utility was initialized oamsys reads system configuration files not board keyword files Board keyword files to be added to the NMS OAM database must be specified within the system configuration file Refer to Creating a system configuration file for oamsys on page 39 When you invoke oamsys with a valid file name oamsys performs the following tasks e Checks the syntax of the system configuration file and ensures that all required keywords are present oamsys reports any syntax errors it finds Note oamsys verifies the syntax of the system configuration file b
46. the CG6000 Installation and Developers Manual FERRER FE TE HE FE E FE TE FE FE HE FE FE FE EEE HEE HE FE E FE TE HE FE E FE TE FE TE HE EEE HER TE HE AE E FE E E E EEE EE Resource 0 Definitions clome cet ali amp echo MMO cu25 amp ier CEE 2E amp TONE Gen amp callp gnc amp ptf det 4f amp rvoice rec mulaw amp rvoice play mulaw rvoice rec alaw amp rvoice play alaw rvoice rec_lin amp rvoice play lin N X X vorcerrec fomi Ole Crp aver lGm LOOM volge olay IG led 24 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual HSC 32 amp imor piha 32 gsm_ms frgsm rec amp gsm ms frgsm play eU2G ssee S voice play 16 200 volce rec 24 amp vorce play 24 100 voice play 24 150 voice play 24 200 WolCS HSC 32 amp WOleS jollaiy 32 OW voice play 32 150 voice play 32 200 voice rec 64 amp voice play 64 100 voice play 64 150 voice play 64 200 wave rec 11 16b amp wave play 11 16b wave rec THE 8b amp wave play 11 8b oki rec 24 E oki play 24 100 Ole ree 32 i NS play_32_100 ima rec 24 amp ima play 24 4 g726 play_32 L2 EE EE EP BE EE oki play 24 150 okikpilay 32 i150 N oki play 24 200 oki play 32 200 DLMFiles 0 cg6krun DLMFiles isdn4ess For other ISDN configurations uncomment one of the DMSFile 1
47. the board boots NMS ISDN provides downloadable variant modules that are specific to the configuration and country For a complete list of the NMS ISDN variant modules see DLMFiles x on page 30 NMS ISDN also provides the downloadable module files imgt leo imgt dlm and c65imgt dlm which contain the basic low level software required by an AG or CG board to support the NMS ISDN Management service For more information about these files and about the Management service refer to the NMS ISDN Management API Developer s Reference Manual Dialogic Corporation 13 Dialogic NaturalAccess ISDN Software Installation Manual Demonstration programs The following demonstration programs source code and makefiles are included in the software package Name Description For more information see the dectrace Decodes and displays messages sent or received by the NMS NMS ISDN Messaging API ISDN protocol stack that were previously captured in a log Developer s Reference file by the oammon utility Manual isdncta ISDN daemon program to start and stop the NMS ISDN NMS ISDN for Natural Call protocol stack in channelized mode Control Developer s Manual isdndemo e Provides an example of a digital trunk application where NMS ISDN Messaging API the NMS ISDN software runs in an ACU configuration ue Reference Manua e Shows how to use the NMS ISDN Messaging service to start this configuration and to receive and place calls on an ISDN tr
48. unicate on a T1 E1 or BRI trunk in your particular country or region The NMS ISDN software package contains the following e A readme file e NMS ISDN function libraries for Natural Access e Header files e Downloadable object modules containing the NMS ISDN protocol stack software and the NMS ISDN management software e Sample board keyword files e Demonstration programs and utilities including the source code files and makefiles e A trunk control program TCP e Several binary parameter files pf files and several ASCII parameter files par files readme file The readme_isdn txt file contains release information that does not appear in other documentation Consult this file to learn where the NMS ISDN software components are located You can find readme_isdn txt in the following location Operating system readme file location Windows nms doc UNIX opt nms doc NMS ISDN function libraries The NMS ISDN function libraries run on the host computer The application uses the function libraries to interact with ISDN protocol stacks running on a board and to communicate with the NCC and ADI services The following table lists the NMS ISDN function libraries Windows UNIX isdnapi lib isdnapi dll libisdnapi so nccisdn lib nccisdn dll libnccisdn so imgtapi lib imgtapi dll libimgtapi so 12 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual Header files The follo
49. unk isdnncc e Uses a TCP with Natural Access to receive and or place NMS ISDN for Natural Call calls Control Developer s Manual e Demonstrates the ISDN TCP on a live trunk e Provides an example of a two way trunk application using the NCC service itrace Runtime filter for NMS ISDN messages from the stack that NMS ISDN Messaging API are sent to the OAM service Developer s Reference Manual lapddemo e Provides an example of a digital trunk application where NMS ISDN Messaging API the NMS ISDN software runs in a LAPD configuration Rd Ed Reference Manua e Shows how to use the Messaging service to start this configuration establish a data link and send and receive Q 931 messages imgtdemo Shows how to use the NMS ISDN Management service to NMS ISDN Management API control and configure B channels For use with PRI only Developer s Reference Manual Trunk control program TCP NMS ISDN software includes one trunk control program TCP isdO tcp This TCP is useful only if you are configuring the NMS ISDN software to access ISDN call control services in a channelized configuration The TCP is transferred to on board memory by the OAM service An instance of the TCP is associated with each context The TCP is used to mediate transactions between Natural Access DSP resources and the NMS ISDN protocol stack For more information see the NMS ISDN for Natural Call Control Developer s Manual 14 Dialogic Corporation
50. ut not of the board keyword files e Checks for uniqueness of board names board numbers bus numbers and slot numbers within the system configuration file e Shuts down all boards referenced in the NMS OAM database e Deletes all board configuration information currently stored in the NMS OAM database e Sets up the NMS OAM database according to settings in the system configuration file and any referenced board keyword files e Attempts to start all boards according to the description in the database Natural Access Server ctdaemon must be running for oamsys to operate For more information about Natural Access Server ctdaemon refer to the Natural Access Developer s Reference Manual 40 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual Changing configuration parameter settings After initializing the database with oamsys you can make further parameter changes as follows e Modify the board keyword file for the board make sure the name is correctly specified in the File statement in oamsys cfg and run oamsys again e Specify parameter settings using the oamcfg utility For information about this utility refer to the NMS OAM System User s Manual e Specify the settings using the OAM service functions See the NMS OAM Service Developer s Reference Manual for more information e Set individual keywords using the oaminfo utility For information about this utility refer to the NMS OAM Sy
51. variants Download only one run module to a particular board 30 Dialogic Corporation Dialogic NaturalAccess ISDN Software Installation Manual PRI run modules The following table lists the PRI run modules Note Europe includes the following countries Austria Belgium Denmark Finland France Germany Greece Ireland Italy Luxembourg Netherlands Norway Portugal Russia Spain Sweden Switzerland UK PRI run module PRI run module PRI run for AG boards for CG boards module for CG 6500C boards isdngen leo isdngen dlm cg65igen dim dpnss leo dpnss dlm c65idpnss dlm BRI run modules The following table lists the BRI run modules Variant ANSI T1 607 AT amp T 4ESS AT amp T 5ESS National ISDN 2 Northern Telecom DMS100 250 EuroISDN France Telecom VN6 Australian Telecom 1 Hong Kong Telephone Korean Operator Nippon Telegraph Telephone Taiwanese Operator ECMA QSIG DPNSS Country USA Europe and other countries where supported France Australia Hong Kong Korea Japan Taiwan All listed countries United Kingdom Note Europe includes the following countries Austria Belgium Denmark Finland France Germany Greece Ireland Italy Luxembourg Netherlands Norway Portugal Russia Spain Sweden Switzerland UK BRI run module Variant Country Euro ISDN France Telecom VN6 France isdnbri leo Dialogic Corporation Europe China Singapore Austr
52. wing header files are supplied with NMS ISDN software File name Contents Used in these configurations isdnval h Definitions for Q 931 messages created by ACU channelized the stack isdndef h Event code definitions and ISDN function ACU LAPD prototypes isdnparm h Parameter structure definitions and ACU LAPD manifest constants for parameter structure fields isdntype h NMS Communications type definitions ACU LAPD basic and derived types and entity identifiers isdnacu h ACU SAP message structure definitions and ACU macros to build ACU messages isdndl h SAPI SIG configuration for raw LAPD and LAPD macros to build LAPD messages nccxadi h NCC parameter structures Channelized nccadi h NCC values for mediamask connectmask Channelized and disconnectmask nccxisdn h ISDN parameter structures and values for Channelized NCC adiisd h TCP parameter structures ADI imgtdef h Management service function prototypes IMGT ang management event code definitions For more information refer to the NMS ISDN Management API Developer s Reference Manual imgtsvc h Management service primitives and related IMGT data structures Downloadable object modules For more information refer to the NMS ISDN Management API Developer s Reference Manual A downloadable object module file contains the basic low level software that an AG or CG board requires to support ISDN The module is transferred from the host to on board memory when
Download Pdf Manuals
Related Search