Dialogic DSI SPCI Network Interface Boards manual Dynamic Operation

Page 29

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

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..31

LIU_SC_DRIVE 0 3 602 0xfffefffe * 30 E1 voice ccts on ts 1..15 & 17..31

LIU_SC_DRIVE 1 0 632 0x00fffffe * 23 T1 voice ccts on timeslots 1..23

LIU_SC_DRIVE 1 1 655 0x00fffffe * 23 T1 voice ccts on timeslots 1..23

LIU_SC_DRIVE 1 2 678 0x00fffffe * 23 T1 voice ccts on timeslots 1..23

LIU_SC_DRIVE 1 3 701 0x00fffffe * 23 T1 voice ccts on timeslots 1..23

4.7.3Dynamic Operation

The application controls dynamic changes to CT bus switching by sending the MVD_MSG_SC_LISTEN message to the board. This message is documented in chapter 5 Program Execution. It contains the liu_id, the timeslot number on the T1/E1 interface and the CT bus channel number (sc_channel) to which the timeslot listens. The message is directed to the correct board by calling the GCT_set_instance function prior to calling GCT_send.

When a new call arrives, the application needs to instigate 2 listen commands (although they do not necessarily both apply to the SS7 board). One connects the voice circuit in the forward direction and the other connects it in the backward direction.

When a call terminates, the application must issue a fixed data message to ensure the network port sees the voice idle pattern.

4.7.4Example Code - Building and Sending SC_LISTEN

/*

*Example function for building and sending an MVD_MSG_SC_LISTEN

*message to a SPCI2S or SPCI4 signalling board.

*

*The only change that the user needs to make is to fill in the

*OUR_MOD_ID definition below so that is equal to the module_id

*of the application module.

*/

#define OUR_MOD_ID		(0xef)
#include "system.h"		/* Definitions of	u8, u16	etc */
#include "msg.h"		/* Definitions of	HDR, MSG etc */
#include	"libc.h"	/* Used only for memset prototype */
#include	"sysgct.h"	/* Prototypes for	GCT_xxx	*/

29

Image 29

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 WindowsName Description Files Installed on a System Running WindowsStarting the Windows Device Driver Clearing Windows 2000 Install Wizard Removing Development Package for Windows Software Installation for LinuxInstalling Development Package for Linux 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 Individual Messages Protocol ConfigurationProtocol Configuration using the s7mgt utility Page Board Diagnostics Hardware Parameters Board Information Diagnostics Parameters are as described below Parameter DescriptionGeographic Addressing Watchdog TimerUsing the CT bus Static Initialization Switching ModelExample Code Building and Sending Sclisten Dynamic OperationMSG Page To run the system within the current console, enter Program ExecutionProgram Execution under Windows To run it in the background enter Program Execution under LinuxDeveloping a User Application Program Execution under SolarisNmake /f ctu.mnt Hardware Control Messages General Configuration MessagesMessage Reference Event Indication Messages MTP Interface MessagesMessage Summary Table Message Summary0x3e18 SSD Reset Request General Configuration MessagesStatus Response Board Reset RequestNumboards 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 MessageSPCI2S or SPCI4 board Field Name Meaning Type Mgtmsgrbrdinfo 0x6f0d SrcValue Mnemonic Meaning 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 NfawRaigen Description RaigenClearmask Field Name Meaning Type Liumsgcontrol 0x7e35 LIU Control RequestParameter Description Aisgen Loopmode Description Diagnostic loop back mode taken from the following tableLoopmode 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 MeaningLocalslot If a parameter is not required, it must be set to zeroLocalstream CT bus speed Source Slot Range SourcestreamSourceslot Destslot DeststreamField Name Meaning Type Mvdmsgcnfclock 0x7e20 Src Configure Clock RequestParameter Description Busspeed 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 IndicationEvent Code is coded as shown in the following table 7 MTP2 Q.752 Event IndicationParameter Description Event Code 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 DescriptionPhysical Interface Parameters Configuration Command Reference1 SS7BOARD Command 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 SecondlsMTP User Part Global Isup ConfigurationIsup Parameters Isup Circuit Group Configuration Userinst CicmaskOpc VariantTUP Parameters Global TUP ConfigurationGlobal configuration parameters for the TUP module Configuration parameters for a group of TUP circuits TUP Circuit Group Configuration107 Host Utilities Command Line OptionsSsds DescriptionMmodule id Kconfig fileS7mgt Inotify module id Example