Dialogic DSI SPCI Network Interface Boards manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Dialogic DSI SPCI Network Interface Boards, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Dialogic DSI SPCI Network Interface Boards one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Dialogic DSI SPCI Network Interface Boards. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Dialogic DSI SPCI Network Interface Boards should contain:
- informations concerning technical data of Dialogic DSI SPCI Network Interface Boards
- name of the manufacturer and a year of construction of the Dialogic DSI SPCI Network Interface Boards item
- rules of operation, control and maintenance of the Dialogic DSI SPCI Network Interface Boards item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Dialogic DSI SPCI Network Interface Boards alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Dialogic DSI SPCI Network Interface Boards, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Dialogic service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Dialogic DSI SPCI Network Interface Boards.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Dialogic DSI SPCI Network Interface Boards item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    March 2 009 U03HSP www.dialogi c.com Dialogic ® DSI SPCI Network Interface Boards Programmer 's Manual[...]

  • Page 2

    2 Copyright and Lega l Notice Copyright © 1993 -2009 Dialogic Corporation . All Rights Reserved. Yo u may not reproduce th is document in wh ole or in part wi thou t permission in writing from Dialogic Corp oration at the address provi ded below. All contents of this docume nt are furnishe d for informational use only and are subject to change wit[...]

  • Page 3

    Dialogic ® DSI SP CI Network Inte rface Boards Pr ogrammer's Ma nual Issue 5 3 Contents Revision History .................. .......................... .................... ..................... .................... .. 6 1 Introduction ......................... ..................... .................... ..................... ................. [...]

  • Page 4

    Contents 4 5.4 Deve loping a Use r Applicat ion ................................ ............................... ............................... .. 34 6 Message Reference ............................................ .................... ..................... ....... 36 6.1 Overv iew ................. ............................... ................[...]

  • Page 5

    Dialogic ® DSI SP CI Network Inte rface Boards Pr ogrammer's Ma nual Issue 5 5 8 Host Utilities .............. .......................... .................... ..................... .................. 108 8.1 ssds .. ................................ ..................................... ................................ ................... ....[...]

  • Page 6

    Revision History 6 Revision History Issue Date Description A 12-Apr-00 Initial release for ev al uation purposes. Some sections incomplete. B 20- A pr-00 Several mi nor corre ctions es peciall y relating t o LIU conf igurati on and switching. Addition of installation s ection for Windows ® NT . 1 30-Jul-01 Sections detail ing support for Windo ws [...]

  • Page 7

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 7 1 Introduct ion The range of Dialogic ® DSI SPCI Network Int erface Boards includes specialized T1/E1 SS7 signaling boards f or use in PCI host computer s ystems. All boards offer a common interfa ce to the applica tion allowi ng applications to be easily ported [...]

  • Page 8

    2 Specificati on 8 2 Specification 2.1 Product Iden tification The product designations are as follows: • Dialogic ® DSI SPCI4 Network Interfa ce Boards – Four T1/E1 in terfaces • Dialogic ® DSI SP CI2S Network Interface Boards – Two T1/E1 interfaces and two serial interfac es Throughout this manual the term "SPCI" is used to re[...]

  • Page 9

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 9 Table 2: Re lationship between Lice nse Button Codes, Run Mode s and Proto col Modules Button Co de Item Market Name Descript io n Maximum Num ber of SS7 Links Run Modes s upport ed MTP2 MTP3 ISUP-S ISUP ISUP-L TUP-S TUP TUP-L MON MM SS7SBPCIMONQ Monitoring 4 √ [...]

  • Page 10

    3 Installation 10 3 Installa t ion 3.1 Introduction This Prog ramm er' s Man ual co vers the i nstal lati on and use o f the s oftware containe d in the follow ing di stributi ons: • Development Package fo r Windows ® • Development Package fo r Linux • Development Package fo r Solaris • User Pa rt Develop ment Package • Code Files f[...]

  • Page 11

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 11 3.2 Hardware config uration 3.2.1 Board Option Switch / Li nk Settings The DSI SPCI Boards contain so me switches and lin ks used to establish optiona l settings at t he time of install ation in a host. These must be set as follows: • CT Bus termination link s [...]

  • Page 12

    3 Installation 12 Table 4: File s Installed on a System Runnin g Windows ® Name Description gctlib.lib Library to be linked w ith user's application (M icrosoft*). gctlibb.lib Library to be linked w ith user's application (B orland*). INC Sub-directory containin g include files. system.txt Exam ple system configuration file. config.txt E[...]

  • Page 13

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 13 Net start Septe l After rebooting the interface w ill be displayed as expected. 4) Right click on the "Sept el" driver and selec t "Properties" and then select the "Driver" tab. 5) The driver can be sta rted immediat ely by selecting[...]

  • Page 14

    3 Installation 14 3.3.4 Removing Development Packa ge for Windows ® Prior to installing a new v e rsion of the Development Package f or Windows ® , the previous package must be removed as fo llows. Thi s pr ocedure requires a user wi th Admini strator privilege. 1) Select the Control Panel (St art Æ Settings Æ Cont rol Panel) . 2) Select "[...]

  • Page 15

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 15 Table 5: Fil es Installed on a System Running Linux Name Description gctlib.lib Library to be linked w ith user's application. system.txt Example system configuration file. config.txt Example protocol con figuration file. gctload.exe ssds.exe s7_mgt .exe s7_[...]

  • Page 16

    3 Installation 16 This warning can be safe ly ignored. For compatibility with the pre-built drivers the ex isting name format is retained for Linux 2.4 drivers e.g., sp tcpi-2.4.18-14s mp.o . However, this name format ca uses proble ms under Linux Kernel version 2. 6; therefore, all Lin ux 2. 6 driver s ar e na med s ptpci26.ko . An install script,[...]

  • Page 17

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 17 On successful completion of the insta llation p rocedure, the following message is displayed, and the user needs to reboot the system. Installation of DKseptel was successful. The following files (or similar) are transferred into the /opt/DKseptel director y. Not[...]

  • Page 18

    3 Installation 18 To enable this functionality the fo llowing line must be added to th e /etc/system file: set sptpci:spt_ claimint=1 The system has to be reb ooted to force the change to take eff ect. 3.5.5 Removing the Development Package for Solaris The Development Package for Sol aris is removed us ing the p ackage removal utility: pkgrm <dp[...]

  • Page 19

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 19 4 Configuration and Operation 4.1 Overview Prior to performing soft ware config uration, the user sh ould gain an appreciation of: • the flexibilit y of the protocol sta ck, • the run-time options that exist, • the mechanisms used to select particul ar feat[...]

  • Page 20

    4 Configuration and Operation 20 The fol lowi ng abbrev iations are used in the table : MTP 2 Message Transfer P art – Level 2 MTP 3 Message Transfer P art – Level 3 ISUP ISDN User Part TUP Telephony User Part In all cases, t he process c alled ssds ( S S7 S oftware D river) must be run on the host computer. This handles messag e transfer betwe[...]

  • Page 21

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 21 4.2 System Configuration System configur ation is handled by the program gctload , which reads the system configuration data from a file ca lled system.txt. This file must be edited to reflect the requirem ents of you r system, pri or to running gctload . System [...]

  • Page 22

    4 Configuration and Operation 22 The full synta x of each comm and is listed in the Softwar e Environ ment Programmer’s Manual. An example sy stem.txt file is shown below : * * Example syste m.txt for the Development Package for Windows®. * * Edit this fil e to reflect your configu ration. * * Essential modules runn ing on host: * LOCAL 0x20 * s[...]

  • Page 23

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 23 LOCAL 0xcf * s7_mgt - Managem ent/config t ask LOCAL 0x2d * upe - Example us er part task LOCAL 0x3d * s7_log - Prints messages to scr een/file After the LOCAL decl arations , REDIRE CT commands are added for modules that run on the bo ard so that messag es desti[...]

  • Page 24

    4 Configuration and Operation 24 4.3 Protocol Configuration The Development Package cont ains a protoc ol configu ration utilit y, s7_m gt which performs initializati on of all the software modul es running on the signaling board. It reads the protocol configura tion data fro m a text file called config.txt and provi des a quick and flex ible metho[...]

  • Page 25

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 25 To config ure the boa rd using indi vidual messages, t he followi ng sequence must be used. (The fo rmat of all t he messages is de scribed in Section 5 of this man ual): 1) Build and send an SSD Reset Message . This cont ains the para meters to initia lize the s[...]

  • Page 26

    4 Configuration and Operation 26 4.4 Board Information Diagnostics To assist in diagnosis of configurat ion pr oblems and rep orting har dware details when encountering problems, a di agnost ic display featur e is availab le in s7_mgt. When s7_mgt is run wi th the –d command line op t ion, a diagnos tic display of board hardware parameters is gen[...]

  • Page 27

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 27 4.5 Geographic Addre ssing Geogr aphic Addr essi ng all ows the l ogic al posi tion of a board (or board_ id) i n a system to remain the same irresp ective of t he addition or removal of other boards on the PCI bus. Two ad dress modes are suppo rted: • PCI addr[...]

  • Page 28

    4 Configuration and Operation 28 4.7.1 Switchin g Model The basic switc hing model assu mes that at sys tem initializ ation all in coming T1/E1 timeslot s and all resour ce board output ti meslots are connect ed up to channels on th e CT bus and that these connection s are never ch anged. This has the advantage that once the on-board CT bus drivers[...]

  • Page 29

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 29 LIU_SC_DRIVE 0 0 512 0xfffef ffe * 30 E1 voice ccts on ts 1..15 & 17..31 LIU_SC_DRIVE 0 1 542 0xfffef ffe * 30 E1 voice ccts on ts 1..15 & 17..31 LIU_SC_DRIVE 0 2 572 0xfffef ffe * 30 E1 voice ccts on ts 1..15 & 17..31 LIU_SC_DRIVE 0 3 602 0xfffef ffe[...]

  • Page 30

    4 Configuration and Operation 30 #include "pack.h " /* Prototypes for rpac kbytes */ #include "ss7_in c.h" /* Message & module de finitions */ /* * Macro to generate the value for use in the rsp_req field of the * message heade r in order to reque st a confirmation m essage: */ #define RESPONSE (module) (((un signed short) 1[...]

  • Page 31

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 31 m->hdr.src = OUR_MOD_ID; /* * Call GCT_ set_instance to rou te the message to t he * correct b oard and GCT_send t o send the message. * If GCT_se nd returns non-zero release the messag e. */ GCT_set_inst ance(board_id, (HDR *)m); if (GCT_send (m->hdr.dst, [...]

  • Page 32

    5 Program Execution 32 5 Program Execution This chapte r describes how to st art the software ru nning. It assumes t hat the software has already been installed and the configuration files system.txt and config .txt have been modifie d accordi ngly. Refer to prev ious sections if unsure. There are three main stages to get a new application up and r[...]

  • Page 33

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 33 5.2 Program Execution under Linux Ensure th e device driver ha s been installed an d the system conf iguration fil e ( system.txt ) has been modified acco rding to the system requirements to select th e correct prot ocols etc. Ensure the cod e file has been copie[...]

  • Page 34

    5 Program Execution 34 5.3 Program Execution under Solaris Ensure the device dri ver has been inst alled and the system configurat ion file ( system.txt ) has been modified according to the system requirements to select t he correct prot ocols etc. Ensure the code file ha s been copied to the direct ory containing the SS7 binari es. If using s7_mgt[...]

  • Page 35

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 35 gctlib.lib (Windows® using Microsoft com piler) gctlibb.lib ( Win dow s® using Borland compiler) gctlib.lib (Linux) gctlib.lib (Solaris) Some simple example programs are supp lied to illustrate the techniques for interfacing to the protocol stack althoug h they[...]

  • Page 36

    6 Message Reference 36 6 Message Reference 6.1 Overview This section d escribes t he individual m essages that may be sent to and received from the Dialogi c ® DSI SPCI Network Interfac e Board. Some messages are sen t by the user' s application sof tware whilst othe rs are sent by utilit y programs such as the configurati on utilit y s7_m gt[...]

  • Page 37

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 37 6.1.3 MTP Interface Messages MTP Interface Messages allow signaling li nks to be activ at ed and deac tivated by the user and provid e a mechanism for communication between the MT P3 module and t he use r par t modul e (e. g., ISUP or TUP). In many case s, the us[...]

  • Page 38

    6 Message Reference 38 0x3e18 Confirmation of MVD_MSG_SC _ DRIVE_LIU 0x3e1f Confirmation of MVD_MSG_ SC _CONNECT 0x3e20 Confirmation of MVD_MSG_ CNF CLOCK 0x3e21 Confirmation of MVD_MSG_ CL K_PRI 0x3e34 Confirma ti on of LIU _MSG_CONF IG 0x3e35 Confirma ti on of LIU _MSG_CONT ROL 0x3f10 Confirma ti on of MGT_M SG_CONFI G0 0x5e37 LIU_MSG_R_CON FIG L[...]

  • Page 39

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 39 6.2 General Configuration Messages 6.2.1 SSD Reset Request Synopsis: Message sent t o SSD once at initializ ation to set up run-time opt ions. Note: When using s7_mgt, this message is generated by s7_mg t and must not be generated by the user. Message Form at: ME[...]

  • Page 40

    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 confirmatio n message (if requeste d) indicates success by sta tus of zero. On error, the fo llowing value ca n be found in the sta tus message confirma tion. Value Mnem onic Description 2 SSD_BAD_PARA M The SS[...]

  • Page 41

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 41 Description: This message is used during initia li zation (or re-configuration) by the application to reset a boar d and download the code f ile that contains the operating software for the board. The download o peration is sup ervised by th e device driver th at[...]

  • Page 42

    6 Message Reference 42 Run Mode Value Run Mode Mnemonic Protocol s select ed to run o n t he boar d 1 DTI Digital Trunk Interface only, no protoco l software. This mode does NOT require th e use of a softw are license button. 2 MTP2 MTP2 p rotocol only. 3 MTP MTP3 plus MT P2 prot o cols. 25 ISUP-S ISUP, small version, p lus all MTP. 4 ISUP ISUP, re[...]

  • Page 43

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 43 Description Event Type This message i s used to conv ey the status of a board res et operation (s uccess of failure) to the use r. The status is indicated i n the sta tus field of the message header. T he followin g table show s the possible Event Type values: Va[...]

  • Page 44

    6 Message Reference 44 PA R A METE R AR EA 8 2 max_sif_len 10 2 l3_fla gs 12 4 pc 16 2 ssf 18 2 up_enable 20 2 link0_flags 22 2 link0_slc 24 4 link0_adj_pc 28 2 link0_stream 30 2 link0_timeslot 32 2 link1_flags 34 2 link1_slc 36 4 link1_adj_pc 40 2 link1_stream 42 2 link1_timeslot 44 2 link2_flags 46 2 link2_slc 48 4 link2_adj_pc 52 2 link2_stream [...]

  • Page 45

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 45 If the board is not licensed to run the requested software configuration, status value of 0x fe is returned. Parameter Description: flag s - Global flags Bit 0 is set to 1 to indicate tha t the us er does not wish to use signal ing software. This all ows operatio[...]

  • Page 46

    6 Message Reference 46 Bit 13 is set to 1 to cause the board to drive the CT_NETR EF1 clocks on the CT bus. The hig hest priori ty in-sync lin e interface is used as a clock sour ce. If this bit is se t to zero then CT_N ETREF1 clock is not driven. All other bi ts are r eserved and must be set to zero. l2_flags - level 2 flags Bit 1 is set to 1 for[...]

  • Page 47

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 47 up_enable - User Part Enable A 16 bit mask used to enable or disable reception of messages on a per user part basis. If bit N i s set to 1, then messages for us er part N are rec eived by the s igna ling po int. For example, to enable the TUP User Part (Service i[...]

  • Page 48

    6 Message Reference 48 Bit 15 is set to 1 to disabl e the link, or zero to enabl e the link. All other bi ts are reserved fo r future us e and must be s et to zero. linkn_slc - Signaling link code The signaling link co de for the link, wh ich must be in the r ange 0 to 15. The signal ing lin k code m ust be agre ed with the admini stration at the o[...]

  • Page 49

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 49 6.2.5 General M odul e Identi fica tion Messa ge Synopsis: Message used to request the module type and softw are revision number. Message Form at: MESSAGE HE ADER Field Name Meaning Typ e GEN _MSG_MO D_IDENT (0x6 111) Id 0 Src Sending module_id Dst on-board manag[...]

  • Page 50

    6 Message Reference 50 text Null terminated string giving tex tual module identity (e.g. , "SS7.DC3"). 6.2.6 Read Board Info R equest Message Synopsis Message used to request basic board information. This message may be sent to several Di alogic ® DSI SS 7 Boar ds, but o nly the parame ters re leva nt to th e Dialogic ® DSI SPCI Network[...]

  • Page 51

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 51 Form at MESSAGE HE ADER Field Name Meaning ty pe MGT_MSG_R _BRDINFO (0x6f0d) id 0 src Sending mod ule_id dst MGMT_ TASK_ID (0x8e) rsp_req used to request a confirma tion hclass 0 status Status Res ponse (if confirmation requested) err_info 0 len 60 PA R A METE R [...]

  • Page 52

    6 Message Reference 52 board_rev The DSI SPCI Board hardware revision numb er. swa The setting of the board's rotary sw itch labeled "Boot". Note: The switch should be se t to 8. swb Geographic addressing switch se tting, that is, the address at which the board app ears wh en th e -o3 f eatur e of ssd s is used . prom_maj_rev Firmwar[...]

  • Page 53

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 53 6.3 Hardware Control Message s 6.3.1 LIU Configuration Request Synopsis: Message sent by the application to establish the o perating mode for a Line Interface Unit (LIU). Note: When using s7_mgt, this message is ge nerated by s7_mg t as a result of the LIU_CONFIG[...]

  • Page 54

    6 Message Reference 54 Description: This message is sent to the DSI S PCI Board to configure the o perating mode a line interf ace unit. Al l configurat ion parameters must be suppli ed in the message (it is not possible to mo dify indiv idual operating para meters in isolation). On receipt of the me ssage th e board first v erifies that the fitt e[...]

  • Page 55

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 55 fram e_fo rma t Description 1 E1 double frame (E1 only). 2 E1 CRC4 multiframe (E 1 only). 4 D3/D4 (Yellow alarm = bit 2 in each chan nel) (T1 only). 7 ESF (Yellow alarm in data link channe l) (T1 only). crc_mode The CRC mode taken from the following table: crc_mo[...]

  • Page 56

    6 Message Reference 56 rai_gen The (initial) mode used to genera t e the Remote Alarm Indic ation (Yellow Alarm) taken from the following table. The user may subsequently modify the setting of the outgoing RAI alarm using th e LIU_MSG_CON TROL messag e. rai_gen Description 1 Disabled - do not generate RAI / Yellow alarm. 2 Forced active - generate [...]

  • Page 57

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 57 6.3.2 LIU Control Request Synopsis: Message sent by the applicat ion to dynamic ally control operation fo r a Line Interface Unit (LIU). Al lows setting of outgoing ala rms and diagnos tic loopbacks. Message Form at: MESSAGE HE ADER Field Name Meaning ty pe LIU_M[...]

  • Page 58

    6 Message Reference 58 ais_gen Description 0 Do not change AIS / B lue alarm generation mode . 1 Disabled - do not generate AIS / Blue alarm. 2 Enabl ed - gener ate AIS / Blue alar m. rai_gen The mode used to generate the Remo te Alarm Indication (Yellow Alarm) taken from the followi ng table: rai_gen Descript ion 0 Do not change RAI / Ye llow alar[...]

  • Page 59

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 59 6.3.3 LIU Read Configuration Request Synopsis: Message sent by th e application t o read back the current LIU configurati on from the DSI SPCI Board. Message Form at: MESSAGE HE ADER Field Name Meaning ty pe LIU_MSG_ R_CONF IG (0x5e37) id liu_id src Sending Mod u[...]

  • Page 60

    6 Message Reference 60 Value Mnemonic Description 0x01 None Invalid framer ID. 0x02 None Invalid message length. 0x03 None Control pa rameters are not consi stent with the ty p e of device be ing con trol l ed or with each othe r. 6.3.4 LIU Read Control Request Synopsis: Message sent by the application to read back t he current LIU contr ol options[...]

  • Page 61

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 61 Status Response The confirmation mes sage (if requested ) indicates s uccess by s tatus of zero. On error, the follow ing status value can be fo und in the confirmation message. Value Mnemonic Description 0x01 N one Invalid framer ID. 0xff None Invalid message le[...]

  • Page 62

    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 Sync Loss 4 Remote Alarm Status Response The confirmatio n message (if requeste d) indicates success by sta tus of zero. On error, the following sta tus values can be found in the co nfirmation message[...]

  • Page 63

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 63 Message Form at: MESSAGE HE ADER Field Name Meaning type MVD_M SG_SC_ DRIVE_LIU (0 x7e18) id 0 src Sending Module ID dst MVD_ TASK_ID (0x10) rsp_req used to request a confirmation hclass 0 status Status Respons e (if confirmation requested) err_info 0 len 10 PA R[...]

  • Page 64

    6 Message Reference 64 Timeslots co ntaining SS7 signa ling processed b y the signaling processo r on the DSI SPCI Board should not be included in the times lot mask. Usually, the mask should be s et to incl ude all bearer (v oice) time slots but no s ignaling timeslots . Bit 0 (corresponding to tim eslot 0 on the LIU) must not be set as timeslot 0[...]

  • Page 65

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 65 6.3.7 CT bus Listen Request Synopsis: Message se nt to the DSI SPCI Board to establis h a connection fro m the CT bus to an outgoing time slot on an T1/E1 Line Interfac e Unit (LIU). Message Form at: MESSAGE HE ADER Field Name Meaning ty pe MV D_ MSG_S C_LI ST EN[...]

  • Page 66

    6 Message Reference 66 Parameter Description: liu_id The identifier of the T1/E1 Line Interfac e Unit in the range 0 to one less than the number of LIUs fitted. This paramete r can also be set t o the special value 0x83 to select the signaling pro cessor instead of an LIU. In this case, timeslots 0 .. . 3 correspon d to signaling pro c essor 0 ... [...]

  • Page 67

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 67 6.3.8 Fixed Data Ou tput R equest Synopsis: Message sent to the DSI SPCI Boa rd in order to generate a fixed pattern on a specific T1/E1 Line Interfa ce Unit timeslot. Message Form at: MESSAGE HE ADER Field Name Meaning ty pe MV D_MS G_SC _FIX DA TA (0x7e15) id 0[...]

  • Page 68

    6 Message Reference 68 timeslot The timeslot number on the T1/E1 line interface u nit on which t he fixed data is transmitted. The vali d range for timeslot is 1 to 31 for an E1 interf ace and 1 to 24 for a T1 interface. pattern The value of the fixed data to be generated. The value must be in the range 0 to 255. Typica l values are 0xff for an &qu[...]

  • Page 69

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 69 Description: This message is sent to the DSI SPCI Board to reset the state o f the digital cross connec t switch in a ccordance with t he configurat ion set using the D SI SPCI Board configurat ion message. All CT bus st reams are t ri-stated leaving just switch [...]

  • Page 70

    6 Message Reference 70 Message Form at: MESSAGE HEADE R Field Name Meaning typ e MVD_MSG_SC _CONNEC T (0x7e1f) id 0 src Sending Module ID dst MVD_T A SK_ID (0 x10) rsp_req used to request a confirmation hclass 0 status Status R espons e (if confirmation requested) err_info 0 len 16 PA R A METE R AR EA Offset Size Name 0 2 local_stream 2 2 local_slo[...]

  • Page 71

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 71 Mode Re quired Pa ra meters local st local ts source st source ts dest st dest ts pa ttern 1 * * * * 2 * * * * 3 * * * * * * 4 * * 5 * * 6 * * 10 * * * 11 * * * * 12 * * * * If a parameter is no t required, it mus t be set to zero. local_stream The local str eam [...]

  • Page 72

    6 Message Reference 72 mode = 2 : Make a simplex connection from a tim eslot o n th e loca l bu s to a timeslot on the CT bus. Using paramet ers local_st ream, local_sl ot, dest_st ream and dest_ slot, to spec ify the local an d CT bus timeslot s respectively. mode = 3 : Make a duplex conn ection bet ween a local st ream timeslot and 2 CT bus times[...]

  • Page 73

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 73 dest_stream The destin ation st ream references which of the CT bus streams is used as a destination for the data. The paramete r takes values in the range 0…31. dest_slot The destin ation s lot referenc es the CT bus t imeslot to which a local st ream timeslot[...]

  • Page 74

    6 Message Reference 74 6.3.11 Configure Clock Request Synopsis: Message sent to a D SI SPCI Board to config ure the clocking mode for the board. Message Form at: MESSAGE HEADE R Field Name Meaning type MVD _MSG_CNFCLO CK (0x7e20) id 0 src Sending Mod ule ID dst MVD_ TASK_ID rsp_req used to reque st a confirmation hclass 0 status Status Respon se (i[...]

  • Page 75

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 75 Value Bus speed 0 No c hange 2 4.096 MHz (Reserv ed for future use) 3 8.192 MHz clk_mode This parameter determines the clo cking mode for t he DSI SPCI Board, t he permissible values are as follows: Value Clock Mo de 0 No c hange 1 C T bus Primary Master , drivin[...]

  • Page 76

    6 Message Reference 76 The PLL clock is u sed as the referenc e when acting as CT bus Pri mary Master. If the clock i s to be r ecov ered from one of the l ine inter faces th en the highest-priority in sync li ne interfac e is used as the reference. Each line interface is ass igned a priority: by default liu_id= 0 is the highest priori ty and liu_i[...]

  • Page 77

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 77 6.3.12 Configure Clock Priority Request Synopsis: Message sent to a DSI SPCI Board to confi gure the clock recovery prio rity order. Message Form at: MESSAGE HE ADER Field Name Meaning type MVD_MS G_CLOCK_ PRI (0x7e21) id 0 src Sending Module ID dst MVD_ TASK_ID [...]

  • Page 78

    6 Message Reference 78 Parameter Description: liu n _pri The relative priority for each LIU usin g the values taken from the following table : Value Meaning 0 No change to the interface’s priority . 1 … 32 New priority value for the line interface. The value 1 indica tes highest priority, 32 the lowest priority. If two interfa ces are given the[...]

  • Page 79

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 79 6.4 Event Indication Me ssage s 6.4.1 Board Status Indication Synopsis: Message sent t o the applicat ion on complet ion of the reset and download sequence or on detection o f a board failure. Note: This message is not required whe n using th e config uration uti[...]

  • Page 80

    6 Message Reference 80 Parameter Description: Board St atus Value Mnemonic Description 0x60 SSDSI_RESET Processor successfully reset. 0x62 SSDSI_FAILURE Failure to reset board. 0x64 SSDSI_BRD_RMV D Board removed (ho t swap only). 0x65 SSDSI_BRD_INS Board inserted (hot sw ap only). 0x66 SSDSI_LIC_FAIL License validation failure. 0x67 SSDSI_L IC_CRP [...]

  • Page 81

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 81 Description: This message is i ssued by s7_mg t on completio n of the initial co nfiguration sequence and in dicates either s uccess (status =zero) or an error cond ition that occurred during configurat ion. The message is only issued when s7_mgt is r un w ith th[...]

  • Page 82

    6 Message Reference 82 Description: This message is issued by the board to indicate events within t he on-board clocking circu itry. Parameter Description: Event ID This field specifies the ev ent that cause d the indicati on to be generated: even t_id Description 1 PLL enter ed hold-o ver mode Issued by boards a cting as primary or secon dary cloc[...]

  • Page 83

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 83 6.4.4 LIU Statu s Indication Synopsis: Message issu ed by the board to not ify of chang es of LIU status . Message Form at: MESSAGE HE ADER Field Name Meaning type MVD _MSG_LIU_STA TUS (0x0e01) id liu_id src MVD_TA SK_ ID dst MGMT_ TASK_ID rsp_req 0 hclass 0 stat[...]

  • Page 84

    6 Message Reference 84 Value Mnemonic State 10 LIU S_SYNC_L OSS Frame Sync Loss 11 LIUS_IN_SYNC F rame Sync OK 12 LIU S_AIS AIS Detect ed 13 LIU S_AIS_CLR D AIS Cleared 14 LIU S_REM_ ALARM Remote Alarm 15 LIUS_REM_ALM_CLRD Remote Alarm Cleared 20 LIUS_PCM_LOSS PCM Loss 21 LIUS_PCM_OK PCM Res tor ed 22 LIUS_FRAME_SLIP Frame Slip 25 LIUS_BER5_OCRD BE[...]

  • Page 85

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 85 Parameter Description: Error Code The Erro r Code is c oded as shown i n the follow ing table: Value Mnem onic ID Desc ription 0x31 S7E_RESET_ERR MTP2 Failed to initialize. 0x33 S7E_POOL_E MPTY l2_llid No free buff ers in MTP2 transmit pool. 0x34 S7E_TX_FA IL l2_[...]

  • Page 86

    6 Message Reference 86 6.4.6 MTP2 Lev el 2 State Indication Synopsis: Indicati on issued by th e board ever y time the level 2 link state con trol stat e machine change s state. Message Form at: MESSAGE HEADE R Field Name Meaning type MGT_ MSG_SS7_STATE (0x0201) id llid (Level 2 logical link id - 0 ... 3) src SS7_ TASK_ID dst 0xdf rsp_req 0 hclass [...]

  • Page 87

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 87 6.4.7 MTP2 Q.7 5 2 Even t In dicati o n Synopsis: Message iss ued by MTP2 to advi se management of protocol e vents in accordance with ITU- T Q.752. Message Form at: MESSAGE HE ADER Field Name Meaning type MGT_ MSG_SS7_EVENT (0x 0202) id l2_llid src MTP2 module i[...]

  • Page 88

    6 Message Reference 88 Value Mnemonic Description 0 S7F_STOP Stop request received 1 S7F_FIBR_BSNR Abnormal FI BR/BSNR 2 S7F_ED A Excessive delay of ackno wledgement 3 S7F_SU ERM Excessive error rate (SUERM ) 4 S7F_EC ONG Ex cessi ve congestion 5 S7F_SI O_RXD Unexpected SIO received 6 S7F_SI N_RXD Unexpected SIN receiv ed 7 S7F_SI E_RXD Unexpected [...]

  • Page 89

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 89 6.4.8 MTP3 Q.7 5 2 Even t In dicati o n Synopsis: Message issued by MTP3 t o notify management of v arious protoc ol events in accordance with ITU- T Q.752. Message Form at: MESSAGE HE ADER Field Name Meaning type MGT _MSG_MTP_EVENT (0x0301) id 0 src MTP3 module [...]

  • Page 90

    6 Message Reference 90 Value Mnemonic Para mt er Description 1 MTPEV_CO link Changeover 2 MTPEV_CB link Changeback 3 MTPEV_REST link Restoration commenced 4 MTPEV_RPO link Remote proc essor ou tage 5 MTPEV_RPO _CLR link Remote proc essor outage cl eared 6 MTPE V_CONG link Signaling link congestion 7 MTPEV_ CONG_ CLR link Con gestion c leared 8 MTPE[...]

  • Page 91

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 91 7 CONFIGURATION COMMAND Reference This chapter describes the comm ands an d parameters used in the protocol configuration file config.txt. These are used by the s7_mgt u tility to perfo rm single-shot c onfiguratio n of the protocol stac k at startup. 7.1 Physic [...]

  • Page 92

    7 CONFIGURATIO N COMMAND Reference 92 Bit 7 Bi t 6 C T Bus Cl ocking Mode 0 0 The CT bus interface is disabled - In this m ode, the board is electrically isolated from the othe r boards using the CT bus. The CT b us connection comman d s may sti ll be use d, but the c onnecti ons made are onl y visible to this board. When using this mode, the on-bo[...]

  • Page 93

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 93 run_mode Protocols selected to Run on the Board DTI Digital Trunk Interface only , no protocol softw are. This mode does NOT require the use of a software license button). MTP2 MTP2 protocol only . MTP MTP3 plus MTP2 protocols. ISUP-S ISUP, small version, plus al[...]

  • Page 94

    7 CONFIGURATIO N COMMAND Reference 94 liu_type Description 1 Disabled (used to deactiva te a LIU). In this mo de the LIU does not produce an output signal. 2 E1 75ohm unbalanced interface (fo r future use). 3 E1 120ohm balanced interface. 4 T1 5 E1 75ohm or 120ohm setting base d on fitted hardware. (Th is is the preferred method of se lecting an E1[...]

  • Page 95

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 95 7.1.3 LIU_SC_ DRIVE Command Syntax: LIU_SC_DRIVE <board_id> <liu_id> <sc_cha nnel> <ts_ mask> {<mo de>} Example: LIU_SC_DRIVE 0 0 512 0xfffefffe This command is used during ini tialization to se t up a static switch path through the [...]

  • Page 96

    7 CONFIGURATIO N COMMAND Reference 96 <mode> This parameter allow s the user to select how the C T bus chan nels are allocated. Us ually (mode=1) th e first timeslot conn ected to the CT bus is connected to sc_channel a nd each subsequen t timeslot that is selected is connecte d to the next CT bu s channel . This allows m aximum utilization o[...]

  • Page 97

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 97 7.2 MTP Parameters 7.2.1 MTP Global Configuration Syntax: MTP_C ONFIG <reserved1> <reserved2> <option s> Example: MTP_CON F IG 0 0 0x0004 0f00 The global config uration paramet ers for the Message Transf er Part (MTP). <reserved1>, <res[...]

  • Page 98

    7 CONFIGURATIO N COMMAND Reference 98 Bit 21 is set to 1 for use in Japanese networks ; otherwise it must be se t to zero. All other bi ts are reserved fo r future us e and must be s et to zero. Note: For ANSI operation bits 8, 9, 10 , 11, and 18 must all be set to 1 . 7.2.2 MTP Link Set Syntax: MTP_LINKSET <linkset_id> <adjacent_spc> &[...]

  • Page 99

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 99 <link_id> The link’s unique logical link identity . It must be in the range 0 to one less than the total number of signaling links supported. <linkset_id> The logical identity of the link set to wh ich the link be longs. The linkse t must already ha[...]

  • Page 100

    7 CONFIGURATIO N COMMAND Reference 100 Bit 2 is set to 1 to cause a signal ing link test (in accordance with ITU-T Q.707 / ANSI T1.111.7) to be carrie d out ever y 30 se conds. Note that th is bit is ignored unless bit 1 is al so set to 1. Bit 8 is used to select the MTP2 error correction mode. It is set to 1 to select PCR (Preventive C yclic Ret r[...]

  • Page 101

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 101 a) The only link set used to rea ch the destination. b) The preferred link set used to reach the destination. c) One of a pair of links sets fo rming a combin ed link set. In the lat ter two case s a second link set (second _ls) must also be specifi ed. Within a[...]

  • Page 102

    7 CONFIGURATIO N COMMAND Reference 102 7.2.5 MTP Us er Part Syntax: MTP_USER _ PA RT <s i> <modu le_id > Example: MTP_USER_ PART 0x0a 0x2d Configuration of a lo cal user part modu le (other than a us er part which has its own config command in config.txt). <si> The service indicator. <module_i d> The module id of the user pr[...]

  • Page 103

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 103 <num_grps> The maximum number of ISU P circuit groups that the user intends to use. This must not e xcee d the maxi mum number of circu it groups supporte d otherwis e module con figuration w ill fail. Typically < num_grps> would be set to the maximu[...]

  • Page 104

    7 CONFIGURATIO N COMMAND Reference 104 <cic_m ask> A 32 bit mask with bits set to indicate which circuits are to be allocated to the circuit gr oup. Bit zero must always be set as it represents the base_c ic/ba se_cid . Subs equent bits re prese nt the subsequent circuits. Not e that A NSI circ uit gr oups are not p erm itted to c ontai n mor[...]

  • Page 105

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 105 7.4 TUP Parameters 7.4.1 Global TUP Configuration Syntax: TUP_CONFIG <r es1> <res2 > <user_ id> <options> <num_grps> <num_cc ts> <partner_id> Example: TUP_CO NFIG 0 0 0x2d 0x854 1 4 128 The global configuration para mete[...]

  • Page 106

    7 CONFIGURATIO N COMMAND Reference 106 7.4.2 TUP Circ uit Group C onfig uration Syntax: TU P_CFG_CCTGRP <gid> <dpc> <base_cic> <base_cid> <cic_mask> <options > <user_inst> <user_i d> <opc> <ssf> <variant> <options2> Example: TUP_CFG_CC TGRP 0 3 1 1 0x7fff7fff 0x000 00003 0 0x2 [...]

  • Page 107

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 107 <ssf> The value to be used in the sub-servic e field o f all TUP mess ages for this circuit grou p. <variant > This field is reserv ed for future use and mus t be set to ze ro. <options2 > This field is reserv ed for future use and mus t be set[...]

  • Page 108

    8 Host Utilities 108 8 Host Utilities This section describes some of the uti lities that can be used with t he Dialogic ® DS I SP CI N etwork Inte rface Boar ds. See the software environment Programmer's Manual for de tails of the gctload , tim , tick , s7_log and s7_play utilitie s. 8.1 ssds 8.1.1 Description The ssds utility in terfaces wit[...]

  • Page 109

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 109 If using Swit ch address m o de , board_id = 0 would be the b oard with ADDR switch set to 6, board_id = 1 woul d be the board wit h ADDR switch set to 4 and so on. It is not nece ssary for all boards lis t ed in this parameter to actual ly exis t in a system. A[...]

  • Page 110

    8 Host Utilities 110 -i<notify module id> The module to which an indication is se nt when the configuration is c omplete. -d Enable diagnostic tracing. 8.2.4 Exampl e To run the s7_mgt utility a s module ID 0xdf with the file my_config. txt as its configuration file and notif ying the module 0xef on completion, th e command is: s7_mgt -m0xdf [...]

  • Page 111

    Dialogic ® DSI SP CI Network Inte rface Board s Programmer 's Manual Issu e 5 111[...]