Manuali utente per Dialogic 6.2

Sommario

• Contents

  6
• About this Publication

  16
  • Introduction

    16
    • Related Documents

      17
    • Operating System Support

      17
    • Manual Conventions

      17
  • Terminology

    19
    • Updated Terminology

      19
  • Getting Technical Support

    21
• 1 - Introduction to the Dialogic® Brooktrout® Bfv API

  22
  • Bfv API and Associated Libraries

    23
  • The Bfv API Functions

    26
    • Administration, Management, and Configuration

      27
      • Administration and Initialization Functions and Macros

        27
      • Firmware Functions and Macros

        31
      • Configuration Functions

        31
      • Module Status and Monitoring Functions

        33
      • Debugging, Error Handling, and Return Values

        33
      • Miscellaneous Functions and Macros

        35
    • Call Control

      36
      • Bfv Call Control

        36
      • BSMI-Level Call Control

        36
    • Media Processing

      38
      • Signal Generation and Tone Detection

        38
      • Voice Record and Play

        39
      • Fax Functions

        40
      • File Format Manipulation Functions

        42
      • The Infopkt Stream

        47
      • Fax Infopkt Parameters

        52
• 2 - Developing Applications Using the Bfv API

  56
  • Developing a Voice Application

    57
    • Recording and Playing Voice

      57
      • Recording Voice

        58
      • Playing Back the Voice Message

        59
  • Using Prompt Files

    59
    • Using the mkprompt Utility

      60
    • Creating a New Prompt File

      60
    • Updating an Existing Prompt File

      61
  • Developing a Fax Application

    61
    • Sending and Receiving a Fax

      61
      • Sending a Fax from One Channel to Another

        62
      • Sending a Fax to a Channel from an External Fax Machine

        63
    • Using Bfv API Fax Functions

      64
      • Using High- and Low-Level Functions

        64
      • Sending a Fax Using Function Calls for Noninfopkt-Formatted Raw G3 Files

        70
      • Receiving a Fax Using Function Calls for Noninfopkt-Formatted Raw G3 Files

        73
      • Sending a Fax Using Calls for TIFF-F Files

        75
      • Receiving a Fax Using Calls for TIFF-F Files

        76
      • Receiving and Storing a Fax in MMR or MR Format

        78
    • Accessing an Infopkt Stream from an Application

      83
    • Sending a TIFF-F Fax File Within an Infopkt Stream

      84
      • Combining Data on a Single Page Using TIFF-F Fax Files

        84
      • Accessing a TIFF-F File from an Application

        87
    • Determining Fax Status Information from an Application

      89
• 3 - Debugging

  91
  • Bfv API Debug Mode

    92
  • BfvDataFSK

    92
  • BfvLineDumpStructure

    93
  • Dump History

    93
    • Invoking Dump History

      94
    • Interpreting the Output

      96
      • Status Header Line

        97
      • Event Logging Lines

        97
      • Event Logging Line Format

        97
  • Parsed Command Information

    98
  • Utility Programs for Debugging

    100
    • btver

      100
    • connlist

      100
    • feature -q

      100
    • modinfo

      100
    • shoparam

      100
  • BSMI Debugging

    101
    • BSMI Message Tracing

      101
      • Running a Layer 2 Trace

        101
      • Understanding Trace Hexadecimal Strings

        104
    • VTTY Tracing Feature

      110
      • VTTY Console Commands

        111
      • VTTY Tracer GUI

        112
  • Call Tracer

    118
    • Command Syntax

      119
      • Arguments

        119
    • Configuration File Format

      120
• 4 - Sample Applications and Utilities

  127
  • boardmon

    127
  • btver

    129
  • connlist

    130
  • csend

    131
  • deact

    132
  • debug_control

    134
  • decode

    135
  • dfax

    136
  • divert

    136
  • dlfax

    137
  • dstrip

    138
  • eccllvoice

    139
  • fax

    140
  • faxhl

    141
  • faxll

    142
  • faxml

    144
  • faxp

    145
  • faxpml

    145
  • feature

    146
  • firm

    148
  • firmload

    149
  • font

    150
  • ipstrip

    151
  • ivr

    152
  • mkdcx

    152
  • mkinfopk

    153
  • mkprompt

    155
  • mktiff

    155
  • modinfo

    156
  • playp

    157
  • rtp

    157
  • shoparam

    158
  • telreset

    158
  • telsave

    159
  • tfax

    160
  • tiffdump

    160
  • tones

    161
  • transfer

    161
  • transferll

    163
  • trombone

    165
  • tstrip

    166
  • voice

    167
  • voiceraw

    169
  • wave

    170
  • Compiling Sample Applications Using Microsoft® Developer Studio Project Files

    172
    • Using Brooktrout Files

      173
  • Compiling Sample Applications Using Makefiles

    174
    • Combining the Sample Applications

      175
    • Compatibility for Compiling

      175
• 5 - Transferring Calls

  176
  • Making Call Transfers Using Bfv

    177
  • Making Hookflash Transfers

    180
    • Using Bfv Applications

      180
    • Using BSMI Applications

      181
  • Making Two B-Channel Transfers

    182
  • Making Call Transfers Using QSIG

    184
    • ISDN QSIG

      184
    • Supplementary Services Support

      184
  • Making Call Transfers Using Active Redirection (Japan)

    187
  • Making Explicit Call Transfers (ECT) With E1 ISDN and BRI

    188
  • Making Two-Channel Call Transfers (Tromboning)

    190
    • Setting up the Two-Channel Call Transfer

      191
      • Connecting Resources

        191
    • Actions During a Two-Channel Call Transfer

      194
      • Performing Echo Cancellation

        194
      • Playing Back Voice Recordings

        197
    • Terminating the Two-Channel Call Transfer

      199
    • Disconnecting Resources

      200
  • Transferring Calls Using Release Link Trunk Transfer

    202
    • Using Bfv Applications

      202
    • Using BSMI Applications

      203
      • Call Control Sequence Diagrams

        204
      • Non-RLT Call Transfer

        204
      • RLT Call Transfer

        205
    • Sample Application

      207
  • Placing Calls on Hold Using BSMI

    210
• 6 - Managing Fax and Voice over IP Sessions

  214
  • Managing Calls Using IP Telephony

    215
    • Adding IP Call Control using the Bfv API

      216
      • Outgoing IP Calls

        217
      • Incoming IP Calls

        218
    • Understanding SIP Functionality

      219
      • Using a SIP Proxy Server

        219
      • Verifying Dialed Strings

        219
      • Sample INVITE Request

        222
      • Call Progress Values

        225
    • Understanding H.323 Functionality

      226
      • Using H.323 Address Forms

        227
  • Failover Based on Telephony Cause Codes

    230
    • Overview

      230
    • Common Failures

      230
    • Failover Scenarios

      232
    • Known Failures From Various Gateways

      233
      • H.323 and SIP

        233
    • SIP to Q.931 Conversion

      236
  • Processing Media Using the T.38 Protocol

    238
    • Sending and Receiving Faxes

      241
  • Configuring T.38, RTP and IP Call Control Activities

    242
  • Troubleshooting

    243
  • Understanding the SIP Protocol

    244
    • Introduction to the SIP Protocol

      244
    • Overview of SIP Functionality

      245
    • Overview of Operation

      247
  • Using Third Party IP Stacks

    256
    • Integrating Bfv IP Fax

      257
      • Components

        258
    • Configuration

      259
      • Disable ECC Component

        259
      • SR140 Software-Based Integration - Linux

        259
      • TR1034 Board-Based Integration - Linux

        260
    • Call Negotiation

      261
      • Inbound Call

        261
      • Outbound Call

        263
• 7 - Robbed Bit Signaling

  264
  • General Information

    264
    • Timer Definitions

      268
    • Timing Diagrams

      275
  • Wink Start & Delay Dial Signaling

    276
    • Incoming Call Processing

      277
    • Outgoing Call Processing

      279
    • Call Teardown Processing

      279
  • Wink Start with Feature Group B & D

    281
    • Incoming Call Processing

      281
    • Outgoing Call Processing

      283
    • Call Teardown Processing

      283
  • Immediate Start/Fixed Pause Signaling

    285
    • Incoming Call Processing (Immediate Start)

      285
    • Outgoing Call Processing (Fixed Pause Mode)

      287
    • Call Teardown Processing

      287
  • Ground Start Signaling

    289
    • FXO Ground Start

      289
      • Incoming Call Processing

        289
      • Outgoing Call Processing

        292
      • Call Teardown Processing

        292
    • FXS Ground Start

      296
      • Incoming Call Processing

        296
      • Outgoing Call Processing

        298
      • Call Teardown Processing

        298
  • Loop Start Signaling

    302
    • FXO Loop Start

      303
      • Incoming Call Processing

        304
      • Outgoing Call Processing

        304
      • Call Teardown Processing

        304
    • FXS Loop Start

      309
      • Incoming Call Processing

        309
      • Outgoing Call Processing

        309
      • Call Teardown Processing

        310
• 8 - ISDN Call Processing and Management

  316
  • ISDN Call Processing Overview

    318
    • Making an ISDN Incoming Call

      318
    • Making an ISDN Outgoing Call

      321
      • ISDN Overlapped Dialing

        323
    • ISDN Call Clearing - Initiated by Module

      323
    • ISDN Call Clearing - Initiated by Network

      325
  • Translating Q.931 to Simple Message Interface

    327
  • Using the overlap_rcv feature of L4L3mENABLE_PROTOCOL

    328
    • What is Overlap Receive?

      328
    • BSMI Reference Notes

      329
    • How Overlap Receive Mode Changes Call Control Events Presentation

      330
  • Q.921/Q.931 Timers

    332
• 9 - Using the BSMI R2 Signaling Capability

  336
  • CPE Signaling Model

    337
  • Enabling the R2 Protocol

    342
    • Protocol Parameter Mechanics

      348
    • Forward Channel

      349
    • Backward Channel

      350
    • R2 Call Control

      355
    • Outbound Call Setup

      356
    • Inbound Call Setup

      359
    • Call Tear Down

      361
    • Channel Blocking

      363
• 10 - Packaging Your Application for Windows®

  364
  • Package Options

    366
  • Installation

    367
    • Installing Modules

      367
    • Installing Virtual Modules (SR140)

      367
    • Installing Software

      368
      • Installing the Brooktrout SDK

        368
      • About the Merge Module Feature

        376
      • Installing the Merge Module Feature

        385
      • Integrating the Modules

        385
  • About Plug and Play Components

    390
    • Plug and Play Installation Scenarios

      392
    • Structure of the Brooktrout PnP Folder

      395
    • About the INF File

      395
    • About the Dialogic® Brooktrout® Plug and Play Co-Installer

      396
    • About the Device Property Page

      398
  • Modifying Configuration Files

    400
    • User-Defined Configuration File (btcall.cfg)

      401
    • Call Control (callctrl.cfg) Configuration File

      402
  • Including the Brooktrout Configuration Tool

    402
  • Downloading Firmware Files

    403
  • Removing Software

    404
  • Removing the Plug and Play Driver

    405
    • For Earlier Versions (Prior to 5.2)

      405
    • For Version 5.2

      406
• G3 Legacy Utilities

  408
  • ASCII to Fax Conversion Utility (asctog3)

    410
  • Cut and Paste Utilities

    411
    • Cut Utility (g3chop)

      411
    • Paste Utility (g3combin)

      412
  • Epson to Fax Conversion Utility (epstog3)

    413
  • Fax Display and Edit Utility: Supershow (ss)

    415
  • G3 Conversion Utility (g3cvt)

    417
  • Print Utility (p)

    419
• Recompiling On Linux Platforms

  422
• Glossary

  426
• Index

  430