Summary of the content on the page No. 1
®
Dialogic DSI SPCI Network Interface Boards
Programmer's Manual
March 2009 U03HSP
www.dialogic.com
Summary of the content on the page No. 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 use only and are subject to change without notice and do not represent a commitment on the part of Dialogic Corporation or its subsidiaries (“Dialogic”). Reasonable effort is made to ensure the acc
Summary of the content on the page No. 3
® Dialogic DSI SPCI Network Interface Boards Programmer's Manual Issue 5 Contents Revision History ........................................................................................................... 6 1 Introduction ........................................................................................................ 7 1.1 Related Documentation............................................................................................................ 7 2 Specification ...........
Summary of the content on the page No. 4
Contents 5.4 Developing a User Application ................................................................................................ 34 6 Message Reference ............................................................................................ 36 6.1 Overview ............................................................................................................................. 36 6.1.1 General Configuration Messages ..........................................................
Summary of the content on the page No. 5
® Dialogic DSI SPCI Network Interface Boards Programmer's Manual Issue 5 8 Host Utilities ................................................................................................... 108 8.1 ssds .................................................................................................................................. 108 8.1.1 Description ........................................................................................................ 108 8.1.2 Syntax ...............
Summary of the content on the page No. 6
Revision History 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 Sections detailing support for Windows 2000, Linux and Solaris added. Additional messages to read LIU state, indicate clock events and s7_mgt completion status. ® 2 06-Jan-03 Branding changed to I
Summary of the content on the page No. 7
® Dialogic DSI SPCI Network Interface Boards Programmer's Manual Issue 5 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 applications to be easily ported between hardware architectures. This Programmer’s Manual ® relates to the low density Dialogic DSI SPCI4 Network Interface Boards and ® Dialogic DSI SPCI2S Network
Summary of the content on the page No. 8
2 Specification 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 term "SPCI" is used to refer (individually and/or collectively, depending on context) to either or both such type of boards. 2.2 Capability Table 1: SPCI Network Interface Board Capability Num
Summary of the content on the page No. 9
® Dialogic DSI SPCI Network Interface Boards Programmer's Manual Issue 5 Table 2: Relationship between License Button Codes, Run Modes and Protocol Modules Run Modes supported MM SS7SBPCIMONQ Monitoring 4 √ M3 SS7SBPCIMTPQ MTP 4 √ √ √ T1 SS7SBPCIISTUPSQ ISUP, TUP (Small) 2 √ √ √ √ √ T2 SS7SBPCIISTUPQ ISUP, TUP (Regular) 4 √ √ √ √ √ T4 SS7SBPCIISTUPLQ ISUP, TUP (Large) 4 √ √ √ √ √ 2.3.2 Capacity The figures in the table below indicate the capacity for modul
Summary of the content on the page No. 10
3 Installation 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 ® • Code Files for Dialogic DSI SPCI Network Interface Boards (various protocols). Each Development Package contains the device driver, library functions, and header files for use by an appli
Summary of the content on the page No. 11
® Dialogic DSI SPCI Network Interface Boards Programmer's Manual Issue 5 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: • CT Bus termination links - full details of how to use these links is provided in the relevant board Installation Guide. • BOOT Mode option switch - ensure the switch is set to the default se
Summary of the content on the page No. 12
3 Installation ® 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 configuration file. config.txt Example protocol configuration file. gctload.exe Executables for use as described elsewhere in this ssds.exe manual. s7_mgt.exe s7_log.exe s7_play.exe tick_nt
Summary of the content on the page No. 13
® Dialogic DSI SPCI Network Interface Boards Programmer's Manual Issue 5 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 started immediately by selecting "start" in the "current status" field. Note: To automatically start the driver at system startup, select the "Automatic" option from the "Startup" menu. The system must be re-started for th
Summary of the content on the page No. 14
3 Installation ® 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 Control Panel). 2) Select "Add/Remove Programs". 3) Scroll down the devices and select "SS7 Development Package" and select "Remove". 4) When package removal is confirmed, restart the target mac
Summary of the content on the page No. 15
® Dialogic DSI SPCI Network Interface Boards Programmer's Manual Issue 5 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. gctload.exe Executables for use as described elsewhere in this ssds.exe manual. s7_mgt.exe s7_log.exe s7_play.exe tick_nt.exe tim_nt.exe upe.exe INC Sub-directory containing header files for
Summary of the content on the page No. 16
3 Installation 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 named sptpci26.ko. An install script, named install_spci_cpm.sh, is included in the package. This script installs the device driver, automatically allocates the major device numbers, and creates th
Summary of the content on the page No. 17
® Dialogic DSI SPCI Network Interface Boards Programmer's Manual Issue 5 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 into the /opt/DKseptel directory. Note: Additional files relating to other products in the range are installed at the same time. Table 6: Files Installed on a System Running Solaris Name Descrip
Summary of the content on the page No. 18
3 Installation 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 the package removal utility: pkgrm The Solaris package removal utility (pkgrm) then prompts for further input. On successful completion of the procedure the following me
Summary of the content on the page No. 19
® Dialogic DSI SPCI Network Interface Boards Programmer's Manual Issue 5 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 used to select particular features. This section gives an overview of these aspects. The user should also consult the Software Environment Programmer’s Manual, which describes the basic principle
Summary of the content on the page No. 20
4 Configuration and Operation 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 (SS7 Software Driver) must be run on the host computer. This handles message transfer between the host and the board using the device driver. To define which protocol modules run on the host, edit the text file system.txt. Run the program gctload, whi
