Manuals / Dialogic / Computer Equipment / Network Router

Dialogic DSI SPCI Network Interface Boards Message Reference, General Configuration Messages

Models: DSI SPCI Network Interface Boards

1 111

Download 111 pages 63.34 Kb

Page 36

6 Message Reference

6 Message Reference

6.1Overview

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 the configuration utility s7_mgt.

Prior to sending any message to the DSI SPCI Network Interface Board the application must call the library function GCT_set_instance to select the board to which the message is sent. After receiving a message from the board, the application must call the library function GCT_get_instance to determine which board the message came from. These library functions are described in the Software Environment Programmer's Manual.

The messages are grouped into four categories:

•General Configuration Messages,

•Hardware Control Messages,

•MTP Interface Messages, and

•Event Indication Messages.

6.1.1General Configuration Messages

General Configuration Messages are normally issued by the s7_mgt configuration utility in which case they need not, and must not, be generated by any user application software.

If the user elects not to use s7_mgt, then it is necessary for the application to build and send messages to configure the SSD module, reset each individual DSI SPCI Board, configure each board and optionally configure additional routes.

6.1.2Hardware Control Messages

Hardware Control Messages are used to control various hardware devices on the board. This includes the T1/E1 Line Interface Units (LIU), the digital cross connect switches and the clocking mode for the DSI SPCI Board.

In a static configuration, all these hardware blocks can be set up using the s7_mgt configuration utility along with the appropriate commands in the config.txt file.

If dynamic control of the hardware is required (or the user has elected to not use s7_mgt), then the user application needs to build and send at least some of the Hardware Control Messages.

36

Image 36

Dialogic DSI SPCI Network Interface Boards Message Reference, General Configuration Messages, Hardware Control Messages

Contents

Dialogic DSI Spci Network Interface Boards MarchCopyright and Legal Notice Contents Configuration Command Reference Message ReferenceTables Host Utilities 108Revision History Introduction Related DocumentationSpecification Product IdentificationCapability License ButtonsProtocol Dimensioning CapacityInstallation IntroductionHardware configuration Software Installation for WindowsBoard Option Switch / Link Settings Installing Development Package for WindowsFiles Installed on a System Running Windows Starting the Windows Device DriverName Description Clearing Windows 2000 Install Wizard Software Installation for Linux Installing Development Package for LinuxRemoving Development Package for Windows Files Installed on a System Running Linux Device Drivers from Source CodeSoftware Installation for Solaris Installing the Development Package for SolarisVerifying Device Driver Loading An example message isSolaris 10 Additional Commands Non-serviced interrupts reportsFiles Installed on a System Running Solaris Solaris 9 Interface Name CheckingSystem has to be rebooted to force the change to take effect Removing the Development Package for SolarisConfiguration and Operation Typical Telephony Systems ConfigurationsOverview System StructureFollowing abbreviations are used in the table Host Processes and UtilitiesIsdn User Part Telephony User PartSystem Configuration System Configuration File SyntaxGenerating a System Configuration File For Linux, these Forkprocess commands are mandatory For Solaris, these Forkprocess commands are mandatoryProtocol Configuration Protocol Configuration using the s7mgt utilityProtocol Configuration Using Individual Messages Page Board Information Diagnostics Board Diagnostics Hardware ParametersParameters are as described below Parameter DescriptionWatchdog Timer Using the CT busGeographic Addressing Switching Model Static InitializationDynamic Operation Example Code Building and Sending SclistenMSG Page Program Execution Program Execution under WindowsTo run the system within the current console, enter Program Execution under Linux To run it in the background enterProgram Execution under Solaris Developing a User ApplicationNmake /f ctu.mnt General Configuration Messages Message ReferenceHardware Control Messages MTP Interface Messages Event Indication MessagesMessage Summary Table Message Summary0x3e18 General Configuration Messages SSD Reset RequestBoard Reset Request NumboardsStatus Response Parameter Description Boardtype PhyidCodefile RunmodeBoard Status Indication FormatBoard Configuration Request Field Name Meaning Type MGTMSGCONFIG0 0x7F10 SrcDescription Event Type Value MeaningMaxsiflen Isolated from the other boards using the CT bus. The CT bus Parameter DescriptionMessage Reference Bit Data Rate Value Description General Module Identification Message Parameter Description MajrevMajor revision identifier for the object being queried MinrevRead Board Info Request Message TextField Name Meaning Type Mgtmsgrbrdinfo 0x6f0d Src Value Mnemonic MeaningSPCI2S or SPCI4 board Boardrev SwaSwb PrommajrevLIU Configuration Request Field Name Meaning Type Liumsgconfig 0x7e34Hardware Control Messages Dst Mvdtaskid RspreqLiutype LinecodeLine coding technique taken from the following table FrameformatCrcmode BuildoutFaw NfawRaigen ClearmaskRaigen Description LIU Control Request Parameter Description AisgenField Name Meaning Type Liumsgcontrol 0x7e35 Diagnostic loop back mode taken from the following table LoopmodeLoopmode Description LIU Read Configuration Request LIU Read Control Request LIU State Request Offset Size Name StateLIU CT bus Initialization Request Parameter Description StateCurrent state of the LIU from the following table State DescriptionParameter Description Liuid ScchannelTsmask Field Name Meaning Type Mvdmsgscdriveliu 0x7e18 SrcValue Mnemonic Description 0xff None Setup failed ModeCT bus Listen Request Offset Size Name Liuid Timeslot ScchannelTimeslot MvipinvalidtimeslotFixed Data Output Request Offset Size Name Liuid Timeslot PatternReset Switch Request PatternCT bus Connect Request Field Name Meaning Mvdmsgscconnect 0x7e1fIf a parameter is not required, it must be set to zero LocalstreamLocalslot Sourcestream SourceslotCT bus speed Source Slot Range Deststream DestslotConfigure Clock Request Parameter Description BusspeedField Name Meaning Type Mvdmsgcnfclock 0x7e20 Src Value Clock Mode ClkmodePllclksrc Value Bus speed No changeValue NETREF1 clock Mode Ref1modeConfigure Clock Priority Request Field Name Meaning Type Mvdmsgclockpri 0x7e21 SrcParameter Description Liunpri Event Indication Messages 2 s7mgt Completion Status Indication Parameter Description Board StatusResult of initial configuration coded as follows Clock Event IndicationParameter Description Completion Status Field Name Meaning Type Mvdmsgclkind 0x0e23 SrcParameter Description Event ID LIU Status Indication LiustatusStatus field in the message header is coded as follows Field Name Meaning Type Mvdmsgliustatus 0x0e01 Liuid SrcError Indication Value Mnemonic StateParameter Description Error Code Error Code is coded as shown in the following table6 MTP2 Level 2 State Indication Parameter Description Link State7 MTP2 Q.752 Event Indication Parameter Description Event CodeEvent Code is coded as shown in the following table Excessive delay of acknowledgement Excessive error rate SuermOnset of signaling link congestion Abatement of signaling link congestion8 MTP3 Q.752 Event Indication Offset Size Name Len Event specific parametersValue Mnemonic Paramter Description MtpevajspokConfiguration Command Reference 1 SS7BOARD CommandPhysical Interface Parameters Bit CT Bus Clocking Mode Liuconfig Command Runmode Protocols selected to Run on the BoardCrcmode CRC mode taken from the following table Frameformat Frame format taken from the following tableLiuscdrive Command BoardidScbuslisten Command MTP Global Configuration MTP ParametersReserved1, reserved2 OptionsMTP Signaling Link MTP Link SetLinkid LinkrefSlc BlinkMTP Route DpcNormls Blink Serial PortSecondls UserpartmaskGlobal Isup Configuration Isup ParametersMTP User Part Isup Circuit Group Configuration Cicmask UserinstOpc VariantGlobal TUP Configuration Global configuration parameters for the TUP moduleTUP Parameters TUP Circuit Group Configuration Configuration parameters for a group of TUP circuits107 Command Line Options Host UtilitiesSsds DescriptionKconfig file S7mgtMmodule id Example Inotify module id