Dialogic DSI SS7MD manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191

Ir para a página of

Bom manual de uso

As regras impõem ao revendedor a obrigação de fornecer ao comprador o manual com o produto Dialogic DSI SS7MD. A falta de manual ou informações incorretas fornecidas ao consumidor são a base de uma queixa por não conformidade do produto com o contrato. De acordo com a lei, pode anexar o manual em uma outra forma de que em papel, o que é frequentemente utilizado, anexando uma forma gráfica ou manual electrónicoDialogic DSI SS7MD vídeos instrutivos para os usuários. A condição é uma forma legível e compreensível.

O que é a instrução?

A palavra vem do latim "Instructio" ou instruir. Portanto, no manual Dialogic DSI SS7MD você pode encontrar uma descrição das fases do processo. O objetivo do manual é instruir, facilitar o arranque, a utilização do equipamento ou a execução de determinadas tarefas. O manual é uma coleção de informações sobre o objeto / serviço, um guia.

Infelizmente, pequenos usuários tomam o tempo para ler o manual Dialogic DSI SS7MD, e um bom manual não só permite conhecer uma série de funcionalidades adicionais do dispositivo, mas evita a formação da maioria das falhas.

Então, o que deve conter o manual perfeito?

Primeiro, o manual Dialogic DSI SS7MD deve conte:
- dados técnicos do dispositivo Dialogic DSI SS7MD
- nome do fabricante e ano de fabricação do dispositivo Dialogic DSI SS7MD
- instruções de utilização, regulação e manutenção do dispositivo Dialogic DSI SS7MD
- sinais de segurança e certificados que comprovam a conformidade com as normas pertinentes

Por que você não ler manuais?

Normalmente, isso é devido à falta de tempo e à certeza quanto à funcionalidade específica do dispositivo adquirido. Infelizmente, a mesma ligação e o arranque Dialogic DSI SS7MD não são suficientes. O manual contém uma série de orientações sobre funcionalidades específicas, a segurança, os métodos de manutenção (mesmo sobre produtos que devem ser usados), possíveis defeitos Dialogic DSI SS7MD e formas de resolver problemas comuns durante o uso. No final, no manual podemos encontrar as coordenadas do serviço Dialogic na ausência da eficácia das soluções propostas. Atualmente, muito apreciados são manuais na forma de animações interessantes e vídeos de instrução que de uma forma melhor do que o o folheto falam ao usuário. Este tipo de manual é a chance que o usuário percorrer todo o vídeo instrutivo, sem ignorar especificações e descrições técnicas complicadas Dialogic DSI SS7MD, como para a versão papel.

Por que ler manuais?

Primeiro de tudo, contem a resposta sobre a construção, as possibilidades do dispositivo Dialogic DSI SS7MD, uso dos acessórios individuais e uma gama de informações para desfrutar plenamente todos os recursos e facilidades.

Após a compra bem sucedida de um equipamento / dispositivo, é bom ter um momento para se familiarizar com cada parte do manual Dialogic DSI SS7MD. Atualmente, são cuidadosamente preparados e traduzidos para sejam não só compreensíveis para os usuários, mas para cumprir a sua função básica de informação

Índice do manual

  • Página 1

    www.dialogic.com Dialogic ® DSI SS7MD Network Interface Boards Programmer’s Manual[...]

  • Página 2

    2 Copyright© 2009 Dialogic Corporation. All Rights R eserved. Y ou may not re produce this document in whole or in part without permission in writing from D ialogic Corporation at the address prov ided below. All contents of this document are furnishe d for informational use only and are subjec t to change without notice and do not represent a com[...]

  • Página 3

    Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 3 Contents 1 Introduction ............................................................................................................. 7 1.1 Related Information ............................................................................................ 7 2 Specification ........................[...]

  • Página 4

    4 Contents 4.8.3 Dynamic Operation ................................................................................. 37 4.8.4 Example Code for Building and Send ing MVD_MSG_SC_LISTEN Message ........ 37 4.8.5 Interconnecting LIUs using STREAM_XCON ................................................ 38 4.9 Receiv ed Message Timestamping ...............[...]

  • Página 5

    Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 5 Figures 1 Switch Connections................................................................................................... 36 2 Drop and Insert........................................................................................................ 38 3 Protocol Configuration Message Sequen[...]

  • Página 6

    6 Contents Revision History Note: The current issue of this guide can be found at: http://www .dialogic.com/support/helpweb/signaling Date Part Number Issue Description July 2009 05-2640-003 3 Description of thermal sensor operation added. May 2009 05-2640-002 2 Support for introduction of A TM termination mode and timestamping. April 2009 05-2640-[...]

  • Página 7

    7 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 1: Introduction Dialogic ® DSI SS7MD Network Interface Boards are specialized T1/E1/J1 S S7 signaling boards suitable for use in PCI Express form factor systems. The boards use the common Dialogic ® DSI software API to the application that enables applic ations to be easily ported. Th[...]

  • Página 8

    8 1 Introduction[...]

  • Página 9

    9 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 2: Specification This chapter provides information about: • Product Identifiers • Dialogic ® DSI SS7MDL4 Network Interface Board - Low Profile PCI Express F orm F actor • Software Licenses[...]

  • Página 10

    10 2 Specification 2.1 Product Identifiers The Dialogic ® DSI SS7MD Network Interface Board prod uct family includes the PCI Express form factor described in the following subsections. 2.1.1 Dialogic ® DSI SS7MDL4 Network Interface Board - Low Profile PCI Express Form Factor Product DSI SS7MDL4 PCI Express form factor pr oduct line includes the f[...]

  • Página 11

    11 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 2.2 Dialogic ® DSI SS7MDL4 Network Interface Board - Low Profile PCI Express Form Factor The DSI SS7MDL4 board is a x1 lane electrical, x4 lane ph ysical, low profile PCI Express form factor , which can be installed in x4, x8, or x16 lane slots. The board is supplied with two End Br ackets su[...]

  • Página 12

    12 2 Specification which to install the board. Refer to Section 2.2.7, “ Airflow Requirements” on page 13 for more information. 2.2.3 Physical Interfaces The DSI SS7MDL4 board supports the following physical interfaces: • Four T1/E1/J1/J1 digital trunk interfaces. See Section 2.2.3.1 below for more detail. 2.2.3.1 T1/E1/J1 Digital Tr unk Inte[...]

  • Página 13

    13 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 2.2.5 Visual Indicators The DSI SS7MDL4 board includes the following visual indicators: • T1/E1/J1 dual-color Green/Re d status LEDs: — Green indicates a valid link — Red indicates a line alarm Note: Only the LEDs 0, 1, 2, and 3 are active (LEDs 4, 5, 6, and 7 are reserv ed for future us[...]

  • Página 14

    14 2 Specification 2.2.9 Safety, EMC and Teleco mmunications Specifications Safety , EMC and telecommunications specification information is provid ed by the following: • Dialogic ® DSI SS7MDL440Q Network Interface Board Regulatory Notices Supplied with each product and provides a full list of the specifications to which DSI SS7MDL4 board confor[...]

  • Página 15

    15 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 2.3 Software Licenses The DSI SS7MDL4 codefile supports different MTP2 lin k densities on the board. T hese are enabled using a Host Software License that is to be ordered at the same time as t he hardware. The Host Software License licenses a specific number of link r esources on the host tha[...]

  • Página 16

    16 2 Specification The following combinations of link types are av ailable to the user: Note: When using multiple link types on the same board, the run mode indica tes to the board the predominant link type. Note: T o change the run mode of a bo ard, the board must be reset. Run Mode LSL Links HSL Links ATM Links IMA Links LSL Y Y Y H S L YYY A T M[...]

  • Página 17

    17 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 3: Installation This chapter contains the following topics: • Software P ackages • Software Installation for Linux • Software Installation for Solaris (SP ARC)[...]

  • Página 18

    18 3 Installation 3.1 Software Packages This manual describes the installation and use of the following software: • Development P ackage • User Part Dev elopment Package • Binary for Dialogic ® DSI SS7MD Network Interface Boards 3.1.1 Development Package Different variants of the Dev elopme nt Package are a vailable for the supported operati[...]

  • Página 19

    19 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 3.2 Software Installation for Linux The Development P ackage for Linux is distributed as a download from the Dialogic web site. See Section 1.1, “Related Information” on page 7 . The distribution is in the form of a single compressed file called dpklnx6.Z . Installation of the software is [...]

  • Página 20

    20 3 Installation The ldconfig utility creates a symbolic link to the GCT li brary shared object within the install directory . For e xa m p le : /opt/dpklnx: libgctlib.so.1 -> libgctlib.so.1.0.1 If the installation machine is to be used to build applications, an additional link must be created from libgctlib.so.1 to libgct.so : ln -s libgctlib.[...]

  • Página 21

    21 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 3.2.3 Support for a Large Number of DSI Messages The default Linux configuration may need to be modified to support a large number of DSI messages. 1. Edit the /etc/rc.local (or distribution-specific equivalent) file to add the following line: sysctl -w kernel.msgmnb=<max_queue_bytes> wh[...]

  • Página 22

    22 3 Installation ss7dpk-devel-5.08-1.<ARCH>.rpm ss7dpk-debuginfo-5.08-1.<ARCH>.rpm ss7dpk-kmod-5.08-1.2.6.9_34.EL.<ARCH>.rpm Where <ARCH> is i386 for 32bit operation and x86_64 for 64 bit operation systems. Note: Device driver binaries, includin g the one for the DSI S S7MD Board, will be built as rpmbuild is run. Therefore[...]

  • Página 23

    23 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 3.3 Software Installation for Solaris (SPARC) Installation of the software is described in more detail in the following topics: • Additional Commands • Support for Larger Message Queues • Re moving the Development Package for Solaris • Solaris Interface Name Checking The Development P [...]

  • Página 24

    24 3 Installation 3.3.1 Additional Commands Customers using Solaris 10 and the DSI SS7MD Boards must perform the following additional commands after installing the package: cd/opt/DKseptel chown root ssdm chmod +s ssdm Note: The commands should be executed by a user with super -user permissions. 3.3.2 Support for Larger Message Queues The number of[...]

  • Página 25

    25 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 4: Dialogic® DSI SS7MD Bo ard Configuration and Operation Before attempting software configur ation, you should g ain an appreciation of the flexibility of the protocol stack, the run-time options that ex ist and the mechanisms that are used to select specific features. This section g[...]

  • Página 26

    26 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.1 Regulatory and Geog raphic Considerations Certain functions of Dialogic ® DSI SS7MD Boards, although implemen ted in hardware, hav e selectable options that are configured by the ss7.dc6 codefile. A user or integr ator must consider the requirements of the application when choosing t[...]

  • Página 27

    27 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.2 System Structure The Dialogic ® DSI Protocol Stack software running on the board communicates with the higher level protocols running on the main CPU of the host comput er . The user ’ s application ma y also be running on the host computer . See Section 4.3, “Running Host Binaries Wi[...]

  • Página 28

    28 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.3 Running Host Binaries With Dialogic ® DSI SS7MD Board The Dialogic ® DSI MTP2 Layer protocol module runs on t he board. The other S S7 protocol modules (MTP3, ISUP , TUP , SCCP , TCAP , MAP , INAP , and IS 41) must be run on the host machine. Host protocol software is av ailable for[...]

  • Página 29

    29 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.4 System Configuration System configur ation is handled by the gctload program that reads system configur ation data from a file called system.txt . System initialization requires: • First, that a pool of message buffers is crea ted for subsequent inter-process communication. • Second, t[...]

  • Página 30

    30 4 Dialogic® DSI SS7MD Board Configuration and Oper ation NUM_MSGS 1000 * Number of standard size messages * * Optional Modules that run on the host: * * LOCAL 0x23 * ISUP module * LOCAL 0x4a * TUP module * LOCAL 0x33 * SCCP module * LOCAL 0x14 * TCAP module * LOCAL 0x22 * MTP3 module * * * Redirection of status indications: * REDIRECT 0xdf 0x2d[...]

  • Página 31

    31 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 It is next necessary to include FORK_PROCESS commands for the modules running on the host computer . All systems require ssdm , tick and tim binaries to be run. • For Linux users, the mandatory FORK_PROCES S commands are: FORK_PROCESS ./ssdm FORK_PROCESS ./tim_lnx FORK_PROCESS ./tick_lnx •[...]

  • Página 32

    32 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.5 Protocol Configuration The Development P ackage contains the s7_mgt protocol configuration utility that performs initialization of all the software modules running on the signaling board. It reads the protocol configur ation data from a text file, called config.txt , and provides a qu[...]

  • Página 33

    33 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 * * ISUP parameters: * * Configure ISUP module: * ISUP_CONFIG <reserved> <reserved> <us er_id> <options> <num_grps> <num_ccts> *ISUP_CONFIG 0 0 0x1d 0x0435 4 64 * * Configure ISUP circuit groups: * ISUP_CFG_CCTGRP <gid> <dpc> <base_cic> <[...]

  • Página 34

    34 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.6 Monitoring The monitoring option can be used in conjunction wi th the SS7 Development P ackage for the appropriate operating system (Linux or Solaris) to realize a high-performance protocol mon itor with up to 4 boards, each monitoring a certain number of links (see the table in Secti[...]

  • Página 35

    35 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.7 ATM Monitoring The system can also be used to monitor AAL5 traffic that is running o ver A TM links. The following is an example config.txt co nfiguration file to support AAL5 Monitoring: ******************************************************************************** * Example Protocol Co[...]

  • Página 36

    36 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.8 Switching Time slots between LIUs The Dialogic DSI SS7MD Boards support multiple T1/E1/J1 Line Interface Un its (LIUs). The onboard signaling processor handles the SS7 signaling timeslots, while the re maining circuits (voice or data bearer circuits) are switched to another onboard LI[...]

  • Página 37

    37 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.8.2 Static Initialization Static initialization is handled by the s7_mgt protocol configuration utility . F or each T1/E1/J1 Line Interface Unit (LIU), the user should includ e an LIU_SC_DRIVE command in the config.txt protocol configuration file. The LIU_SC_DRIVE command has sever al parame[...]

  • Página 38

    38 4 Dialogic® DSI SS7MD Board Configuration and Oper ation MSG *m; u8 *pptr; /* * Allocate a message (and fill in type, id, rsp_req & len): */ if ((m = getm(MVD_MSG_SC_LISTEN, 0, RESPONSE(OUR_MOD_ID), MVDML_SCLIS)) != 0) { pptr = get_param(m); memset(pptr, 0, m->len); /* * Enter the parameters in machine independent format: */ rpackbytes(p[...]

  • Página 39

    39 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.9 Received Message Timestamping Timestamping of received message s can be enabled for monitored lin ks. This functionality provides a timestamp of the time a message is received by a bo ard. Individual boards maint ain time by synchronising with the host time. The following table provides de[...]

  • Página 40

    40 4 Dialogic® DSI SS7MD Board Configuration and Oper ation 4.10 High Speed Link Operation High Speed Link (HSL) operation is supported in the following mode: • Structured mode, where the data stream is fr amed as for conventional SS7: — For T1, 8 bits in each of 24 timeslots are available for signalling. — For E1, timeslot 0 is used for fr [...]

  • Página 41

    41 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 4.11 Operation of the Thermal Sensor Thermal Protection The Dialogic ® DSI SS7MDL4 Network Interface Board is a hi gh performance, densely pack ed, low profile PCIe board supporting high message rates. In achiev ing this performance, the board ma y dissipate up to 17W and this must be taken i[...]

  • Página 42

    42 4 Dialogic® DSI SS7MD Board Configuration and Oper ation[...]

  • Página 43

    43 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 5: Program Execution This chapter describes how to start the so ftware and execute progr ams. It assumes that: • The software has already been installed. R efer to Chapter 3, “Installation” . • The system.txt configuration file has been modified correctly . Refer to Section 4.4[...]

  • Página 44

    44 5 Program Execution 5.1 Program Execution Overview There are three main stages to getting a new application up and running, although the precise means of achieving this vary slightly depe nding upon the operating system: 1. Ensure that the device driv er is installed and running. 2. Ensure that the protocol soft ware is running on the host. 3. W[...]

  • Página 45

    45 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 5.2 Program Execution Under Linux and Solaris Proceed as follows: 1. Ensure the device driver has been installed and the system.txt configur ation file has been modified in accordance with system requirements to select the correct protocols etc. 2. Ensure that the correct codefile has been cop[...]

  • Página 46

    46 5 Program Execution[...]

  • Página 47

    47 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 6: Message Reference This section describes the individual messages that may be sent to or received fr om a Dialogic® DSI S S7MD Board. Some messages are sent by the user's application software, while others are sent by utility progr ams such as the s7_mgt protocol configuration [...]

  • Página 48

    48 6 Message Reference 6.1 DSI SS7MD Software Modu le IDs for DSI SS7MD Board Ta b l e 6 lists the software modules IDs (by mnemonic and value) used on the DSI SS7MD Board. Table 6. DSI SS7MD Board Software Module IDs Mnemonic Value Description MGMT_T ASK_ID 0x8e SS7MD Board Management Module MVD_T ASK_ID 0x10 SS7MD LIU and S witch Management Modul[...]

  • Página 49

    49 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.2 General Configuration Messages General configur ation messages are typically issued by the s7_mgt protocol configuration utility , in which case they need not, and should not, be gene r ated by any user application software. If the user elects not to use the s7_mgt protocol configuration u[...]

  • Página 50

    50 6 Message Reference Parameters The SSD_MSG_RESET message includes the following par ameters: • mgmt_id The module ID of the manageme nt module to which SSD should send board status indications. • num_boards The maximum number of boards that ssd is required to manage. This should not exceed 4. 6.2.2 SSD_MSG_RST_BOARD – Board Reset Request S[...]

  • Página 51

    51 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • run_mode The protocols to be run. The following tabl e shows the permitted v alues and their meaning. The following combinations of link types are av ailable to the user . Note: When using multiple link types on the same board, the run mode indica tes to the board the predominant link type[...]

  • Página 52

    52 6 Message Reference 6.2.3 SSD_MSG_BOARD_INFO – Board Information Request Synopsis Message used to retrieve inform ation about the DSI SS7MD Board. Format Description This message is used when a user application wants to obtain information about a DSI SS7MD Board. This can happen at any time after the board has been report ed as being present i[...]

  • Página 53

    53 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • current_temp Signed 8-bit value containing the current temper ature of the board within the range -128 to 127 degrees Celsius. • max_temp Signed 8-bit value containing the maximum temper ature the board has reached since SSDM was last started. V alue is within the rang e -128 to 127 degr[...]

  • Página 54

    54 6 Message Reference — Bit 15 is set to 1 for diagnostics purposes to cause the results of board configuration to be passed to the host. When set, all confirmation messages g enerated internally on the board during the configuration sequence are sent to the 0xdf module ID on the host. — All other bits are reserved for fu ture use and should b[...]

  • Página 55

    55 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Configure the LSL timeslot rate: • l1_resource_id Layer 1 (logical) resource identifier . • data_rate Used for setting the link operation. The following table shows the perm itted v alues and their meaning. • link_source Configure the signaling source. Set to 0 for DSI SS7MD Board. • l[...]

  • Página 56

    56 6 Message Reference 6.2.6 MGT_MSG_L1_END – Layer 1 Configuration End Synopsis Message sent to a board to remove an existing layer 1 link that was pr eviously configured by sending an MGT_MSG_L1_CONFIG message. Format Parameters The MGT_MSG_L1_END message includes the following parameters: • l1_resource_id Layer 1 (logical) resource identifie[...]

  • Página 57

    57 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Parameters The MGT_MSG_NTP_CONFIG message incl udes the following par ameters: • enable Set to 1 to enable timestamping, 0 to disable timestamping. • poll_interval Set to 4. • ntp_management_id Set to 0x20.[...]

  • Página 58

    58 6 Message Reference 6.3 Hardware Control Messages Hardware control messages are used to control v arious hardware devices on the board, including the T1/E1/ J1 Line Interface Units (LIUs), the digital cross connect switches and th e clocking mode for the board. In a static configuration, these hard w are blocks can be set up using the s7_mgt pro[...]

  • Página 59

    59 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.3.1 LIU_MSG_CONFIG – LIU Configuration Request Synopsis Message sent by the application to establish the operating mode for a Line Interface Unit (LIU). Note: When using the s7_mgt protocol configuration utility , this message is generated by s7_mgt as a result of the LIU_CONFIG command. I[...]

  • Página 60

    60 6 Message Reference Note: The option chosen by the user m ust be appropriate to the actual hardw are fitted; otherwise an error status is returned. • line_code The line coding technique. The following table shows the permitted values and their meanings. • frame_format The frame format. The following table shows the permitted v alues and thei[...]

  • Página 61

    61 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • ais_gen The (initial) mode used to generate the Alarm Indi cation Signal (Blue alarm). The user may subsequently modify the setting of the outgoing signal using the LIU_MSG_CONTROL message. The following table shows the permitted valu es and their meanings. • high_Z The mode settings to [...]

  • Página 62

    62 6 Message Reference 6.3.2 LIU_MSG_CONTROL – LIU Control Request Synopsis Message sent by the application to dynamically control operation for a Line Interface Unit (LIU). Allows setting of outgoing alarms an d diagnostic loopbacks. Format Description This message is sent to the board to perform dynami c changes to the operation of the Line Int[...]

  • Página 63

    63 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • loop_mode The diagnostic loopback mode. The following tabl e shows the permitted v alues and their meanings. • prbs_gen The Pseudo Random Bit Sequence (PRBS) gener ation mode. The following tabl e shows the permitted values and their meanings. 6.3.3 LIU_MSG_R_CONFIG – LIU Read Configur[...]

  • Página 64

    64 6 Message Reference 6.3.4 LIU_MSG_R_CONTROL – LIU Read Control Request Synopsis Message sent by the application to read back the current Line Interfac e Unit (LIU) control options from the board. Format Description This message is sent to the board to read back the current control parameters selected for a Line Interface Unit (LIU). The user s[...]

  • Página 65

    65 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 The confirmation message (if re quested) indicates success with a status v alue of 0. On receipt of the confirmation message, the operation to reset the switch is completed. 6.3.6 MVD_MSG_SC_CONNECT – Connect Request Synopsis Message sent to the board to control the switch path. Format Descr[...]

  • Página 66

    66 6 Message Reference Parameters The parameters that can be included in the MVD_MSG_SC_CONNECT message depend on the requested mode. The following table depicts the parameters that are required for each possible mode: • local_stream Defines which local stream to use for all the modes of operation.The local_stream par ameter specifies either a T1[...]

  • Página 67

    67 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • source_stream The source_stream references the cross connect sw itch streams that should be used as a source for data. The parameter tak es values in the range of 0 to 31. F or some modes (for example, 11 and 12), this field is used to specify a local st ream instead of a switch stream. ?[...]

  • Página 68

    68 6 Message Reference 6.3.7 MVD_MSG_SC_MULTI_CONNECT – Multiple Connect Request Synopsis Message sent to the board to control the switch to connect multiple paths. Format Description This message is sent to the board in order to control the configuration of the cross connect switch for more complex configurations. Parameters The MVD_MSG_SC_MUL T[...]

  • Página 69

    69 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • source_st , source_ts When mode is set to 11, these paramete rs give the source_st and so urce_ts for conne ction to the specified local timeslots. For othe r modes the source_st an d source_ts specify the cross connect switch stream and timeslot, respectively . 6.3.8 MVD_MSG_SC_DRIVE_LIU [...]

  • Página 70

    70 6 Message Reference • mode The mode of operation that controls how the switch channels are allocated. T ypically , when mode is set to 1, the first timeslot connected to the switch is connected to th e timeslot indicated by sc_channel and each subsequent timeslot that is connected will be connected to th e next switch channel. This allows maxi[...]

  • Página 71

    71 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.4 Signaling Interface Messages Signaling interface messages allow signaling links to be ac tivated and deactiv ated by the user and provide a mechanism for communication between the MTP3 module and the user part module (for example, ISUP , TUP or SCCP). In many cases, the user part module is[...]

  • Página 72

    72 6 Message Reference 6.4.1 SS7_MSG_CONFIG – MTP2 Li nk Configuration Request Synopsis Message issued by management to MTP2 to con figure an individual signaling link for oper ation. Format Description This message is used to configure the operational par a meters for an individual signaling link and to cause the power up action defined in Q.703[...]

  • Página 73

    73 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 messages may be issued to the MTP2 module to modify timer configur ation parameters however; these messages do not affect SS7 oper ation (that is, th e power up sequence is not re-executed, but the parameters are modified). For backw ards compatibility , the MTP2 module acce pts messages with [...]

  • Página 74

    74 6 Message Reference the loop delay in ms for 56 kbits/ s operation. If set to 0, the MTP2 module assumes a v alue of 12800 for an HSL link, 400 otherwise. • rtv_attempts Re served. Set to 0. • t1, t2, t3, t4n, t4e, t5, t6, t7 V alues for the protocol timers as defined in Q.70 3. These should be set to the number of (tick * timer_res) interva[...]

  • Página 75

    75 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Parameters The MTP_MSG_RX_IND message includes the following parameter: • Signaling Unit Data The SU data in binary format, excluding the Flags and Checksum. • UUI User to User Information – pa rameter gener ated when operating in A TM monitoring mode only . • CPI Common Part Indicator[...]

  • Página 76

    76 6 Message Reference • seconds_fraction Binary fractions of a second. 6.4.4 API_MSG_TX_REQ – MTP2 Transmission Request Synopsis Message issued to the board by MTP3 , containing an SS7 Message Signal Unit (MSU) for tr ansmission on the specified link. Format Description Message issued to the board by MTP3 containing an SS 7 Message Signal Unit[...]

  • Página 77

    77 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.4.5 GEN_MSG_MOD_IDENT – Module Identification Request Synopsis Message issued to request software v ersion. Format Description Message issued to requ est software v ersion. Parameters The GEN_MSG_MOD_INDENT message incl udes the following parameters: • maj_rev Major revision identifier f[...]

  • Página 78

    78 6 Message Reference 6.5 ATM Interface Messages A TM Interface Messages allow A TM lin ks to be configured, activate d, and deactiv ated by the user . • A TM_MSG_CONFIG - Configure A TM • A TM_MSG_CFG_STREAM - A TM Cell Stream Configuration • A TM_MSG_END_STREAM - Remov e A TM Cell Stream Configuration • A TM_MSG_R_STREAM_ST A TS - P er A[...]

  • Página 79

    79 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • options • num_streams The maximum number of cell streams this modul e will be asked to simultaneously support. Each cell stream shall be treated independently of the link bandwidth the cell stream consumes. For an IMA bundle, each TDM stream within the bundle will be counted as separate.[...]

  • Página 80

    80 6 Message Reference 6.5.2 ATM_MSG_CFG_STREAM – ATM Cell Stream Configuration Synopsis Message used to configur e an A TM cell stream. Format Description Processed by the module (once a module configuration message has been correctly processed) to configure and activate an A TM cell stream (w hether single TDM or IMA bundle). After extraction o[...]

  • Página 81

    81 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • options Note: Either Pa yload Scrambling or A TM Coset mode, or both, must be enabled for correct operation. Configurations which disable bo th options will be rejected. • ima frame length The length of the IMA frame. Note: For non IMA streams this field is r eserved and should be set to[...]

  • Página 82

    82 6 Message Reference Note: Attempting to activ ate TDM tim eslots that are not present on th e underlying TDM (e.g. , using a bitmap of 0xfffefffe when the TDM is configured as T1) may NO T result in the rejection of the configuration message. • mgmt_id ID of management module for status updates. • upper_stream_id Upper layer (la yer 3) strea[...]

  • Página 83

    83 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Description Sent by the user to request (and optionally reset) the statistics for the cell stream. The v alues returned are the totals for the links using this cell stream. The confirmation message (if re quested) indicates success with a status v alue of 0. • Cell Stream ID The logical Cell[...]

  • Página 84

    84 6 Message Reference 6.5.5 ATM_MSG_AAL_CFG_MON_LINK – Configure AAL Monitor Link Synopsis Message used to configure a monitor link. Format Description Sent by the user to configure the pa rameters of a monitored link. At pr esent, the only link type a vailable via this message is an AAL5 link. • link_id Identifier for this link. Note: This id[...]

  • Página 85

    85 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • VPI The VPI of the AAL5 stream to be monitored. The VPI must be viable in the mask configured in the A TM_MSG_CONFIG message. • VCI The VCI of the AAL5 stream to be mon itored. The VCI v alue must be viab le in the mask specified in the A TM_MSG_CONFIG message. Note : 0, 3, and 4 are res[...]

  • Página 86

    86 6 Message Reference 6.5.7 ATM_MSG_R_AAL_LINK_STATS – Per Monitored Link Statistics Synopsis Message used to retrieve (and re set) per monitored link statistics. Format Description Sent by the user to request (and optionally reset) the statistics for the specified AAL link. The confirmation message (if requested) indicates success with a status[...]

  • Página 87

    87 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.5.8 ATM_MSG_STREAM_STATE – AT M Stream Status Indication Synopsis Primitive generated by A TM to advise ma nagement of changes to the stream state. Message Format Description Sent by the A TM module when a st ream becomes active or inactive MESSAGE HEADER Field Name Meaning type A TM_MSG_S[...]

  • Página 88

    88 6 Message Reference 6.5.9 ATM_MSG_LINK_STATE – AA L Link Status Indication Synopsis Primitive generated by AAL to advise ma nagement of changes to the link state. Format Description Sent by the A TM module when an AAL link becomes active or inactive. MESSAGE HEADER Field Name Meaning type A TM_MSG_LINK_ST A TE (0x026b) id link_id src A TM Modu[...]

  • Página 89

    89 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.6 Q.SAAL Module This section describes the formats of all the messages used in the non-primitive interface. The full list of management requests sent to Q.SAAL includes: • SS7_ MS G_R ESE T - Q.SAAL Module R eset Request • QSL_MSG_CFG_LINK - Configure Q.SAAL Link • QSL_MSG_CFG_TIMERS -[...]

  • Página 90

    90 6 Message Reference • num_links Maximum number of Q.SAAL signaling links to support on this board. This may r ange from 0 to one less than the maximum number of links supported depend ing on how many signaling links the user wishes to use. It is not necessary to alw a ys use this number of links. 6.6.2 QSL_MSG_CFG_LINK – Configure Q.SAAL Lin[...]

  • Página 91

    91 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 QSAAL_MSG_TIMERS messages may be issued to the Q .SAAL module to modify timer configur ation parameters howeve r; these messages do not affect Q.SA AL oper ation (that is, the power up sequence is not re-executed, but the par ameters are modified). • link_id Identifier for this link. Note: T[...]

  • Página 92

    92 6 Message Reference • co1, co2, co3, ca1, ca2, ca3, cd1, cd2, cd3 Congestion onset, abatement and discard thresholds for use when th e Multiple Congestion Thresholds mode of operation is selected. The following relationships must be true: ca1 <= co1 <= ca2 <= co2 <= ca3 <= co3 and co1 <= cd1 <= co2 <= cd2 <= co3 <[...]

  • Página 93

    93 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Description QSAAL_MSG_CFG_LINK messages may be issued to the Q .SAAL module to modify timer configur ation parameters. Otherwise default timer v alues will be used. • Timer_CC Time between transmission of un- ack'ed BGN, END, ER, RS PDUs • Timer_keep_alive Time between keep alive mess[...]

  • Página 94

    94 6 Message Reference 6.6.4 QSL_MSG_END_LINK – Remove Q.SAAL Link Synopsis Re move a Q.SAAL Link - only allowed wh en the link is in the inactiv e state. Message Format Description Sent by the user to deactivate a link, remove its connection from the un derling A TM cell stream and release its resources. • link_id Identifier for this link. MES[...]

  • Página 95

    95 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.6.5 SS7_MSG_TRACE_MASK – Set Trace Mask Request Synopsis Message issued to Q.SAAL modu le to set the mask of wh ich messages should be traced Message Format Description The Q.SAAL module supports comprehe nsive tracing options on a per-lin k and per-primitive basis. The module can be confi[...]

  • Página 96

    96 6 Message Reference • ip_evt_mask The input event trace mask. This is a 16-bit v alue with bits set to 1 to cause a trace message to be sent to the management module whenever a message is received by Q . SAAL. Care should be take n when tracing messages, as system throughput ma y be red uced. The fields in the tr ace mask cause the events indi[...]

  • Página 97

    97 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.6.6 SS7_MSG_R_STATE – Read Link State Request Synopsis Message sent to Q.SAAL to re trieve current per link state in the same format as MTP2 Message Format Description This message is issued to the Q.SAAL module to read the current internal state of the link and the number of MSU's cu[...]

  • Página 98

    98 6 Message Reference 6.6.7 SS7_MSG_R_STATS – Read Link Statistics Request Synopsis Message sent to Q.SAAL module to retriev e per link statistics in sa me format as MTP2. Message Format Description Message used to retrieve Q.S AAL per-link statistics. Th e statistics are written into the parameter area of the message and the message is returned[...]

  • Página 99

    99 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.6.8 MGT_MSG_QSL_EVENT – Q.SAAL "Q.791 style" Event Indication Synopsis "Q791 style" event indication gener ated by Q.SAAL module to advise management of protocol ev ents. Message Format Description Sent by Q.SAAL module to mana gement when an event occurs. MESSAGE HEADE[...]

  • Página 100

    100 6 Message Reference 6.6.9 MGT_MSG_SS7_STATE – Link State Indication Synopsis Indication generated by Q .SAAL module to advise management of changes to the per-link state Message Format Description: This primitive is used by Q.S AAL to advise management of changes of state within the Link State Control function. These indications are only give[...]

  • Página 101

    101 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.6.11 Primitives issued to MTP3-b The following primitives are supported by the Q.S AAL module. For message defi nitions refer to Dialogic® SS7 Protocols MTP2 Progr ammer's Manual. MTP2 Primitive Description NN I Primitive Equivalent API_MSG_RX_IND Received Data Indication AAL -RECEIVE[...]

  • Página 102

    102 6 Message Reference 6.7 Event Indication Messages Event indication messages are the mechanism by which pr otocol and software error ev ents are reported to the application. These messages are generated asynchronously by differ ent modules within the stack. The messages in the event indi cation category include: • MGT_MSG_EVENT_IND - Error Ind[...]

  • Página 103

    103 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.7.2 MGT_MSG_TRACE_EV – Trace Event Indication Synopsis Message issued by a module to trace protocol ev ents. Message Format Description An individual module may be configured to report to management each prim itive issued or received. This is useful for trace and debug purposes. The event[...]

  • Página 104

    104 6 Message Reference 6.7.3 SSD_MSG_STATE_IND – Board Status Indication Synopsis Message sent to the application on completion of the reset and down load sequence or on detection of a board status event. Note: This message is not re quired when using the s7_mgt protocol configuration utilit y . Format Description This message is used to convey [...]

  • Página 105

    105 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.7.4 API_MSG_CNF_IND – Configurat ion Completion Status Indication Synopsis Message issued by the s7_mgt protocol configuration utility on comp letion of initial configur ation sequence. Format Description This message is issued by the s7_mgt protocol configuration utility on completion of[...]

  • Página 106

    106 6 Message Reference 6.7.5 MVD_MSG_LIU_STATUS – LIU Status Indication Synopsis Message issued by the board to provide notification of changes in LIU status. Format Description This message is issued by the board for ev ery change of state on the trunk interface. The MVD_MSG_LIU_ST A TUS message head er uses the following parameters: • liu_id[...]

  • Página 107

    107 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.7.6 MGT_MSG_SS7_EVENT – MTP2 Q.791 Event Indication Synopsis Message issued by the MTP2 module to advise management of protocol ev ents in accordance with Q.791. Format Description This primitive is used by MTP2 to advise system mana gement of the occurrence of protocol related events in [...]

  • Página 108

    108 6 Message Reference 6.7.7 MGT_MSG_NTP_SYNC – Timestampi ng Resynchronization Indication Synopsis Message sent if a significant time difference between the board and the ho st is detected. This message is generated only if received message timestamping is configured. See Section 4.9, “Received Message Timestamping” on page 39 for more info[...]

  • Página 109

    109 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.8 Status Request Messages Status request messages can be used to poll the status of modules or systems running on the board. The messages in the status request category include: • LIU_MSG_R_ST A TE - LIU Read State R equest • LIU_MSG_R_ST A TS - LIU Re ad Statistics Request • MGT_MSG_[...]

  • Página 110

    110 6 Message Reference 6.8.2 LIU_MSG_R_STATS – LIU Read Statistics Request Synopsis Message used to read back perfo rmance statistics associated with a Line Interface Unit (LIU). Format Description This message is used to collect performance statisti cs for a given Line Interface Unit (LIU). A module requesting LIU statistic information is requi[...]

  • Página 111

    111 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 — For E1 oper ating modes, it is the number of errors detected in the frame alignment word. — For T1 interfaces oper ating in D3/D4 frame form at, it is the number of fr aming bit errors. — For T1 interfaces oper ating in ESF form at, it is the number of CRC6 errors. Note: In general, t[...]

  • Página 112

    112 6 Message Reference 6.8.3 MGT_MSG_R_BRDINFO – Read Board Info Request Synopsis Message used to request basic board information. Format Description This message is provided to request a reply indicating the v alues of a nu mber of attributes associated with the board. On receipt of th is request, the module retur ns the message with the stat u[...]

  • Página 113

    113 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.8.4 DVR_MSG_R_L1_STATS – Link Statistics Request Synopsis Re trieve link statistics. Format Description This message provides the user with a number of statis tics on a per link basis. If the user sends the message with a non zero status field, the stat istics are reset to 0 after being r[...]

  • Página 114

    114 6 Message Reference • receiver_busy_cnt The number of times the receiver has entered the busy state as a result of the number of internal buffers falling below a set threshold. • rx_frame_cnt The number of (error-free) fr ames received on the link, excluding any duplicate fr ames that are discarded as a result of th e internal filtering mec[...]

  • Página 115

    115 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 6.9 Message Summary Table The following table lists, by message type, all the messages described in this manual. Table 7. Message Summary Message Type Mnemonic Description 0x0003 MGT_MSG_TRACE_EV T race Event Indication 0x0008 MGT_MSG_EVENT_IND Error Indication 0x0201 MGT_MSG_SS7_ST ATE Link [...]

  • Página 116

    116 6 Message Reference 0x6214 SS7_MSG_R_ST AT S R ead Link Statistics Request 0x6215 SS7_MSG_R_ST ATE R ead Link State Request 0x6263 A TM_MSG_R_STREAM_ST ATS Per A TM Cell Stream Statistics 0x6266 A TM_MSG_R_AAL_LINK_ST A TS Per Monitored Link Statistics 0x6f0d MGT_MSG_R_BRDINFO Read Board Info R equest 0x7200 SS7_MSG_RESET Q.SAAL Module Reset R [...]

  • Página 117

    117 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 7: Configuration Command Reference This chapter describes the comman ds and parameters used in the config.txt protocol configur ation file. These commands are used by the s7_mgt protocol configuration utility to perform one time configur ation of the protocol stack at startup. The com[...]

  • Página 118

    118 7 Configuration Command R eference 7.1 Physical Interface Configuration Commands The physical interface configur ation commands are: • SS7_B OAR D - Configure Dialogic ® DSI SS7MD Network Interface Board • LIU_CONFIG - Configure a T1/E1/J1 LIU • LIU_SC_DRIVE - Set Up Path Between LIU • SCBUS_LISTEN - Connect Switch Timeslot to LIU Time[...]

  • Página 119

    119 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.1.1 SS7_BOARD – Configure Dialogic ® DSI SS7MD Network Interface Board Synopsis Command to configure a DSI SS7MD Board in the system. Syntax SS7_BOARD <board_id> <board_type> <flags> <code_file> <run_mode> Example SS7_BOARD 0 SS7MD 0x0000 ss7.dc6 LSL Paramet[...]

  • Página 120

    120 7 Configuration Command R eference • <board_id> The logical identity of the board in the range from 0 to one less th an the number of boards supported. • <liu_id> The identifier of the T1/E1/J1 Line Interface Unit (LIU) in the range from 0 to one less than the number of LIUs. • <liu_type> The physical interface type. The[...]

  • Página 121

    121 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • <build_out> The build out type. The following table shows the permitted values and their meanings. Value Description Valid For 0 Setting for E1 devices liu_type = 5 1 T1/J1 default (short haul) liu_type = 4 8 T1/J1 long haul LBO (-0 dB) 9 T1/J1 long haul LBO (-7.5 dB) 10 T1/J1 long [...]

  • Página 122

    122 7 Configuration Command R eference 7.1.3 LIU_SC_DRIVE – Set Up Path Between LIU Synopsis This command is used during initialization to set up a static switch path betw een the Line Interface Units (LIUs) and the cross connect switch. It connects selecte d incoming voice timeslots from one T1/E1/J1 LIU to a sequential block of channels on the [...]

  • Página 123

    123 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.1.4 SCBUS_LISTEN – Connect Sw itch Timeslot to LIU Timeslot Synopsis This command establishes a connection from the switch to an outgoing timesl ot on the Line Interface Unit (LIU). Note: Dynamic modification of voice paths can only be performed by issuing messages directly to the board. [...]

  • Página 124

    124 7 Configuration Command R eference 7.1.5 STREAM_XCON – Cros s Connect Configuration Synopsis The STREAM_XCON command controls the cross connect switch on the signaling bo ards, enabling the cross- connection of timeslots between two Line Interface Unit (LIU ) on each signaling board . The LIUs on a board are referenced by a fixe d logical str[...]

  • Página 125

    125 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 — E1 interfaces have 32 timeslots numbered 0 to 31. Timeslot 0 is used for fr ame alignment and timeslot 16 is generally used for signaling or is empty . Hence the normal co nfigur ation is to cross connect timeslots 1 to 15 and 17 to 31 between the two ports on each signaling board by sett[...]

  • Página 126

    126 7 Configuration Command R eference 7.2 Monitor Configuration Commands The monitor configuration command is: • MONITOR_LINK - Configure Link in Monitoring Mode[...]

  • Página 127

    127 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.2.1 MONITOR_LINK – Configure Link in Monitoring Mode Synopsis The MONITOR_LINK command allows the user to conf igure a signaling link or A TM link to operate in monitoring only mode. The command is differentiated based on the data rate par ameter . R eceived signaling messages are passed [...]

  • Página 128

    128 7 Configuration Command R eference • <data_rate> An optional parameter to specify link par ameters, re quired for HSL or A TM operation. The v alid values are: MTP HSL/LSL Link Parameters • <board_id> The logical identity of the board in the range from 0 to one less th an the number of boards supported. • <blink> The ind[...]

  • Página 129

    129 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.3 MTP Configuration Commands The Message T ransfer P art (MTP ) configuration commands are: • MTP_CONFIG - Configure MTP • MTP_LINKSET - Configure a Linkset • MTP_LINK - Configure a Link • MTP_ROUTE - Configure a R oute • MTP_USER_PAR T - Configure a Local User Part 7.3.1 MTP_CONF[...]

  • Página 130

    130 7 Configuration Command R eference set to 0, on detection of RPO, the signaling link is tak en out of service and restoration commences. This bit should normally be set to 1. — Bit 20 used in conjunction with bit 9 to select point codes (see table above). — Bit 21 should be set to 1 for use in Japanese networks; otherwise it should be set t[...]

  • Página 131

    131 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.3.2 MTP_LINKSET – Configure a Linkset Synopsis Configuration of a linkset to an adjacent signaling point. Syntax MTP_LINKSET <linkset_id> <adjacent_spc> <num_links> <flags> <local_spc> <ssf> Example MTP_LINKSET 0 321 2 0x0000 456 0x8 Parameters The MTP_[...]

  • Página 132

    132 7 Configuration Command R eference Syntax MTP HSL/LSL Links MTP_LINK <link_id> <linkset_id> <link_ref> <slc> <board_id> <blink> <stream> <timeslot> <flags> [<data_rate>] Example MTP_LINK 0 0 0 0 0 0 0 16 0x0006 TDM ATM Links MTP_LINK <link_id> <linkset_id> <link_ref> [...]

  • Página 133

    133 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 — Bit 12 is used to select 12- or 7-bit sequence numbers for HSL only . Th is bit should be set for 12-bit sequence numbers, clear otherwise. — Bits 13 and 14 reserved. Set to 0. — Bit 15 is set to 1 to disable the link. This bit should be set to 0 to enable normal link oper ation. — [...]

  • Página 134

    134 7 Configuration Command R eference — vpi is the Virtual P ath Indicator of th e signaling link within the A TM cell stream. — vci is the Virtual Channel Indicator of th e signaling link within the A TM cell stream. For restrictions on the choice of VPI -VCI combinations refer to Section 6.5.1, “ A TM_MSG_CONFIG” on page 78 . 7.3.4 MTP_R[...]

  • Página 135

    135 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 — All other bits are reserved for fu ture use and must be set to 0. 7.3.5 MTP_USER_PART – Configure a Local User Part Synopsis Configuration of a local user part mod ule, other than a user part which has its own configuration command in the config.txt protocol configuration file. Syntax M[...]

  • Página 136

    136 7 Configuration Command R eference 7.4 ATM Configuration Commands The A TM configuration commands are: • A TM_CONFIG - Configure the A TM Module • A TM_STREAM - Configure A TM Cell Stream • A TM_TIMER - Configure Timers for Q.SAAL Links[...]

  • Página 137

    137 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.4.1 ATM_CONFIG – Configure the ATM Module Synopsis Global configuration of the A TM Module. Syntax ATM_CONFIG <options> <num_streams> Example ATM_CONFIG 0x0000 4 Parameters The A TM_CONFIG command includes the following parameters: • < options > A 16-bit value containi[...]

  • Página 138

    138 7 Configuration Command R eference 7.4.2 ATM_STREAM – Configure ATM Cell Stream Synopsis Configures an A TM Cell Stream. Syntax ATM_STREAM <id> <board_id> <cellstream_id> <liu_id> <options> <ima_frame_len> <max_frame_len> <def_vpi> <def_vci> <timeslot> Example ATM_STREAM 3 0 3 3 0x00[...]

  • Página 139

    139 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • < def_vci > A default AAL5 link will be configured for the cell stream to signal incomi ng active connections. This is the VCI that will be used for this connection. V alues 0, 3, and 4 are reserved an d should not be used. Note: The default VPI/VCI combination configured here m ust[...]

  • Página 140

    140 7 Configuration Command R eference 7.4.3 ATM_TIMER – Configure Timers for Q.SAAL Links Synopsis Override the default timer v alues for A TM Links. Syntax ATM_TIMER <reserved> <timer_id> <value> Example ATM_TIMER 0 T1 10 Parameters The A TM_TIMER command inc ludes the following parameters: • <reserved> This parameter [...]

  • Página 141

    141 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.5 ISUP Configuration Commands The ISUP configuration commands are: • ISUP_CONFIG - Configure ISUP • ISUP_CFG_CCTGRP - Configure an ISUP Circuit Group • ISUP_TIMER - Configure ISUP Timers 7.5.1 ISUP_CONFIG – Configure ISUP Synopsis The global configuration par ame ters for the ISUP m[...]

  • Página 142

    142 7 Configuration Command R eference 7.5.2 ISUP_CFG_CCTGRP – Config ure an ISUP Circuit Group Synopsis The configuration par ameters for a grou p of ISUP circuits. T ypically , a group is all the circuits in a single E1, T1, or J1 interface. Syntax ISUP_CFG_CCTGRP <gid> <dpc> <base_cic> <base_cid> < cic_mask> <o[...]

  • Página 143

    143 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.5.3 ISUP_TIMER – Configure ISUP Timers Synopsis The ISUP_TIMER command provides the ability to configure the ISUP protocol timers from the config.txt file. Syntax ISUP_TIMER <reserved> <timer_id> <value> Example ISUP_TIMER 0 t4 550 Parameters The ISUP_TIMER command inclu[...]

  • Página 144

    144 7 Configuration Command R eference 7.6 TUP Configuration Commands The TUP configuration commands are: • TUP_CONFIG - Configure TUP • TUP_CFG_CCTGRP - Configure a TUP Circuit Group 7.6.1 TUP_CONFIG – Configure TUP Synopsis The global configuration par a meters for the TUP module. Syntax TUP_CONFIG <res1> <res2> <user_id> [...]

  • Página 145

    145 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.6.2 TUP_CFG_CCTGRP – Conf igure a TUP Circuit Group Synopsis The configuration par ameters for a group of TUP circuits. Syntax TUP_CFG_CCTGRP <gid> <dpc> <base_cic> <base_cid> <cic_mask> <options> <user_inst> <user_id> <opc> <ssf>[...]

  • Página 146

    146 7 Configuration Command R eference 7.7 SCCP Configuration Commands The SCCP configuration commands are: • SCCP_CONFIG - Configure SCCP • SCCP_SSR - SCCP Sub-S ystem Resource • SCCP_CONC_SSR - SCCP Concerned Sub- System Re source • SCCP_TRACE - SCCP T race • SCCP_GT T_PA TTERN - Define Global Title P attern • SCCP_GT T_ADDRESS - Defi[...]

  • Página 147

    147 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.7.2 SCCP_SSR – SCCP Sub-System Resource Synopsis The SCCP_SSR command supplies the global configuration par ameters for the SCCP . Syntax SCCP_SSR <ssr_id> RSP <remote_spc> <flags> <pc_mask> SCCP_SSR <ssr_id> LSS <local_ssn> <module_id> <flags&[...]

  • Página 148

    148 7 Configuration Command R eference 7.7.3 SCCP_CONC_SSR – SCCP Co ncerned Sub-System Resource Synopsis The SCCP_CONC_SSR command marks the specified su b-system (which was dec lared by SCCP_S SR) as requiring notification of changes in the accessibility of another sub-system. No tification is given in the form of an SCCP management indication.[...]

  • Página 149

    149 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.7.5 SCCP_GTT_PATTERN – Defi ne Global Title Pattern Synopsis The SCCP_GT T_PA TTERN command defin es a global title pattern to be matc hed for a global title tr anslation. Syntax SCCP_GTT_PATTERN <pattern_id> <addr_indicator> <pc> <ssn> <global_title> [<gt[...]

  • Página 150

    150 7 Configuration Command R eference • <address_id> A unique ID identifying the address. • < addr_indicator > The address indicator octets. • < pc > The point code. This is ignored if bit 0 of < addr_indicator > is not set. • < ssn > The subsystem number . This is ignored if bit 1 of < addr_indicator > [...]

  • Página 151

    151 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 < gtai_replacement > parameter of the associated SCCP_GTT_ADDRES S command. The mask can contain the following: • < primary_address_id > Identifies the SCCP_GT T_ADDRESS command to use as the primary translation. • < backup_address_id > Identifies the SCCP_GT T_ADDRESS c[...]

  • Página 152

    152 7 Configuration Command R eference 7.8 DTC Configuration Commands The DT C configuration commands are: • DT C_CONFIG - Configure D TC • DT C_SSR - D TC Sub S ystem Resource 7.8.1 DTC_CONFIG – Configure DTC Synopsis The DT C_CONFIG command supplies the global configuratio n par ameters for the DT C protocol, activating DT C and higher prot[...]

  • Página 153

    153 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • < protocol > Should be set to TCAP , MAP , INAP or IS41 according to the layer of th e protocol stack to which the user application interfaces. Note: There can be at most one LSS for each of MAP , INAP and IS41.[...]

  • Página 154

    154 7 Configuration Command R eference 7.9 TCAP Configuration Commands The TCAP configur ation commands are: • TCA P _ CO N F IG - Configure TCAP • TCA P _ CF G _ DG R P - TCAP Dialog Group Configure • TCAP_TRACE - T CAP T race 7.9.1 TCAP_CONFIG – Configure TCAP Synopsis The TCAP_CONFIG command provides the T CAP operatin g par ameters and,[...]

  • Página 155

    155 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • < addr_format > Defines how TCAP should interpret address informat ion from messages receiv ed from SCCP in order to direct received T CAP primitives to unique SCCP sub-systems (T CAP user a pplications). It should be set to 0, 1, 2, 3 or 4 for the following options: 7.9.2 TCAP_CFG_[...]

  • Página 156

    156 7 Configuration Command R eference 7.9.3 TCAP_TRACE – TCAP Trace Synopsis The TCAP_TRACE command is used to configure T CAP to send trace messa ges to the trace module whenev er a specific message type is sent or received. See the TCAP Programmer’s Manual for details. Syntax TCAP_TRACE <op_evt_mask> <ip_evt_mask> <non_prim_ma[...]

  • Página 157

    157 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.10 MAP Configuration Commands The MAP configuration commands are: • MAP_CONFIG - Configure MAP • MAP_TRACE - MAP T race 7.10.1 MAP_CONFIG – Configure MAP Synopsis The MAP_CONFIG command provides the MAP operatin g parameters and, if used, must appear after the SCCP_SSR commands in the[...]

  • Página 158

    158 7 Configuration Command R eference 7.11 INAP Configuration Commands The INAP configuration commands are: • INAP_CONFIG - Configure INAP • INAP_FE - INAP Functional Entities • INAP_AC - INAP Application Context • INAP_TRACE - INAP T race 7.11.1 INAP_CONFIG – Configure INAP Synopsis The INAP_CONFIG command provides the INAP operating pa[...]

  • Página 159

    159 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 7.11.3 INAP_AC – INAP Application Context Synopsis This command is used to configur e the INAP Application Context (AC) records for use. These control the application context negotiation that the module co nducts during dialog establishment. The supported application contexts must be indivi[...]

  • Página 160

    160 7 Configuration Command R eference 7.12 IS41 Configuration Commands The IS41 configuration commands are: • IS41_TRACE - IS41 T race 7.12.1 IS41_TRACE – IS41 Trace Synopsis The IS41_TRACE command is used to configure IS41 to send trace messa ges to the tr ace module whenever a specific message type is sent or received. See the IS41 Programme[...]

  • Página 161

    161 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Chapter 8: Host Utilities This chapter describes the following host utilities that can be used with Dialogic ® DSI SS7MD Boards: • s7_log • s7_play • gctload • tim • tick • s7_mgt • ssdm • tempmon[...]

  • Página 162

    162 8 Host Utilities 8.1 s7_log Description The s7_log utility is a console application program that recei v es messages and displays them as text on the host console. Maintenance and status events are interp reted as text; other messag es are typically display ed in hexadecimal format. The s7_log utility can optionally print the date and time of w[...]

  • Página 163

    163 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 • -f<filename> Optionally specifies a file to which all screen output is written. If the sp ecified file does not exist, it is created. If the specified file already exists, it is overw ritten. The data is stored in the file in ASCII format. • -t[t|d] Specifies the format of timesta[...]

  • Página 164

    164 8 Host Utilities Messages that are not interprete d as text are display ed in hexadecimal format as follows: M t<type> i<id> f<src> d<dst> s<status> e<err_info> p<param> Each field contains the value of the correspon ding message field in hexadecimal format.[...]

  • Página 165

    165 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.2 s7_play Description The s7_play utility is a console application that reads commands from as ASCII text file then executes the commands. Each command can specify either: • a message to be sent to a destination process • a delay to apply before the next command is executed Syntax s7_pl[...]

  • Página 166

    166 8 Host Utilities Each field identifier is optional and ca uses the corresponding message field to be set to zero if not present. All values are entered in hexa decimal format. F or example: M-tc701-i0000-f1d-d23-s00-p0000ffffffff The following command file sends a re set circuit group message to the first ISUP group, w aits for 5 seconds, then [...]

  • Página 167

    167 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.3 gctload Description gctload is a task that initializes the host system environment and starts up all other processes (such as ssd ), deriving the process and message queue configuration from a text file. F or further de tails of the operation of gctload, refer to the Software Environment [...]

  • Página 168

    168 8 Host Utilities • -x T erminate a running system. An active instance of the gctload module, together with any forked binaries, is terminated if a subsequent call of gctload binary is made with the -x parameter . Example T o run gctload with the system.txt file as the configuration file, a cong estion onset v alue of 70, a congestion abatemen[...]

  • Página 169

    169 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 The output above indicates that there are messages sent to a destination module ID 0xef in the IPC system. Under normal operation, the message queues for destination tasks should ei ther be empty or contain a small number of messages. If this is not the case, th is may be due to one of the fo[...]

  • Página 170

    170 8 Host Utilities 8.4 tim Description The tim utility starts the tim process that receives periodic tick notification from tick processes and handles protocol timers for all other processes. Syntax tim_xxx [-v] where xxx is operating system specific, lnx for Linux and sol for Solaris versions. Command Line Options The tim utility supports the fo[...]

  • Página 171

    171 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.5 tick Description The tick utility starts the tick process that sends periodic tick notification to the tim process, which in turn handles protocol timers. Syntax tick_xxx [-v] where xxx is operating system specific, lnx for Linux and sol for Solaris versions. Command Line Options The tick[...]

  • Página 172

    172 8 Host Utilities 8.6 s7_mgt Description The s7_mgt utility performs one-time protocol config uration for all protocol modules, deriving the configuration par ameters from a text file ( config.txt by default). This process is optional. As an alternative, the user may elect to perform protocol configur ation by sending messages directly to th e o[...]

  • Página 173

    173 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.7 ssdm Description SSDM interfaces with the device driver for passing messages to and from the board and controls the downloading software to the board. SSDM can be con figured to handle different modes of addressing for each board within a system. This can be based on ei ther the PCI bus e[...]

  • Página 174

    174 8 Host Utilities -aPX00020,PX00015,PX00015,PX01000 Up to a maximum of 4 addresses can be specified in this list. In the example above, board_id = 0 would be the board with serial number PX00020 irrespective of where in the chassis th is board w as located. Notes: It is not necessary for all boards lis ted in this option to physically exist in a[...]

  • Página 175

    175 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 8.8 tempmon Description The tempmon (T emperature Monitor) ut ility is a standalone console application program that runs in isolation from the GCT environment and periodically reads back the temperature, as recorded by the on-board temperature sensor , of all DSI SS7MD Boards present in the [...]

  • Página 176

    176 8 Host Utilities Example tempmon -ftemplog.txt -t5 Sample Output tempmon: Temperature monitor (C) 2009 Dialogic Corporation ========================================================== 2009-06-02 10:36:00, PX800007, PX800046, PX800057, PX800023 2009-06-02 10:36:00, 35, 36, 34, 35 2009-06-02 10:36:05, 35, 36, 34, 35 2009-06-02 10:36:10, 35, 36, 35[...]

  • Página 177

    177 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Appendix A: Protocol Configur ation Using Discrete Messages This appendix provides guidelines for protoc ol configur ation using individual messages. A.1 Protocol Configuration Us ing Individual Messages As an alternative to using the s7_mgt protocol configuration utilit y (see Section 4.5.1,[...]

  • Página 178

    178 Appendix A Protocol Configur ation Using Discrete Messages 9. Build and send an MTP3 Signaling Link Config uration R equest (MTP_MSG_CNF_LINK) to set up configuration par ameters for the individual link. See the MTP3 Programmer’s Manual for the message definition. W ait for the confirmat ion message and check the status. For each link set in [...]

  • Página 179

    179 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Figure 3. Protocol Configurat ion Message Sequence Diagram (0x3f 17) SSD_MSG_RESET (0x7680 ) (0x3680) SSD_MSG_RST_BOARD (0x7681 ) (0x3681) Board Stat us I ndicati on (0x 06a0) MGT_MSG_CONFIG0 (0x7f 10) (0x3f10) (0x3e34) Repeated per LI U Repeated per Li nk MGT_MSG_L1_CONFI G (0x 7f17 ) LIU_CO[...]

  • Página 180

    180 Appendix A Protocol Configur ation Using Discrete Messages A.2 Monitoring Configuration Using Individual Messages T o configure the board for monitoring it usi ng individual messages, proceed as follows: 1. Build and send an SSD R eset Request to the SSD module. This contains the par ameters to initialize the SSD m od ule . 2. Build and send a [...]

  • Página 181

    181 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 A.3 Q.SAAL Protocol Configuration Using Individual Messages The process to configure the board for Q.SAAL links usi ng individual messages is closely related to section A.1. The full message sequence is shown diagr ammatically in Figure 4 . Note: The format of all of the messages is desc ribe[...]

  • Página 182

    182 Appendix A Protocol Configur ation Using Discrete Messages route. See the MTP3 Programmer's Manual for the me ssage definition. W ait for the confirmation message and check the status. Proceed now with the User Part config ur ation procedure. Once this is comp lete, issue an MTP Link Activation Re quest (MTP_MSG_ACT_SL) for each link in th[...]

  • Página 183

    183 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Appendix B: Thermal guidelines for selecting suitable servers f or use with a Dialogic® DSI SS7MDL4 Network Interface Board The Dialogic ® DSI SS7MDL4 Network Interface Board is a hi gh performance SS7 board capable of delivering over 30,000 MTP2 pack ets per second. T o achieve such le vel[...]

  • Página 184

    184 Appendix B Thermal guide lines for selecting suitable serv ers for use with a Dialo gic® DSI SS7MDL 4 Network In- terface Board[...]

  • Página 185

    185 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Glossary AAL5 A TM Adaptive Layer part 5 AIS Alarm Indication Signal (Blue alarm). A TM Asynchronous T ransfer Mode config.txt A text file used for protocol configuration. ctu An example program that demonstr ates ho w a user application can interface with telephony user parts, such as ISUP a[...]

  • Página 186

    186 Glossary PRBS Pseudo Random Bit Sequence. A technique used for bit error rate testing on T1/E1/J1 trunks. Q.SAAL Link conforming to Q.2140/Q.2110/GR -2878. RAI R emote Alarm Indication (Y ellow alarm). route An MTP3 concept that determines how sign aling is distributed over linksets. A route consists of a destination point code and the lin kset[...]

  • Página 187

    187 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 Index A API_MSG_CNF_IND message 105 API_MSG_RX_INDT message 75 application programs running under Linux 45 ATM monitoring 35 ATM_CONFIG 137 ATM_STREAM 138 , 140 B binary file ss7.dc6 18 binary files for DSI SS7MD Boards 18 board identifiers DSI SS7MD Network Interface Boards, DSI SS7ML4 board[...]

  • Página 188

    188 Index DSI SS7MDL4 boards 13 event indication messages 102 API_MSG_CNF_IND 105 MGT_MSG_NTP_SYNC 108 MGT_MSG_SS7_EVENT 107 MVD_MSG_LIU_STATUS 106 SSD_MSG_STATE_IND 104 example code for building and sending MVD_MSG_SC_LISTEN message 37 execution Linux 45 Solaris 45 F file suffix for DSI SS7MD Board codefile 18 files installed on Linux 19 installed[...]

  • Página 189

    189 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 LIU_MSG_R_CONFIG message 63 LIU_MSG_R_CONTROL message 64 LIU_MSG_R_STATE message 109 LIU_MSG_R_STATS message 110 LIU_SC_DRIVE 122 LIUs switching timeslots 36 log utility 162 logging s7_log 27 M MAP configuration commands MAP_CONFIG 157 MAP_TRACE 157 MAP_CONFIG configuration command 157 MAP_TR[...]

  • Página 190

    190 Index DSI SS7MDL4 boards 14 relm( ) function usage 177 removing Development Package Linux 21 route configuration command 134 RPM creation instructions 21 installation 21 packages 22 using management tools 22 running programs under Linux 45 runtime operations 34 S s7_log utility 162 s7_mgt protocol configuration utility 32 s7_mgt utility 172 s7_[...]

  • Página 191

    191 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 tick 171 tim 170 V verifying device driver loading 20 visual indicators DSI SS7MDL4 boards 13 W warranty information link to 14[...]