Welltech SPCI2S Intel NetStructure SS7 Boards Manuale Utente

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 1 Intel® NetStructure™ SS7 Boards Programmer’s Manual for SPCI2S, SPCI4 and CPM8 Do

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 10 To automatically start the driver at system startup, select the ’Automatic’ optio

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 100 Bit 1 is set to 1 to cause a signalling link test (in accordance with ITU-T Q.70

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 101 A2.4 MTP Route Syntax: MTP_ROUTE <dpc> <norm_ls> <user_part_mask&

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 102 Bit 1 is used to determine whether or not to load share messages across the two

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 103 A2.5 MTP User Part Syntax: MTP_USER_PART <si> <module_id> Example: M

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 104 A3 ISUP Parameters A3.1 Global ISUP Configuration Syntax: ISUP_CONFIG <res1&g

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 105 <gid > The group id of the circuit group in the range 0 to one less than t

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 106 A4 TUP Parameters A4.1 Global TUP Configuration Syntax: TUP_CONFIG <res1>

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 107 <gid > The group id of the circuit group in the range 0 to one less than

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 11 2.2 Software Installation for Linux* The Development Package for Linux is distrib

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 12 2.2.1 Creating Linux device nodes The Linux device driver is a run-time loadable

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 13 The -f option is used to force loading of the driver even if it was built using a

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 14 2.3 Software Installation for Solaris* The Development Package for Solaris is dis

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 15 On successful completion of the procedure the following message is displayed and

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 16 3. CONFIGURATION AND OPERATION 3.1 Overview Prior to attempting software configur

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 17 The following abbreviations are used in the table: MTP2 - Message Transfer Par

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 18 3.2 System Configuration System configuration is handled by the program gctload w

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 19 b) REDIRECT commands to cause messages generated for modules not running locally

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 2 Revision History ISSUE DATE CHANGES A 12-Apr-00 Initial release for evaluatio

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 20 3.2.2 Generating system.txt This section describes the procedure for generating a

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 21 It is next necessary to include FORK_PROCESS commands for all modules running on

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 22 3.3 Protocol Configuration The Development Package contains a protocol configurat

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 23 calling the library function relm(). The library functions are all described in t

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 24 3.4 Using the CT bus 3.4.1 Introduction The SPCI2S, SPCI4 and CPM8 cards support

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 25 When a new call arrives the application will, in general, need to initiate two li

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 26 3.4.5 Example code - Building and sending SC_LISTEN /* * Example function for bu

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 27 4. PROGRAM EXECUTION This section describes how to start the software running. It

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 28 4.1 Program execution under Windows Ensure the device driver has been installed a

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 29 4.2 Program execution under Linux Ensure the device driver has been installed and

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 3 Contents 1. INTRODUCTION ...

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 30 4.3 Program execution under Solaris Ensure the device driver has been installed a

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 31 4.4 Developing a user application The Development Package, along with the User Pa

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 32 5. APPLICATION MESSAGE SPECIFICATIONS 5.1 Overview This section describes the ind

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 33 5.1.3 MTP Interface Messages MTP Interface Messages allow signalling links to be

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 34 0x3e1f Confirmation of MVD_MSG_SC_CONNECT 0x3e20 Confirmation of MVD_MSG_CN

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 35 5.2 General Configuration Messages 5.2.1 SSD Reset Request Synopsis: Message sen

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 36 Parameter Description: mgmt_id The module_id of the management module to which

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 37 5.2.2 Board Reset Request Synopsis: Message sent to SSD to cause a single board

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 38 Parameter Description: board_type The type of board to be reset. This should be

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 39 5.2.3 Board Configuration Request Synopsis: Message sent to a board immediately

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 4 5.3.5 LIU State Request...

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 40 Message Format: MESSAGE HEADER FIELD NAME MEANING type MGT_MSG_CONFIG0 (0x7F10)

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 41 Description: This message must be the first message sent to the board once the S

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 42 Bit 6 and 7 together select the initial CT bus clocking mode as shown in the fol

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 43 l3_flags - level 3 flags Bit 0 is set to 1 to disable the level 3 discrimination

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 44 linkn_flags - Per link flags Bit 0 is set to 1 to force the use of the emergency

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 45 linkn_slc - Signalling link code. The signalling link code for the link which mu

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 46 5.2.4 MTP Route Configuration Request Synopsis: Message sent to MTP3 to add a ro

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 47 The confirmation message (if requested) will indicate success by a status of 0.

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 48 flags This field is a 16 bit field containing run-time configuration options for

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 49 5.3 Hardware Control Messages 5.3.1 LIU Configuration Request Synopsis: Message

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 5 1. INTRODUCTION The range of Intel NetStructure SS7 Boards includes specialised

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 50 Description: This message is sent to the board to configure the operating mode a

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 51 frame_format The frame format taken from the following table: frame_format Descr

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 52 ais_gen The (initial) mode used to generate the Alarm Indication Signal (Blue Al

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 53 5.3.2 LIU Control Request Synopsis: Message sent by the application to dynamical

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 54 Parameter Description: ais_gen The mode used to generate the Alarm Indication Si

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 55 5.3.3 LIU Read Configuration Request Synopsis: Message sent by the application t

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 56 5.3.4 LIU Read Control Request Synopsis: Message sent by the application to read

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 57 5.3.5 LIU State Request Synopsis: Message sent by the application to read the cu

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 58 5.3.6 LIU CT bus Initialisation Request Synopsis: This message is sent to the bo

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 59 sc_channel The channel number of the first channel to be used on the CT bus. Thi

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 6 1.1 Related Documentation U02HSP - CPM8 User Manual U04HSP - SPCI2S, SPCI4 User Ma

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 60 5.3.7 CT bus Listen Request Synopsis: Message sent to the board to establish a c

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 61 Parameter Description: liu_id The identifier of the E1/T1 Line Interface Unit in

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 62 5.3.8 Fixed Data Output Request Synopsis: Message sent to the board in order to

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 63 pattern The value of the fixed data to be generated. The value should be in the

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 64 5.3.9 Reset Switch Request Synopsis: Resets the digital switch to its default st

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 65 5.3.10 CT bus Connect Request Synopsis: Message sent to the board to control the

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 66 Parameter Description: The following table depicts which parameters are required

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 67 mode The value of the mode parameter determines which of the following operatio

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 68 source_slot The source slot references the CT bus timeslot from which to connec

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 69 5.3.11 Configure Clock Request Synopsis: Message sent to a SPCI2S, SPCI4 or CPM8

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 7 2. INSTALLATION 2.1 Introduction This programmer’s manual covers the installation

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 70 Parameter Description: bus_speed This parameter is used to set the CT bus speed,

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 71 pll_src This parameter determines the source of the PLL reference clock, the per

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 72 ref1_mode This parameter determines whether the CT bus NETREF_1 clock is driven

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 73 5.3.12 Configure Clock Priority Request Synopsis: Message sent to a SPCI2S, SPCI

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 74 Parameter Description: liun_pri The relative priority for each LIU using the val

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 75 5.4 MTP Interface Messages 5.4.1 MTP Link Activation Request Synopsis: Primitive

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 76 5.4.2 MTP Link Deactivation Request Synopsis: Primitive request sent to MTP3 3 m

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 77 5.4.3 MTP Transfer Request Synopsis: Primitive request sent to MTP3 to convey a

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 78 5.4.4 MTP Transfer Indication Synopsis: Primitive indication issued by MTP3 to c

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 79 5.4.5 MTP Pause Indication Synopsis: Primitive request issued by MTP3 to indicat

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 8 2.2 Software Installation for Windows* The Development Package for Windows is dist

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 80 5.4.6 MTP Resume Indication Synopsis: Primitive request issued by MTP3 to indica

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 81 5.4.7 MTP Status Indication Synopsis: This primitive is used by level 3 to indic

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 82 5.5 Event Indication Messages 5.5.1 Board Status Indication Synopsis: Message se

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 83 5.5.2 s7_mgt Completion Status Indication Synopsis: Message issued by s7_mgt on

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 84 5.5.3 Clock Event Indication Synopsis: Message issued by the board to indicate o

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 85 5.5.4 LIU Status Indication Synopsis: Message issued by the board to notify of c

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 86 5.5.5 Error Indication Synopsis: Message issued to management to advise of errors

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 87 The ERROR_CODE is coded as shown in the following table: Value Mnemonic id Descri

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 88 5.5.6 MTP2 Level 2 State Indication Synopsis: Indication issued by the board eve

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 89 5.5.7 MTP2 Q.791 Event Indication Synopsis: Message issued by MTP2 to advise man

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 9 The installation process automatically installs the device driver so the setup pro

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 90 5.5.8 MTP3 Q.791 Event Indication Synopsis: Message issued by MTP3 to notify man

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 91 APPENDIX A : PROTOCOL CONFIGURATION COMMANDS This appendix describes the commands

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 92 Bit 13 causes the board to drive the CT_NETREF1 clocks on the CT bus when set to

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 93 A1.2 LIU_CONFIG Command Syntax:LIU_CONFIG <board_id> <liu_id> <liu

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 94 <frame_format> The frame format taken from the following table: frame_forma

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 95 A1.3 LIU_SC_DRIVE Command Syntax: LIU_SC_DRIVE <board_id> <liu_id> &l

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 96 A1.4 SCBUS_LISTEN Command Syntax: SCBUS_LISTEN <board_id> <liu_id> &l

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 97 A2 MTP Parameters A2.1 MTP Global Configuration Syntax: MTP_CONFIG <reserved1&

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 98 A2.2 MTP Link Set Syntax: MTP_LINKSET <linkset_id> <adjacent_spc> <

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 99 A2.3 MTP Signalling Link Syntax: MTP_LINK <link_id> <linkset_id> <