Dialogic DSI SPCI Network Interface Boards MTP Interface Messages, Event Indication Messages

Page 37

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5

6.1.3MTP 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 TUP). In many cases, the user part module is an SS7 Protocol binary so the user does not need to handle the MTP-TRANSFER, MTP-PAUSE, MTP_RESUME & MTP-STATUS primitives as they pass directly between MTP3 and the user part module.

In the case that the user application is implementing the user part functionality, then the MTP primitives are applicable and these are documented in the MTP Interface messages section.

6.1.4Event Indication Messages

Event Indication Messages are the mechanism by which protocol and software error events are reported to the application. These messages are generated asynchronously by different modules within the stack.

6.1.5Message Summary Table

The following table lists, by message type, all the messages described in this manual:

Table 10: Message Summary

Message

Mnemonic

Description

Type

 

 

 

 

 

0x0008

MGT_MSG_EVENT_IND

Error Indication

 

 

 

 

0x0201

MGT_MSG_SS7_STATE

MTP2 Level 2 State Indication

 

 

 

 

0x0202

MGT_MSG_SS7_EVENT

MTP2 Q.752 Event Indication

 

 

 

 

0x0301

MGT_MSG_MTP_EVENT

MTP3 Q.752 Event Indication

 

 

 

 

0x06a0

SSD_MSG_STATE_IND

Board Status Indication

 

 

 

 

0x0e01

MVD_MSG_LIU_STATUS

LIU Status Indication

 

 

 

 

0x0e23

MVD_MSG_CLK_IND

Clock Event Indication

 

 

 

 

0x0f09

API_MSG_CNF_IND

s7_mgt Completion Status Indication

 

 

 

 

0x1e37

 

Confirmation of LIU_MSG_R_CONFIG

 

 

 

 

 

0x1e38

 

Confirmation of LIU_MSG_R_CONTROL

 

 

 

 

 

0x1e39

 

Confirmation of LIU_MSG_R_STATE

 

 

 

 

 

0x3312

 

Confirmation of MTP_MSG_CNF_ROUTE

 

 

 

 

 

0x3680

 

Confirmation of SSD_MSG_RESET

 

 

 

 

 

0x3681

 

Confirmation of SSD_MSG_RST_BOARD

 

 

 

 

 

0x3e00

 

Confirmation of MVD_MSG_RESETSWX

 

 

 

 

 

0x3e15

 

Confirmation of MVD_MSG_SC_FIXDATA

 

 

 

 

 

0x3e17

 

Confirmation of MVD_MSG_SC_LISTEN

 

 

37

Image 37
Contents March Dialogic DSI Spci Network Interface BoardsCopyright and Legal Notice Contents Message Reference Configuration Command ReferenceHost Utilities 108 TablesRevision History Related Documentation IntroductionProduct Identification SpecificationCapability License ButtonsCapacity Protocol DimensioningIntroduction InstallationSoftware Installation for Windows Hardware configurationBoard Option Switch / Link Settings Installing Development Package for WindowsStarting 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 LinuxInstalling the Development Package for Solaris Software Installation for SolarisVerifying Device Driver Loading An example message isNon-serviced interrupts reports Solaris 10 Additional CommandsFiles Installed on a System Running Solaris Solaris 9 Interface Name CheckingRemoving the Development Package for Solaris System has to be rebooted to force the change to take effectTypical Telephony Systems Configurations Configuration and OperationOverview System StructureHost Processes and Utilities Following abbreviations are used in the tableIsdn User Part Telephony 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 Board Diagnostics Hardware Parameters Board Information DiagnosticsParameters are as described below Parameter DescriptionUsing 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 Linux Developing a User Application Program Execution under SolarisNmake /f ctu.mnt Message Reference General Configuration MessagesHardware Control Messages Event Indication Messages MTP Interface MessagesMessage Summary Table Message Summary0x3e18 SSD Reset Request General Configuration MessagesNumboards Board Reset RequestStatus Response Phyid Parameter Description BoardtypeCodefile RunmodeFormat Board Status IndicationField Name Meaning Type MGTMSGCONFIG0 0x7F10 Src Board Configuration RequestDescription Event Type Value MeaningMaxsiflen Parameter Description Isolated from the other boards using the CT bus. The CT busMessage Reference Bit Data Rate Value Description Parameter Description Majrev General Module Identification MessageMajor revision identifier for the object being queried MinrevText Read Board Info Request MessageValue Mnemonic Meaning Field Name Meaning Type Mgtmsgrbrdinfo 0x6f0d SrcSPCI2S or SPCI4 board Swa BoardrevSwb PrommajrevField Name Meaning Type Liumsgconfig 0x7e34 LIU Configuration RequestHardware Control Messages Dst Mvdtaskid RspreqLinecode LiutypeLine coding technique taken from the following table FrameformatBuildout CrcmodeFaw NfawClearmask 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 RequestParameter Description State LIU CT bus Initialization RequestCurrent state of the LIU from the following table State DescriptionScchannel Parameter Description LiuidTsmask Field Name Meaning Type Mvdmsgscdriveliu 0x7e18 SrcMode 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 Clkmode Value Clock ModePllclksrc Value Bus speed No changeRef1mode 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 IndicationClock Event Indication Result of initial configuration coded as followsParameter Description Completion Status Field Name Meaning Type Mvdmsgclkind 0x0e23 SrcParameter Description Event ID Liustatus LIU Status IndicationStatus field in the message header is coded as follows Field Name Meaning Type Mvdmsgliustatus 0x0e01 Liuid SrcValue 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 Excessive error rate Suerm Excessive delay of acknowledgementOnset of signaling link congestion Abatement 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 MTP Parameters MTP Global ConfigurationReserved1, reserved2 OptionsMTP Link Set MTP Signaling LinkLinkref LinkidSlc BlinkDpc MTP RouteNormls Blink Serial PortUserpartmask SecondlsIsup Parameters Global Isup ConfigurationMTP User Part Isup Circuit Group Configuration Userinst CicmaskOpc VariantGlobal configuration parameters for the TUP module Global TUP ConfigurationTUP Parameters Configuration parameters for a group of TUP circuits TUP Circuit Group Configuration107 Host Utilities Command Line OptionsSsds DescriptionS7mgt Kconfig fileMmodule id Inotify module id Example