Page 3 - Contents
Voice API for Linux Demo Guide – June 2005 3 Contents Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...
Page 4 - Revision History
Voice API for Linux Demo Guide — June 2005 4 Revision History This revision history summarizes the changes made in each published version of this document. Document No. Publication Date Description of Revisions 05-2342-002 June 2005 Demo Descriptions chapter : Added custserv, dpddemo, and d40demo. A...
Page 5 - About This Publication; Purpose
Voice API for Linux Demo Guide — June 2005 5 About This Publication The following topics provide information about the Voice API for Linux Demo Guide : • Purpose • Applicability • Intended Audience • How to Use This Publication • Related Information Purpose This publication describes the voice demon...
Page 6 - How to Use This Publication; Related Information
6 Voice API for Linux Demo Guide — June 2005 About This Publication How to Use This Publication This publication assumes that you understand computer telephony terms and concepts, and are familiar with the Linux operating system and the C programming language. The information in this guide is organi...
Page 9 - System Requirements; Hardware Requirements
Voice API for Linux Demo Guide — June 2005 9 2 2. System Requirements The requirements for running the voice demos are described in the following sections: • Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 • Software Requirement...
Page 11 - Preparing to Run the Demos
Voice API for Linux Demo Guide — June 2005 11 3 3. Preparing to Run the Demos This chapter provides information on preparations to follow before running a voice demo. Before you run a voice demo program, ensure that you have performed the following: 1. Adhered to the hardware and software requiremen...
Page 13 - Running the Demos; Starting the Demo; Starting the cbansr demo
Voice API for Linux Demo Guide — June 2005 13 4 4. Running the Demos This chapter describes how to run the voice demos. Topics include: • Starting the Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 • Demo Options . . . . . . . . . . ...
Page 14 - Starting the pansr demo; Starting the custserv demo
14 Voice API for Linux Demo Guide — June 2005 Running the Demos 4.1.2 Starting the pansr demo To run the pansr demo, follow these instructions: 1. Open a command prompt window and go to the directory where the demo is located. The default location is the /demos/dx_demos/ansr directory under INTEL_DI...
Page 15 - Starting the d40demo; Demo Options
Voice API for Linux Demo Guide — June 2005 15 Running the Demos Note: On Linux, the demo name is case-sensitive and must be entered as shown. The demo options are described in Table 1, “Voice Demo Options” , on page 15. If you don’t specify an option, default options are assumed. 4.1.5 Starting the ...
Page 16 - Examples; Using the Demo; Using the cbansr demo
16 Voice API for Linux Demo Guide — June 2005 Running the Demos Examples To run the cbansr demo on a D/41JCT-LS board, specify the following: . /cbansr -d1 -n4 -fAnalog To run the pansr demo on a D/120JCT-LS board using four channels, specify the following: . /pansr -d1 -n4 -fAnalog 4.3 Using the De...
Page 17 - Using the pansr demo
Voice API for Linux Demo Guide — June 2005 17 Running the Demos 7. Hang up the telephone. 8. Press Ctrl-C to terminate the demo. Note: If you do not terminate the demo using Ctrl-C, the driver for the demo does not unload after quitting the program, necessitating a reboot before another demo can be ...
Page 18 - Using the dpddemo
18 Voice API for Linux Demo Guide — June 2005 Running the Demos 5. Press Ctrl-C to terminate the demo. Note: If you do not terminate the demo using Ctrl-C, the driver for the demo does not unload after quitting the program, necessitating a reboot before another demo can be loaded. 4.3.4 Using the dp...
Page 19 - Stopping the Demo
Voice API for Linux Demo Guide — June 2005 19 Running the Demos 4.4 Stopping the Demo Press Ctrl-C at any time to exit a voice demo. All channels and files are properly closed by the demo.
Page 21 - Demo Details; Files Used by cbansr and pansr; Files Used by custserv
Voice API for Linux Demo Guide — June 2005 21 5 5. Demo Details This chapter provides more detail about the voice demos. You do not need this information to run the demos successfully. • Files Used by cbansr and pansr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...
Page 22 - Files Used by dpddemo; Files Used by d40demo
22 Voice API for Linux Demo Guide — June 2005 Demo Details 5.3 Files Used by dpddemo Table 4 lists the files that are used by the dpddemo. 5.4 Files Used by d40demo Table 5 lists the files that are used by the d40demo. Table 3. Files Used by the custserv File Name Purpose custserv Executable file cu...
Page 23 - Supplementary Information for d40demo; Source Code Overview
Voice API for Linux Demo Guide — June 2005 23 Demo Details 5.5 Supplementary Information for d40demo Supplementary information on the d40demo is given in the following topics: • Source Code Overview • Global Variables • Initialization Routine • Menu System Routine • Messaging System Routine 5.5.1 So...
Page 24 - Global Variables
24 Voice API for Linux Demo Guide — June 2005 Demo Details Since d40demo is also a working order entry system, the source code contains nonsystem routines that are specific to the order entry application. The d40demo.c module contains the routines that manage a simple database, which are called the ...
Page 25 - Menu System Routine; Model of the Menu System
Voice API for Linux Demo Guide — June 2005 25 Demo Details if (rc == 0) { close(0); . . The code that follows the close( ) function call within the if statement is only executed in the child process. The parent process fails the (rc == 0) comparison and loops back to the while statement. When all th...
Page 26 - Implementation; DL_MENU Data Structure
26 Voice API for Linux Demo Guide — June 2005 Demo Details When input is received from the caller, four things can happen: control is passed to another menu; an action is performed; an action is performed and control is passed to another menu; an error message is played (invalid input). All menus pr...
Page 27 - DL_MNUOPTS Data Structure
Voice API for Linux Demo Guide — June 2005 27 Demo Details that can be used, DL_PREV and DL_CURR. DL_PREV returns the caller to the previous menu, and DL_CURR returns the caller to the current menu. me_validfnc Validation Function - Pointer to the function that validates the caller's response. This ...
Page 29 - DL_DATA Data Structure
Voice API for Linux Demo Guide — June 2005 29 Demo Details DL_DATA Data Structure The DL_DATA structure defines the termination conditions for getting the response to the menu options. It holds the values for several fields that map to corresponding DV_TPT elements used when getting a caller's respo...
Page 33 - Messaging System Routine
Voice API for Linux Demo Guide — June 2005 33 Demo Details check_term( ) uses ATDX_TERMMSK( ) attribute to check the termination type. If the I/O function was terminated for any of the cases, the function calls a longjmp( ) and returns to idlestate. If none of these terminations occurred, the caller...
Page 35 - Index
Voice API for Linux Demo Guide — June 2005 35 Index A A 7 answer.h 21 , 22 asynchronous callback programming model 7 asynchronous polled programming model 7 C cbansr demo command line options 15description 7exiting 17files used 21 , 22 running 16starting 13 cbansr executable file 21 cbansr.c 21 cust...