Dialogic Brooktrout digital board Operator's manual

www.dialogic.com

March 2013 931-131-11

Dialogic® Brooktrout® Fax Products SDK

Installation and Configuration Guide

Release 6.6

page 2

without permission in writing from Dialogic Inc. 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 Inc. and its affiliates or 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.

IINFORMATION 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.

Dialogic products are not intended for use in certain safety-affecting situations. Please see

http://www.dialogic.com/company/terms-of-use.aspx for more details.

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 Inc. 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 6700 de la

Cote-de-Liesse Road, Suite 100, Borough of Saint-Laurent, Montreal, Quebec, Canada H4T 2B5. Dialogic encourages

all users of its products to procure all necessary intellectual property licenses 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.

Dialogic, Dialogic Pro, Dialogic Blue, Veraz, Brooktrout, Diva, BorderNet, PowerMedia, ControlSwitch, I-Gate, Mobile

Experience Matters, Network Fuel, Video is the New Voice, Making Innovation Thrive, Diastar, Cantata, TruFax,

SwitchKit, Eiconcard, NMS Communications, SIPcontrol, Exnet, EXS, Vision, inCloud9, NaturalAccess and Shiva,

among others as well as related logos, are either registered trademarks or trademarks of Dialogic Inc. and its affiliates or

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 6700 de la Cote-de-Liesse Road, Suite 100, Borough of Saint-Laurent,

Montreal, Quebec, Canada H4T 2B5. Any authorized use of Dialogic's trademarks will be subject to full respect of the

trademark guidelines published by Dialogic from time to time and any use of Dialogic's trademarks requires proper

acknowledgement.

The names of actual companies and products mentioned herein are the trademarks of their respective owners.

page 3

Hardware Limited Warranty

Refer to the following Dialogic web site for information on hardware warranty information, which applies

unless different terms have been agreed to in a signed agreement between yourself and Dialogic Corporation

or its subsidiaries. The listed hardware warranty periods and terms are subject to change without notice. For

purchases not made directly from Dialogic please contact your direct vendor in connection with the warranty

period and terms that they offer.

http://www.dialogic.com/warranties

page 4

SOFTWARE DEVELOPER LICENSE AGREEMENT

*** IMPORTANT ***

PLEASE READ CAREFULLY BEFORE USING THE SOFTWARE.

This Software Developer License Agreement is a legal agreement between Dialogic Corporation, and its affiliates or

subsidiaries (collectively, “Dialogic”) and you (either an individual or an entity) (“Developer”). IF YOU HAVE A

WRITTEN, SIGNED LICENSE AGREEMENT GOVERNING THE USE OF THE ACCOMPANYING

SOFTWARE, THE TERMS AND CONDITIONS OF THAT AGREEMENT WILL APPLY TO YOUR USE OF THE

SOFTWARE. IF YOU HAVE WRITTEN, SIGNED SPECIAL TERMS GOVERNING THE USE OF THE

ACCOMPANYING SOFTWARE (“SPECIAL TERMS”), THOSE SPECIAL TERMS ARE HEREBY

INCORPORATED INTO THIS AGREEMENT. Read the following terms and conditions carefully before using the

accompanying software. They define your rights and obligations with respect to the enclosed Software. If you do not

agree to the terms of this Software Developer License Agreement, promptly return the Developer License Key that you

obtained for the Software or the Dialogic® Hardware that you purchased for use with the Software, if any, to the place

you obtained it for a full refund. USING THE SOFTWARE INDICATES YOUR AGREEMENT WITH AND

ACCEPTANCE OF THE FOLLOWING TERMS AND CONDITIONS. AN INDIVIDUAL WHO DOES NOT HAVE

AUTHORITY TO BIND THE ENTITY USING THE SOFTWARE SHOULD NOT USE THE SOFTWARE WITHOUT

OBTAINING APPROVAL OF THIS AGREEMENT FROM A PERSON HAVING SUCH AUTHORITY.

YOU UNDERSTAND THAT IF YOU PURCHASED THE PACKAGE FROM AN AUTHORIZED RESELLER OF

DIALOGIC, THAT RESELLER IS NOT DIALOGIC’S AGENT AND IS NOT AUTHORIZED TO MAKE ANY

REPRESENTATIONS, CONDITIONS OR WARRANTIES, STATUTORY OR OTHERWISE, ON DIALOGIC'S BEHALF

NOR TO VARY ANY OF THE TERMS OR CONDITIONS OF THIS AGREEMENT. IN ADDITION, YOU

ACKNOWLEDGE THAT, UNLESS OTHERWISE AGREED BY THAT RESELLER IN WRITING OR PROHIBITED BY

LAW, THE LIMITATIONS OF CONDITIONS AND WARRANTIES, STATUTORY OR OTHERWISE, AND LIABILITY

SET FORTH IN THIS AGREEMENT ALSO APPLY TO AND BENEFIT THAT RESELLER.

The Software may include object code versions of third party software packages, including one or more of

the following, which are subject to the terms and conditions of the applicable license agreements found at

the websites identified below. Please refer to the attached Exhibit A to find out which, if any, licenses are

applicable.

ACE™ software and TAO™ software are copyrighted by Douglas C. Schmidt and his research group at

Washington University, University of California, Irvine, and Vanderbilt University Copyright (c)

http://www.cs.wustl.edu/~schmidt/ACE.html

Smart, Robert Roebling et al. More information is available at:

http://www.wxWindows.org

1. Definitions

1.1. “Dialogic Hardware” means voice and/or fax processing hardware and/or any other computer hardware

manufactured by or for Dialogic which may (without limitation) be marketed under the brands Dialogic, Brooktrout,

Excel, and/or Snowshore and purchased by the End User from Dialogic or one of its authorized resellers.

1.2. “Developer License Key” means an access code or activation key provided by Dialogic to enable a Developer to use

the Software for the purposes set forth herein.

1.3. “End User” means the ultimate user of the Software who has obtained such Software pursuant to an End User

Agreement.

1.4. “End User Agreement” means a sublicense agreement granting an End User the right to use the Software internally

but not to further distribute or sublicense such Software, which agreement meets the requirements of Section 2.8.

1.5. “Integrated Product”meanstheSoftwareasintegratedwithoneormoreofDeveloper’s products to provideenhanced

functionality.

1.6. “License Key” means an access code or activation key provided by Dialogic to enable an End User to use the Software.

1.7. “Software” means thesoftwareprovidedtoyouintheenclosedpackage, or enabled by theenclosedDeveloperLicense

Key together with any accompanying documentation.

1.8. “Sublicensee” means any reseller, dealer, distributor or other entity authorized by Developer pursuant to a

Sublicense Agreement meeting the requirements of Section 2.9, to sublicense the use of and distribution of the

Software to End Users or other intermediate parties, such as dealers, in the distribution chain to End Users.

page 5

2. License

2.1. Demonstration or Evaluation. If the Software is provided to Developer as a demonstration or evaluation unit, (a) the

licenses granted in Section 2.2 shall not apply and (b) Dialogic grants the Developer, and the Developer accepts, a

non-exclusive, non-transferable right and license (without the right to grant sublicenses) to use the Software for a

period of ninety (90) days from the date of delivery of the Software to Developer for the sole purpose of evaluating

the suitability of such Software. Under no circumstances shall the Software be used for any commercial purposes,

and Developer is not being granted any rights to distribute the Software under this Agreement without the express

written permission of Dialogic.

2.2. License Grant. Subject to the terms and conditions contained herein, Dialogic grants Developer a license to use and

distribute the Software subject to and in accordance with the following provisions.

a. If the Software is distributed to Developer for use with Dialogic Hardware, Dialogic grants Developer a

royalty-free, non-transferable license (without the right to grant sublicenses, except as set forth in Section 2.9)

to (i) use the Software solely for the purposes of developing Integrated Products; (ii) make copies of the Software

for distribution to End Users, whether as a stand-alone product or as part of an Integrated Product, solely for

use by such End Users for their internal business purposes in connection with Dialogic Hardware; and (iii)

distribute the Software to End Users, whether as a stand-alone product or as part of an Integrated Product,

solely for use by such End Users for their internal business purposes in connection with Dialogic Hardware. The

Software is used in connection with Dialogic Hardware if it is operated only on the central processing unit of a

computer served by one or more items of Dialogic Hardware and, where appropriate in connection with such use,

it is downloaded into memory located on Dialogic Hardware.

b. If the Software is distributed to Developer as host-based media processing software, Dialogic grants Developer

a royalty-bearing, non-transferable license (without the right to grant sublicenses, except as set forth in Section

2.9) to (i) use the Software solely for the purpose of developing Integrated Products; (ii) make copies of the

Software for distribution to End Users, whether as a stand-alone product or as part of an Integrated Product for

the End Users’ internal business purposes; and (iii) distribute copies of the Software to End Users, whether as

a stand-alone product or as part of an Integrated Product for the End Users’ internal business purposes, subject

to the purchase by the End User of a License Key. Developer shall not distribute or otherwise transfer any

Developer License Key for any purpose without Dialogic’s prior written consent.

2.3. Copies. Developer shall not remove or alter any copyright or other proprietary notices that appear on the Software

and shall include all such notices on all copies of the Software (including without limitation all copies of the Software

that are incorporated into Integrated Products).

2.4. No Reverse Engineering. Developer shall have no rights to any source code for the Software. Developer agrees that

it shall not cause or permit the disassembly, decompilation or reverse engineering of the Software or otherwise

attempt to gain access to the source code to the Software. If applicable law requires access to source code for some

purpose, such as inter-operability with other software, and Developer desires access for that required purpose,

Developer shall notify Dialogic, and Dialogic shall have the option, in its discretion, to (i) perform the work to derive

any required information at Dialogic’s usual consulting rate, or (ii) allow Developer access to source code solely for

the legally required purpose.

2.5. Additional Restrictions. Developer shall not, and shall not permit any third party to disclose the results of any

benchmark test of the Software to a third party without the prior written approval of Dialogic.

2.6. Reservation of Rights. Dialogic and its licensors reserve all rights not otherwise expressly granted in this Section 2.

Any use, modification, reproduction or distribution of the Software not expressly permitted under this Agreement is

hereby expressly prohibited.

2.7. License Keys. The use of the Software may require a License Key. Developer shall not (a) use any access code or

activation key other than the Developer License Key (if any) provided by Dialogic or (b) develop or alter any access

code for the Software or otherwise circumvent or attempt to circumvent the License Key or Developer License Key.

2.8. End User Agreements. The Software shall be distributed to each End User under an End User Agreement entered

into by such End User which may be a shrink-wrap, break-the-seal or click-wrap or executed written agreement

which provides for the same level of protection of Dialogic’s title, rights and defenses as this Agreement, and

pursuant to which the End User agrees (a) to use the Software solely for its own internal business purposes, and not

for further distribution or licensing; (b) not to copy the Software in whole or in part, except as permitted under

applicable law, and then only with the inclusion of all copyright, proprietary and other notices; (c) not to permit any

parent, subsidiaries, affiliated entities or third parties to use the Software; and (d) not rent, lease, loan or transfer

the Software. Where the Software or Integrated Product is distributed to an End User pursuant to Section 2.2(a),

the End User shall also agree to use the Software solely in connection with Dialogic Hardware. Developer may

include in such End User Agreement, the terms of the limited warranty attached as Exhibit B hereto.

2.9. Sublicenses. Developer shall have the right to sublicense its rights under Sections 2.2(a)(iii) and 2.2(b)(iii) solely to

allow Sublicensees to distribute the Software to End Users, whether as a stand-alone product or as part of

Developer’s Integrated Product, but in no event shall any Sublicensee have the right to (a) use the Software to

page 6

develop its own integrated products or (b) make copies of the Software. Each Sublicensee shall execute a Sublicense

AgreementthatcontainssubstantiallysimilartermsandconditionsasarecontainedinthisAgreementandprovides

for the same level of protection of Dialogic’s title, rights and defenses as this Agreement.

2.10. Protection of Rights. Developer will use the same efforts that it would use to protect its own rights, including its

intellectual property rights, but not less than commercially reasonable efforts to ensure that Sublicensees and End

Users comply with the terms of their respective agreements, and will notify Dialogic of any known violation. Upon

Dialogic’s request, Developer will supply Dialogic with a copy of anysublicense agreement by and between Developer

and any Sublicensees or End Users.

3. Ownership

3.1. Dialogic or its licensors own and shall retain all proprietary rights, including all patent, copyright, trade secret,

trademark and other intellectual property rights, in and to the Software and any modifications thereto made by any

entity.

3.2. Except as set forth in a separate agreement between Dialogic and Developer, Developer shall have no right to receive

any corrections, enhancements, upgrades or other modifications to the Software (“Changes”). Unless otherwise

agreed to in such separate agreement, any Changes to the Software providedby Dialogic to Developer in accordance

with the separate agreement shall be governed by the terms of this Agreement. If Developer does receive Changes

from Dialogic, it shall incorporate those Changes into Software that it distributes to End Users under Section 2.2 for

initial installation by End Users. Developer acknowledges that the license granted under this Agreement does not

provide Developer with title to or ownership of the Software, but only a right of limited use under the terms and

conditions of this Agreement. Developer shall keep the Software free and clear of all claims, liens and encumbrances.

4. Limited Warranty

4.1. Scope of Limited Warranty

a. Dialogic warrants to Developer that for a period of ninety (90) days from delivery of the Software to Developer

(the “Warranty Period”), the media on which the Software is delivered shall be free from defects in materials and

workmanship. Dialogic’s sole liability and Developer’s exclusive remedy under this limited warranty shall be the

replacement of the non-conforming media.

b. The remedies set forth in Section 4.1(a) are available only if Dialogic is promptly notified in writing, within the

Warranty period, upon discovery of the defect by Developer.

4.2. Disclaimer of Any Other Warranties

a. NOTWITHSTANDING ANYTHING IN THIS AGREEMENT TO THE CONTRARY, ANY SOFTWARE

PROVIDED UNDER SECTION 2.1 AS A DEMONSTRATION OR EVALUATION UNIT IS BEING PROVIDED

“AS IS” WITHOUT WARRANTY OF ANY KIND AND LICENSOR HEREBY DISCLAIMS ALL WARRANTIES,

WHETHER EXPRESS OR IMPLIED, ORAL OR WRITTEN, WITH RESPECT TO THE LICENSED

SOFTWARE INCLUDING, WITHOUT LIMITATION, ALL IMPLIED WARRANTIES OF

MERCHANTABILITY, FITNESS FOR ANY PARTICULAR PURPOSE AND NON-INFRINGEMENT.

b. EXCEPT FOR THE EXPRESS, LIMITED WARRANTY PROVIDED IN SECTION 4.1, DIALOGIC MAKES NO

WARRANTIES, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THE SOFTWARE, AND DIALOGIC

DISCLAIMS ALL IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR

PURPOSE AND NONINFRINGEMENT. DIALOGIC DOES NOT WARRANT THAT THE SOFTWARE WILL

BE UNINTERRUPTED OR ERROR-FREE, OR THAT IT WILL SATISFY DEVELOPER’S REQUIREMENTS.

4.3. Dialogic will not be responsible to any End User for any warranties made by Developer with respect to any Software

beyond the limited warranty described in Exhibit B.

5. Limitation of Liability

5.1. IN NO EVENT SHALL DIALOGIC’S OR ITS LICENSORS’ AGGREGATE LIABILITY UNDER THIS

AGREEMENT EXCEED THE AMOUNTS PAID BY DEVELOPER TO DIALOGIC FOR THE SOFTWARE (as

“Software” is defined above).

5.2. IN NO EVENT WILL DIALOGIC OR ITS LICENSORS BE LIABLE TO DEVELOPER OR ANY END USER OR

OTHER THIRD PARTY FOR SPECIAL, INCIDENTAL, CONSEQUENTIAL, EXEMPLARY, PUNITIVE,

MULTIPLE OR OTHER INDIRECT DAMAGES, OR FOR LOSS OF PROFITS, LOSS OF DATA OR LOSS OF USE

DAMAGES, ARISING OUT OF THIS AGREEMENT, WHETHER BASED UPON WARRANTY, CONTRACT,

TORT, STRICT LIABILITY OR OTHERWISE, EVEN IF DIALOGIC HAS BEEN ADVISED OF THE POSSIBILITY

OF SUCH DAMAGES OR LOSSES.

6. Term and Termination

6.1. Termination. Dialogic shall have the right to terminate this Agreement and the license granted herein in the event

Developer fails to comply with any ofthetermsandconditionsofthis Agreement andsuchdefault has notbeen cured

within thirty (30) days after written notice of such default.

page 7

6.2. Effect of Termination. Upon termination of this Agreement, all licenses and other rights granted to you under this

Agreement will become null and void, except that the End User Licenses and any Sublicenses shall survive

termination as long as the End Users and Sublicensees are in compliance with the terms of this Agreement. Within

five (5) days after termination of this Agreement, you shall return to Dialogic or destroy, at Developer’s expense, the

Software, including all copies thereof. Sections 2.3-2.8, 2.10, 3, 4, 5, 6, 7, 8, and 9 of this Agreement shall survive

termination of this Agreement.

7. U.S. Government Restricted Rights

If Software is acquired by or on behalf of a unit or agency of the United States government, the Software is provided as

“commercial computer software” or “commercial computer software documentation” and, absent a written agreement to

the contrary, the government’s rights with respect to such Software are limited by the terms of this Agreement pursuant

to FAR Paragraph 12.212(a) and/or DFARS Paragraph 227.7202-1(a), as applicable.

8. Export

Developer shall comply with all export and re-export restrictions, laws and regulations of the U.S. Commerce

Department and other U.S. agencies and authorities.

9. General

9.1. Assignment. This Agreementshallbebindingupon and inuretothebenefitoftheparties hereto, andtheirrespective

successors and permitted assigns. Developer shall not assign or otherwise transfer this Agreement or any rights or

obligations hereunder, in whole or in part, whether by operation of law or otherwise, without Dialogic’s prior written

consent. Any purported transfer, assignment or delegation without such prior written consent will be null and void

and of no force or effect.

9.2. Entire Agreement. This Agreement, together with any Special Terms, represents the entire agreement between the

parties, and supersedes all prior agreements and understandings with respect to the matters covered by this

Agreement.In the eventofaconflict between thisAgreementand the Special Terms, the Special Terms shall control.

Developer agrees that it has not entered in this Agreement based on any representations other than those contained

herein. No modification of or amendment to this Agreement, nor any waiver of any rights under this Agreement,

shall be effective unless in writing signed by the party to be charged.

9.3. Governing Law. This Agreement shall in all respects be governed by the laws of the Commonwealth of

Massachusetts, excluding: (i) its conflicts of laws principles; (ii) the United Nations Convention on Contracts for the

International Sale of Goods; (iii) the 1974 Convention on the Limitation Period in the International Sale of Goods;

and (iv) the Protocol amending the 1974 Convention, done at Vienna April 11, 1980.

9.4. Severability. If any of the provisions of this Agreement is held by a court of competent jurisdiction to be invalid under

any applicable statute or rule of law, such provision shall, to that extent, be deemed omitted, and the remaining

portions of this Agreement shall remain in full force and effect.

9.5. Waiver. The waiver of one breach or default or any delay in exercising any rights shall not constitute a waiver of any

subsequent breach or default.

9.6. Notices. All notices permitted or required under this Agreement shall be in writing and shall be delivered in person

or mailed by first class, registered or certified mail, postage prepaid, to the address of the party specified on the first

page of this Agreement or such other address as either party may specify in writing. Such notice shall be deemed to

have been given upon receipt.

9.7. Counterparts. This Agreement may be executed in counterparts, each of which shall be deemed an original and all

of which together shall constitute one instrument.

9.8. Headings. The headings are for convenience and shall not be used to construe this Agreement.

9.9. No Agency; Independent Contractors. Nothing contained in this Agreement shall be deemed to imply or constitute

that either party is the agent or representative of the other party, or that both parties are joint ventures or partners

for any purpose.

page 8

EXHIBIT A

THIRD PARTY SOFTWARE LICENSES

The Software includes object code versions of the following third party software packages which are subject to the terms

and conditions of the applicable license agreements found at the websites identified:

ACE™ software and TAO™ software are copyrighted by Douglas C. Schmidt and his research group at

Washington University, University of California, Irvine, and Vanderbilt University. Copyright (c)

http://www.cs.wustl.edu/~schmidt/ACE.html

Smart, Robert Roebling et al. More information is available at:

http://www.wxWindows.org

Portions of the Software are licensed under the Apache License, Version 2.0 (the "Apache License");

you may not use this file except in compliance with the Apache License. You may obtain a copy of the

Apache License at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the Apache

License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,

either express or implied. See the Apache License for the specific language governing permissions and

limitations under the Apache License.

March 2013

Hardware Limited Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

SOFTWARE DEVELOPER LICENSE AGREEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Preface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Operating System Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Compile Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Manual Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Hardware Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Software Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Getting Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Updated Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Chapter 1 – Quick Start Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

This chapter provides a series of steps that you can perform to quickly set up and

test your installation of the Dialogic® Brooktrout® software and hardware.

Determining the Board Module Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Dialogic® Brooktrout® SR140 Fax Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Quick Start for Windows Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Step 1: Install Dialogic® Brooktrout® Software and Hardware . . . . . . . . . . . . . . . . . . . 28

Step 2: Configure the Dialogic® Brooktrout® Software and Hardware . . . . . . . . . . . . . 29

Step 3: Compile and Run the Sample Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Contents

March 2013 10

Next Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Quick Start for Linux and Solaris Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Step 1: Install Dialogic® Brooktrout® software and hardware . . . . . . . . . . . . . . . . . . . . 31

Step 2: Configure the Dialogic® Brooktrout® Software and Hardware . . . . . . . . . . . . . 32

Create the Configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Start Boston Host Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Step 3: Compile and Run the Sample Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Next Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Chapter 2 – Installing the SDK on Red Hat Linux. . . . . . . . . . . . . . 34

This chapter describes how one can install Dialogic® Brooktrout® software on

Red Hat Linux operating systems.

Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Removing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Starting or Stopping the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Reinitializing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Configuring the Driver Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

History Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Advanced Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Linux Kernel Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Removing the Manually Configured Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Using Boston Host Service Under Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Root login for Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Special Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

PCI Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Dialogic® Brooktrout® Bfv API Libraries and Makefiles . . . . . . . . . . . . . . . . . . . . . . . . 45

Writing Multithreaded Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Warning and Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Determining Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Command Line Configuration for dinstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Driver File Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Reviewing Compiler and Linker Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Message About “Tainted” Kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

SELinux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Recompiling on Linux Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

March 2013 11

Bostsrv Port in Use Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Additional Packages Required for Red Hat Linux 6.0 x64 Only . . . . . . . . . . . . . . . . . . 53

Chapter 3 – Installing the SDK on Solaris. . . . . . . . . . . . . . . . . . . . 54

This chapter describes how one can install Dialogic® Brooktrout® software on

Solaris operating systems.

Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Removing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Starting or Stopping the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Reinitializing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Configuring the Driver Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

History Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Advanced Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Resource Allocation Failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Removing the Manually Configured Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Using Boston Host Service Under Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Root login for Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Special Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

PCI Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Dialogic® Brooktrout® Bfv API Libraries and Makefiles . . . . . . . . . . . . . . . . . . . . . . . . 65

Writing Multithreaded Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Warning and Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Memory Allocation Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

pci_pci Loading Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Determining Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Command Line Configuration for dinstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Structure Packing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Compiler Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Driver File Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Reviewing Compiler and Linker Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Chapter 4 – Installing the SDK on Windows. . . . . . . . . . . . . . . . . . 71

This chapter describes how one can install Dialogic® Brooktrout® software on

Windows operating systems.

March 2013 12

System Requirements for Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Installation Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Installing the Dialogic® Brooktrout® SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Removing or Modifying the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

64-bit Windows API Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Brooktrout_x64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

System Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Chapter 5 – Installing the Device Driver on Windows . . . . . . . . . . 86

This chapter describes how one can install the device driver on Windows systems.

Installing and Configuring Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Installing the Plug-and-Play Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Updating Computer Telephony and the Plug-and-Play Driver . . . . . . . . . . . . . . . . . . . 96

Removing Dialogic® Brooktrout® Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Updating Previous Versions of the Plug-and-Play Driver . . . . . . . . . . . . . . . . . . . . . . . 97

Removing the Plug-and-Play Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

For Earlier Versions of the Driver (Prior to 5.2.0) . . . . . . . . . . . . . . . . . . . . . . . 99

For Driver Version 5.2 (Brooktrout SDK Version 5.2.0 and Later.) . . . . . . . . . 100

Disabling Plug-and-Play Driver Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Reinitializing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Installing and Configuring the Driver using a Command (cmd) Prompt . . . . . . . . . . . . . . . 103

History Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Advanced Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Memory Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Removing the Driver with a Command (cmd) Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Reinitializing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Using the Boston Host Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Installing Bostsrv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Starting Bostsrv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Troubleshooting Bostsrv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

System Error 59 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Special Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

PCI Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Dialogic® Brooktrout® Bfv API Libraries and Makefiles . . . . . . . . . . . . . . . . . . . . . . . 111

Writing Multithreaded Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Using BOSTDLLD with Debugging Enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

March 2013 13

Determining Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Driver Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Global Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Limits on Open Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Process Priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Command Line Configuration for Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Driver File Locations (install) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Build Requirements for install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Version Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Reviewing Compiler and Linker Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Chapter 6 – Configuring Software . . . . . . . . . . . . . . . . . . . . . . . . . 119

This chapter describes how one can configure the Dialogic® Brooktrout® Fax

Software for your Dialogic® Brooktrout® boards.

Using the Dialogic® Brooktrout® Configuration Tool on Windows Systems . . . . . . . . . . . 121

Running the Dialogic® Brooktrout® Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Choosing the File Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Setting File Locations Prior to First Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Example of settings.cfg File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

Getting Help From the Dialogic® Brooktrout® Configuration Tool . . . . . . . . . . . . . . . 129

Identifying the Model of the Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Resolving the Configtool Error Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Configuring in Wizard Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Advanced Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Offline Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Adding a Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Removing a Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

SR140 Modules in Offline Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Using a Call Control Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

About the Call Control Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

Call Control (callctrl.cfg) File Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

March 2013 14

Chapter 7 – Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

This chapter contains tablesthat show the directory structure used for all installed

binary, firmware, and sample source files, both platform-independent and

platform-specific for all operating system platforms.

Installed Files Directory Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Chapter 8 – Using the Dialogic® Brooktrout® TECUpdate Utility 152

This chapter describes how one can use the Dialogic® Brooktrout® Technology

Expansion Capability (TEC) utility to display and upgrade the configured feature

set on an installed board.

Starting Dialogic® Brooktrout® TECUpdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

When Errors Occur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Driver Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Firmware Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Running the Dialogic® Brooktrout® TECUpdate Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Error Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Chapter 9 – Downloading Firmware . . . . . . . . . . . . . . . . . . . . . . . 159

This chapter describes how one can download the firmware to the board.

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

Firmware Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Updating Boot ROM Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

Manually Downloading the Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Appendix A – Compliance Information . . . . . . . . . . . . . . . . . . . . . 166

This appendix describes how the Dialogic® Brooktrout® boards conform to

compliance standards.

Electromagnetic Compatibility Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

United States of America . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

Mandatory Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

Class A Statement (for “Class A” products) . . . . . . . . . . . . . . . . . . . . . . . . . . 168

Class B Statements (for “Class B” products) . . . . . . . . . . . . . . . . . . . . . . . . . 169

Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

March 2013 15

Class A Statements (for “Class A” products) . . . . . . . . . . . . . . . . . . . . . . . . . 170

Class B Statements (for “Class B” products) . . . . . . . . . . . . . . . . . . . . . . . . . 170

European Union . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

Class A Statements (for “Class A” products) . . . . . . . . . . . . . . . . . . . . . . . . . 170

Class B Statements (for “Class B” products) . . . . . . . . . . . . . . . . . . . . . . . . . 170

Japan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

VCCI Class Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Telecommunications Compliance Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

United States of America . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

Equipment Approved After July 23, 2001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

Ringer Equivalence Number (REN) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

Connection to Telecommunications Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

FCC Rules Regarding FAX Branding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

FCC Regulations For Connecting to a T1 Interface . . . . . . . . . . . . . . . . . . . . . . . 175

Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Australia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

Safety Compliance Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

United States of America and Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

Appendix B – Configuration from a Custom

Installation Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

This appendix describes how one can create a custom installation program for

manual configuration of the driver.

Linux Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

Linux Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

Checking the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

Defining Default Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Removing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Solaris Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Solaris Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Checking the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

Defining Default Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

Removing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Windows Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Installing the Windows Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Driver Parameters Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

March 2013 16

Checking the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Defining Default Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Removing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Appendix C – Reinitializing the Device Driver . . . . . . . . . . . . . . . 196

This appendix describes the driver reinitialization utility. This utility is used to

return the device driver to a state as close as possible to that of a fresh driver start

without stopping the driver.

Introducing the Driver Reinitialization Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Using the driver_reinit Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

March 2013 17

Preface

Introduction

The Dialogic® Brooktrout® Fax Products SDK Installation and

Configuration Guide explains how to install the software (firmware,

Dialogic® Brooktrout® Bfv APIs, and driver for the Dialogic®

Brooktrout® TR1034/SR140/TruFax® products) on your host

system. It also describes how to configure the driver, configure call

control, and download the firmware to a Brooktrout module.

Chapter 1 provides a quick start for users experienced with API

programming in general and the Dialogic® Brooktrout® Bfv

APIs in particular.

Chapter 2 explains how to install the Dialogic® Brooktrout®

software and the device driver on a Red Hat Linux operating

system.

Chapter 3 explains how to install the Dialogic® Brooktrout®

software and the device driver on the Solaris operating system.

Chapter 4 explains how to install the Dialogic® Brooktrout®

software on a Windows operating system.

Chapter 5 describes how to install the Dialogic® Brooktrout®

device driver on Windows operating systems.

Chapter 6 describes how to configure your software and

hardware on Windows systems.

Chapter 7 lists the directories where files are installed.

Chapter 8 describes how to use the Dialogic® Brooktrout®

TECUpdate Utility.

March 2013 18

Chapter 9 describes the firmware files, how to load them, and

how to update the boot ROM.

Appendix A describes compliance with North American and

European standards that includes general telecommunications

and safety.

Appendix B describes how to create a custom installation

program for the manual configuration of the driver.

Appendix C describes how to use the driver reinitialization

utility.

A glossary provides definitions for some of the terms used in the

manual.

A copy of this manual in Adobe Acrobat PDF format is included in

the Documents directory on the Dialogic® Brooktrout® Fax Products

SDK CD-ROM.

Refer to Dialogic® Brooktrout® SR140 Software Windows User

Guide and Dialogic® Brooktrout® SR140 Software Linux User Guide

for instructions to activate the software using the License Manager.

Operating System Support

See the latest Dialogic® Brooktrout® Release Notes for the supported

operating systems. A copy of the Dialogic® Brooktrout® Release

Notes is found in the Documents directory on the Dialogic®

Brooktrout® Fax Products SDK CD-ROM.

Compile Compatibility

Applications compiled with Brooktrout SDK 6.0 or newer work with

the latest Brooktrout SDK without recompiling as long as the

application called the BT_API_SET_VER macro. See the Dialogic®

Brooktrout® Bfv APIs Reference Manual, Volume 1.

You might also require one of the following:

Windows libraries, see Special Considerations on page 110

Linux libraries, see Special Considerations on page 43

Solaris libraries, see Special Considerations on page 64

March 2013 19

Manual Conventions

This manual uses the following conventions:

Italics denote file names, directory names, and program names

within the general text.

The Courier font in bold indicates a command sequence entered

by the user at the system prompt, for example:

cd /boston/bfv.api

The Courier font not bolded indicates system output, for

example:

C:>Files installed.

The Courier font also denotes programming code, such as C and

C++. Programming code appears in program examples.

Bold indicates names of variables, Dialogic® Brooktrout® Bfv

API functions, dialog boxes, dialog box controls, windows, and

menu items.

Square brackets [ ] indicate that the information to be typed is

optional.

Angle brackets < > indicate that you must supply a value with

the parameter.

The Caution icon is used to indicate an action that could cause harm to

the software or hardware.

The Warning icon is used to indicate an action that could cause harm to

the user.

Popular Software manuals by other brands

Kyocera

Kyocera TASKalfa 2420w Operation guide

UBI

UBI EasyCoder 101 user guide

Philips

Philips TSU6000 user manual

Adobe

Adobe 13102498 - Photoshop CS3 - Mac user guide

Nokia

Nokia NPS6113000 - Secure Access System Getting started guide

McAfee

McAfee VSMCDE-AA-AA - VirusScan Mobile - PC user guide

Xerox

Xerox Document centre 490 Color management guide

Sling Media

Sling Media SlingPlayer user guide

Western Digital

Western Digital My Passport WDBBEP0010BBK user manual

Juniper

Juniper JUNOSE SOFTWARE 11.0.X - COMMAND REFERENCE A TO M... Command reference

Novell

Novell ZENWORKS LINUX MANAGEMENT 7.2 IR2 - ... installation guide

Ulead

Ulead USBAV-701 user guide

Alcatel-Lucent

Alcatel-Lucent 5920 brochure

Yamaha

Yamaha DSP5D Editor owner's manual

Toshiba

Toshiba Strata CIX SIP Trunking Product bulletin

Asus

Asus A3Ac user guide

DeLorme

DeLorme Topo North America 9.0 user guide

Lexmark

Lexmark Document Server Admin user guide

Dialogic Brooktrout Digital Board Operator's manual

Popular Software manuals by other brands