You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > ISDN Interface Configure 0x0060

ISDN Interface Configure 0x0060

SwitchKit Name

ISDNInterfaceConfig

Type

EXS API and SwitchKit API message

Description

Use this message to configure general options to an ISDN interface. It should be sent immediately following the D Channel Assign message.

NOTE: PCM encoding for channels controlled by the D channel is defaulted based on the network signaling variant. E-1 spans configured for Euro-ISDN default to a-law, while all other variants default to µ-law. For more information, see the message PCM Encoding Format Configure (0x00D9).

Sent by

Host

SwitchKit Code

Configuration

ISNDInterfaceConfig (

Node = integer,

Span = integer,

Channel = integer,

Entity = integer,

Data = byte array);

C Structure

typedef struct {

unsigned short Span;

UBYTE Channel;

UBYTE Entity;

UBYTE Data[222];

} XL_ISDNInterfaceConfig;

C++ Class

class XLC_ISDNInterfaceConfig : public XLC_OutboundMessage {

public:

unsigned short getSpan() const;

void setSpan(unsigned short x);

UBYTE getChannel() const;

void setChannel(UBYTE x);

UBYTE getEntity() const;

void setEntity(UBYTE x);

int getMsgSize() const;

void setMsgSize(UBYTE x);

const UBYTE *getData() const;

UBYTE *getData();

void setData(UBYTE *x);

};

 

Overview of message

The following table provides an overview of this message. The table following it, provides the detail for each byte.

MESSAGE (White)

RESPONSE (Gray)

Byte

Field Description

Byte

Field Description

0

Frame (0xFE)

0

Frame (0xFE)

1, 2

Length (0x00NN)

1, 2

Length (0x0007)

3, 4

Message Type (0x0060)

3, 4

Message Type (0x0060)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

:

AIB (starting with byte 0)

8, 9

Status (MSB, LSB)

10

Checksum

:

:

:

Entity

:

Data [0]

:

:

:

Checksum

EXS API Hex Format - Detailed

MESSAGE (White)

RESPONSE (Gray)

Byte

Field Description

Byte

Field Description

0

Frame (0xFE)

0

Frame (0xFE)

1, 2

Length (0xNNNN)

1, 2

Length (0x0007)

3, 4

Message (0x0060)

3, 4

Message Type (0x0060)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

:

AIB

0x00 - Individual AEs

10

Checksum

Number of AEs to follow

AE

0x0D Channel

:

Entity

0x01* Connection Type

0x02 Options (bit mask)

0x03 D Channel Physical Medium

0x03 Span/Channel/Subrate Length

0x04 HDLC Bit Polarity

0x05 Network Side Layer 2

0x06 B Channel Selection Mode

0x07 Location

0x08 Layer 4 Channel Release Request on ISDN Disconnect

0x09 Protocol Discriminator for Maintenance Messages

0x0A B Channel Encoding for Transmission

0x0B Load Information Library Entry
For ISDN only. DASS 2/DPNSS has a different format and is documented in the
DASS 2/DPNSS Data ICB area of this Publication Set.

0x0C Congestion Threshold

0x0D Fill Mask Functionality

0x0F Super Rate D Channel

Data[0] Reserved

Data[1] Number of D Channels (DSOs) 0x02 - 0x04


*If you use the value 0x01 (Connection Type) in the Entity field, you set all B channel parameters and the parameters below to their respective default values:
PCM Encoding Format
Release Modes
Answer Supervision Mode


If you must modify the default PPL Configuration Bytes or PPL Timers, you must first change the Connection Type.

:

Data[0]

The meaning of the Data fields depends on the value of the Entity field.
Valid entries for this field are listed below by Entity field value.

Default values are marked with an asterisk (*).

 

0x01 Connection Type

Data[0] 0x00 (Reserved)


Data[1]

User-Side Variants

0x01* Lucent 4ESS Q.931 PRI

0x02 Lucent 5ESS Q.931 PRI (Custom)

0x03 Northern Telecom DMS-100 Q.931 PRI (Custom)

0x04 Northern Telecom DMS-250 Q.931 PRI (Custom)

0x05 AUSTEL

0x06 JATE (INS 1500)

0x07 Euro-ISDN PRI (Includes French and German Delta)

0x08 Reserved

0x09 NI 2 User Side Connection endpoint variant

0x0A User Side LAPD variant

0x0B Reserved

0x0C UK DPNSS

0x0D* UK DASS 2 (This is the default, if the card is DASS 2/DPNSS.)


Network-Side Variants

0x11-0x16 Reserved

0x17 Euro ISDN PRI
0x19 NI 2 Network Side endpoint variant

0x1A Network Side LAPD variant

Changing the connection type modifies the PPL configuration bytes and timers to the default values for the type of Excel platform indicated. Therefore, change the PPL configuration bytes and timers after sending the PPL Interface Configuration message, which changes the connection type.

 


0x02 Options (Bit Mask)

Data[0] 0x00 (Reserved)

Data[1] This field is a bit mask, where 0=No and 1=Yes:

Bit 0 Send Exact l2 Frames to the Host in a Diagnostic Indication message

Bit 1 Reserved

Bit 2 DPNSS Virtual Channel DLC Initialization disable.
(Disables the initiation of a SABMR on the virtual channels.)

0 = Enabled (default)

1 = Disabled


0x03 D Channel Physical Medium

Data[0] 0x00 (Reserved)

Data[1] 0x01 64 kbps (T1/E1/J1)

 


0x04 HDLC Bit Polarity

Data[0] 0x00 (Reserved)

Data[1] 0x00* Normal

0x01 Inverted (typically used with T1 D4 and AMI line coding)

 

0x05 Network-Side Layer 2

Data[0] 0x00 (Reserved)

Data[1] 0x00* User Side

0x01 Network Side (C/R Bit Inverted)
If the Connection Type is set to a Network Side variant, this option is automatically set to
Network Side


0x06 B Channel Selection Mode

Data[0] 0x00 (Reserved)

Data[1] 0x00 Disabled

0x01* Linear Clockwise

0x02 Linear Counter Clockwise

0x03 Circular Clockwise

0x04 Circular Counter Clockwise


0x07 Location

Data[0] 0x00 (Reserved)

Data[1] 0x00* User

0x01 Private network serving local user

0x02 Public network serving local user

0x03 Transit network

0x04 Public network serving remote user

0x05 Private network serving remote user

0x07 International network

0x0A Network beyond interworking point

 

 

0x08 Layer 4 Channel Release Request on ISDN Disconnect

Data[0] 0x00 (Reserved)

Data[1 ] 0x00* Do not send host Channel Release Request on ISDN Disconnect

0x01 Send host Channel Release Request on ISDN Disconnect.

The host must respond to a Channel Release Request with a Release With Data
message within 20 seconds.


0x09 Protocol Discriminator Value for Maintenance Messages

Data[0] 0x00 (Reserved)

Data[1] 0x03


0x0A B Channel Encoding for Transmission

Data[0] 0x00 (Reserved)

Data[1] 0x00* Channel Number

0x01 Slot Map


0x0B Load Information Library Entry

Data[0] Entry Number (0x00-0x1D)

Data[1] IE Type

0x01 Q.931 IE

Include the following data fields only if Data[1] above is 0x01 (Q.931 IE type):

Data[2] Total IE Length (0x00-0x1C)

Data[3] IE Data

 

 

0x0C Congestion Threshold

Data [0-3] Level 2 burst threshold.

Range 1-10000 messages ( Default = 250 messages)

Data [4-7] Level 2 average threshold

Range 1-10000 messages ( Default = 1300 messages)

Data [8-11] Abatement threshold

Range 1-10000 messages ( Default = 300 messages)

Data [12-15] Burst time window

Range 1-10000 seconds ( Default = 1 second)

Data [16-19] Number of samples in average

Range 0-19 burst time windows ( Default =10 burst time windows)

Data [20-23] Abatement window

Range 1-10000 seconds ( Default = 5 seconds)

Data [24--27] Level 1 burst threshold

Range 1-10000 messages ( Default = 200 messages)

Data [28-31] Level 1 average threshold

Range 1-10000 messages ( Default = 1100 messages)

For the Data Field values above, each value consists of four bytes (one "long word")

 

* default value

 

0x0D Fill Mask Functionality

Data [0] Range

:

Checksum