You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > E1 Span Configure 0x00D8

E1 Span Configure 0x00D8

SwitchKit Name

E1SpanConfig

Type

EXS API and SwitchKit API message

Description

E1 Span Configure 0x00D8

This message allows the host to configure the transmission format, line length, and SA bits of an E1 span.

NOTE: Before changing span configuration, Dialogic ALWAYS RECOMMENDS that you de-assign the spans, assign them again and then send the new span configuration.

Sent by

Host

Example Message

The following sample message configures an E1 span with the default coding method, signaling method, E1 Layer I management. CRC-4 and FEBE error checking are configured. The default line length, SA Registers, and TS 16 Register are also configured.

00 0F 00 D8 00 FF FF 00 01 0C 02 01 23 E8 00 F8 D0

SwitchKit Code

Configuration

E1SpanConfig (

Node = integer,

Span = integer,

Format = integer,

LineLength = integer,

SARegisters = integer,

TS16Registers = integer);

C Structure

typedef struct {

unsigned short Span;

UBYTE Format;

UBYTE LineLength;

UBYTE SARegisters;

UBYTE TS16Registers;

} XL_E1SpanConfig;

C++ Class

class XLC_E1SpanConfig : public XLC_SpanMessage {

public:

unsigned short getSpan() const;

void setSpan(unsigned short x);

UBYTE getFormat() const;

void setFormat(UBYTE x);

UBYTE getLineLength() const;

void setLineLength(UBYTE x);

UBYTE getSARegisters() const;

void setSARegisters(UBYTE x);

UBYTE getTS16Registers() const;

void setTS16Registers(UBYTE x);

};

EXS API Hex Format

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 Type (0x00D8) | 3, 4 | Message Type (0x00D8)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
: | AIB Address Method 0x00 - Individual AEs | 8, 9 | Status MSB, LSB
10 | Checksum
Number of AEs to follow
AE 0x0C Logical Span
: | Format This field is a bit mask. The meaning of each bit is described below. Unless otherwise stated, 0 = Disabled, 1 = Enabled. 0x01 - default for the CSP Coding Method Bit 0 0 Alternate Mark Inversion (AMI) 1 High-Density Bipolar Three-Bit Substitution (HDB3) (Default) Error Checking Bit 1 Enable CRC-4 Cyclic Redundancy Check Bit 2 Enable FEBE (Far-End Block Error) Enables the use of E-bits in the CRC-4 multiframe alignment signal for the automatic reporting of a CRC error received during the previous multiframe. Signaling Method Bit 3 0 Channel Associated Signaling (Default) In CAS mode, in-band line signaling for voice channels is carried in timeslot 16. 1 Clear Channel In Clear Channel mode, in-band line signaling is not transmitted in timeslot 16. Bit 4 Transmit all zeroes Bit 5 0 E1 Layer I management (Default) 1 Euro-ISDN E1 Layer I management For Euro-ISDN compliant E1, see Notes 4 and 5. Bit 6 0 E1 Layer I management (Default) 1 Austel-ISDN E1 Layer I management For Austel-ISDN compliant E1, see Notes 4 and 6. Bit 7 Reserved, must be 0.
: | Line Length 0x00 G.703 ITU-T (75 ohm) (Default) 0x04 G.703 ITU-T (120 ohm)
: | SA Registers This field is a bit mask. The meaning of each bit is described below. Unless otherwise stated, 0 = Disabled, 1 = Enabled. The default for all bits is 1. See Note 3. Bits 0–2 Reserved (must be 0) Bit 3 Value to which all bits in SA Bit 4 Register should be set. Bit 4 Value to which all bits in SA Bit 5 Register should be set. Bit 5 Value to which all bits in SA Bit 6 Register should be set. Bit 6 Value to which all bits in SA Bit 7 Register should be set. Bit 7 Value to which all bits in SA Bit 8 Register should be set.
: | TS 16 Register This field is a bit mask. The meaning of each bit is described below. Unless otherwise stated, 0 = Disabled, 1 = Enabled. The default for all bits is 1. See Note 3. Bits 0–3 Reserved (must be 0) Bit 4 Value to which spare bit x1 in frame 0 of timeslot 16 should be set. Bit 5 Reserved (must be 0) Bit 6 Value to which spare bit x3 in frame 0 of timeslot 16 should be set. Bit 7 Value to which spare bit x4 in frame 0 of timeslot 16 should be set.
: | Checksum

NOTES

1. To configure a single node for greater than 64 spans, please contact Dialogic technical support.

2. Note that the Dialogic message bit-numbering format is 0–7, while the SA Register and TS 16 Register formats are 1–8. Therefore, bit 3 of the host message format is bit 4 of the SA Register and TS 16 Register formats, and so on.

3. This message is backward-compatible to previous software releases.

4. Refer to ITU-T Recommendation G.704 more details on programming SA bits and spare timeslot 16 bits.

5. To use Euro-ISDN Layer 1, you must use an SE1LC Rev. B11 or greater. For more information, refer to the appropriate "Hardware Product Descriptions."

6. For Euro-ISDN compliant E1, set the following:
(Bit 0 = 1) Line format to HDB3
(Bit 1 = 1) CRC
(Bit 2 = 1) FEBE
(Bit 3 = 1) E1 clear Channel
(Bit 5 =1) Euro-ISDN Layer I
Line length to G.703

7. For Austel-ISDN compliant E1, set the following:
(Bit 0 = 1) Line format to HDB3
(Bit 1 = 1) CRC
(Bit 2 = 1) FEBE
(Bit 3 = 1) E1 clear Channel
(Bit 6 = 1) Austel-ISDN Layer I
Line length to G.703

Default E1 Format

The table below shows the default format for E1 spans.You must enable Clear Channel signaling to use timeslot 16 (Channel 30) as a voice channel or for out-of-band signaling (for example, an ISDN application).

NOTE: Clear Channel signaling must be enabled to use timeslot 16 (channel 30) as a D channel in ISDN applications.

Timeslot | Channel | Description
--- | --- | ---
0 | 31 | Alarms and framing
1 | 0 | Voice channels
2 | 1
3 | 2
4 | 3
5 | 4
6 | 5
7 | 6
8 | 7
9 | 8
10 | 9
11 | 10
12 | 11
13 | 12
14 | 13
15 | 14
16 | 30 | In-band line signaling (CAS)
17 | 15 | Voice channels
18 | 16
19 | 17
20 | 18
21 | 19
22 | 20
23 | 21
24 | 22
25 | 23
26 | 24
27 | 25
28 | 26
29 | 27
30 | 28
31 | 29

A digital communications link - voice, data, and video at a 2.048 Mbps rate; 30B/2D or 31B/1D (ISDN); non-North American version of T1.
Range of channels provided by T1 or E1 transmission service. A physical span is a group of channels taking up a single physical wire. A logical span is a group of channels taking up less than a single logical wire, or carried over more than one physical wire.
A computer, attached to the Excel platform through an RS-232 or Ethernet link, from which you run the telecommunications application that controls the Excel platform.
A group of data bits in a specific format, with a flag at each end to indicate the beginning and the end of the frame.
See Address Information Block.
Most Significant Bit
Least Significant Bit
Signaling methods used in Excel platform are: Clear Channel and Channel Associated Signaling.
CAS. Signaling in which the signals necessary to switch a given circuit are transmitted via the circuit itself or via a signaling channel permanently associated with it.
See Channel Associated Signaling.
Signaling technique where the full channel bandwidth is used for data transmission, while the framing and control bits (signaling) use a separate channel. No control or signaling is performed on this path. See B8ZS and ZBTSI.
See Integrated Services Digital Network.
Options for line length when configuring a T-1 span on a Excel platform are as follows.
0 - 133 Feet
134 - 166 Feet
167 - 299 Feet
300 - 533 Feet
534 - 655 Feet
G.703 ITU-T
International Telecommunications Union (UN)
International Telephone Union – Telecommunications sector (UN)