Dialogic DSI SPCI Network Interface Boards manual Introduction, Related Documentation

Page 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 Interface Boards. Each low density board contains an embedded signaling processor capable of handling up to 4 SS7 signaling links and runs software which is downloaded onto the board at run time.

The boards provide a suitable hardware platform for running the Dialogic® DSI protocol for realizing Signaling System Number 7 signaling nodes. The boards can be used under any of the following operating systems: Windows® 2000, Windows® XP, Linux and Solaris. Throughout the remainder of this document the term "Windows®" may be used to collectively refer to the Windows® 2000 and the Windows® XP operating systems.

This document is the Dialogic® DSI SPCI Network Interface Boards Programmer’s Manual and it is targeted at system developers who choose to integrate the boards in a host computer and to develop applications that make use of the underlying SS7 protocol stack. The Programmer's Manual includes information on software installation, system configuration, protocol configuration, and operation of the board and SS7 software stack.

The Programmer's Manual should be used in conjunction with the appropriate Installation Guide and Regulatory Notice for the board, the Dialogic® Software Environment Programmer's Manual and the Programmer’s Manuals for the individual protocol modules as detailed in section 1.1.

High Density board ranges SS7HD and SS7MD are not covered by this manual, and users should refer instead to the relevant documentation package.

1.1Related Documentation

64-0393-xx Dialogic® DSI SPCI Network Interface Boards Installation Guide 60-1554-xx Dialogic® DSI SPCI Regulatory Notices

U10SSS - Dialogic® Distributed Signaling Interface Components - Software Environment Programmer's Manual

05-2331-xx - Dialogic® SS7 Protocols MTP2 Programmer’s Manual 05-2471-xx - Dialogic® SS7 Protocols MTP3 Programmer’s Manual U04SSS - Dialogic® SS7 Protocols ISUP Programmer's Manual U09SSS - TUP Programmer’s Manual

U32SSS - Dialogic® DSI Protocol Stacks - Host Licensing User Guide

7

Image 7
Contents March Dialogic DSI Spci Network Interface BoardsCopyright and Legal Notice Contents Message Reference Configuration Command ReferenceHost Utilities 108 TablesRevision History Related Documentation IntroductionLicense Buttons SpecificationProduct Identification CapabilityCapacity Protocol DimensioningIntroduction InstallationInstalling Development Package for Windows Hardware configurationSoftware Installation for Windows Board Option Switch / Link SettingsStarting the Windows Device Driver Files Installed on a System Running WindowsName Description Clearing Windows 2000 Install Wizard Installing Development Package for Linux Software Installation for LinuxRemoving Development Package for Windows Device Drivers from Source Code Files Installed on a System Running LinuxAn example message is Software Installation for SolarisInstalling the Development Package for Solaris Verifying Device Driver LoadingSolaris 9 Interface Name Checking Solaris 10 Additional CommandsNon-serviced interrupts reports Files Installed on a System Running SolarisRemoving the Development Package for Solaris System has to be rebooted to force the change to take effectSystem Structure Configuration and OperationTypical Telephony Systems Configurations OverviewTelephony User Part Following abbreviations are used in the tableHost Processes and Utilities Isdn User PartSystem Configuration File Syntax System ConfigurationGenerating a System Configuration File For Solaris, these Forkprocess commands are mandatory For Linux, these Forkprocess commands are mandatoryProtocol Configuration using the s7mgt utility Protocol ConfigurationProtocol Configuration Using Individual Messages Page Parameter Description Board Information DiagnosticsBoard Diagnostics Hardware Parameters Parameters are as described belowUsing the CT bus Watchdog TimerGeographic Addressing Static Initialization Switching ModelExample Code Building and Sending Sclisten Dynamic OperationMSG Page Program Execution under Windows Program ExecutionTo run the system within the current console, enter To run it in the background enter Program Execution under LinuxDeveloping a User Application Program Execution under SolarisNmake /f ctu.mnt Message Reference General Configuration MessagesHardware Control Messages Message Summary MTP Interface MessagesEvent Indication Messages Message Summary Table0x3e18 SSD Reset Request General Configuration MessagesNumboards Board Reset RequestStatus Response Runmode Parameter Description BoardtypePhyid CodefileFormat Board Status IndicationValue Meaning Board Configuration RequestField Name Meaning Type MGTMSGCONFIG0 0x7F10 Src Description Event TypeMaxsiflen Parameter Description Isolated from the other boards using the CT bus. The CT busMessage Reference Bit Data Rate Value Description Minrev General Module Identification MessageParameter Description Majrev Major revision identifier for the object being queriedText Read Board Info Request MessageValue Mnemonic Meaning Field Name Meaning Type Mgtmsgrbrdinfo 0x6f0d SrcSPCI2S or SPCI4 board Prommajrev BoardrevSwa SwbDst Mvdtaskid Rspreq LIU Configuration RequestField Name Meaning Type Liumsgconfig 0x7e34 Hardware Control MessagesFrameformat LiutypeLinecode Line coding technique taken from the following tableNfaw CrcmodeBuildout FawClearmask RaigenRaigen Description Parameter Description Aisgen LIU Control RequestField Name Meaning Type Liumsgcontrol 0x7e35 Loopmode Diagnostic loop back mode taken from the following tableLoopmode Description LIU Read Configuration Request LIU Read Control Request Offset Size Name State LIU State RequestState Description LIU CT bus Initialization RequestParameter Description State Current state of the LIU from the following tableField Name Meaning Type Mvdmsgscdriveliu 0x7e18 Src Parameter Description LiuidScchannel TsmaskMode Value Mnemonic Description 0xff None Setup failedOffset Size Name Liuid Timeslot Scchannel CT bus Listen RequestMvipinvalidtimeslot TimeslotOffset Size Name Liuid Timeslot Pattern Fixed Data Output RequestPattern Reset Switch RequestCT bus Connect Request Mvdmsgscconnect 0x7e1f Field Name MeaningLocalstream If a parameter is not required, it must be set to zeroLocalslot Sourceslot SourcestreamCT bus speed Source Slot Range Destslot DeststreamParameter Description Busspeed Configure Clock RequestField Name Meaning Type Mvdmsgcnfclock 0x7e20 Src Value Bus speed No change Value Clock ModeClkmode PllclksrcRef1mode Value NETREF1 clock ModeField Name Meaning Type Mvdmsgclockpri 0x7e21 Src Configure Clock Priority RequestParameter Description Liunpri Event Indication Messages Parameter Description Board Status 2 s7mgt Completion Status IndicationField Name Meaning Type Mvdmsgclkind 0x0e23 Src Result of initial configuration coded as followsClock Event Indication Parameter Description Completion StatusParameter Description Event ID Field Name Meaning Type Mvdmsgliustatus 0x0e01 Liuid Src LIU Status IndicationLiustatus Status field in the message header is coded as followsValue Mnemonic State Error IndicationError Code is coded as shown in the following table Parameter Description Error CodeParameter Description Link State 6 MTP2 Level 2 State IndicationParameter Description Event Code 7 MTP2 Q.752 Event IndicationEvent Code is coded as shown in the following table Abatement of signaling link congestion Excessive delay of acknowledgementExcessive error rate Suerm Onset of signaling link congestionOffset Size Name Len Event specific parameters 8 MTP3 Q.752 Event IndicationMtpevajspok Value Mnemonic Paramter Description1 SS7BOARD Command Configuration Command ReferencePhysical Interface Parameters Bit CT Bus Clocking Mode Runmode Protocols selected to Run on the Board Liuconfig CommandFrameformat Frame format taken from the following table Crcmode CRC mode taken from the following tableBoardid Liuscdrive CommandScbuslisten Command Options MTP Global ConfigurationMTP Parameters Reserved1, reserved2MTP Link Set MTP Signaling LinkBlink LinkidLinkref SlcBlink Serial Port MTP RouteDpc NormlsUserpartmask SecondlsIsup Parameters Global Isup ConfigurationMTP User Part Isup Circuit Group Configuration Variant CicmaskUserinst OpcGlobal configuration parameters for the TUP module Global TUP ConfigurationTUP Parameters Configuration parameters for a group of TUP circuits TUP Circuit Group Configuration107 Description Command Line OptionsHost Utilities SsdsS7mgt Kconfig fileMmodule id Inotify module id Example