Dialogic DSI SS7MD - Manuals

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 ATM termin...

7 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 Chapter 1: Introduction Dialogic ® DSI SS7MD Network Interface Boards are specialized T1/E1/J1 SS7 signaling boards suitable for use in PCI Express form factor systems. The boards use the common Dialogic ® DSI software API to the application that en...

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 Form Factor • Software Licenses

10 2 Specification 2.1 Product Identifiers The Dialogic ® DSI SS7MD Network Interface Board product 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 E...

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 physical, low profile PCI Express form factor, which can be installed in x4, x8, or x16 lane slots. The ...

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 d...

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/Red 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, ...

14 2 Specification 2.2.9 Safety, EMC and Telecommunications Specifications Safety, EMC and telecommunications specification information is provided by the following: • Dialogic ® DSI SS7MDL440Q Network Interface Board Regulatory Notices Supplied with each product and provides a full list of the spec...

16 2 Specification The following combinations of link types are available to the user: Note: When using multiple link types on the same board, the run mode indicates to the board the predominant link type. Note: To change the run mode of a board, the board must be reset. Run Mode LSL Links HSL Links...

17 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 Chapter 3: Installation This chapter contains the following topics: • Software Packages • Software Installation for Linux • Software Installation for Solaris (SPARC)

18 3 Installation 3.1 Software Packages This manual describes the installation and use of the following software: • Development Package • User Part Development Package • Binary for Dialogic ® DSI SS7MD Network Interface Boards 3.1.1 Development Package Different variants of the Development Package a...

20 3 Installation The ldconfig utility creates a symbolic link to the GCT library shared object within the install directory. For example: /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 lib...

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: sysc...

22 3 Installation ss7dpk-devel-5.08-1.<ARCH>.rpmss7dpk-debuginfo-5.08-1.<ARCH>.rpmss7dpk-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, including the one for the DSI SS7MD Boar...

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 ssdmchmod +s ssdm Note: The commands should be executed by a user with super-user permissions. 3.3.2...

25 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 Chapter 4: Dialogic® DSI SS7MD Board Configuration and Operation Before attempting software configuration, you should gain an appreciation of the flexibility of the protocol stack, the run-time options that exist and the mechanisms that are used to...

28 4 Dialogic® DSI SS7MD Board Configuration and Operation 4.3 Running Host Binaries With Dialogic ® DSI SS7MD Board The Dialogic ® DSI MTP2 Layer protocol module runs on the board. The other SS7 protocol modules (MTP3, ISUP, TUP, SCCP, TCAP, MAP, INAP, and IS41) must be run on the host machine. Hos...

29 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 4.4 System Configuration System configuration is handled by the gctload program that reads system configuration data from a file called system.txt . System initialization requires: • First, that a pool of message buffers is created for subsequent i...

30 4 Dialogic® DSI SS7MD Board Configuration and Operation 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 ...

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_PROCESS commands are: FORK_PROCESS ./ssdm FORK_PRO...

32 4 Dialogic® DSI SS7MD Board Configuration and Operation 4.5 Protocol Configuration The Development Package contains the s7_mgt protocol configuration utility that performs initialization of all the software modules running on the signaling board. It reads the protocol configuration data from a te...

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

34 4 Dialogic® DSI SS7MD Board Configuration and Operation 4.6 Monitoring The monitoring option can be used in conjunction with the SS7 Development Package for the appropriate operating system (Linux or Solaris) to realize a high-performance protocol monitor with up to 4 boards, each monitoring a ce...

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 over ATM links. The following is an example config.txt configuration file to support AAL5 Monitoring: ***********************************************************...

36 4 Dialogic® DSI SS7MD Board Configuration and Operation 4.8 Switching Timeslots between LIUs The Dialogic DSI SS7MD Boards support multiple T1/E1/J1 Line Interface Units (LIUs). The onboard signaling processor handles the SS7 signaling timeslots, while the remaining circuits (voice or data bearer...

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. For each T1/E1/J1 Line Interface Unit (LIU), the user should include an LIU_SC_DRIVE command in the config.txt protocol configuration file. T...

38 4 Dialogic® DSI SS7MD Board Configuration and Operation 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 machi...

39 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 4.9 Received Message Timestamping Timestamping of received messages can be enabled for monitored links. This functionality provides a timestamp of the time a message is received by a board. Individual boards maintain time by synchronising with the ...

40 4 Dialogic® DSI SS7MD Board Configuration and Operation 4.10 High Speed Link Operation High Speed Link (HSL) operation is supported in the following mode: • Structured mode, where the data stream is framed as for conventional SS7: — For T1, 8 bits in each of 24 timeslots are available for signall...

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 high performance, densely packed, low profile PCIe board supporting high message rates. In achieving this performance, the board may dis...

43 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 Chapter 5: Program Execution This chapter describes how to start the software and execute programs. It assumes that: • The software has already been installed. Refer to Chapter 3, “Installation” . • The system.txt configuration file has been modifi...

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 depending upon the operating system: 1. Ensure that the device driver is installed and running. 2. Ensure that the...

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 configuration file has been modified in accordance with system requirements to select the correct protocols etc. 2. ...

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 from a Dialogic® DSI SS7MD Board. Some messages are sent by the user's application software, while others are sent by utility programs such ...

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 permitted values and their meaning. • link_source Configure the signaling source...

57 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 Parameters The MGT_MSG_NTP_CONFIG message includes the following parameters: • 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 various hardware devices on the board, including the T1/E1/J1 Line Interface Units (LIUs), the digital cross connect switches and the clocking mode for the board. In a static configuration, these hardw...

61 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 • ais_gen The (initial) mode used to generate the Alarm Indication 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 values and their ...

71 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 6.4 Signaling Interface Messages Signaling interface messages allow signaling links to be activated and deactivated by the user and provide a mechanism for communication between the MTP3 module and the user part module (for example, ISUP, TUP or SC...

73 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 messages may be issued to the MTP2 module to modify timer configuration parameters however; these messages do not affect SS7 operation (that is, the power up sequence is not re-executed, but the parameters are modified). For backwards compatibility...

79 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 • options • num_streams The maximum number of cell streams this module 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 ...

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 ATM_MSG_CONFIG message. • VCI The VCI of the AAL5 stream to be monitored. The VCI value must be viable in the mask specified in the ATM_MSG_CONFI...

91 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 QSAAL_MSG_TIMERS messages may be issued to the Q.SAAL module to modify timer configuration parameters however; these messages do not affect Q.SAAL operation (that is, the power up sequence is not re-executed, but the parameters are modified). • lin...

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 configuration parameters. Otherwise default timer values will be used. • Timer_CC Time between transmission of un-ack'ed BGN, END, ER, RS PDUs • Timer_keep_a...

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.SAAL module. For message definitions refer to Dialogic® SS7 Protocols MTP2 Programmer's Manual. MTP2 Primitive Description NNI Primitive Equivalent API_MSG_RX_IND R...

111 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 — For E1 operating modes, it is the number of errors detected in the frame alignment word. — For T1 interfaces operating in D3/D4 frame format, it is the number of framing bit errors. — For T1 interfaces operating in ESF format, it is the number o...

117 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 Chapter 7: Configuration Command Reference This chapter describes the commands and parameters used in the config.txt protocol configuration file. These commands are used by the s7_mgt protocol configuration utility to perform one time configuratio...

118 7 Configuration Command Reference 7.1 Physical Interface Configuration Commands The physical interface configuration commands are: • SS7_BOARD - 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 ...

122 7 Configuration Command Reference 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 between the Line Interface Units (LIUs) and the cross connect switch. It connects selected incoming voice timeslots from one T1/E1/J1 ...

123 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 7.1.4 SCBUS_LISTEN – Connect Switch Timeslot to LIU Timeslot Synopsis This command establishes a connection from the switch to an outgoing timeslot on the Line Interface Unit (LIU). Note: Dynamic modification of voice paths can only be performed b...

124 7 Configuration Command Reference 7.1.5 STREAM_XCON – Cross Connect Configuration Synopsis The STREAM_XCON command controls the cross connect switch on the signaling boards, enabling the cross-connection of timeslots between two Line Interface Unit (LIU) on each signaling board. The LIUs on a bo...

126 7 Configuration Command Reference 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 configure a signaling link or ATM link to operate in monitoring only mode. The command is differentiated based on the data rate parameter. ...

130 7 Configuration Command Reference set to 0, on detection of RPO, the signaling link is taken 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 Jap...

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_LINKSE...

132 7 Configuration Command Reference 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 <...

134 7 Configuration Command Reference — vpi is the Virtual Path Indicator of the signaling link within the ATM cell stream. — vci is the Virtual Channel Indicator of the signaling link within the ATM cell stream. For restrictions on the choice of VPI-VCI combinations refer to Section 6.5.1, “ATM_MSG...

135 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 — All other bits are reserved for future 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 module, other than a user part which has its own configuration command in the config.t...

136 7 Configuration Command Reference 7.4 ATM Configuration Commands The ATM configuration commands are: • ATM_CONFIG - Configure the ATM Module • ATM_STREAM - Configure ATM Cell Stream • ATM_TIMER - Configure Timers for Q.SAAL Links

137 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 7.4.1 ATM_CONFIG – Configure the ATM Module Synopsis Global configuration of the ATM Module. Syntax ATM_CONFIG <options> <num_streams> Example ATM_CONFIG 0x0000 4 Parameters The ATM_CONFIG command includes the following parameters: • &...

138 7 Configuration Command Reference 7.4.2 ATM_STREAM – Configure ATM Cell Stream Synopsis Configures an ATM Cell Stream. Syntax ATM_STREAM <id> <board_id> <cellstream_id> <liu_id> <options> <ima_frame_len> <max_frame_len> <def_vpi> <def_vci> &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 incoming active connections. This is the VCI that will be used for this connection. Values 0, 3, and 4 are reserved and should not be used. Note: The default ...

140 7 Configuration Command Reference 7.4.3 ATM_TIMER – Configure Timers for Q.SAAL Links Synopsis Override the default timer values for ATM Links. Syntax ATM_TIMER <reserved> <timer_id> <value> Example ATM_TIMER 0 T1 10 Parameters The ATM_TIMER command includes the following param...

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 con...

142 7 Configuration Command Reference 7.5.2 ISUP_CFG_CCTGRP – Configure an ISUP Circuit Group Synopsis The configuration parameters for a group of ISUP circuits. Typically, a group is all the circuits in a single E1, T1, or J1 interface. Syntax ISUP_CFG_CCTGRP <gid> <dpc> <base_cic>...

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...

144 7 Configuration Command Reference 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 parameters for the TUP module. Syntax TUP_CONFIG &...

145 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 7.6.2 TUP_CFG_CCTGRP – Configure a TUP Circuit Group Synopsis The configuration parameters for a group of TUP circuits. Syntax TUP_CFG_CCTGRP <gid> <dpc> <base_cic> <base_cid> <cic_mask> <options> <user_inst&...

146 7 Configuration Command Reference 7.7 SCCP Configuration Commands The SCCP configuration commands are: • SCCP_CONFIG - Configure SCCP • SCCP_SSR - SCCP Sub-System Resource • SCCP_CONC_SSR - SCCP Concerned Sub-System Resource • SCCP_TRACE - SCCP Trace • SCCP_GTT_PATTERN - Define Global Title Patt...

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 parameters for the SCCP. Syntax SCCP_SSR <ssr_id> RSP <remote_spc> <flags> <pc_mask> SCCP_SSR <ssr_id> LSS <...

148 7 Configuration Command Reference 7.7.3 SCCP_CONC_SSR – SCCP Concerned Sub-System Resource Synopsis The SCCP_CONC_SSR command marks the specified sub-system (which was declared by SCCP_SSR) as requiring notification of changes in the accessibility of another sub-system. Notification is given in ...

149 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 7.7.5 SCCP_GTT_PATTERN – Define Global Title Pattern Synopsis The SCCP_GTT_PATTERN command defines a global title pattern to be matched for a global title translation. Syntax SCCP_GTT_PATTERN <pattern_id> <addr_indicator> <pc> &l...

150 7 Configuration Command Reference • <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 ignor...

152 7 Configuration Command Reference 7.8 DTC Configuration Commands The DTC configuration commands are: • DTC_CONFIG - Configure DTC • DTC_SSR - DTC Sub System Resource 7.8.1 DTC_CONFIG – Configure DTC Synopsis The DTC_CONFIG command supplies the global configuration parameters for the DTC protocol...

153 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 • < protocol > Should be set to TCAP, MAP, INAP or IS41 according to the layer of the 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 Reference 7.9 TCAP Configuration Commands The TCAP configuration commands are: • TCAP_CONFIG - Configure TCAP • TCAP_CFG_DGRP - TCAP Dialog Group Configure • TCAP_TRACE - TCAP Trace 7.9.1 TCAP_CONFIG – Configure TCAP Synopsis The TCAP_CONFIG command provides the TCAP oper...

155 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 • < addr_format > Defines how TCAP should interpret address information from messages received from SCCP in order to direct received TCAP primitives to unique SCCP sub-systems (TCAP user applications). It should be set to 0, 1, 2, 3 or 4 for...

156 7 Configuration Command Reference 7.9.3 TCAP_TRACE – TCAP Trace Synopsis The TCAP_TRACE command is used to configure TCAP to send trace messages to the trace module whenever a specific message type is sent or received. See the TCAP Programmer’s Manual for details. Syntax TCAP_TRACE <op_evt_ma...

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 Trace 7.10.1 MAP_CONFIG – Configure MAP Synopsis The MAP_CONFIG command provides the MAP operating parameters and, if used, must app...

158 7 Configuration Command Reference 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 Trace 7.11.1 INAP_CONFIG – Configure INAP Synopsis The INAP_CONFIG ...

159 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 7.11.3 INAP_AC – INAP Application Context Synopsis This command is used to configure the INAP Application Context (AC) records for use. These control the application context negotiation that the module conducts during dialog establishment. The sup...

160 7 Configuration Command Reference 7.12 IS41 Configuration Commands The IS41 configuration commands are: • IS41_TRACE - IS41 Trace 7.12.1 IS41_TRACE – IS41 Trace Synopsis The IS41_TRACE command is used to configure IS41 to send trace messages to the trace module whenever a specific message type i...

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

163 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 • -f<filename> Optionally specifies a file to which all screen output is written. If the specified file does not exist, it is created. If the specified file already exists, it is overwritten. The data is stored in the file in ASCII format. •...

166 8 Host Utilities Each field identifier is optional and causes the corresponding message field to be set to zero if not present. All values are entered in hexadecimal format. For example: M-tc701-i0000-f1d-d23-s00-p0000ffffffff The following command file sends a reset circuit group message to the...

168 8 Host Utilities • -x Terminate 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 To run gctload with the system.txt file as the configuration file, a congesti...

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 either be empty or contain a small number of messages. If this is no...

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. Co...

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 S...

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 this board was located. Notes: It is not necessary for all boards...

175 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 8.8 tempmon Description The tempmon (Temperature Monitor) utility 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 sens...

177 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 Appendix A: Protocol Configuration Using Discrete Messages This appendix provides guidelines for protocol configuration using individual messages. A.1 Protocol Configuration Using Individual Messages As an alternative to using the s7_mgt protocol ...

178 Appendix A Protocol Configuration Using Discrete Messages 9. Build and send an MTP3 Signaling Link Configuration Request (MTP_MSG_CNF_LINK) to set up configuration parameters for the individual link. See the MTP3 Programmer’s Manual for the message definition. Wait for the confirmation message a...

179 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 Figure 3. Protocol Configuration Message Sequence Diagram (0x3f17) SSD_MSG_RESET (0x7680) (0x3680) SSD_MSG_RST_BOARD (0x7681) (0x3681) Board Status Indication (0x06a0) MGT_MSG_CONFIG0 (0x7f10) (0x3f10) (0x3e34) Repeated per LIU Repeated per Link M...

180 Appendix A Protocol Configuration Using Discrete Messages A.2 Monitoring Configuration Using Individual Messages To configure the board for monitoring it using individual messages, proceed as follows: 1. Build and send an SSD Reset Request to the SSD module. This contains the parameters to initi...

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 using individual messages is closely related to section A.1. The full message sequence is shown diagrammatically in Figure 4 . Note: Th...

182 Appendix A Protocol Configuration Using Discrete Messages route. See the MTP3 Programmer's Manual for the message definition. Wait for the confirmation message and check the status. Proceed now with the User Part configuration procedure. Once this is complete, issue an MTP Link Activation Reques...

185 Dialogic ® DSI SS7MD Programmer’s Manual Issue 3 Glossary AAL5 ATM Adaptive Layer part 5 AIS Alarm Indication Signal (Blue alarm). ATM Asynchronous Transfer Mode config.txt A text file used for protocol configuration. ctu An example program that demonstrates how a user application can interface ...

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 SS...