You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > E1 Span Configure 0x00D8
SwitchKit Name
E1SpanConfig
Type
EXS API and SwitchKit API message
Description
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
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 |
: |
Address Method 0x00 - Individual AEs |
8, 9 |
|
10 |
Checksum |
||
Number of AEs to follow |
|||
AE |
|||
: |
Format This field is a bit mask. The meaning of each bit is described below.
0x01 - default for the CSP
Bit 0 1 High-Density Bipolar Three-Bit Substitution (HDB3) (Default)
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 Bit 3 In CAS mode, in-band line signaling for voice channels is carried in In Clear Channel mode, in-band line signaling is not transmitted in Bit 4 Transmit all zeroes Bit 5 1 Euro-ISDN E1 Layer I management For Euro-ISDN compliant E1, see Notes 4 and 5. Bit 6 1 Austel-ISDN E1 Layer I management For Austel-ISDN compliant E1, see Notes 4 and 6. Bit 7 Reserved, must be 0. |
||
: |
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.
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.
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 |