Eicon Networks V8.3 Wartungshandbuch

www.dialogic.com Dialogic® Diva® System Release 8.5LIN Reference Guide

9 The Dialogic® Diva® System Release software enables you to use your Dialogic® Diva® Media Board with Linux, such as to provide analog, digital, an

99 #! /bin/sh #This "n_cons" value will start 30 server and 30 client sessions n_cons=30 # remove old log files rm -f log.* while [ $(

100 tty_test in terminal mode tty_test includes a simple and easy to use terminal mode. To start tty_test in terminal mode, execute: /usr/lib/opendiva

101 You can use the Dialogic® Diva® web interface, accessible at port 10005, to gain access to Dialogic® Diva® Media Board and system configuration, m

102 After the first access to the Dialogic® Diva® HTTP server, the login page appears: After a successful login, the Diva HTTP server verifies the &q

103 the following help window appears: Click the Dialogic symbol to access the Dialogic home page. Click Reference Guides in the upper right

104 After the successful Login procedure on page 102 the Dialogic® Diva® WEB server presents you the main page: Main page

105 System control (driver start/stop) If you click System control (driver start/stop) the following page opens, where you can start and to stop Dialo

106 Board configuration If you click Board configuration on the left side, the following page opens, which allows you to create/change the configurati

107 Use the Restart symbol to restart. In the drop-down menu on the right of the Diva Media Board description you can select different options: • Se

108 System configuration If you click System configuration on the left hand side, a page opens that allows you to configure global system parameters t

10 General features The Dialogic® Diva® System Release software offers the following features: • RAS connection to a Linux-based RAS server from digi

109 Board monitor If you click Board monitor on the left hand side the following page opens, which allows you to control the current status and the co

110 Management interface browser You can navigate through the Management interface on page 73 of the selected Dialogic® Diva® Media Board or driver us

111 Dialogic® Diva® Media Board management interface If you click the icon below Mgnt in the Available Diva Board section, the management interface br

112 CAPI driver management interface If you click the icon below Mgnt for the CAPI driver in the Available System Release driver section, the manageme

113 Dialogic® Diva® TTY driver management interface If you click the icon below Mgnt for the TTY driver in the Available System Release driver section

114 This page allows you to get important information about your system (kernel version, PCI hardware configuration, system resources, etc.). Most of

115 Once the trace process (ditrace) is running you can issue one test call or stop the trace process and retrieve compressed trace file. At any

116 Support/Troubleshooting In case of a problem you can use this page to capture relevant information for your support request: You can invoke the

117 System messages This page allows you to view the last 200 messages from the kernel ring buffer. This is equivalent to the command dmesg > msg.t

118 View trace file This page allows you to decode and to view a trace file. You can filter the trace file to view only specific sources of the inform

11 Fax and voice features • Fax Class 1 and 2 • Fax and voice support via CAPI • Fax sub-addressing (SUB), polled document selection (SEL), passwor

119 Finally, you can view or download the decoded trace file: Orange and green trace messages deal with the call establishment.

120 Red trace messages deal with the call release. D-channel analyzer Some of the messages are displayed as HTML links (underlined). You can receiv

121 AudioTap analyzer The blue trace messages (and HTML links) deal with AudioTap data. Audio taps are the audio data samples on the input (outp

122 Control panel Digital oscilloscope (view timing diagram)

123 Digital spectral analyzer

124 EYE pattern diagram WAV file download Moreover, it is possible to download an Audio Tap file in "WAV" file format.

125 View call history This page allows you to view the last segment (up to 10000 calls) of the call record that is stored in the /var/log/divalog file

126 View statistics This page allows you to perform statistical analysis of the call record (call journal) files. The result of the analysis is presen

127

128

12 Q.SIG features • Basic call (64 kbps unrestricted, 3.1 kHz audio and speech bearer services) ECMA 142/143 • Line identification presentation ECMA

129

130 View report This page allows you to view the state and the cumulative statistics for the active Dialogic® Diva® Media Boards. If you click the boa

131 View recovered debug/trace buffer This page allows you to view or download the decoded trace file. The internal debug/trace buffer of Dialogic® D

132 Each Dialogic® Diva® Media Board provides different features and capabilities with the Dialogic® Diva® System Release software. The table bel

133 See the table on the next page for features available with the Diva ISDN Media Boards: Features of Dialogic® Diva® ISDN Media Boards via interface

134 Feature IDI TTY CAPI 2.0 Transparent HDLC, 64/56 kbps • • • Transparent (Voice) (8 bit 8 kHz A- Law/u-Law) • • • X.75 • • • X.75/V.42bis

135 Fax 33.6 kbps with MMR (T.6 coding) [a] • • • Fax tone detection [a] • • • Reversal of fax direction • • Fax polling / fax on demand [a]

136 For an overview of supplementary services supported by the different switch types, see Supplementary services of Dialogic® Diva® ISDN Media Boards

137 Supplementary Service IDI TTY CAPI 2.0 MSN (multiple subscriber number) • • • DDI (direct dialing-in) • • • SUB (sub-addressing) • • •

138 The Dialogic® Diva® System Release software supports basic call services for the available switch types. In addition to this, it offers supplement

13 Dialogic® Diva® TTY driver The Dialogic® Diva® ISDN serial driver provides access to analog, digital, fax (FAX CLASS 1 and FAX CLASS 2 with ECM, co

139 • Euro-ISDN (ETSI) BRI and PRI • 5ESS Custom (AT&T) • 5ESS NI (Lucent/Avaya) • DMS 100 (Nortel) • Q.SIG Q.SIG support is available for th

140 HOLD (hold and retrieve a call) • [b] • • [c] • ECT (explicit call transfer) • • [d] • Path replacement • Single-step call transfer (over

141 Dialogic® Diva® Analog Media Boards offer the following feature set: • Call control features on page 141 • Voice and speech features on page 142

142 Voice and speech features • G.711 coding (a-law, µ-law selectable) • DTMF detection and generation • DTMF clamping and filtering • Generic ton

143 Fax • Support for Fax class 1 and 2 • Support for Fax Group 3, T.30 • V.17, V.29, V.27ter, V.21, V.34 Modulation • Up to 33.600 bps with each

144 Once the .bin files (binary files) are installed, the modules still have to be translated for the running kernel. The following drivers are avai

145 Dialogic® Diva® TTY driver The Dialogic® Diva® TTY driver is provided only in binary form, and can only be recompiled for your own kernel using th

146 • Change the configuration of your kernel now in order to meet the configuration of the kernel that the Diva TTY driver was compiled for and reco

147 [9] If you do not know which applications or drivers access interfaces of Dialogic® Diva® drivers or you cannot stop these applications, proceed a

148 [19] The stunnel is designed to work as SSL encryption wrapper between remote clients and local (xinetd-startable) or remove servers. The concept

14 Licensable features For the following features you need to purchase a license: Licensable features for the Dialogic® Diva® Media Boards, except the

15 - Extended modulations V.23 half duplex, V.23 on hook (SMSC mode), V.23 off hook, Bell 202 (POS), Telenot The following requirements have to be m

16 The Dialogic® Diva® System Release software can be installed on a wide range of Linux distributions. The software consists of an integrated install

17 The following files are included in the package: Files included in the package

18 • Device driver for active Dialogic® Diva® Media Boards (divas.[k]o, divadidd.[k]o, diva_idi.[k]o) • CAPI 2.0 interface (divacapi.[k]o, kernelcap

1 Contents Dialogic® Diva® System Release LIN Reference Guide 3 Syntax used throughout the guide...

19 After you have installed your Dialogic® Diva® product, you might need to generate a license and activate it in the web interface to unlock the requ

20 Proof of Purchase Code (PPC) When you purchase the license, you will receive a PPC either in printed form or via email. By registering this PPC, yo

21 3. If your PPC is valid, the following web site will open: 4. Paste your Device Unique ID (DUID) that you copied from the Diva web interface and

22 To activate the license The date set in the system settings of your computer must be correct. Otherwise, you cannot add your license file. 1. Open

23 Post installation settings The Dialogic® Diva® System Release software installs and configures the Dialogic® Diva® WEB Configuration Wizard (lightw

24 3. The system configuration also allows you to specify startup options for your Dialogic® Diva® Media Boards. If you plan to clone your system con

25 Depending on the installed board and the selected D-channel protocol, you might need to configure various advanced parameters. To do so, set View e

26 Maintenance The Dialogic® Diva® WEB Configuration Wizard provides access to the following maintenance functions: • System environment on page 26 a

27 Trace/Debug The Dialogic® Diva® Trace Wizard allows for selecting various trace profiles and thus enables you to trace everything or to suppress un

28 View trace file The trace file browser allows for decoding, filtering, and browsing the trace file without downloading this file to your machine an

2 Management interface 73 "divalogd" accounting utility...

29 During installation and configuration, the divas_cfg.rc script is automatically generated. This script is used to load protocol, CAPI, and TTY inte

30 "/proc" file system After being started, the DIDD (divadidd.[k]o) driver creates the directory /proc/net/isdn/eicon for kernel 2.4.x and

31 Global fax configuration options allow for overwriting parameters passed by the fax application to the Dialogic® Diva® Media Board and to control p

32 Fax configuration options Option Description Fax speed limit Allows to limit the transmission speed. Normally, you do not need to limit the fax s

33 Dialogic® Diva® Media Boards provide numerous configuration options part of which are only used in special applications. These configuration option

34 ACOPY2 file server This tool allows you to test the Dialogic® Diva® Media Board and CAPI 2.0 interface functionality and link integrity using the X

35 The /dev/ttydsxx ports must be configured by AT commands (parameters enclosed in square brackets are optional. Variables are enclosed in angle bra

36 AT I[<n>] INFO. Returns the modem identification string. <n> : integer ranging from 0 to 9 AT H[0] HANGUP. Disconnects the line. AT O

37 <n> (0 ... 255) Description 127 Disables the escape sequence process, i.e. no escape character is recognized. ATS2=<n> 43 The defaul

38 4 16 Reserved 5 32 Reserved 6 64 Reserved 7 128 Reserved ATS91=<bitmask> Bit Value Result 0 1 Use reverse SDLC establishment (SNRM s

3 This guide provides a detailed description of how to install and configure the Dialogic® Diva® System Release software, and how to troubleshoot your

39 ATS254=<bitmask> Bit Value Result 0 1 Allows to reject incoming call using ATH, ATZ commands or using DTR drop procedure. 1 2 Activat

40 5 Force MNP error correction. Disconnect in case of failure. 6 Force V.42 or MNP error correction. Disconnect in case of failure. 7 Try to estab

41 Supported AT# commands AT command Description AT #CID=? Displays CID (Caller ID) setting. The short form of this command is "CID?". <

42 2 Turns 1800 Hz guard tone on. AT &D[<n>] Data Terminal Ready (DTR) options. <n> ranges from 0 to 3. See AT&Q command below.

43 Supported AT$ commands AT command Description AT $F<number> Controls Dialogic® Diva® FastSetup. 0 - Normal connection (default), 1 - FastS

44 1 ... 255 AT-command response is delayed. <n> RNA Framing. [e] 0 No framing check (pass data transparently). 1 Force synchronous conversa

45 4 RNA mode. TTY operates in framing mode, investigates protocol data units, and provides ASYNC/SYNC conversion if necessary. 5 BTX over ISDN mode

46 Format Service Indicator/Additional Service Indicator Number Sets the Service Indicator to the provided value. The Additional Service Indicator i

47 AT&F18+IE=piafs China variable speed PIAFS link AT+IE=none Resets the tty interfaces to "default" mode (i.e. signaling information

48 AT +MF=<data bits><parity>,<top bits> Data bits: 8,7,5. Parity: N (none), O (odd), E (even), S (space), M (mark). Stop bits: 1, 2

4 Copyright © 1993 - 2008 Dialogic Corporation. All Rights Reserved. You may not reproduce this document in whole or in part without permission in wri

49 Supported Class Fax1 and class Fax2 AT commands The following list is an excerpt of the complete list. Command Description AT +FCLASS? Queries th

50 AT+FTD. Set current time and date The AT+FTD command is used to set the current date and time. The current time and date should be set before each

51 AT+FPH command parameters Parameter Description mode Reserved. Should be set to 1. string The string defines the page header itself. Only ASCII p

52 You can use the AT&F[<profile>] and ATZ[<profile>] commands to select a TTY profile. Supported TTY profiles Profile Description 14

53 For incoming calls, you can use autodetection of the B-channel protocol. The call autodetection procedure detects the call type, uses the right fra

54 The ASYNC/SYNC conversion module is inserted on top of OSI layer 3 and is used for automatic framing type detection and conversion. Together with t

55 Reliable data transfer between application and Dialogic® Diva® Media Board Dialogic® Diva® Media Boards provide a high-performance block-oriented I

56 ECM (Error Correction Mode) support You can control ECM support via the FAX CLASS 2 AT-command set or via Global Dialogic® Diva® TTY configuration

57 Global Dialogic® Diva® TTY configuration options allow you to overwrite the parameters passed by the application and to control parameters running

58 By default, the Dialogic® Diva® TTY interface operates in "channel pool" mode. It presents the available Dialogic® Diva® Media Boards as

5 Software License Agreement This is an Agreement between you, the Company, and your Affiliates (referred to in some instances as "You" and

59 The ESCAPE sequence enables you to switch from ONLINE mode (data transfer mode) to ESCAPE mode (command mode with the connection established in the

60 Depending on the response code format that is selected by the ATV command, the result code can be delivered as plain text message (direct form) or

61 The format of the plain text CONNECT command response can be controlled by the AT\V command. Command responses Meaning Direct form Numeric form C

62 56000 17 64000 18 11111 19 75 20 110 21 150 22 300 23 600 24 2400 26 4800 27 7200 28 9600 29 12000 30 14400 31 16800 32 19200 33 21

63 50400 46 52800 47 55200 48 56000 49 57600 50 60000 51 62400 52 64000 53 28000 54 29333 55 30666 56 32000 57 33333 58 34666 59 37333 60 38666

64 This section describes step-by-step how to set up a dial-in server using mgetty and pppd applications. The dial-in server is built using the mg

65 5. Make sure that the ppp package is installed on your system. 6. Change the context of the /etc/ppp/options file as follows: # # Common option

66 7. In case you plan to use the PAP authentication protocol, create the file /etc/ppp/pap-secrets: # Secrets for authentication using PAP # client

67 2. Install the changed ppp.callback ppp application in the /usr/sbin directory. 3. Change the context of the /etc/mgetty+sendfax/login.config fil

68 # # Common options for TTY interfaces # # # Debug # #debug 9 #kdebug 9 # # # Allow callback operation and set-up callback script # callback 21

6 • Each end user to whom a Licensed System is distributed must agree to license terms with respect to the Program that are at least as protective of

69 Note: The "lock" option was removed and two new parameters were added: "callback", which activates callback and provides defaul

70 #! /bin/sh set -e # Parameter 1 - Callback Address # Parameter 2 - TTY device name # Parameter 3 - peer auth name if [ $(($#)) -lt $((3)) ]

71 6. Change the permissions of callback.sh file to "executable". 7. The callback script receives the callback number, the Dialogic® Diva

72 Before you can uninstall the Dialogic® Diva® System Release software, you need to unload the Dialogic® Diva® driver modules. The Diva driver module

73 The management interface can be used to control the Dialogic® Diva® Media Board configuration at run time without reloading or restarting the Diva

74 The divactrl package contains the mantool utility that allows you to access (read, write or execute) directories and variables of the management in

75 The management interface is structured like a virtual file space, containing directories with variables. The set of operations that is valid for ea

76 Dialogic® Diva® Media Board management interface directory The Dialogic® Diva® Media Board management interface on page 111 is located on the Dialo

77 PRI MI_BOOLEAN RO Dialogic® Diva® PRI Media Board or Dialogic® Diva® BRI Media Board Channels MI_UINT RO Number of channels AnalogChannels MI_UINT

78 Call rejected MI_UINT RO Number of calls refused because they were rejected Wrong number MI_UINT RO Number of calls refused because an invali

7 Limited Warranty Dialogic solely warrants the media on which the Program is furnished to You to be free from defects in materials and workmanship un

79 Log Buffer MI_TRACE EVENT Trace information: L1, D-channel, B-channel and debug information Dialogic® Diva® TTY management interface directory

80 Dialogic® Diva® TTY driver configuration directory The "GlobalOptions" management interface directory allows to change the values of the

81 TTY Call filter directory The "CallFilter" management interface directory allows for configuration of the call filters. The call filter a

82 TTY Port Manager directory The "TTY" management interface directory allows you to control the state of the available TTY interfaces (TTY

83 Dialogic® Diva® CAPI management interface directory The CAPI driver management interface on page 112 is located in the CAPI device driver. It is

84 To configure and secure the SNMP master agent correctly, read the corresponding documentation and FAQ. For the impatient, a quickstart is provided

85 This section provides information about supported MIBs, OIDs, and traps by Dialogic® Diva® SNMPX and about the relationship between supported OIDs

86 ISDN-MIB (RFC2127) transmission.isdnMib.isdnMibObjects.isdnSignalingGroup isdnSignalingGetIndex Number of possible D-channels (equals number of

87 callActiveIndex Unique index callActivePeerAddress Address of remote partner callActivePeerSubAddress Subaddress of remote partner callA

88 callHistoryDisconnectTime Timeticks measured from start of divasnmpx. callHistoryCallOrigin Direction of call: Answer or originate. After ins

8 Miscellaneous You acknowledge that You have read this Agreement, that You understand it, and that You agree to be bound by its terms and conditions,

89 If application problems occur; for example, you cannot connect to a specific number, the application returns an error, the application does not rec

90 D-channel trace mode To start the D-channel monitoring tool in trace mode, execute: divactrl dchannel -c <x> [<parameters>], where: <

91 SIG-X(004) 08 01 82 01 Q.931 CR82 ALERT SIG-X(007) 08 01 82 0D 18 01 89 Q.931 CR82 SETUP_ACK Channel Id

92 D-channel monitor mode In monitor mode, the D-channel monitor runs in the background as daemon and reports status changes of layer 1 and (or) layer

93 The Dialogic® Diva® Media Board health monitor contained in the divactrl package allows you to control the operating status of the Dialogic® Diva®

94 XLOG trace mode The following trace information is accessible via the XLOG interface: • D-channel traces • B-channel traces (first 24 bytes) • L

95 The tty_test utility contains a test server, a test client, and a small terminal application. The test client calls the test server. When the conne

96 -l<frame_length> Optional Length of the test frame. It is normally not used by the test server but it should be provided if the -s option fo

97 x75v42 HDLC/X.75 with V.42bis data compression/Transparent. This protocol is not used on the server side because x75 automatically detects X.75

98 -l<frame_length> Optional Length of the test frame. It is normally not used by the test server but it should be provided if the -s option fo