Digital Network Interface Software Reference for Linux and Windows Copyright © 1999-2003 Intel Corporation 05-1313-005 INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL’S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. Intel products are not intended for use in medical, life saving, or life sustaining applications. Intel may make changes to specifications and product descriptions at any time, without notice. This document as well as the software described in it is furnished under license and may only be used or copied in accordance with the terms of the license. The information in this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. Except as permitted by such license, no part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means without express written consent of Intel Corporation. Copyright © 1999-2003 Intel Corporation. AnyPoint, BoardWatch, BunnyPeople, CablePort, Celeron, Chips, CT Media, Dialogic, DM3, EtherExpress, ETOX, FlashFile, i386, i486, i960, iCOMP, InstantIP, Intel, Intel Centrino, Intel Centrino logo, Intel logo, Intel386, Intel486, Intel740, IntelDX2, IntelDX4, IntelSX2, Intel InBusiness, Intel Inside, Intel Inside logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel StrataFlash, Intel TeamStation, Intel Xeon, Intel XScale, IPLink, Itanium, MCS, MMX, MMX logo, Optimizer logo, OverDrive, Paragon, PDCharm, Pentium, Pentium II Xeon, Pentium III Xeon, Performance at Your Command, RemoteExpress, SmartDie, Solutions960, Sound Mark, StorageExpress, The Computer Inside., The Journey Inside, TokenExpress, VoiceBrick, VTune, and Xircom are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. *Other names and brands may be claimed as the property of others. Publication Date: October, 2003 Intel Converged Communications, Inc. 1515 Route 10 Parsippany NJ 07054 For Technical Support, visit the Intel Telecom Support Resources website: http://developer.intel.com/design/telecom/support/ For Products and Services Information, visit the Intel Communications Systems Products website: http://www.intel.com/network/csp/ For Sales Offices, visit the Intel Telecom Building Blocks Sales Offices page: http://www.intel.com/network/csp/sales/ Table of Contents 1. How To Use This Manual ............................................................................... 1 1.1. Getting Started with this Guide...................................................................... 1 1.2. Organization of this Guide ............................................................................. 2 2. General Description ........................................................................................ 3 2.1. Typical Applications ...................................................................................... 3 2.2. Compatibility.................................................................................................. 4 2.3. SCbus Overview ............................................................................................ 5 3. Digital Telephony Overview........................................................................... 7 3.1. T1 Digital Telephony ..................................................................................... 7 3.1.1. T1 Frame Format................................................................................... 7 3.1.2. T1 Synchronization ............................................................................... 9 3.1.3. T1 Signaling .......................................................................................... 9 3.2. E1 Digital Telephony ................................................................................... 10 3.2.1. E1 Frame Format................................................................................. 10 3.2.2. E1 Synchronization ............................................................................. 12 3.2.3. E1 Signaling ........................................................................................ 13 3.2.4. E1 National and International Bits ...................................................... 15 3.3. Digital Network Interface Hardware Implementation.................................. 16 3.3.1. SCbus Routing..................................................................................... 16 3.3.2. Loss of Synchronization Alarm Handling ........................................... 16 3.3.3. Digital Network Interface Hardware Alarm Indicators ....................... 19 4. Function Overview........................................................................................ 21 4.1. Digital Network Interface Function Categories ........................................... 21 4.1.1. Alarm Functions.................................................................................. 22 4.1.2. Diagnostic Functions........................................................................... 22 4.1.3. Extended Attribute Functions.............................................................. 22 4.1.4. Parameter Request Functions .............................................................. 23 4.1.5. Parameter Setting Functions................................................................ 23 4.1.6. Resource Management Functions........................................................ 24 4.1.7. Routing Functions ............................................................................... 24 4.1.8. Time Slot Audio Functions ................................................................. 25 4.1.9. Time Slot Signaling Functions ............................................................ 25 4.2. Error Handling ............................................................................................. 26 4.3. Include Files................................................................................................. 29 iii Digital Network Interface Software Reference for Linux and Windows 5. Function Reference ....................................................................................... 31 ATDT_BDMODE( ) - returns the current mode of every time slot..................... 32 ATDT_BDSGBIT( ) - returns the current state of the transmit and receive ........ 35 ATDT_DNLDVER( ) - returns the firmware version.......................................... 39 ATDT_IDLEST( ) - returns the current idle state ................................................ 44 ATDT_ROMVER( ) - returns the version of the EPROM .................................. 47 ATDT_STATUS( ) - returns the current status.................................................... 52 ATDT_TSMODE( ) - returns the current signaling mode ................................... 55 ATDT_TSSGBIT( ) - retrieves the current state.................................................. 58 dt_castmgmt( ) - manage the CAS DTI templates ............................................... 61 dt_castdecode( ) - decode the CAS DTI reply or event message block ............... 74 dt_castencode( ) - validate and encode the message ............................................ 76 dt_close( ) - closes digital network interface devices .......................................... 78 dt_dial( ) - allows the application to pulse dial .................................................... 80 dt_getctinfo( ) - returns information about the digital network interface............. 85 dt_getevt( ) - blocks and returns control to the program ...................................... 89 dt_getevtmsk( ) - retrieves the current event bitmask(s) ...................................... 93 dt_getparm( ) - gets the current value .................................................................. 98 dt_getxmitslot( ) - returns the SCbus time slot................................................... 105 dt_listen( ) - connects the digital listen channel ................................................. 108 dt_open( ) - opens a digital network interface device ........................................ 112 dt_rundiag( ) - runs diagnostics ......................................................................... 115 dt_setevtmsk( ) - enables and disables notification for events ........................... 120 dt_setidle( ) - enables or disables transmission .................................................. 126 dt_setparm( ) - changes the value of a DNI device parameter ........................... 129 dt_setsigmod( ) - sets the type of signaling........................................................ 132 dt_settssig( ) - sets or clears the transmit ........................................................... 135 dt_settssigsim( ) - simultaneous setting or clearing of transmit signaling bits... 138 dt_tstcom(