Instruction/ maintenance manual of the product DSI SS7MD Dialogic
Go to page of 191
www.dialogic.com Dialogic ® DSI SS7MD Network Interface Boards Programmer’s Manual.
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.
Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 3 Contents 1 Introduction ............................................................................................................. 7 1.1 Related Information ....................................
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 ...
Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 5 Figures 1 Switch Connections................................................................................................... 36 2 Drop and Insert................................................
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.
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.
8 1 Introduction.
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 - L.
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.
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.
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.
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: — Gree.
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 .
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.
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.
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 Inst.
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.
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.
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.
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.
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.
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 C.
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.
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.
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.
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 .
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.
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.
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.
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 .
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.
33 Dialogic ® DSI SS7MD Programmer’ s Manual Issue 3 * * ISUP parameters: * * Configure ISUP module: * ISUP_CONFIG <reserved> <reserved> <us er_id> <options> <num_grps>.
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 (Li.
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.
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).
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.
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_MO.
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.
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.
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.
42 4 Dialogic® DSI SS7MD Board Configuration and Oper ation.
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” .
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.
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.
46 5 Program Execution.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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).
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.
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.
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.
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.
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 .
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.
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).
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.
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).
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.
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 .
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.
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.
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 .
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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 Inter.
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.
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.
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.
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.
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.
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 .
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 .
126 7 Configuration Command R eference 7.2 Monitor Configuration Commands The monitor configuration command is: • MONITOR_LINK - Configure Link in Monitoring Mode.
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 .
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.
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.
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).
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.
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> .
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.
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.
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.
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.
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.
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> <l.
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.
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.
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.
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.
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.
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.
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.
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 .
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 .
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
176 8 Host Utilities Example tempmon -ftemplog.txt -t5 Sample Output tempmon: Temperature monitor (C) 2009 Dialogic Corporation ========================================================== 2009-06-02 10.
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.
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.
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) Boar.
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.
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 .
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.
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.
184 Appendix B Thermal guide lines for selecting suitable serv ers for use with a Dialo gic® DSI SS7MDL 4 Network In- terface Board.
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.
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.
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.
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 .
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 switchin.
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 manageme.
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.
An important point after buying a device Dialogic DSI SS7MD (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Dialogic DSI SS7MD yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Dialogic DSI SS7MD - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Dialogic DSI SS7MD you will learn all the available features of the product, as well as information on its operation. The information that you get Dialogic DSI SS7MD will certainly help you make a decision on the purchase.
If you already are a holder of Dialogic DSI SS7MD, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Dialogic DSI SS7MD.
However, one of the most important roles played by the user manual is to help in solving problems with Dialogic DSI SS7MD. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Dialogic DSI SS7MD along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
