beautypg.com

6message reference, 1 overview – Dialogic DSI SPCI Network Interface Boards User Manual

Page 36

background image

6 Message Reference

36

6

Message Reference

6.1

Overview

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

General 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.2

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