BenutzerhandbuchInhaltsverzeichnis1. How To Use This Guide11.1. Products Covered by this Guide11.2. Organization of this Guide12. Introduction to Dialogic ISDN Products32.1. The Basic Rate Interface32.1.1. Features of BRI42.1.2. Typical BRI Applications72.2. The Primary Rate Interface72.2.1. Benefits of PRI82.2.2. PRI Configurations and Applications92.3. Dialogic ISDN Protocol Support113. ISDN Technology Overview133.1. Signaling133.2. Framing143.2.1. Data Link Layer (Layer 2) Frames143.2.2. Network Layer (Layer 3) Frames143.3. ISDN Call Control States153.3.1. Asynchronous Call Establishment173.3.2. Synchronous Call Establishment203.3.3. Asynchronous Call Termination233.3.4. Synchronous Call Termination254. ISDN Function Overview294.1. ISDN Library Function Categories294.2. API Functions and Supported ISDN Technologies405. ISDN Function Reference455.1. Function Description Format455.2. Programming Conventions475.3. Function References: CRNs, CRVs, and Line Device Handles475.4. Interpreting Function Call Failures48cc_AcceptCall( ) - responds to an incoming call request50cc_AnswerCall( ) - accepts a connection request from the remote end53cc_CallAck( ) - send the first response to an incoming call56cc_CallProgress( ) - sends a PROGRESS message to the network60cc_CallState( ) - retrieves the state of a call63cc_CauseValue( ) - retrieves the error/cause code of a failure67cc_Close( ) - closes a previously opened line device70cc_CRN2LineDev( ) - matches a CRN to its line device handle73cc_DropCall( ) - allows the application to disconnect a call75cc_GetBChanState( ) - retrieves the status of the B channel83cc_GetBilling( ) - gets the call charge information86cc_GetCallInfo( ) - gets the information elements associated with the CRN89cc_GetCES( ) - retrieves the connection endpoint suffix93cc_GetChanId( ) - gets the last channel information96cc_GetCRN( ) - retrieves the call reference number for the event101cc_GetDChanState( ) - retrieves the status of the D channel104cc_GetDLinkCfg( ) - retrieves the configuration of a logical link107cc_GetDLinkState( ) - retrieves the logical data link state109cc_GetDNIS( ) - gets the dialed number information string112cc_GetEvtMsk( ) - retrieves the current ISDN event mask115cc_GetFrame( ) - retrieves the frame119cc_GetLineDev( ) - retrieves the line device handle for an event125cc_GetMoreDigits( ) - collects more digits via overlap receiving127cc_GetNetCRV( ) - retrieves the network call reference value131event134cc_GetParm( ) - gets the current parameter values of the line device138cc_GetParmEx( ) - retrieve parameters containing variable data144cc_GetSAPI( ) - retrieves the service access point ID148cc_GetSigInfo( ) - gets the signaling information of an incoming message151cc_GetUsrAttr( ) - gets the established attribute for the line device156cc_GetUsrAttr( ) - gets the established attribute for the line device156cc_GetVer( ) - retrieves the firmware version number159cc_HoldAck( ) - accept a hold request from remote equipment161cc_HoldCall( ) - place an active call on hold164cc_HoldRej( ) - reject a hold request from remote equipment167cc_MakeCall( ) - request a connection to make an outgoing call170cc_Open( ) - opens a device176cc_PlayTone( ) - play a user-defined tone179cc_ReleaseCall( ) - release all internal resources183cc_ReleaseCallEx( ) - release all Dialogic ISDN resources186cc_ReqANI( ) - returns the caller ID190cc_Restart( ) - resets the channel to Null state194cc_ResultMsg( ) - interprets the function return code198cc_ResultValue( ) - gets an error/cause code201cc_RetrieveAck( ) - accept a request to retrieve a call from hold204cc_RetrieveCall( ) - retrieve a call from the Hold state207cc_RetrieveRej( ) - reject a request to retrieve a held call210cc_SetBilling( ) - sets the billing rate for Vari-A-Bill services214cc_SetCallingNum( ) - sets the default calling party number218cc_SetChanState( ) - change the maintenance state of a specified B channel221cc_SetDChanCfg( ) - sets the configuration of the Digital Subscriber Loop224cc_SetDLinkCfg( ) - configures a logical link228cc_SetDLinkState( ) - set the logical data link state230cc_SetEvtMsk( ) - sets the event mask233cc_SetInfoElem( ) - sets additional information elements238cc_SetMinDigits( ) - sets the minimum number of digits to be collected241cc_SetParm( ) - sets the default channel parameters244cc_SetParmEx( ) - set parameters requiring variable data to be passed250cc_SetUsrAttr( ) - sets the user attribute254cc_SndFrame( ) - sends a frame to the data link layer257cc_SndNonCallMsg( ) - sends a non-call related ISDN message264cc_StartTrace( ) - start the capture of all D channel information268cc_StopTone( ) - forces the termination of a tone271cc_StopTrace( ) - stops the trace275CCEV_TERM_REGISTER278cc_ToneRedefine( ) - redefines a call progress tone’s attributes283cc_WaitCall( ) - sets up conditions for processing an incoming call2896. Data Structure Reference2936.1. CC_RATE_U2946.2. channel_id2946.3. DCHAN_CFG2956.4. DLINK3026.5. DLINK_CFG3036.6. IE_BLK3046.7. L2_BLK3056.8. MAKECALL_BLK3056.8.1. MAKECALL_BLK Initialization3146.9. NONCRN_BLK3156.10. PARM_INFO3166.11. SPID_BLK3166.12. TERM_BLK3176.13. TERM_NACK_BLK3196.14. ToneParm3206.15. USPID_BLK3216.16. USRINFO_ELEM3226.17. WAITCALL_BLK3237. ISDN Events and Errors3257.1. Event Categories3257.1.1. Termination Events3257.1.2. Unsolicited Events3307.2. Error Handling3387.2.1. Cause/Error Codes from the ISDN Firmware3397.2.2. Cause/Error Codes from the ISDN Network3427.2.3. Cause/Error Codes from the ISDN Library3478. Application Guidelines3498.1. General Guidelines3498.1.1. Symbolic Defines3498.1.2. Header Files3508.1.3. Aborting and Terminating the Application3508.2. Handling Errors, Events and Alarms3508.2.1. Handling Errors3518.2.2. Handling Events3518.2.3. Handling Alarms3528.3. Programming Considerations - PRI and BRI3528.3.1. Resource Association3528.3.2. MAKECALL Block Initialization and Settings3538.3.3. Information Element Settings3548.4. Programming Considerations - BRI/SC Only3578.4.1. BRI/SC Configuration3578.4.2. BRI/SC Terminal Initialization3588.4.3. BRI/SC Tone Generation Configuration3598.5. Diagnostic Tools (The DialView Suite)3608.5.1. ISDIAG Utility3608.5.2. ISDTRACE Utility362Appendix A - Call Control Scenarios367BRI Channel Initialization and Start Up (User Side)368BRI Channel Initialization and Start Up (Network Side)369PRI Channel Initialization and Start Up370Normal Call Establishment and Termination371Network initiated call (inbound call)371Network terminated call374Application initiated call (outbound call)378Aborting cc_MakeCall( )380Application Terminated Call381Call Rejection385Outgoing call rejected by the network385Incoming call rejected by the application386to the network388to the network390Simultaneous disconnect (any state)392Hold and retrieve - local initiated395Hold and retrieve - remote initiated396Network Facility Request or Service397Vari-A-Bill (AT&T Service Only)397ANI-on-demand - incoming call (AT&T Service Only)398Advice of charge - inbound and outbound call (AT&T Service Only)399Two B Channel Transfer (TBCT)400Non-Call Associated Signaling (NCAS)409User-initiated call410Network-initiated call413Appendix B - DPNSS Call Scenarios415Executive Intrusion - Normal416Executive intrusion - with prior validation416Local diversion - outbound417Local diversion - inbound417Remote diversion - outbound418Remote diversion - inbound419Transfer420Virtual call -outbound422Virtual call - inbound423Appendix C - IEs and ISDN Message Types for DPNSS425Information Elements for cc_GetCallInfo( ) and cc_GetSigInfo( )425Intrusion IE:425Diversion IE:425Diversion Validation IE:426Transit IE:426Text Display IE:427Network Specific Indications (NSI) IE:428Extension Status IE:428Virtual Call IE:429Information Elements for cc_SetInfoElem( )430Intrusion IE:430Diversion IE:431Diversion Bypass IE:431Inquiry IE:432Extension Status IE:432Virtual Call IE:433Text Display IE:433Network Specific Indications (NSI) IE:434DPNSS Message Types for cc_SndMsg( )434SndMsg_Divert:435SndMsg_Intrude:435SndMsg_NSI:436SndMsg_Transfer:436SndMsg_Transit:437Appendix D – BRI Supplemental Services439Appendix E - Establishing ISDN Cable Connections445Ordering Service445Establishing Connections to an NTU445Appendix F - Related Publications447Glossary449Index455Table 1. ISDN Protocols11Table 2. Call Control States16Table 3. Inbound Call Set-Up (Asynchronous Example)19Table 4. Outbound Call Set-up (Asynchronous Example)20Table 5. Inbound Call Set-Up (Synchronous Example)22Table 6. Outbound Call Set-up (Synchronous Example)23Table 7. Call Termination (Asynchronous Example)25Table 8. Call Termination (Synchronous Example)27Table 9. Call Control Functions31Table 10. Optional Call Handling Functions32Table 11. System Control Functions34Table 12. System Tool Functions35Table 13. Data Link Layer Handling Functions38Table 14. Hold and Retrieve Functions39Table 15. Global Tone Generation Functions40Table 16. ISDN API Functions and Supported Technologies41Table 17. ISDN Function Description Format46Table 18. cc_DropCall( ) Causes75Table 19. cc_GetCallInfo( ) Info_ID Definitions90Table 20. Bitmask Values115Table 21. cc_GetParm( ) Parameter ID Definitions139Table 22. cc_GetParmEx( ) Parameter ID Definitions145Table 23. cc_GetSigInfo( ) Info_ID Definitions152Table 24. Bitmask Values233Table 25. Bitmask Actions235Table 26. cc_SetParm( ) Parameter ID Definitions245Table 27. ISDN Message Types for cc_SndMsg( )261Table 28. Terminal Initialization Events and Data Structures279Table 29. Tone Template Table284Table 30. CC_RATE_U Field Descriptions294Table 31. channel_id Descriptions and Values295Table 32. DCHAN_CFG Field Descriptions and Values297Table 33. DLINK Field Descriptions303Table 34. DLINK_CFG Field Descriptions303Table 35. IE_BLK Field Descriptions304Table 36. L2_BLK Field Descriptions305MAKECALL_BLK Parameter ID Definitions307NONCRN_BLK Field Descriptions315PARM_INFO Field Descriptions316SPID_BLK Field Descriptions317TERM_BLK Field Descriptions318TERM_NACK_BLK Field Descriptions319Cause Values Associated with CCEV_RCVTERMREG_NACK320ToneParm Field Descriptions321USPID_BLK Field Descriptions322USRINFO_ELEM Field Descriptions323Termination Events326Unsolicited Events330Cause/Error Locations339ISDN Firmware Error Codes340ISDN Firmware Error Codes for cc_SetBilling( )342ISDN Network Error Codes343ISDN Library Error Codes347Variable Length IEs354NON-LOCKING Shift IEs - Type 1355Single Byte IEs - Type 2355LOCKING Shift IEs - Option 1355LOCKING Shift IEs - Option 2356ISDTRACE Example File363ETSI Specification Cross-Reference for Supplemental Services443Figure 1. Layer 2 Frame (D Channel)14Figure 2. Layer 3 Frame (D Channel)15Figure 3. Asynchronous Call Establishment Process18Figure 4. Synchronous Call Establishment Process21Figure 5. Asynchronous Call Disconnect or Failure Process24Figure 6. Synchronous Call Disconnect or Failure Process26Figure 7. TBCT Invocation with Notification (Both Calls Answered)401Alerting)402Figure 9. User-Accepted Network-Initiated NCAS Request409Figure 10. User-Rejected Network-Initiated NCAS Request410Figure 11. User-Disconnected NCAS Call410Figure 12. Information Element Format441Größe: 910 KBSeiten: 476Language: EnglishHandbuch öffnen