Connect Tone Pattern 0x002F

SwitchKit Name

ConnectTonePattern

Type

EXS API and SwitchKit API message

Description

Connect Tone Pattern 0x002F

This message instructs the CSP to transmit a call progress pattern ID to the specified channel. The channel must be in any state other than: idle, out of service, or busied out.

If you want to be notified with a Call Processing Event message (0x21 - Tone Complete) when tone transmission has stopped, set the Generate Event Flag.

Sent by

Host

SwitchKit Code

C Structure

typedef struct {

unsigned short Span;

UBYTE Channel;

UBYTE reserved20[27];

UBYTE CallProgressPatternID;

unsigned short NumCycles;

UBYTE Flag;

UBYTE reserved51[219];

} XL_ConnectTonePattern;

C++ Class

class XLC_ConnectTonePattern : public XLC_OneChannelOutbound {

public:

unsigned short getSpan() const;

void setSpan(unsigned short x);

UBYTE getChannel() const;

void setChannel(UBYTE x);

UBYTE getCallProgressPatternID() const;

void setCallProgressPatternID(UBYTE x);

unsigned short getNumCycles() const;

void setNumCycles(unsigned short x);

UBYTE getFlag() const;

void setFlag(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 (0x00NN)

1, 2

Length (0x0007)

3, 4

Message Type (0x002F)

3, 4

Message Type (0x002F)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

8

AIB (Individual AEs)

0x0D Channel

8, 9

Status (MSB, LSB)

10

Checksum

:

Transmit Call Progress Pattern ID

NOTE: These are not the same pattern IDs as those used for call progress analysis.


0x00 Silence Tone

0x01 Dial Tone

0x02 Ringback

0x03 Busy

0x04 Reorder

0x05 Warning

0x06 Call Waiting

0x07 ONI Call (Zip Tone)

0x08 ANI Failure (Zip Tone)

0x09 Confirmation Tone

0x0A Recall Dial Tone

0x0B Class of Service, Tone 2

0x0C Class of Service, Tone 3

0x0D Intercept

0x0E Vacant Code

0x0F Reorder-LEC

0x10 No Circuit-LEC

0x11 Reorder-Carrier

0x12 No Circuit-Carrier

0x13 400 Hz continuous tone

0x14 Specialized tone to wait 500 ms then play 480Hz for 800 ms

0x15 Bong Tone (Calling Card Service Prompt Tone) (When specifying the Bong Tone, it will only play once, but not a number of cycles).

0x16-3F User-defined Patterns

:

Number of Cycles to Transmit, MSB, LSB

 

The value in this field for ringback should be greater than 0x03 and for all others greater than 0x01.

 

The value in this field does not apply for the Dial Tone (0x01), Recall Dial Tone (0x0A), and Bong Tone (0x15), as they have no cycles. Dial Tone and Recall Dial Tone play continuously and Bong Tone plays once.
0x0000 - undefined

0x0000–0xFFFE Valid numbers of cycles
0xFFFF Continuous (for example, Dial Tone)

:

Generate Event Flag

0x00 Do not inform the host when the outpulsing of the tone is complete.

0x01 Inform the host with a Call Processing Event message that the outpulsing
of the tone is complete.

 

The CSP stops playing the tone only if:
- the number of cycles to transmit is reached
- the host issues a Collect Digit String message with Configuration Bit 4 set to
Cancel Prompting Tone or RAN (0x00)
- the host issues a Disconnect Tone Pattern message.

 

A Connect Tone Pattern message does not cancel the outpulsing of call progress tones. However, a Connect With Data message with an action ICB of Free System Resources does cancel outpulsing. For more information, refer to the Connect With Data message.

:

Checksum