Dialogic DSI SPCI Network Interface Boards Manuale Utente

March 2009 U03HSP www.dialogic.com Dialogic® DSI SPCI Network Interface Boards Programmer's Manual

3 Installation 10 3 Installation 3.1 Introduction This Programmer's Manual covers the installation and use of the software contained in the fol

7 CONFIGURATION COMMAND Reference 100 Bit 2 is set to 1 to cause a signaling link test (in accordance with ITU-T Q.707 / ANSI T1.111.7) to be carried

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 101 a) The only link set used to reach the destination. b) The preferre

7 CONFIGURATION COMMAND Reference 102 7.2.5 MTP User Part Syntax: MTP_USER_PART <si> <module_id> Example: MTP_USER_PART 0x0a 0x2d Conf

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 103 <num_grps> The maximum number of ISUP circuit groups that the u

7 CONFIGURATION COMMAND Reference 104 <cic_mask> A 32 bit mask with bits set to indicate which circuits are to be allocated to the circuit group

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 105 7.4 TUP Parameters 7.4.1 Global TUP Configuration Syntax: TUP_CONF

7 CONFIGURATION COMMAND Reference 106 7.4.2 TUP Circuit Group Configuration Syntax: TUP_CFG_CCTGRP <gid> <dpc> <base_cic> <base

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 107 <ssf> The value to be used in the sub-service field of all TUP

8 Host Utilities 108 8 Host Utilities This section describes some of the utilities that can be used with the Dialogic® DSI SPCI Network Interface Boa

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 109 If using Switch address mode , board_id = 0 would be the board with A

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 11 3.2 Hardware configuration 3.2.1 Board Option Switch / Link Settings

8 Host Utilities 110 -i<notify module id> The module to which an indication is sent when the configuration is complete. -d Enable diagnostic tra

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

3 Installation 12 Table 4: Files Installed on a System Running Windows® Name Description gctlib.lib Library to be linked with user's applicati

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 13 Net start Septel After rebooting the interface will be displayed as ex

3 Installation 14 3.3.4 Removing Development Package for Windows® Prior to installing a new version of the Development Package for Windows®, the prev

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 15 Table 5: Files Installed on a System Running Linux Name Description

3 Installation 16 This warning can be safely ignored. For compatibility with the pre-built drivers the existing name format is retained for Linux 2.4

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 17 On successful completion of the installation procedure, the following

3 Installation 18 To enable this functionality the following line must be added to the /etc/system file: set sptpci:spt_claimint=1 The system has to b

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 19 4 Configuration and Operation 4.1 Overview Prior to performing softw

2 Copyright and Legal Notice Copyright © 1993-2009 Dialogic Corporation. All Rights Reserved. You may not reproduce this document in whole or in part

4 Configuration and Operation 20 The following abbreviations are used in the table: MTP2 Message Transfer Part – Level 2 MTP3 Message Transfer Part –

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 21 4.2 System Configuration System configuration is handled by the progr

4 Configuration and Operation 22 The full syntax of each command is listed in the Software Environment Programmer’s Manual. An example system.txt file

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 23 LOCAL 0xcf * s7_mgt - Management/config task LOCAL 0x2d * upe

4 Configuration and Operation 24 4.3 Protocol Configuration The Development Package contains a protocol configuration utility, s7_mgt which performs

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 25 To configure the board using individual messages, the following sequen

4 Configuration and Operation 26 4.4 Board Information Diagnostics To assist in diagnosis of configuration problems and reporting hardware details wh

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 27 4.5 Geographic Addressing Geographic Addressing allows the logical po

4 Configuration and Operation 28 4.7.1 Switching Model The basic switching model assumes that at system initialization all incoming T1/E1 timeslots a

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 29 LIU_SC_DRIVE 0 0 512 0xfffefffe * 30 E1 voice ccts on ts 1..15 &

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 3 Contents Revision History ...

4 Configuration and Operation 30 #include "pack.h" /* Prototypes for rpackbytes */ #include "ss7_inc.h" /

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 31 m->hdr.src = OUR_MOD_ID; /* * Call GCT_set_instance t

5 Program Execution 32 5 Program Execution This chapter describes how to start the software running. It assumes that the software has already been in

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 33 5.2 Program Execution under Linux Ensure the device driver has been i

5 Program Execution 34 5.3 Program Execution under Solaris Ensure the device driver has been installed and the system configuration file (system.txt)

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 35 gctlib.lib (Windows® using Microsoft compiler) gctlibb.lib (Window

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 Dia

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 37 6.1.3 MTP Interface Messages MTP Interface Messages allow signaling l

6 Message Reference 38 0x3e18 Confirmation of MVD_MSG_SC_DRIVE_LIU 0x3e1f Confirmation of MVD_MSG_SC_CONNECT 0x3e20 Confirmation of MVD_MSG_CNFC

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 39 6.2 General Configuration Messages 6.2.1 SSD Reset Request Synopsis:

Contents 4 5.4 Developing a User Application ... 34 6 M

6 Message Reference 40 num_boards The maximum number of boards that ssd is required to manage. This must not exceed 16. Status Response The confirmati

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 41 Description: This message is used during initialization (or re-configu

6 Message Reference 42 Run Mode Value Run Mode Mnemonic Protocols selected to run on the board 1 DTI Digital Trunk Interface only, no protocol soft

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 43 Description Event Type This message is used to convey the status of a

6 Message Reference 44 PARAMETER AREA 8 2 max_sif_len 10 2 l3_flags 12 4 pc 16 2 ssf 18 2 up_enable 20 2 link0_flags 22 2 link0_slc 24 4 link

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 45 If the board is not licensed to run the requested software configurati

6 Message Reference 46 Bit 13 is set to 1 to cause the board to drive the CT_NETREF1 clocks on the CT bus. The highest priority in-sync line interface

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 47 up_enable - User Part Enable A 16 bit mask used to enable or disable r

6 Message Reference 48 Bit 15 is set to 1 to disable the link, or zero to enable the link. All other bits are reserved for future use and must be set

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 49 6.2.5 General Module Identification Message Synopsis: Message used to

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 5 8 Host Utilities ...

6 Message Reference 50 text Null terminated string giving textual module identity (e.g., "SS7.DC3"). 6.2.6 Read Board Info Request Message

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 51 Format MESSAGE HEADER Field Name Meaning type MGT_MSG_R_BRDINFO (0x6

6 Message Reference 52 board_rev The DSI SPCI Board hardware revision number. swa The setting of the board's rotary switch labeled "Boot&quo

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 53 6.3 Hardware Control Messages 6.3.1 LIU Configuration Request Synops

6 Message Reference 54 Description: This message is sent to the DSI SPCI Board to configure the operating mode a line interface unit. All configuratio

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 55 frame_format Description 1 E1 double frame (E1 only). 2 E1 CRC4 mu

6 Message Reference 56 rai_gen The (initial) mode used to generate the Remote Alarm Indication (Yellow Alarm) taken from the following table. The user

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 57 6.3.2 LIU Control Request Synopsis: Message sent by the application t

6 Message Reference 58 ais_gen Description 0 Do not change AIS / Blue alarm generation mode. 1 Disabled - do not generate AIS / Blue alarm. 2 Enab

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 59 6.3.3 LIU Read Configuration Request Synopsis: Message sent by the ap

Revision History 6 Revision History Issue Date Description A 12-Apr-00 Initial release for evaluation purposes. Some sections incomplete. B 20-Ap

6 Message Reference 60 Value Mnemonic Description 0x01 None Invalid framer ID. 0x02 None Invalid message length. 0x03 None Control parameters

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 61 Status Response The confirmation message (if requested) indicates succ

6 Message Reference 62 Parameter Description: state The current state of the LIU from the following table: State Description 0 OK 1 PCM Loss 2 AIS 3

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 63 Message Format: MESSAGE HEADER Field Name Meaning type MVD_MSG_SC_DRI

6 Message Reference 64 Timeslots containing SS7 signaling processed by the signaling processor on the DSI SPCI Board should not be included in the tim

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 65 6.3.7 CT bus Listen Request Synopsis: Message sent to the DSI SPCI Bo

6 Message Reference 66 Parameter Description: liu_id The identifier of the T1/E1 Line Interface Unit in the range 0 to one less than the number of LIU

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 67 6.3.8 Fixed Data Output Request Synopsis: Message sent to the DSI SPC

6 Message Reference 68 timeslot The timeslot number on the T1/E1 line interface unit on which the fixed data is transmitted. The valid range for times

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 69 Description: This message is sent to the DSI SPCI Board to reset the s

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 7 1 Introduction The range of Dialogic® DSI SPCI Network Interface Board

6 Message Reference 70 Message Format: MESSAGE HEADER Field Name Meaning type MVD_MSG_SC_CONNECT (0x7e1f) id 0 src Sending Module ID dst MVD_TASK_ID

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 71 Mode Required Parameters local st local ts source st source ts d

6 Message Reference 72 mode = 2 : Make a simplex connection from a timeslot on the local bus to a timeslot on the CT bus. Using parameters local_strea

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 73 dest_stream The destination stream references which of the CT bus stre

6 Message Reference 74 6.3.11 Configure Clock Request Synopsis: Message sent to a DSI SPCI Board to configure the clocking mode for the board. Messag

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 75 Value Bus speed 0 No change 2 4.096 MHz (Reserved for future use) 3

6 Message Reference 76 The PLL clock is used as the reference when acting as CT bus Primary Master. If the clock is to be recovered from one of the li

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 77 6.3.12 Configure Clock Priority Request Synopsis: Message sent to a D

6 Message Reference 78 Parameter Description: liun_pri The relative priority for each LIU using the values taken from the following table: Value Mean

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 79 6.4 Event Indication Messages 6.4.1 Board Status Indication Synopsis

2 Specification 8 2 Specification 2.1 Product Identification The product designations are as follows: • Dialogic® DSI SPCI4 Network Interface Board

6 Message Reference 80 Parameter Description: Board Status Value Mnemonic Description 0x60 SSDSI_RESET Processor successfully reset. 0x62 SSDSI_F

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 81 Description: This message is issued by s7_mgt on completion of the ini

6 Message Reference 82 Description: This message is issued by the board to indicate events within the on-board clocking circuitry. Parameter Descripti

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 83 6.4.4 LIU Status Indication Synopsis: Message issued by the board to

6 Message Reference 84 Value Mnemonic State 10 LIUS_SYNC_LOSS Frame Sync Loss 11 LIUS_IN_SYNC Frame Sync OK 12 LIUS_AIS AIS Detected 13 LIUS_AIS_CL

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 85 Parameter Description: Error Code The Error Code is coded as shown in

6 Message Reference 86 6.4.6 MTP2 Level 2 State Indication Synopsis: Indication issued by the board every time the level 2 link state control state m

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 87 6.4.7 MTP2 Q.752 Event Indication Synopsis: Message issued by MTP2 to

6 Message Reference 88 Value Mnemonic Description 0 S7F_STOP Stop request received 1 S7F_FIBR_BSNR Abnormal FIBR/BSNR 2 S7F_EDA Excessive delay of

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 89 6.4.8 MTP3 Q.752 Event Indication Synopsis: Message issued by MTP3 to

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 9 Table 2: Relationship between License Button Codes, Run Modes and Prot

6 Message Reference 90 Value Mnemonic Paramter Description 1 MTPEV_CO link Changeover 2 MTPEV_CB link Changeback 3 MTPEV_REST link Restoration

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 91 7 CONFIGURATION COMMAND Reference This chapter describes the commands

7 CONFIGURATION COMMAND Reference 92 Bit 7 Bit 6 CT Bus Clocking Mode 0 0 The CT bus interface is disabled - In this mode, the board is electricall

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 93 run_mode Protocols selected to Run on the Board DTI Digital Trunk I

7 CONFIGURATION COMMAND Reference 94 liu_type Description 1 Disabled (used to deactivate a LIU). In this mode the LIU does not produce an output sig

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 95 7.1.3 LIU_SC_DRIVE Command Syntax: LIU_SC_DRIVE <board_id> &l

7 CONFIGURATION COMMAND Reference 96 <mode> This parameter allows the user to select how the CT bus channels are allocated. Usually (mode=1) the

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 97 7.2 MTP Parameters 7.2.1 MTP Global Configuration Syntax: MTP_CONFI

7 CONFIGURATION COMMAND Reference 98 Bit 21 is set to 1 for use in Japanese networks; otherwise it must be set to zero. All other bits are reserved fo

Dialogic® DSI SPCI Network Interface Boards Programmer's Manual Issue 5 99 <link_id> The link’s unique logical link identity. It must be in