Specifications

Dialogic
®
DSI SS7HD Network Interface Boards Programmer's Manual Issue 11
119
Appendix A. Protocol Configuration Using Discrete
Messages
This appendix provides guidelines for protocol configuration using individual messages.
A.1 Protocol Configuration Using Individual Messages
As an alternative to using the s7_mgt protocol configuration utility it is possible to
perform protocol configuration by building and sending messages directly to the board.
This approach means that it is necessary to write some application code to handle
configuration, but has the advantage that the application can, if required, reconfigure
the board without restarting the application.
Communication with the board is achieved by sending and receiving messages. The
configuration sequence is described below. The application should allocate a message
structure using the getm( ) library function and send it to the board using the
GCT_send( ) library function. The application should periodically call the GCT_receive(
) or GCT_grab( ) library functions to receive messages from the board. The
GCT_receive( ) function blocks until a message is available, while the GCT_grab( )
function returns immediately. Once the application has finished processing the received
message, it should release the message structure back to the system by calling the
relm( ) library function. The library functions are described in the Software
Environment Programmer's Manual.
To configure the board using individual messages, the following sequence should be
used. The message sequence is shown diagrammatically in Figure 3. Protocol
Configuration Message Sequence Diagram.
Note: The format of all the messages is described in Section 4, “Message Reference” on
page 47.
1. Build and send an SSD Reset Request (SSD_MSG_RESET ) to the SSD module.
This message contains the parameters required to initialize the SSD module.
2. Then build and send a Board Reset Request (SSD_MSG_RST_BOARD )for each
board in the system. This message contains the address (or identifier) of the board
and the name of the code file. It causes the board to be reset and the code file
downloaded. For each board, the application should wait until a Board Status
Indication (SSD_MSG_STATE_IND) is received and inspect the status field to
determine if the reset operation was successful. On failure, the user should check
carefully the ssdm parameters and try again.
3. Build and send a Board Configuration Request (MGT_MSG_CONFIG0) to the
onboard management task (MGMT_TASK_ID) to configure the basic board
parameters. When using Dialogic
®
DSI SS7HD Boards, the value of the config_type
parameter in the Board Configuration Request must be set to 3. For this version of
the message, the automatic configuration of MTP parameters is not supported.
Wait for the confirmation message and check the status.
4. To set up the LIU and port for the T1/E1/J1 ports, the LIU Configuration Request
(LIU_MSG_CONFIG) should be used. Wait for the confirmation message for each
LIU and check the status.
For each link in the system: