Page 2 - Copyright and Legal Notice
2 Copyright and Legal Notice Copyright © 1993-2009 Dialogic Corporation. All Rights Reserved. You may not reproduce this document in whole or in part without permission in writing from Dialogic Corporation at the address provided below. All contents of this document are furnished for informational u...
Page 3 - Contents
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 3 Contents Revision History ........................................................................................................... 6 1 Introduction .............................................................................
Page 5 - Tables
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 5 8 Host Utilities ................................................................................................... 108 8.1 ssds ..................................................................................................
Page 6 - Revision History; Current software and documentation supporting Dialogic
Revision History 6 Revision History Issue Date Description A 12-Apr-00 Initial release for evaluation purposes. Some sections incomplete. B 20-Apr-00 Several minor corrections especially relating to LIU configuration and switching. Addition of installation section for Windows ® NT. 1 30-Jul-01 Secti...
Page 7 - Introduction; Related Documentation
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 7 1 Introduction The range of Dialogic ® DSI SPCI Network Interface Boards includes specialized T1/E1 SS7 signaling boards for use in PCI host computer systems. All boards offer a common interface to the application allowing ap...
Page 8 - Specification; Product Identification; Table 1: SPCI Network Interface Board Capability; SPCI2S; License Buttons; Run Modes
2 Specification 8 2 Specification 2.1 Product Identification The product designations are as follows: • Dialogic ® DSI SPCI4 Network Interface Boards – Four T1/E1 interfaces • Dialogic ® DSI SPCI2S Network Interface Boards – Two T1/E1 interfaces and two serial interfaces Throughout this manual the t...
Page 9 - Run Modes supported; Table 3: Protocol Dimensioning; Capacity
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 9 Table 2: Relationship between License Button Codes, Run Modes and Protocol Modules Bu tt o n Co de Item M a rk et N a m e De s c ri pt io n M a x imu m N u m b e r o f S S 7 Link s Run Modes supported MTP 2 MTP 3 IS UP -S IS ...
Page 10 - Installation
3 Installation 10 3 Installation 3.1 Introduction This Programmer's Manual covers the installation and use of the software contained in the following distributions: • Development Package for Windows ® • Development Package for Linux • Development Package for Solaris • User Part Development Package •...
Page 11 - Hardware configuration; Board Option Switch / Link Settings; Geographic Addressing; Software Installation for Windows; The Development Package for Windows; Installing Development Package for Windows; driver is correctly loaded.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 11 3.2 Hardware configuration 3.2.1 Board Option Switch / Link Settings The DSI SPCI Boards contain some switches and links used to establish optional settings at the time of installation in a host. These must be set as follows...
Page 12 - Table 4: Files Installed on a System Running Windows; Name; installing the package.; Starting the Windows; Select the Control Panel (Start
3 Installation 12 Table 4: Files Installed on a System Running Windows ® Name Description gctlib.lib Library to be linked with user's application (Microsoft*). gctlibb.lib Library to be linked with user's application (Borland*). INC Sub-directory containing include files. system.txt Example system c...
Page 13 - Net start Septel; Clearing Windows
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 13 Net start Septel After rebooting the interface will be displayed as expected. 4) Right click on the "Septel" driver and select "Properties" and then select the "Driver" tab. 5) The driver can be start...
Page 14 - Removing Development Package for Windows; Software Installation for Linux; Installing Development Package for Linux
3 Installation 14 3.3.4 Removing Development Package for Windows ® Prior to installing a new version of the Development Package for Windows ® , the previous package must be removed as follows. This procedure requires a user with Administrator privilege. 1) Select the Control Panel (Start Æ Settings ...
Page 15 - Table 5: Files Installed on a System Running Linux; Device Drivers from Source Code; clean
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 15 Table 5: Files Installed on a System Running Linux Name Description gctlib.lib Library to be linked with user's application. system.txt Example system configuration file. config.txt Example protocol configuration file. gctlo...
Page 16 - remove; Verifying Device Driver Loading; Software Installation for Solaris; Installing the Development Package for Solaris
3 Installation 16 This warning can be safely ignored. For compatibility with the pre-built drivers the existing name format is retained for Linux 2.4 drivers e.g., sptcpi-2.4.18-14smp.o . However, this name format causes problems under Linux Kernel version 2.6; therefore, all Linux 2.6 drivers are n...
Page 17 - Installation of DKseptel was successful.; Table 6: Files Installed on a System Running Solaris; Solaris 9 - Interface Name Checking; To use the package under Solaris 9, interface name checking; Solaris 10 - Additional Commands; can impact the system performance.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 17 On successful completion of the installation procedure, the following message is displayed, and the user needs to reboot the system. Installation of DKseptel was successful. The following files (or similar) are transferred i...
Page 18 - The system has to be rebooted to force the change to take effect.; Removing the Development Package for Solaris; and the user should reboot the system:
3 Installation 18 To enable this functionality the following line must be added to the /etc/system file: set sptpci:spt_claimint=1 The system has to be rebooted to force the change to take effect. 3.5.5 Removing the Development Package for Solaris The Development Package for Solaris is removed using...
Page 19 - Configuration and Operation; Overview; the flexibility of the protocol stack,; System Structure; Table 7: Typical Telephony Systems Configurations; Small System; Number of boards
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 19 4 Configuration and Operation 4.1 Overview Prior to performing software configuration, the user should gain an appreciation of: • the flexibility of the protocol stack, • the run-time options that exist, • the mechanisms use...
Page 20 - ISUP; ssds; Software Environment; Table 8: Host Processes and Utilities
4 Configuration and Operation 20 The following abbreviations are used in the table: MTP2 Message Transfer Part – Level 2 MTP3 Message Transfer Part – Level 3 ISUP ISDN User Part TUP Telephony User Part In all cases, the process called ssds ( S S7 S oftware D river) must be run on the host computer. ...
Page 21 - System Configuration; System Configuration File Syntax
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 21 4.2 System Configuration System configuration is handled by the program gctload , which reads the system configuration data from a file called system.txt. This file must be edited to reflect the requirements of your system, ...
Page 22 - An example; Generating a System Configuration File; ) and details any operating system specific differences in
4 Configuration and Operation 22 The full syntax of each command is listed in the Software Environment Programmer’s Manual. An example system.txt file is shown below: * * Example system.txt for the Development Package for Windows®. * * Edit this file to reflect your configuration. * * Essential modu...
Page 23 - These REDIRECT commands are always required:
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 23 LOCAL 0xcf * s7_mgt - Management/config task LOCAL 0x2d * upe - Example user part task LOCAL 0x3d * s7_log - Prints messages to screen/file After the LOCAL declarations, REDIRECT commands are added for modules that run on th...
Page 24 - Protocol Configuration; Protocol; Protocol Configuration using the s7_mgt utility; Board Information Diagnostics; Protocol Configuration Using Individual Messages
4 Configuration and Operation 24 4.3 Protocol Configuration The Development Package contains a protocol configuration utility, s7_mgt which performs initialization of all the software modules running on the signaling board. It reads the protocol configuration data from a text file called config.txt ...
Page 26 - board hardware parameters is generated in this format following; Table 9: Board Diagnostics – Hardware Parameters; Parameter
4 Configuration and Operation 26 4.4 Board Information Diagnostics To assist in diagnosis of configuration problems and reporting hardware details when encountering problems, a diagnostic display feature is available in s7_mgt. When s7_mgt is run with the –d command line option, a diagnostic display...
Page 27 - Watchdog Timer; Using the CT bus
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 27 4.5 Geographic Addressing Geographic Addressing allows the logical position of a board (or board_id) in a system to remain the same irrespective of the addition or removal of other boards on the PCI bus. Two address modes ar...
Page 28 - Switching Model
4 Configuration and Operation 28 4.7.1 Switching Model The basic switching model assumes that at system initialization all incoming T1/E1 timeslots and all resource board output timeslots are connected up to channels on the CT bus and that these connections are never changed. This has the advantage ...
Page 29 - Dynamic Operation; Program Execution; timeslot; Example Code - Building and Sending SC_LISTEN
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 29 LIU_SC_DRIVE 0 0 512 0xfffefffe * 30 E1 voice ccts on ts 1..15 & 17..31 LIU_SC_DRIVE 0 1 542 0xfffefffe * 30 E1 voice ccts on ts 1..15 & 17..31 LIU_SC_DRIVE 0 2 572 0xfffefffe * 30 E1 voice ccts on ts 1..15 & 17....
Page 32 - Program Execution under Windows; gctload
5 Program Execution 32 5 Program Execution This chapter describes how to start the software running. It assumes that the software has already been installed and the configuration files system.txt and config.txt have been modified accordingly. Refer to previous sections if unsure. There are three mai...
Page 33 - Program Execution under Linux; mtpsl act 0 0; gctload –x
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 33 5.2 Program Execution under Linux Ensure the device driver has been installed and the system configuration file ( system.txt ) has been modified according to the system requirements to select the correct protocols etc. Ensur...
Page 34 - Program Execution under Solaris; Developing a User Application
5 Program Execution 34 5.3 Program Execution under Solaris Ensure the device driver has been installed and the system configuration file ( system.txt ) has been modified according to the system requirements to select the correct protocols etc. Ensure the code file has been copied to the directory co...
Page 35 - yourself with the example programs and how they are built.; upe; exchanging messages with the MTP3 module. It loops back any MTP-; mtpsl; is an example of how to send messages to MTP3 to activate and; ctu
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 35 gctlib.lib (Windows® using Microsoft compiler) gctlibb.lib (Windows® using Borland compiler) gctlib.lib (Linux) gctlib.lib (Solaris) Some simple example programs are supplied to illustrate the techniques for interfacing to t...
Page 36 - Message Reference; Software Environment Programmer's Manual; General Configuration Messages
6 Message Reference 36 6 Message Reference 6.1 Overview This section describes the individual messages that may be sent to and received from the Dialogic ® DSI SPCI Network Interface Board. Some messages are sent by the user's application software whilst others are sent by utility programs such as t...
Page 37 - MTP Interface Messages; documented in the MTP Interface messages section.; Event Indication Messages; asynchronously by different modules within the stack.; Message Summary Table; Table 10: Message Summary; Mnemonic
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 37 6.1.3 MTP Interface Messages MTP 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 (e.g., ISUP or ...
Page 39 - SSD Reset Request; When using s7_mgt, this message is generated by s7_mgt and must not be; module and set up its run-time parameters.; Parameter Description:
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 39 6.2 General Configuration Messages 6.2.1 SSD Reset Request Synopsis: Message sent to SSD once at initialization to set up run-time options. Note: When using s7_mgt, this message is generated by s7_mgt and must not be generat...
Page 40 - Status Response; On error, the following value can be found in the status message; Board Reset Request
6 Message Reference 40 num_boards The maximum number of boards that ssd is required to manage. This must not exceed 16. Status Response The confirmation message (if requested) indicates success by status of zero. On error, the following value can be found in the status message confirmation. Value Mn...
Page 41 - operating software for the board.; Board Status Indication; download operation or failure during the procedure.; The type of board to be reset. This must be set to 2 for DSI SPCI Boards.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 41 Description: This message is used during initialization (or re-configuration) by the application to reset a board and download the code file that contains the operating software for the board. The download operation is super...
Page 42 - No status values indicating errors are defined.; Synopsis; sequence or on detection of a board status event.; Format
6 Message Reference 42 Run Mode Value Run Mode Mnemonic Protocols selected to run on the board 1 DTI Digital Trunk Interface only, no protocol software. This mode does NOT require the use of a software license button. 2 MTP2 MTP2 protocol only. 3 MTP MTP3 plus MTP2 protocols. 25 ISUP-S ISUP, small v...
Page 43 - Description; Board Configuration Request; provide protocol configuration parameters.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 43 Description Event Type This message is used to convey the status of a board reset operation (success of failure) to the user. The status is indicated in the status field of the message header. The following table shows the p...
Page 44 - PARAMETER AREA; check the status for success.
6 Message Reference 44 PARAMETER AREA 8 2 max_sif_len 10 2 l3_flags 12 4 pc 16 2 ssf 18 2 up_enable 20 2 link0_flags 22 2 link0_slc 24 4 link0_adj_pc 28 2 link0_stream 30 2 link0_timeslot 32 2 link1_flags 34 2 link1_slc 36 4 link1_adj_pc 40 2 link1_stream 42 2 link1_timeslot 44 2 link2_flags 46 2 li...
Page 45 - CT bus clocking mode; Primary Master, A Channel; Secondary Master, B Channel; Slave, initially A Channel
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 45 If the board is not licensed to run the requested software configuration, status value of 0xfe is returned. Parameter Description: flags - Global flags Bit 0 is set to 1 to indicate that the user does not wish to use signali...
Page 47 - Data Rate; Serial Port
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 47 up_enable - User Part Enable A 16 bit mask used to enable or disable reception of messages on a per user part basis. If bit N is set to 1, then messages for user part N are received by the signaling point. For example, to en...
Page 48 - Value
6 Message Reference 48 Bit 15 is set to 1 to disable the link, or zero to enable the link. All other bits are reserved for future use and must be set to zero. linkn_slc - Signaling link code The signaling link code for the link, which must be in the range 0 to 15. The signaling link code must be agr...
Page 49 - General Module Identification Message; of the code file running on a live system.; Major revision identifier for the object being queried.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 49 6.2.5 General Module Identification Message Synopsis: Message used to request the module type and software revision number. Message Format: MESSAGE HEADER Field Name Meaning Type GEN_MSG_MOD_IDENT (0x6111) Id 0 Src Sending m...
Page 50 - text; Read Board Info Request Message; DSI SS7 Boards, but only the parameters relevant to the
6 Message Reference 50 text Null terminated string giving textual module identity (e.g., "SS7.DC3"). 6.2.6 Read Board Info Request Message Synopsis Message used to request basic board information. This message may be sent to several Dialogic ® DSI SS7 Boards, but only the parameters relevant...
Page 52 - The DSI SPCI Board hardware revision number.; swa; The switch should be set to 8.; swb; appears when the -o3 feature of ssds is used.; esn
6 Message Reference 52 board_rev The DSI SPCI Board hardware revision number. swa The setting of the board's rotary switch labeled "Boot". Note: The switch should be set to 8. swb Geographic addressing switch setting, that is, the address at which the board appears when the -o3 feature of ss...
Page 53 - Hardware Control Messages; LIU Configuration Request
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 53 6.3 Hardware Control Messages 6.3.1 LIU Configuration Request Synopsis: Message sent by the application to establish the operating mode for a Line Interface Unit (LIU). Note: When using s7_mgt, this message is generated by s...
Page 54 - The line coding technique taken from the following table:; The frame format taken from the following table:
6 Message Reference 54 Description: This message is sent to the DSI SPCI Board to configure the operating mode a line interface unit. All configuration parameters must be supplied in the message (it is not possible to modify individual operating parameters in isolation). On receipt of the message th...
Page 55 - fixed values must be used.; faw; x9f for E1 operation and set to zero for T1.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 55 frame_format Description 1 E1 double frame (E1 only). 2 E1 CRC4 multiframe (E1 only). 4 D3/D4 (Yellow alarm = bit 2 in each channel) (T1 only). 7 ESF (Yellow alarm in data link channel) (T1 only). crc_mode The CRC mode taken...
Page 57 - LIU Control Request; from the following table:
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 57 6.3.2 LIU Control Request Synopsis: Message sent by the application to dynamically control operation for a Line Interface Unit (LIU). Allows setting of outgoing alarms and diagnostic loopbacks. Message Format: MESSAGE HEADER...
Page 58 - The diagnostic loop back mode taken from the following table:
6 Message Reference 58 ais_gen Description 0 Do not change AIS / Blue alarm generation mode. 1 Disabled - do not generate AIS / Blue alarm. 2 Enabled - generate AIS / Blue alarm. rai_gen The mode used to generate the Remote Alarm Indication (Yellow Alarm) taken from the following table: rai_gen Desc...
Page 59 - LIU Read Configuration Request; This message is sent to the DSI SPCI Board to read back the current
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 59 6.3.3 LIU Read Configuration Request Synopsis: Message sent by the application to read back the current LIU configuration from the DSI SPCI Board. Message Format: MESSAGE HEADER Field Name Meaning type LIU_MSG_R_CONFIG (0x5e...
Page 60 - LIU Read Control Request; from the DSI SPCI Board.
6 Message Reference 60 Value Mnemonic Description 0x01 None Invalid framer ID. 0x02 None Invalid message length. 0x03 None Control parameters are not consistent with the type of device being controlled or with each other. 6.3.4 LIU Read Control Request Synopsis: Message sent by the application to re...
Page 61 - LIU State Request; area of the message.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 61 Status Response The confirmation message (if requested) indicates success by status of zero. On error, the following status value can be found in the confirmation message. Value Mnemonic Description 0x01 None Invalid framer ...
Page 62 - The current state of the LIU from the following table:; LIU CT bus Initialization Request
6 Message Reference 62 Parameter Description: state The current state of the LIU from the following table: State Description 0 OK 1 PCM Loss 2 AIS 3 Sync Loss 4 Remote Alarm Status Response The confirmation message (if requested) indicates success by status of zero. On error, the following status va...
Page 63 - corresponding bit is set in
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 63 Message Format: MESSAGE HEADER Field Name Meaning type MVD_MSG_SC_DRIVE_LIU (0x7e18) id 0 src Sending Module ID dst MVD_TASK_ID (0x10) rsp_req used to request a confirmation hclass 0 status Status Response (if confirmation r...
Page 64 - mode
6 Message Reference 64 Timeslots containing SS7 signaling processed by the signaling processor on the DSI SPCI Board should not be included in the timeslot mask. Usually, the mask should be set to include all bearer (voice) timeslots but no signaling timeslots. Bit 0 (corresponding to timeslot 0 on ...
Page 65 - CT bus Listen Request
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 65 6.3.7 CT bus Listen Request Synopsis: Message sent to the DSI SPCI Board to establish a connection from the CT bus to an outgoing timeslot on an T1/E1 Line Interface Unit (LIU). Message Format: MESSAGE HEADER Field Name Mean...
Page 66 - For the SPCI2S, valid values for the LIU identifiers are 2 and 3.; interface and 1 to 24 for a T1 interface.
6 Message Reference 66 Parameter Description: liu_id The identifier of the T1/E1 Line Interface Unit in the range 0 to one less than the number of LIUs fitted. This parameter can also be set to the special value 0x83 to select the signaling processor instead of an LIU. In this case, timeslots 0 ... ...
Page 67 - Fixed Data Output Request; the number of LIUs fitted.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 67 6.3.8 Fixed Data Output Request Synopsis: Message sent to the DSI SPCI Board in order to generate a fixed pattern on a specific T1/E1 Line Interface Unit timeslot. Message Format: MESSAGE HEADER Field Name Meaning type MVD_M...
Page 68 - is transmitted. The valid range for; is 1 to 31 for an E1 interface and; pattern; Reset Switch Request; board configuration.
6 Message Reference 68 timeslot The timeslot number on the T1/E1 line interface unit on which the fixed data is transmitted. The valid range for timeslot is 1 to 31 for an E1 interface and 1 to 24 for a T1 interface. pattern The value of the fixed data to be generated. The value must be in the range...
Page 69 - CT bus Connect Request
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 69 Description: This message is sent to the DSI SPCI Board to reset the state of the digital cross connect switch in accordance with the configuration set using the DSI SPCI Board configuration message. All CT bus streams are t...
Page 71 - local stream
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 71 Mode Required Parameters local st local ts source st source ts dest st dest ts pattern 1 * * * * 2 * * * * 3 * * * * * * 4 * * 5 * * 6 * * 10 * * * 11 * * * * 12 * * * * If a parameter is not required, it must be set to zero...
Page 72 - source stream
6 Message Reference 72 mode = 2 : Make a simplex connection from a timeslot on the local bus to a timeslot on the CT bus. Using parameters local_stream, local_slot, dest_stream and dest_slot, to specify the local and CT bus timeslots respectively. mode = 3 : Make a duplex connection between a local ...
Page 73 - The
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 73 dest_stream The destination stream references which of the CT bus streams is used as a destination for the data. The parameter takes values in the range 0…31. dest_slot The destination slot references the CT bus timeslot to ...
Page 74 - Configure Clock Request; the local and bus reference clocks.
6 Message Reference 74 6.3.11 Configure Clock Request Synopsis: Message sent to a DSI SPCI Board to configure the clocking mode for the board. Message Format: MESSAGE HEADER Field Name Meaning type MVD_MSG_CNFCLOCK (0x7e20) id 0 src Sending Module ID dst MVD_TASK_ID rsp_req used to request a confirm...
Page 75 - If the DSI SPCI Board is configured to be Slave to the CT bus, then it
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 75 Value Bus speed 0 No change 2 4.096 MHz (Reserved for future use) 3 8.192 MHz clk_mode This parameter determines the clocking mode for the DSI SPCI Board, the permissible values are as follows: Value Clock Mode 0 No change 1...
Page 76 - automatically switches to use it as the clock reference.; then no signal is driven onto the bus.
6 Message Reference 76 The PLL clock is used as the reference when acting as CT bus Primary Master. If the clock is to be recovered from one of the line interfaces then the highest-priority in sync line interface is used as the reference. Each line interface is assigned a priority: by default liu_id...
Page 77 - Configure Clock Priority Request; mode, based on the last valid clock that was recovered.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 77 6.3.12 Configure Clock Priority Request Synopsis: Message sent to a DSI SPCI Board to configure the clock recovery priority order. Message Format: MESSAGE HEADER Field Name Meaning type MVD_MSG_CLOCK_PRI (0x7e21) id 0 src Se...
Page 80 - s7_mgt Completion Status Indication
6 Message Reference 80 Parameter Description: Board Status Value Mnemonic Description 0x60 SSDSI_RESET Processor successfully reset. 0x62 SSDSI_FAILURE Failure to reset board. 0x64 SSDSI_BRD_RMVD Board removed (hot swap only). 0x65 SSDSI_BRD_INS Board inserted (hot swap only). 0x66 SSDSI_LIC_FAIL Li...
Page 81 - command line option specifying the module_id of the; Notification Module; to which the message is sent. For example:; The result of initial configuration coded as follows:; Clock Event Indication
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 81 Description: This message is issued by s7_mgt on completion of the initial configuration sequence and indicates either success (status=zero) or an error condition that occurred during configuration. The message is only issue...
Page 83 - LIU Status Indication; Message issued by the board to notify of changes of LIU status.; len; The status field in the message header is coded as follows:
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 83 6.4.4 LIU Status Indication Synopsis: Message issued by the board to notify of changes of LIU status. Message Format: MESSAGE HEADER Field Name Meaning type MVD_MSG_LIU_STATUS (0x0e01) id liu_id src MVD_TASK_ID dst MGMT_TASK...
Page 84 - Error Indication; occurring within the protocol software.
6 Message Reference 84 Value Mnemonic State 10 LIUS_SYNC_LOSS Frame Sync Loss 11 LIUS_IN_SYNC Frame Sync OK 12 LIUS_AIS AIS Detected 13 LIUS_AIS_CLRD AIS Cleared 14 LIUS_REM_ALARM Remote Alarm 15 LIUS_REM_ALM_CLRD Remote Alarm Cleared 20 LIUS_PCM_LOSS PCM Loss 21 LIUS_PCM_OK PCM Restored 22 LIUS_FRA...
Page 85 - The Error Code
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 85 Parameter Description: Error Code The Error Code is coded as shown in the following table: Value Mnemonic ID Description 0x31 S7E_RESET_ERR MTP2 Failed to initialize. 0x33 S7E_POOL_EMPTY l2_llid No free buffers in MTP2 trans...
Page 86 - MTP2 Level 2 State Indication; by the user parts to determine destination accessibility.; just been entered. It is coded as follows:
6 Message Reference 86 6.4.6 MTP2 Level 2 State Indication Synopsis: Indication issued by the board every time the level 2 link state control state machine changes state. Message Format: MESSAGE HEADER Field Name Meaning type MGT_MSG_SS7_STATE (0x0201) id llid (Level 2 logical link id - 0 ... 3) src...
Page 87 - MTP2 Q.752 Event Indication; The Event Code
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 87 6.4.7 MTP2 Q.752 Event Indication Synopsis: Message issued by MTP2 to advise management of protocol events in accordance with ITU-T Q.752. Message Format: MESSAGE HEADER Field Name Meaning type MGT_MSG_SS7_EVENT (0x0202) id ...
Page 89 - MTP3 Q.752 Event Indication; given in the following table:; link
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 89 6.4.8 MTP3 Q.752 Event Indication Synopsis: Message issued by MTP3 to notify management of various protocol events in accordance with ITU-T Q.752. Message Format: MESSAGE HEADER Field Name Meaning type MGT_MSG_MTP_EVENT (0x0...
Page 91 - CONFIGURATION COMMAND Reference; Physical Interface Parameters
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 91 7 CONFIGURATION COMMAND Reference This chapter describes the commands and parameters used in the protocol configuration file config.txt. These are used by the s7_mgt utility to perform single-shot configuration of the protoc...
Page 92 - CT Bus Clocking Mode; Primary Master, Clock set A; Secondary Master, Clock set B; Slave, initially using Clock set A; causes the board to drive the CT_NETREF1 clocks on the CT bus when
7 CONFIGURATION COMMAND Reference 92 Bit 7 Bit 6 CT Bus Clocking Mode 0 0 The CT bus interface is disabled - In this mode, the board is electrically isolated from the other boards using the CT bus. The CT bus connection commands may still be used, but the connections made are only visible to this bo...
Page 93 - Protocols selected to Run on the Board
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 93 run_mode Protocols selected to Run on the Board DTI Digital Trunk Interface only, no protocol software. This mode does NOT require the use of a software license button). MTP2 MTP2 protocol only. MTP MTP3 plus MTP2 protocols....
Page 95 - number of boards supported.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 95 7.1.3 LIU_SC_DRIVE Command Syntax: LIU_SC_DRIVE <board_id> <liu_id> <sc_channel> <ts_mask> {<mode>} Example: LIU_SC_DRIVE 0 0 512 0xfffefffe This command is used during initialization to set up ...
Page 96 - result in a number of CT bus channels being not used.; SCBUS_LISTEN Command
7 CONFIGURATION COMMAND Reference 96 <mode> This parameter allows the user to select how the CT bus channels are allocated. Usually (mode=1) the first timeslot connected to the CT bus is connected to sc_channel and each subsequent timeslot that is selected is connected to the next CT bus chann...
Page 97 - MTP Parameters; MTP Global Configuration; Point Code
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 97 7.2 MTP Parameters 7.2.1 MTP Global Configuration Syntax: MTP_CONFIG <reserved1> <reserved2> <options> Example: MTP_CONFIG 0 0 0x00040f00 The global configuration parameters for the Message Transfer Part (M...
Page 98 - MTP Link Set
7 CONFIGURATION COMMAND Reference 98 Bit 21 is set to 1 for use in Japanese networks; otherwise it must be set to zero. All other bits are reserved for future use and must be set to zero. Note: For ANSI operation bits 8, 9, 10, 11, and 18 must all be set to 1. 7.2.2 MTP Link Set Syntax: MTP_LINKSET ...
Page 99 - than the total number of signaling links supported.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 99 <link_id> The link’s unique logical link identity. It must be in the range 0 to one less than the total number of signaling links supported. <linkset_id> The logical identity of the link set to which the link bel...
Page 100 - Blink
7 CONFIGURATION COMMAND Reference 100 Bit 2 is set to 1 to cause a signaling link test (in accordance with ITU-T Q.707 / ANSI T1.111.7) to be carried out every 30 seconds. Note that this bit is ignored unless bit 1 is also set to 1. Bit 8 is used to select the MTP2 error correction mode. It is set t...
Page 102 - MTP User Part; The service indicator.; ISUP Parameters; Global ISUP Configuration; The global configuration parameters for the ISUP module.
7 CONFIGURATION COMMAND Reference 102 7.2.5 MTP User Part Syntax: MTP_USER_PART <si> <module_id> Example: MTP_USER_PART 0x0a 0x2d Configuration of a local user part module (other than a user part which has its own config command in config.txt). <si> The service indicator. <modul...
Page 103 - to the maximum number of circuit groups supported.; ISUP Circuit Group Configuration; all the circuits on a single E1 or T1 interface.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 103 <num_grps> The maximum number of ISUP circuit groups that the user intends to use. This must not exceed the maximum number of circuit groups supported otherwise module configuration will fail. Typically <num_grps&g...
Page 104 - circuit group. Bit zero must always be set as it represents the
7 CONFIGURATION COMMAND Reference 104 <cic_mask> A 32 bit mask with bits set to indicate which circuits are to be allocated to the circuit group. Bit zero must always be set as it represents the base_cic/base_cid. Subsequent bits represent the subsequent circuits. Note that ANSI circuit groups...
Page 105 - TUP Parameters; Global TUP Configuration; The global configuration parameters for the TUP module.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 105 7.4 TUP Parameters 7.4.1 Global TUP Configuration Syntax: TUP_CONFIG <res1> <res2> <user_id> <options> <num_grps> <num_ccts> <partner_id> Example: TUP_CONFIG 0 0 0x2d 0x8541 4 128 T...
Page 106 - TUP Circuit Group Configuration; The configuration parameters for a group of TUP circuits.
7 CONFIGURATION COMMAND Reference 106 7.4.2 TUP Circuit Group Configuration Syntax: TUP_CFG_CCTGRP <gid> <dpc> <base_cic> <base_cid> <cic_mask> <options> <user_inst> <user_id> <opc> <ssf> <variant> <options2> Example: TUP_CFG_CC...
Page 107 - This field is reserved for future use and must be set to zero.
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 107 <ssf> The value to be used in the sub-service field of all TUP messages for this circuit group. <variant> This field is reserved for future use and must be set to zero. <options2> This field is reserved fo...
Page 108 - Host Utilities
8 Host Utilities 108 8 Host Utilities This section describes some of the utilities that can be used with the Dialogic ® DSI SPCI Network Interface Boards. See the software environment Programmer's Manual for details of the gctload , tim , tick , s7_log and s7_play utilities. 8.1 ssds 8.1.1 Descripti...
Page 109 - Protocol Configuration Using; Syntax
Dialogic ® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 109 If using Switch address mode , board_id = 0 would be the board with ADDR switch set to 6, board_id = 1 would be the board with ADDR switch set to 4 and so on. It is not necessary for all boards listed in this parameter to a...
Page 110 - Enable diagnostic tracing.; Example
8 Host Utilities 110 -i<notify module id> The module to which an indication is sent when the configuration is complete. -d Enable diagnostic tracing. 8.2.4 Example To run the s7_mgt utility as module ID 0xdf with the file my_config.txt as its configuration file and notifying the module 0xef on...