Go to page of
A good user manual
The rules should oblige the seller to give the purchaser an operating instrucion of Intel 05-2505-001, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.
What is an instruction?
The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Intel 05-2505-001 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.
Unfortunately, only a few customers devote their time to read an instruction of Intel 05-2505-001. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.
What should a perfect user manual contain?
First and foremost, an user manual of Intel 05-2505-001 should contain:
- informations concerning technical data of Intel 05-2505-001
- name of the manufacturer and a year of construction of the Intel 05-2505-001 item
- rules of operation, control and maintenance of the Intel 05-2505-001 item
- safety signs and mark certificates which confirm compatibility with appropriate standards
Why don't we read the manuals?
Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Intel 05-2505-001 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Intel 05-2505-001, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Intel service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Intel 05-2505-001.
Why one should read the manuals?
It is mostly in the manuals where we will find the details concerning construction and possibility of the Intel 05-2505-001 item, and its use of respective accessory, as well as information concerning all the functions and facilities.
After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.
Table of contents for the manual
-
Page 1
Conferencing API Pr ogramming Guide A ugust 2006 05-2505-00 1[...]
-
Page 2
Conferencing API Programm ing Guide – August 2006 INFORMA TION IN THIS DO CUMENT IS PRO VIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EX PRESS OR IMPLIED , BY EST OPPEL OR O THER WISE, T O ANY INTELLECTU AL PR OPER TY RIGHTS IS GRANTED BY THIS DOCUMENT . EXCEPT AS PR O VIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS,[...]
-
Page 3
Conferencing API Program m ing Guide – August 2006 3 Contents Revision H istory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Purpo[...]
-
Page 4
4 Conferencing API Programm ing Guide – August 2006 Contents 8.1.1 Include Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 8.1.2 Required Lib raries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 8.2 Variables for Compiling a[...]
-
Page 5
Conferencing API Programming G uide — August 2006 5 Re vision Histor y This re vision history summarizes the changes made in each published vers ion of this document. Document No. Publication Date Description of Revisions 05-2505-001 A u gust 2006 Initial version of document.[...]
-
Page 6
6 Conferencing API Progra mming Guide — August 2006 Revisi on History[...]
-
Page 7
Conferencing API Programming G uide — August 2006 7 About This Pub lication The following topics provide more inform ation about this publication: • Purpose • Applicability • Intended Audience • How to Use This Publication • Related Information Purpose This publication provides programming gu idelines for the co nferencing API, supporte[...]
-
Page 8
8 Conferencing API Progra mming Guide — August 2006 About This Public ation How to Use This Pub lication This document assumes that y ou are familiar with the Linux* or Windo ws* operatin g systems and the C programming language. The information in this docum ent is organized as follo ws: • Chapter 1, “Produ ct Description” introduces the k[...]
-
Page 9
Conferencing API Programming G uide — August 2006 9 1 1 . Pr oduct Description This chapter provides an ov erview of th e conferencing library . T opics include: • Overvie w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 • K ey Features . . . . . . . . . . . . . . . . [...]
-
Page 10
10 Conferencing API Progra mming Guide — August 2006 Produc t Description DTMF digit detection The application can determine whether a party has generated a DTMF digit. Vo l u m e c o n t r o l A party can adjust the listening volume of th e conference using pre-pr ogra mmed DTMF di gits. DTMF tone clamping This feature mutes dual tone multi-freq[...]
-
Page 11
Conferencing API Programming G uide — August 2006 11 Pr oduct Descriptio n A conference may be formed from parties that are connected to an y one of th e follo win g technology device handles: • voice (dx) de vice han dle • IP media (ipm) device handle • digital network interface (dti) de vice handle Note: A de vice hand le obtained from gc[...]
-
Page 12
12 Conferencing API Progra mming Guide — August 2006 Produc t Description through the device management library . For more information about device management functions, see the Device Manag ement API Library Refer ence . 1.4.3 V oice API Library The voice API pro vides a collection of functions supporting call processing such as dual ton e multi[...]
-
Page 13
Conferencing API Programming G uide — August 2006 13 2 2 . Pr ogramming Models This chapter describes the programming models supported by the confer encing software. The follo wing topics are covered: • Programming Models Overvie w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 • Asynchronous Programmin[...]
-
Page 14
14 Conferencing API Progra mming Guide — August 2006 Progra mm ing Models[...]
-
Page 15
Conferencing API Programming G uide — August 2006 15 3 3 . Event Handling All conferencing e vents are retrieved using St andard Runtime Library (SRL) e vent retriev al mechanisms, including ev ent handlers. The SRL is a de vice-independent library cont aining ev ent management functions and Standard At tribute func tions. This chapter lists SRL [...]
-
Page 16
16 Conferencing API Progra mming Guide — August 2006 Event Handling ATDV_NAMEP( ) pointer to device name ATDV_SUBDEVS( ) number of subde vices Note: See the Standard Runtime Library API Libr ary Reference for function details.[...]
-
Page 17
Conferencing API Programming G uide — August 2006 17 4 4 . Err or Handling This chapter describes error hand ling for the conferencing software. All conferencing functions return a v alue that indicates the success or f ailure of the function call. Success is indicated b y a return v alue of CN F_ SUCCESS . Failure is in dicated b y a value of CN[...]
-
Page 18
18 Conferencing API Progra mming Guide — August 2006 Error Handling[...]
-
Page 19
Conferencing API Programming G uide — August 2006 19 5 5 . Application De velopment Guidelines This chapter contains guidelines for dev eloping conferenci ng applications. The following topics are cov ered: • Using Symbolic Def ines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 • Using Conf[...]
-
Page 20
20 Conferencing API Progra mming Guide — August 2006 Application Development Gu idelines devices at once. A conference device and a party device are independent; that is, you can open a party device without first opening a conference device. 5.3 Creating a Conference The following steps describe ho w to create a conference. See the Gl ossary for [...]
-
Page 21
Conferencing API Programming G uide — August 2006 21 Application Development Guide lines 11. If desired, you can specify attributes for a party using cnf_SetA ttributes( ) . A ttributes are contained in the CNF_A TTR data stru cture. Use cnf_GetAttributes( ) to return the current attributes for the party . 12. Before a party can participate in a [...]
-
Page 22
22 Conferencing API Progra mming Guide — August 2006 Application Development Gu idelines • Even though two (or more) conferences can be bridged together , the attributes and settings of each conference remain unchang ed. The application is responsible for managing each conference and conference related e vents separately . • The coach/pupil f[...]
-
Page 23
Conferencing API Programming G uide — August 2006 23 Application Development Guide lines 5.7 Multipr ocessing Considerations Having multiple processes acting on the sam e board is undesirable. It is recommended to use a single process per board, or a single process for al l boards, rather than more than one process acting on the same board. Consi[...]
-
Page 24
24 Conferencing API Progra mming Guide — August 2006 Application Development Gu idelines[...]
-
Page 25
Conferencing API Programming G uide — August 2006 25 6 6 . Using Active T alker This chapter provides information about the acti ve talker feature. An acti ve talker refers to a party in a confer ence who is pro viding “non -silence” energ y . Activ e talkers are determined by the loudness or strength of their “non-silence” ener gy . The [...]
-
Page 26
26 Conferencing API Progra mming Guide — August 2006 Using Active T alker[...]
-
Page 27
Conferencing API Programming G uide — August 2006 27 7 7 . Using V olume Contr ol This chapter provides informat ion about controlling th e volume le vel in a conferen ce. A party in a conference may wish to change the volume le vel of the recei ved signal. This is accomplished using the vo lume control feature. The cnf_SetDTMFCon trol( ) functio[...]
-
Page 28
28 Conferencing API Progra mming Guide — August 2006 Using V olume Contr ol[...]
-
Page 29
Conferencing API Programming G uide — August 2006 29 8 8 . Building Applications This chapter provides information on building a pplications using the conferencing API library . The following topics are discussed: • Compiling and Linking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 • V a[...]
-
Page 30
30 Conferencing API Progra mming Guide — August 2006 Building Applications If you use other library functions such as voice or IP media, you will hav e to include the header files for that library: dxxxlib.h Contains function prototypes and symbolic defines for the v oice library . dtilib.h Contains function prototypes an d symbolic def ines for [...]
-
Page 31
Conferencing API Programming G uide — August 2006 31 Building Applicat ions Linux In Linux, you must link the following library files in the order sho wn when compiling your conferencing application: libsrl.so Standard Runtime Library file. Required in all applications. Specify -lsrl in makefile. libdxxx.so the primary voice library f ile. Requi [...]
-
Page 32
32 Conferencing API Progra mming Guide — August 2006 Building Applications[...]
-
Page 33
Conferencing API Programming G uide — August 2006 33 Glossar y active tal ker: A participant in a conf erence who is providin g “non-silence” ener gy . automatic g ain control (A GC ): An electronic circuit used to maintain the audio signal volume at a constant lev el. AGC maintains nearly constant gain during voice signals, thereby a voiding[...]
-
Page 34
34 Conferencing API Progra mming Guide — August 2006 configuratio n file: An unformat ted ASCII file that stores de vice initializati on information for an application. configuratio n manager: A utility with a graphical user interface (GUI) that enables you to add new boards to your system, start and stop system service, and work with board confi[...]
-
Page 35
Conferencing API Programming G uide — August 2006 35 pupil: A participant in a conference that has a mentoring relationship with a coach. resour ce: Funct ionality (for example, conferencing) that can be assigned to a call. Resources are shared whe n functionality is selectiv ely assigned to a call a nd may be shared among mu ltiple calls. Resour[...]
-
Page 36
36 Conferencing API Progra mming Guide — August 2006 tone c lamping: (DTMF tone clamping) Mutes DTMF tones h eard in a conference. If a confereee’ s phon e generates a tone, the DTMF signal will not inte rfere with the conference. Applies to transmitted aud io into the conference and does not affe ct DTMF function. time divisi on multiplexing ([...]
-
Page 37
Conferencing API Programming G uide — August 2006 37 Inde x A active talker enabling 25 feature description 10 asynchronous callback model, Linux 13 asynchronous mode programming Linux 13 asynchronous models Linux 13 asynchronous polled model Linux 13 asynchronous programming model 9 , 20 ATDV_ERRMSGP( ) 15 , 17 ATDV_LASTERR( ) 15 , 17 ATDV_NAMEP[...]
-
Page 38
38 Conferencing API Programmi ng Guide — August 2006 ipmlib.h 30 L libcnf.lib 30 libcnf.so 31 libdevmgmt.lib 30 libdevmgmt.so 31 libdti.so 31 libdtimt.li b 30 libdxxmt.lib 30 libdxxx.so 31 libgc.lib 30 libgc.so 31 libipm.lib 30 libipm.so 31 libsrl.so 31 libsrlmt.lib 30 linking applications 29 M monitoring a conference 10 multiprocessing considera[...]