Dialogic DSI SPCI Network Interface Boards manual System Configuration File Syntax

Page 21

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

4.2System Configuration

System configuration is handled by the program gctload, which reads the system configuration data from a file called system.txt. This file must be edited to reflect the requirements of your system, prior to running gctload.

System initialization requires first that a pool of message buffers is created for subsequent inter-process communication. Secondly, that a message queue is created for each process that runs and that any message re- direction for modules that are running remotely is initialized. Then all processes can be started.

The program gctload exists to handle this initialization sequence and to create the inter-process communication environment. It reads input from the text file called system.txt, carries out all system initialization and starts up all processes. system.txt is a user configurable file containing details of all the module identifiers known to the system, details of whether they are local modules or remote modules accessed by a local module (message redirection), and lists the command line for all processes to be started by gctload.

gctload creates a message queue for each of the local module identifiers. It subsequently expects a process to service its message queue otherwise messages written to that queue will never be read, causing eventual loss of system messages.

gctload initializes the message queue look-up table so that messages destined for modules that do not exist locally are re-directed to a message queue for a module that does exist locally.

Having created the system environment, gctload proceeds to spawn all processes listed in the system.txt file in the order listed.

4.2.1System Configuration File Syntax

The system configuration file system.txt is a text file used by gctload to configure the software environment.

The file syntax permits the use of comments to improve the readability of the file. Comments are inserted into the file by using an asterisk *; all characters on the line after the asterisk are ignored.

Numbers can be entered in either decimal or hexadecimal format. Hexadecimal numbers must be prefixed with 0x. For example, the value eighteen can be entered in either of the following formats:

0x12

*(Hexadecimal)

18

*(Decimal)

The System Configuration File contains the following commands:

a)LOCAL commands to allow gctload to generate message queues for modules running locally.

b)REDIRECT commands to cause messages generated for modules not running locally to be redirected via a module that is running locally.

c)FORK_PROCESS commands advising gctload of any processes that need to be started locally.

21

Page 20 Page 22
Image 21
Page 20 Page 22
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 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 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 Checking Removing 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 Protocol Configuration using the s7mgt utilityProtocol Configuration Using Individual Messages Page Board Diagnostics Hardware Parameters Board Information DiagnosticsParameters are as described below Parameter DescriptionWatchdog Timer Using the CT busGeographic Addressing Static Initialization Switching ModelExample Code Building and Sending Sclisten Dynamic OperationMSG Page Program Execution Program Execution under WindowsTo 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 General Configuration Messages Message ReferenceHardware Control Messages Event Indication Messages MTP Interface MessagesMessage Summary Table Message Summary0x3e18 SSD Reset Request General Configuration MessagesBoard Reset Request NumboardsStatus 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 MessageField Name Meaning Type Mgtmsgrbrdinfo 0x6f0d Src Value Mnemonic MeaningSPCI2S 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 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 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 MeaningIf a parameter is not required, it must be set to zero LocalstreamLocalslot Sourcestream SourceslotCT bus speed Source Slot Range Destslot DeststreamConfigure Clock Request Parameter Description BusspeedField 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 Indication7 MTP2 Q.752 Event Indication Parameter Description Event CodeEvent 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 DescriptionConfiguration Command Reference 1 SS7BOARD CommandPhysical 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 SecondlsGlobal Isup Configuration Isup ParametersMTP User Part Isup Circuit Group Configuration Userinst CicmaskOpc VariantGlobal TUP Configuration Global configuration parameters for the TUP moduleTUP Parameters Configuration parameters for a group of TUP circuits TUP Circuit Group Configuration107 Host Utilities Command Line OptionsSsds DescriptionKconfig file S7mgtMmodule id Inotify module id Example
Top Page Image Contents