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

T1 Span Configure 0x00A9

SwitchKit Name

T1SpanConfig

Type

EXS API and SwitchKit API message

Description

T1 Span Configure 0x00A9

This message is used to configure the characteristics of a T1 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 (Socket Log Output for SwitchKit)

The following socket log output/example message shows a T1 Span being configured with D4 framing and a line coding method of bit 7 zero suppression. The line length is 0-133 feet.

00 0D 00 A9 00 00 FF 00 01 0C 02 01 23 09 06

SwitchKit Code

Configuration

T1SpanConfig (

Node = integer,

Span = integer,

Format1 = integer,

Format2 = integer);

NOTE: In SwitchKit, the parameter Format1 is the same as Format in EXS API. In SwitchKit, the parameter Format2 is the same as Line Length in EXS API.

C Structure

typedef struct {

unsigned short Span;

UBYTE Format1;

UBYTE Format2;

} XL_T1SpanConfig;

C++ Class

class XLC_T1SpanConfig : public XLC_SpanMessage {

public:

unsigned short getSpan() const;

void setSpan(unsigned short x);

UBYTE getFormat1() const;

void setFormat1(UBYTE x);

UBYTE getFormat2() const;

void setFormat2(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 (0x00A9) | 3, 4 | Message Type (0x00A9)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
8 : : | AIB Address Method 0x00 - Individual AEs (NOT Ranges) | 8, 9 | Status MSB, LSB
10 | Checksum
Number of AEs to follow
AEs 0x0C Logical Span
: | Format This field is a bit mask. The bit values are 0=Disabled, 1=Enabled. Bit Framing 0 D4 (Default) 1 ESF 2 Reserved, must be 0 Line Coding Method 3 Bit 7 zero suppressing (Default) 4 B8ZS zero suppression 5 Reserved, must be 0 Signaling Method 6 Clear Channel (disable signaling insertion) 7 Reserved, must be 0 NOTE: To configure a single node for greater than 64 spans, please contact Dialogic technical support.
: | Line Length 0x06 000–133 ft. (Default) 0x01 134–166 ft. 0x05 167–299 ft. 0x03 300–533 ft. 0x07 534–655 ft. 0x00 G.703 ITU-T
: | Checksum

Digital communications link - voice, data, and video at a 1.544 Mbps rate (24 64 Kbps channels)
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 bit framing standard for traditional time-division multiplexing, which standard describes user channels multiplexed onto a trunk that has been segmented (framed) into 24 bytes of 8 bits each. Note: The multiplexing function is performed in the D-4 framing structure by interleaving bits of consecutive bytes as they are presented from individual circuits into each D-4 frame.
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
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
Error control procedure for digital communication channels providing definable bit patterns to allow the receiver to identify the start of each frame of data and the signaling data.
Extended Super Frame
Bipolar with 8-Zero Substitution. Coding method used with Clear Channel signaling to allow true 64Kbps channel data transmission speeds. See also ZBTSI.
Signaling methods used in Excel platform are: Clear Channel and 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.
International Telecommunications Union (UN)