Intel Voice API 52377002 Manuel d'utilisateur

Voice APIProgramming GuideJune 200505-2377-002

10 Voice API Programming Guide – June 2005ContentsTables1 Voice Device Inputs for Event Management Functions . . . . . . . . . . . . . . . . . . . . .

100 Voice API Programming Guide — June 2005Recording and PlaybackThe pause and resume play feature is not supported on Springware boards.8.11.2 Pause

Voice API Programming Guide — June 2005 101Recording and Playback• It does not make sense to use the same DTMF digit as a termination condition on a p

102 Voice API Programming Guide — June 2005Recording and Playback8.12.2 Echo Cancellation Resource OperationThe echo canceller accepts two TDM bus inp

Voice API Programming Guide — June 2005 103Recording and PlaybackFigure 16. Echo Canceller Operating over a TDM busOnce the ECR feature is enabled on

104 Voice API Programming Guide — June 2005Recording and Playback8.12.3 Modes of OperationThe echo cancellation resource feature has two modes of oper

Voice API Programming Guide — June 2005 105Recording and PlaybackECR mode is activated using the dx_listenecrex( ) function. For technical information

106 Voice API Programming Guide — June 2005Recording and Playback2. Have both MSI/SC stations listen to the ECR transmit of the opposite voice channel

Voice API Programming Guide — June 2005 107Recording and Playback /* Open voice board 1 channel 1 device */ if ((chdev1 = dx_open("dxxxB1C1&q

108 Voice API Programming Guide — June 2005Recording and Playback scts = ms1txts; /* Have channel 1 listen to station 1's transmit */ if (d

Voice API Programming Guide — June 2005 109Recording and Playback exit(1); } if (dx_close(chdev2) == -1) { printf("Error message =

Voice API Programming Guide — June 2005 11Revision HistoryThis revision history summarizes the changes made in each published version of this document

110 Voice API Programming Guide — June 2005Recording and PlaybackFigure 18. An ECR Play Over the TDM bus Example#include <stdio.h> #include <

Voice API Programming Guide — June 2005 111Recording and Playback /* Open MSI/SC board 1 station 2 device */ if ((msdev2 = ms_open("msiB1C2&q

112 Voice API Programming Guide — June 2005Recording and Playback /* . . Continue . */ /* Then perform xx_unlisten() and dx_unlistenecr(),

Voice API Programming Guide — June 2005 11399.Speed and Volume ControlThis chapter describes how to control the speed and volume of play on a channel.

114 Voice API Programming Guide — June 2005Speed and Volume Controldx_addvoldig( ) adds a digit that will modify volume by a specified amountSee the V

Voice API Programming Guide — June 2005 115Speed and Volume ControlA speed/volume adjustment stays in effect until the next adjustment on that channel

116 Voice API Programming Guide — June 2005Speed and Volume ControlThe default speed modification table is shown in Table 11. Consider the following u

Voice API Programming Guide — June 2005 117Speed and Volume ControlThe default volume modification table is shown in Table 12. Consider the following

118 Voice API Programming Guide — June 2005Speed and Volume Control9.5 Play Adjustment DigitsThe voice software processes play adjustment digits diffe

Voice API Programming Guide — June 2005 119Speed and Volume ControlSee the Voice API Library Reference for more information about these functions and

12 Voice API Programming Guide — June 2005Revision History

120 Voice API Programming Guide — June 2005Speed and Volume Control

Voice API Programming Guide — June 2005 1211010.Send and Receive FSK DataThis chapter describes the Analog Display Services Interface (ADSI) protocol,

122 Voice API Programming Guide — June 2005Send and Receive FSK Dataacknowledge and the data transmission (and/or reception) will then be initiated. O

Voice API Programming Guide — June 2005 123Send and Receive FSK Data10.3 ADSI OperationADSI data is encoded using a standard 1200 baud modem specifica

124 Voice API Programming Guide — June 2005Send and Receive FSK Data10.5 Two-Way ADSITwo-way ADSI includes several enhancements to one-way ADSI, inclu

Voice API Programming Guide — June 2005 125Send and Receive FSK Datainformation about two-way FSK transmission, see Telcordia Technologies Special Rep

126 Voice API Programming Guide — June 2005Send and Receive FSK Data10.7.1 Library Support on DM3 BoardsDM3 boards support ADSI one-way, two-way FSK,

Voice API Programming Guide — June 2005 127Send and Receive FSK Data10.7.2 Library Support on Springware BoardsSpringware boards support ADSI one-way,

128 Voice API Programming Guide — June 2005Send and Receive FSK Data• Implementing Two-Way ADSI Using dx_TxRxIottData( )10.8.1 Technical Overview of O

Voice API Programming Guide — June 2005 129Send and Receive FSK Data2. Issue dx_TxIottData( ). To generate an initial CAS to the CPE device, dwTxDataM

Voice API Programming Guide — June 2005 13About This PublicationThe following topics provide information about this publication: • Purpose • Applicabi

130 Voice API Programming Guide — June 2005Send and Receive FSK Data10.8.3 Technical Overview of Two-Way ADSI Data TransferIn two-way ADSI data transf

Voice API Programming Guide — June 2005 131Send and Receive FSK Data10.8.4 Implementing Two-Way ADSI Using dx_TxIottData( ) The dx_TxIottData( ) funct

132 Voice API Programming Guide — June 2005Send and Receive FSK Data10.8.5 Implementing Two-Way ADSI Using dx_TxRxIottData( )After the two-way ADSI tr

Voice API Programming Guide — June 2005 133Send and Receive FSK Data8. Issue dx_RxIottData( ) to receive messages from the CPE. This function should b

134 Voice API Programming Guide — June 2005Send and Receive FSK DataThe following sample code illustrates the use of the dx_TxIottData( ) function to

Voice API Programming Guide — June 2005 1351111.Caller IDThis chapter provides information on caller ID:• Overview of Caller ID . . . . . . . . . . .

136 Voice API Programming Guide — June 2005Caller IDACLIP (Analog Calling Line Identity Presentation)a standard used in Singapore published by the Tel

Voice API Programming Guide — June 2005 137Caller ID11.3 Accessing Caller ID InformationYou can process caller ID information in your application in t

138 Voice API Programming Guide — June 2005Caller ID11.4 Enabling Channels to Use the Caller ID FeatureDuring Intel Dialogic System Service startup, b

Voice API Programming Guide — June 2005 139Caller ID• Bellcore specification TR-NWT-000030 (see Telcordia Technologies contact info provided in CLASS)

14 Voice API Programming Guide — June 2005About This Publication• Independent Software Vendors (ISVs)• Value Added Resellers (VARs)• Original Equipmen

140 Voice API Programming Guide — June 2005Caller ID

Voice API Programming Guide — June 2005 1411212.Cached Prompt ManagementThis chapter discusses the cached prompt management feature of the voice libra

142 Voice API Programming Guide — June 2005Cached Prompt Management2. Call SRLGetPhysicalBoardName( ) to return the physical board name, which is in t

Voice API Programming Guide — June 2005 143Cached Prompt Management• If the combined length of data specified in the series of DX_IOTT data structures

144 Voice API Programming Guide — June 2005Cached Prompt Management12.3 Cached Prompt Management Example CodeThis example code illustrates one way to

Voice API Programming Guide — June 2005 145Cached Prompt Managementdevh[i] = dx_open(&szBoardName[offset],0);}//Step 4 Download the prompts to a b

146 Voice API Programming Guide — June 2005Cached Prompt Managementtpt.tp_flags = TF_MAXDTMF;/* Open VOX file to play -- Linux only */ if ((fd = open(

Voice API Programming Guide — June 2005 1471313.Global Tone Detection and Generation, and Cadenced Tone GenerationThis chapter discusses global tone d

148 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone GenerationDTMF set (0-9, a-d, *, and #), and the st

Voice API Programming Guide — June 2005 149Global Tone Detection and Generation, and Cadenced Tone Generation• cadence components Adding a tone templa

Voice API Programming Guide — June 2005 15About This Publication• Chapter 15, “R2/MF Signaling” describes the R2/MF signaling protocol, the API functi

150 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone GenerationTips and Hints for Building Tone Template

Voice API Programming Guide — June 2005 151Global Tone Detection and Generation, and Cadenced Tone Generationdx_deltones( ) Removes all tone templates

152 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone Generation13.1.7 Setting GTD Tones as Termination C

Voice API Programming Guide — June 2005 153Global Tone Detection and Generation, and Cadenced Tone Generationdeviation of each of the two tones minus

154 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone Generationanalysis creates 8 GTD tones; this uses 1

Voice API Programming Guide — June 2005 155Global Tone Detection and Generation, and Cadenced Tone Generation13.1.11 Global Tone Detection Application

156 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone Generation• Duration of tone The functions and data

Voice API Programming Guide — June 2005 157Global Tone Detection and Generation, and Cadenced Tone Generation13.3 Cadenced Tone GenerationThe followin

158 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone Generationb. Use the dx_bldtngen( ) function to spe

Voice API Programming Guide — June 2005 159Global Tone Detection and Generation, and Cadenced Tone GenerationFigure 19. Example of Custom Cadenced Ton

16 Voice API Programming Guide — June 2005About This Publication

160 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone Generation13.3.3 How To Generate a Non-Cadenced Ton

Voice API Programming Guide — June 2005 161Global Tone Detection and Generation, and Cadenced Tone Generation13.3.6 Predefined Set of Standard PBX Cal

162 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone GenerationTable 19. Standard PBX Call Progress Sign

Voice API Programming Guide — June 2005 163Global Tone Detection and Generation, and Cadenced Tone GenerationFigure 20. Standard PBX Call Progress Sig

164 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone GenerationFigure 21. Standard PBX Call Progress Sig

Voice API Programming Guide — June 2005 165Global Tone Detection and Generation, and Cadenced Tone GenerationTable 20. TN_GENCAD Definitions for Stand

166 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone Generation13.3.7 Important Considerations for Using

Voice API Programming Guide — June 2005 167Global Tone Detection and Generation, and Cadenced Tone Generation• To generate a continuous, non-cadenced

168 Voice API Programming Guide — June 2005Global Tone Detection and Generation, and Cadenced Tone Generation

Voice API Programming Guide — June 2005 1691414.Global Dial Pulse DetectionGlobal dial pulse detection (global DPD) is a signaling component of the vo

Voice API Programming Guide — June 2005 1711.Product DescriptionThis chapter provides information on key voice library features and capability. The fo

170 Voice API Programming Guide — June 2005Global Dial Pulse Detection• The application can enable global DPD and volume control. (Previously, there w

Voice API Programming Guide — June 2005 171Global Dial Pulse DetectionGlobal DPD must be implemented on a call-by-call basis. Global DPD uses the dx_s

172 Voice API Programming Guide — June 2005Global Dial Pulse Detection14.6 Retrieving Digits as EventsTo get the digits as events, use the following a

Voice API Programming Guide — June 2005 173Global Dial Pulse Detection14.9 Global DPD Programming ProcedureUse the following procedure to implement gl

174 Voice API Programming Guide — June 2005Global Dial Pulse Detection /* enable DPD and DTMF digits */ dx_setdigtyp(dev, D_DPDZ|D_DTMF); /*

Voice API Programming Guide — June 2005 1751515.R2/MF SignalingThis chapter provides a description of R2/MF signaling protocol. The following topics a

176 Voice API Programming Guide — June 2005R2/MF SignalingR2/MF signals that are used for supervisory signaling on the network are called line signals

Voice API Programming Guide — June 2005 177R2/MF Signaling15.4 R2/MF Signal MeaningsThere are two groups of meanings associated with each set of signa

178 Voice API Programming Guide — June 2005R2/MF SignalingFigure 23. Multiple Meanings for R2/MF Signals In general, Group I forward signals and Group

Voice API Programming Guide — June 2005 179R2/MF SignalingThe incoming register backward signals can request:• Transmission of address – Send next dig

18 Voice API Programming Guide — June 2005Product DescriptionIn addition to original Springware products (also known as earlier-generation products),

180 Voice API Programming Guide — June 2005R2/MF SignalingTable 24. Meanings for R2/MF Group I Forward SignalsTone NumberIntel Define (A) Primary Mean

Voice API Programming Guide — June 2005 181R2/MF SignalingTable 25. Meanings for R2/MF Group II Forward SignalsTone NumberIntel Define Meaning1 SIGII_

182 Voice API Programming Guide — June 2005R2/MF SignalingTable 26. Meanings for R2/MF Group A Backward Signals Tone NumberIntel Define Meaning1 SIGA_

Voice API Programming Guide — June 2005 183R2/MF Signaling15.5 R2/MF Compelled SignalingR2/MF interregister signaling uses forward and backward compel

184 Voice API Programming Guide — June 2005R2/MF Signaling• As soon as the CO recognizes the CPE acknowledging signal, it stops sending the forward si

Voice API Programming Guide — June 2005 185R2/MF SignalingFigure 25. Example of R2/MF Signals for 4-digit DDI Application15.6 R2/MF Voice Library Func

186 Voice API Programming Guide — June 2005R2/MF SignalingFour sets of defines are provided to specify the 15 Group I and 15 Group II forward signals,

Voice API Programming Guide 1871616.Syntellect License Automated AttendantThis chapter discusses Intel® hardware and software that include a license f

188 Voice API Programming GuideSyntellect License Automated Attendant– receives digit input and transfers the call to the proper extension• the source

Voice API Programming Guide — June 2005 1891717.Building ApplicationsThis chapter provides information on building applications using the voice librar

Voice API Programming Guide — June 2005 19Product DescriptionSee Chapter 13, “Global Tone Detection and Generation, and Cadenced Tone Generation” for

190 Voice API Programming Guide — June 2005Building Applications17.2 Compiling and LinkingThe following topics discuss compiling and linking requireme

Voice API Programming Guide — June 2005 191Building Applicationslibsrl.so Standard Runtime Library file. Specify -lsrl in makefile. If you use curses,

192 Voice API Programming Guide — June 2005Building Applications

Voice API Programming Guide — June 2005 571GlossaryA-law: Pulse Code Modulation (PCM) algorithm used in digitizing telephone audio signals in E1 areas

572 Voice API Programming Guide — June 2005board locator technology (BLT): Operates in conjunction with a rotary switch to determine and set non-confl

Voice API Programming Guide — June 2005 573network. Computer telephony technology supports applications such as: automatic call processing; automatic

574 Voice API Programming Guide — June 2005download: The process where board level program instructions and routines are loaded during board initializ

Voice API Programming Guide — June 2005 575G.726: An international standard for encoding 8 kHz sampled audio signals for transmission over 16, 24, 32

576 Voice API Programming Guide — June 2005on-hook: Condition or state of a telephone line when a handset on the line is returned to its cradle (or an

Voice API Programming Guide — June 2005 577silence threshold: The level that sets whether incoming data to the voice board is recognized as silence or

Voice API Programming Guide – June 2005INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY

20 Voice API Programming Guide — June 2005Product Description1.6.1 Play and Record FunctionsThe voice library includes several functions and data stru

578 Voice API Programming Guide — June 2005TDM bus: Time division multiplexing bus. A resource sharing bus such as the SCbus or CT Bus that allows inf

Voice API Programming Guide — June 2005 201IndexAAdaptive Differential Pulse Code Modulation (ADPCM) 91address signals, R2/MF signaling 175ADPCM, G.72

202 Voice API Programming Guide — June 2005call status transitionevent handlingasynchronous 151synchronous 151call waiting tone 162caller IDaccessing

Voice API Programming Guide — June 2005 203dx_blddtcad( ) 149dx_bldst( ) 149dx_bldstcad( ) 149dx_bldtngen( ) 156DX_CAP data structure 48, 61, 70clear

204 Voice API Programming Guide — June 2005ETSI-FSK channel parameters 126ETSI-FSK specification 125event handling 27event management functions 27exe

Voice API Programming Guide — June 2005 205libsrl.so 190libsrlmt.lib 191line signals, R2/MF signaling 176linear PCM 90, 91linkinglibrary files 190, 1

206 Voice API Programming Guide — June 2005routing configuration (fixed/flexible)overview 35run-time linking 191Sshort message service (SMS) 121, 125

Voice API Programming Guide — June 2005 207TID_SIT_ANY 52TID_SIT_IC 52TID_SIT_INEFFECTIVE_OTHER 52TID_SIT_IO 52TID_SIT_NC 52TID_SIT_NC_INTERLATA 52TI

208 Voice API Programming Guide — June 2005

Voice API Programming Guide — June 2005 21Product Description1.6.6 Echo Cancellation ResourceThe echo cancellation resource (ECR) feature enables a vo

22 Voice API Programming Guide — June 2005Product Description1.10 TDM Bus RoutingA time division multiplexing (TDM) bus is a technique for transmittin

Voice API Programming Guide — June 2005 2322.Programming ModelsThis chapter briefly discusses the Standard Runtime Library and supported programming m

24 Voice API Programming Guide — June 2005Programming ModelsSynchronous programming models allow you to scale an application by simply instantiating m

Voice API Programming Guide — June 2005 2533.Device HandlingThis chapter describes the concept of a voice device and how voice devices are named and u

26 Voice API Programming Guide — June 2005Device HandlingFor example, a D/240JCT-T1 board employs 24 voice channels; the software therefore divides th

Voice API Programming Guide — June 2005 2744.Event HandlingThis chapter provides information on functions used to retrieve and handle events. Topics i

28 Voice API Programming Guide — June 2005Event HandlingEach of the event management functions applicable to the voice boards are listed in the follow

Voice API Programming Guide — June 2005 2955.Error HandlingThis chapter discusses how to handle errors that can occur when running an application. All

Voice API Programming Guide – June 2005 3ContentsRevision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

30 Voice API Programming Guide — June 2005Error Handling

Voice API Programming Guide — June 2005 3166.Application Development GuidelinesThis chapter provides programming guidelines and techniques for develop

32 Voice API Programming Guide — June 2005Application Development Guidelines6.1.2 Setting Termination Conditions for I/O FunctionsWhen an I/O function

Voice API Programming Guide — June 2005 33Application Development Guidelinesspecified in the tp_flags field of the DV_TPT. When this termination condi

34 Voice API Programming Guide — June 2005Application Development Guidelinesspecific digit received (DX_DIGMASK)Digits received during an I/O function

Voice API Programming Guide — June 2005 35Application Development GuidelinesTo specify an additional timeout if subsequent digits are not received, us

36 Voice API Programming Guide — June 2005Application Development Guidelinesdevices is predefined and static. The resource device also does not have a

Voice API Programming Guide — June 2005 37Application Development Guidelines6.3 Fixed Routing Configuration RestrictionsFlexible routing configuration

38 Voice API Programming Guide — June 2005Application Development Guidelines• Device Initialization Hint• TDM Bus Time Slot Considerations• Tone Detec

Voice API Programming Guide — June 2005 39Application Development Guidelines6.4.3 DM3 Media LoadsDifferent configurations for DM3 products are support

4 Voice API Programming Guide – June 2005Contents6.1 General Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

40 Voice API Programming Guide — June 2005Application Development GuidelinesWith some applications, this may cause slow device-initialization performa

Voice API Programming Guide — June 2005 41Application Development Guidelineshttp://resource.intel.com/telecom/support/tnotes/gentnote/dl_soft/tn253.ht

42 Voice API Programming Guide — June 2005Application Development Guidelinesduration = the value entered x 10 msecThe syntax of the function is:int du

Voice API Programming Guide — June 2005 4377.Call Progress AnalysisThis chapter provides detailed information about the call progress analysis feature

44 Voice API Programming Guide — June 2005Call Progress AnalysisThere are two forms of call progress analysis: PerfectCall call progress analysis Als

Voice API Programming Guide — June 2005 45Call Progress Analysis• positive answering machine detection (post-connect part of call progress analysis)•

46 Voice API Programming Guide — June 2005Call Progress AnalysisFigure 3. PerfectCall Call Progress Analysis Components 7.4 Using Call Progress Analys

Voice API Programming Guide — June 2005 47Call Progress AnalysisTable 4 provides information on call progress analysis scenarios supported with the dx

48 Voice API Programming Guide — June 2005Call Progress Analysis7.4.3 Setting Up Call Progress Analysis Parameters in DX_CAPThe call progress analysis

Voice API Programming Guide — June 2005 49Call Progress AnalysisNotes: 1. On DM3 boards, dx_dial( ) cannot be used to start an outbound call; instead

Voice API Programming Guide – June 2005 5Contents7.10 Using Call Progress Analysis on Springware Boards . . . . . . . . . . . . . . . . . . . . . . .

50 Voice API Programming Guide — June 2005Call Progress AnalysisFigure 4. Call Outcomes for Call Progress Analysis (DM3)7.4.6 Obtaining Additional Cal

Voice API Programming Guide — June 2005 51Call Progress Analysis7.5 Call Progress Analysis Tone Detection on DM3 BoardsThe following topics discuss to

52 Voice API Programming Guide — June 2005Call Progress AnalysisTID_RNGBK2 Ringback (detected as dual tone)TID_SIT_ANY Catch all (returned for a Speci

Voice API Programming Guide — June 2005 53Call Progress AnalysisTo enable ringback detection, turn on SIT frequency detection in the DX_CAP ca_intflg

54 Voice API Programming Guide — June 2005Call Progress AnalysisTable 5 shows default tone definitions for SIT sequences used on DM3 boards. The value

Voice API Programming Guide — June 2005 55Call Progress Analysis7.6 Media Tone Detection on DM3 BoardsMedia tone detection in call progress analysis i

56 Voice API Programming Guide — June 2005Call Progress Analysisdetects live voice as accurately as PAMD_FULL but is more accurate than PAMD_FULL (alt

Voice API Programming Guide — June 2005 57Call Progress Analysis7.8 Modifying Default Call Progress Analysis Tone Definitions on DM3 BoardsOn DM3 boar

58 Voice API Programming Guide — June 2005Call Progress Analysisdx_deletetone( ) deletes a specific call progress tone dx_createtone( ) creates a new

Voice API Programming Guide — June 2005 59Call Progress AnalysisTONE_DATA.numofseg Specifies the number of segments for a multi-segment tone. 7.8.3 Ru

6 Voice API Programming Guide – June 2005Contents8.9.2 Enabling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

60 Voice API Programming Guide — June 2005Call Progress AnalysisConsider the following guidelines when creating a single tone proxy:• It is recommende

Voice API Programming Guide — June 2005 61Call Progress Analysis• Determining the Outcome of a Call• Obtaining Additional Call Outcome Information7.10

62 Voice API Programming Guide — June 2005Call Progress Analysis• DX_PAMDENABLE. Enables PAMD, PVD, and fax tone detection.• DX_PAMDOPTEN. Enables PAM

Voice API Programming Guide — June 2005 63Call Progress Analysis7.10.5 Determining the Outcome of a CallIn asynchronous mode, once dx_dial( ) with cal

64 Voice API Programming Guide — June 2005Call Progress AnalysisFigure 5. Call Outcomes for Call Progress Analysis (Springware)7.10.6 Obtaining Additi

Voice API Programming Guide — June 2005 65Call Progress AnalysisATDX_FRQDUR3( ) Returns duration of third frequency detected. ATDX_FRQHZ( ) Returns fr

66 Voice API Programming Guide — June 2005Call Progress Analysis7.11.1 Tone Detection OverviewPerfectCall call progress analysis uses a combination of

Voice API Programming Guide — June 2005 67Call Progress Analysis7.11.3 Dial Tone DetectionWherever call progress analysis is in effect, a dial string

68 Voice API Programming Guide — June 2005Call Progress AnalysisThe following DX_CAP fields govern ringback behavior: ca_stdely Start Delay: the dela

Voice API Programming Guide — June 2005 69Call Progress AnalysisSome telephone systems return a momentary drop in loop current when a connection has b

Voice API Programming Guide – June 2005 7Contents11.4 Enabling Channels to Use the Caller ID Feature. . . . . . . . . . . . . . . . . . . . . . . . .

70 Voice API Programming Guide — June 2005Call Progress Analysis7.12.1 Positive Voice Detection (PVD)Positive voice detection (PVD) can detect when a

Voice API Programming Guide — June 2005 71Call Progress Analysisca_pamd_qtemp PAMD Qualification Template: the algorithm to use in PAMD. At present t

72 Voice API Programming Guide — June 2005Call Progress AnalysisThe voice driver contains default definitions for each of these tones. The default def

Voice API Programming Guide — June 2005 73Call Progress Analysis7.15.1 Tri-Tone SIT SequencesSIT frequency detection operates simultaneously with all

74 Voice API Programming Guide — June 2005Call Progress Analysis3. After a SIT sequence is detected, ATDX_CPTERM( ) will return CR_CEPT to indicate an

Voice API Programming Guide — June 2005 75Call Progress Analysisca_lower2frq Lower bound for second tone in Hz. Default: 0. ca_upper2frq Upper bound f

76 Voice API Programming Guide — June 2005Call Progress AnalysisATDX_FRQDUR2( ) Duration of the tone detected in the tone detection range specified by

Voice API Programming Guide — June 2005 77Call Progress Analysis7.15.6 Setting Single Tone Frequency Detection ParametersThe information in this secti

78 Voice API Programming Guide — June 2005Call Progress Analysis7.16 Cadence Detection in Basic Call Progress Analysis (Springware Only)Cadence detect

Voice API Programming Guide — June 2005 79Call Progress AnalysisFigure 6. A Standard Busy SignalFigure 7. A Standard Single RingFigure 8. A Type of Do

8 Voice API Programming Guide – June 2005Contents15 R2/MF Signaling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

80 Voice API Programming Guide — June 2005Call Progress AnalysisFigure 9. Cadence DetectionOnce the cadence is established, the cadence values can be

Voice API Programming Guide — June 2005 81Call Progress Analysis7.16.4 Outcomes of Cadence DetectionCadence detection can identify the following condi

82 Voice API Programming Guide — June 2005Call Progress Analysis7.16.5 Setting Selected Cadence Detection ParametersOnly the most commonly adjusted ca

Voice API Programming Guide — June 2005 83Call Progress AnalysisFigure 11. No Ringback Due to Continuous No Signal If the length of any period of nons

84 Voice API Programming Guide — June 2005Call Progress Analysisca_nsbusyNonsilence Busy: the number of nonsilence periods in addition to ca_nbrdna to

Voice API Programming Guide — June 2005 85Call Progress AnalysisCadence detection will measure the length of the salutation when the ca_hedge (hello e

86 Voice API Programming Guide — June 2005Call Progress AnalysisAfter call progress analysis is complete, call ATDX_ANSRSIZ( ). If the return value is

Voice API Programming Guide — June 2005 8788.Recording and PlaybackThis chapter discusses playback and recording features supported by the voice libra

88 Voice API Programming Guide — June 2005Recording and Playback8.2 Digital Recording and PlaybackIn digital speech recording, the voice board convert

Voice API Programming Guide — June 2005 89Recording and Playbackentry for that file. Using dx_playf( ) is more convenient for a single file playback b

Voice API Programming Guide – June 2005 9ContentsFigures1 Cluster Configurations for Fixed and Flexible Routing . . . . . . . . . . . . . . . . . . .

90 Voice API Programming Guide — June 2005Recording and PlaybackNote: On DM3 boards, not all voice coders are available on all boards. The availabilit

Voice API Programming Guide — June 2005 91Recording and PlaybackNote: On Springware boards, voice coders listed here are not available in all situatio

92 Voice API Programming Guide — June 2005Recording and Playback• Subsequent pairs of the code words are packed in the same way into successive octets

Voice API Programming Guide — June 2005 93Recording and PlaybackOn Springware boards on Linux, use the following functions for transaction record: dx_

94 Voice API Programming Guide — June 2005Recording and Playbackwith SCR. For more information on modifying SCR parameters, see the Configuration Guid

Voice API Programming Guide — June 2005 95Recording and Playback• G.711 PCM, 6 kHz with 8-bit samples (48 kbps) and 8 kHz with 8-bit samples (64 kbps)

96 Voice API Programming Guide — June 2005Recording and Playback8.9.2 EnablingThe modes related to the voice activity detector are specified in the mo

Voice API Programming Guide — June 2005 97Recording and Playback• G.726 bit-exact voice coder at 8 kHz with 2-, 3-, 4-, or 5-bit samples (16, 24, 32,

98 Voice API Programming Guide — June 2005Recording and Playback8.10.3 Implementing Streaming to BoardPerform the following steps to implement streami

Voice API Programming Guide — June 2005 99Recording and Playback• Recommendation for the high water mark: it should be based on the following:(size of