You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Tone Query 0x005A
SwitchKit Name
TransmitToneQuery
Type
EXS API and SwitchKit API message
Description
This message is used to query the transmit and receive tones assigned to a DSP, as well as the frequency and power levels of the tones.
NOTE: A Tone Query message in the middle of several Tone Configure messages shows the configuration as updated even when the Update All Flag is not set.
Sent by
Host Application
SwitchKit Code
C Structure
typedef struct {
UBYTE QueryEntity;
UBYTE QueryValue[252];
} XL_TransmitToneQuery;
C Structure Response
typedef struct {
unsigned short Status;
UBYTE Data[251];
} XL_TransmitToneQueryAck;
C++ Class
class XLC_TransmitToneQuery : public XLC_OutboundMessage {
public:
UBYTE getQueryEntity() const;
void setQueryEntity(UBYTE x);
const UBYTE *getQueryValue() const;
UBYTE *getQueryValue();
void setQueryValue(UBYTE *x);
};
C++ Class Response
class XLC_TransmitToneQueryAck : public XLC_AcknowledgeMessage {
public:
unsigned short getStatus() const;
void setStatus(unsigned short 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 (0x00NN) |
3, 4 |
Message Type (0x005A) |
3, 4 |
Message Type (0x005A) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
8 |
Query Entity |
8, 9 |
|
9 |
Data[0] |
10 |
Data[0] |
: |
: |
: |
: |
: |
Data[n] |
: |
Data[n] |
: |
Checksum |
: |
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 (0x00NN) |
1, 2 |
Length (0x00NN) |
3, 4 |
Message Type (0x005A) |
3, 4 |
Message Type (0x005A) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
8 |
Query Entity 0x01 Call Progress Transmit Tone Frequency 0x02 Tone IDs (per DSP) 0x03 Global dBm level (per Tone Type) |
8, 9 |
Status (MSB, LSB) 0x04 Tone Not Found |
9 |
Data[0] The value of the message Data fields are dependent on the Query Entity, as shown below:
0x01 Call Progress Transmit Tone Frequency Data[0] Tone ID Value (1C) Data[1] 0x00 Data[2] 0x00
0x02 Call Progress Transmit Tone IDs per DSP For the MFDSP and DSP-ONE Cards: Data[0] DSP card slot number (015) Data[1] SIMM number (03) Data[2] DSP number (03)
0x03 Global dBm level per Tone Type Data[0] Tone Type (25) Data[1] 0x00 Data[2] 0x00 |
10 |
Data[0] The value of the response Data fields are dependent on the Entity, as shown below.
0x01 Frequency and Power Data[0] Entity Data[1] Tone ID Data[2] Number of Frequencies making up tone Data[3] Reserved Data[4] Frequency Value[0] Hz, MSB Data[5] Frequency Value[0] Hz, LSB Data[6] Frequency dBm[0], MSB Data[7] Frequency dBm[0], LSB : Data[...] Frequency Value[n] Hz, MSB Data[...] Frequency Value[n] Hz, LSB Data[...] Frequency dBm[n], MSB Data[n] Frequency dBm[n], LSB
0x02 Call Progress Transmit Tone IDs Data[0] Entity Data[1] Number of Tone IDs supported per DSP Data[2] DSP Channel Number Data[3] Tone ID : Data[...] DSP Channel Number Data[n] Tone ID
0x03 Global dBm Level The value of the data bytes depends on the tone
For Tone Type 2 (DTMF) Data[0] Entity Data[1] Tone Type Data[2] dBm level for low-band frequency Data[3] dBm level for low-band frequency Data[4] dBm level for high-band frequency Data[5] dBm level for high-band frequency
For Tone Types 35 Data[0] Entity Data[1] Tone Type Data[2] dBm level, MSB Data[3] dBm level, LSB |
|
0x04 Call Progress Receive Tone Frequency and
Data[0] Tone ID Value (0x0 - 0x11) Data[1] Tone Group (0x0 - 0x09) Data[2] Reserved
|
|
0x04 Call Progress Tone Receive Frequency and
Data [0] Query entity Data [1] Tone ID (0x0 - 0x11) Data [n++] Frequency value [n] Hz, MSB |
: |
Data[n] |
: |
Data[n] |
: |
Checksum |
: |
Checksum |
Example: Query Call Progress Transmit Tone Frequency and Power
This is an example of a message to query Call Progress Transmit Tone Frequency and Power per Tone ID for Tone ID Number 4 configured in the example for the Tone Configure message.
Byte |
Message Field |
Value |
0 |
Frame |
0xFE |
1, 2 |
Length |
0x0009 |
3, 4 |
Message Type |
0x005A |
5 |
Reserved |
0x00 |
6 |
Sequence Number |
SN |
7 |
Logical Node ID |
0xFF |
8 |
Query Entity |
0x01 |
9 |
Data[0]: Tone ID Value |
0x04 |
10 |
Data[1] |
0x00 |
11 |
Data[2] |
0x00 |
12 |
Checksum |
CS |
Byte |
Response Field |
Value |
0 |
Message Frame |
0xFE |
1, 2 |
Length |
0x0013 |
3, 4 |
Message Type |
0x005A |
5 |
Reserved |
0x00 |
6 |
Sequence Number |
SN |
7 |
Logical Node ID |
0xFF |
8, 9 |
Status (MSB, LSB) |
0x0010 |
10 |
Data[0]: Entity |
0x01 |
11 |
Data[1]: Tone ID being queried |
0x04 |
12 |
Data[2]: Number of frequencies making up tone |
0x02 |
13 |
Data[3]: Reserved |
0x00 |
14, 15 |
Data[4, 5]: Frequency Value[0] Hz (MSB, LSB) |
0x01B8 |
16, 17 |
Data[6, 7]: Frequency dBm[0] (MSB, LSB) |
0xFFF3 |
18, 19 |
Data[8, 9]: Frequency Value[n] Hz (MSB, LSB) |
0x010E |
20, 21 |
Data[10, 11]: Frequency dBm[n] (MSB, LSB) |
0xFFF3 |
22 |
Checksum |
CS |
Example: Query Call Progress Transmit Tone IDs
This is an example of a message to query Call Progress Transmit Tone IDs.
Byte |
Message Field |
Value |
0 |
Frame |
0xFE |
1, 2 |
Length |
0x0009 |
3, 4 |
Message Type |
0x005A |
5 |
Reserved |
0x00 |
6 |
Sequence Number |
SN |
7 |
Logical Node ID |
0xFF |
8 |
Query Entity |
0x02 |
9 |
Data[0]: MFDSP Card Slot Number |
0x01 |
10 |
Data[1]: SIMM Number |
0x02 |
11 |
Data[2]: DSP Number |
0x03 |
12 |
Checksum |
CS |
Byte |
Response Field |
Value |
0 |
Message Frame |
0xFE |
1, 2 |
Length |
0x000N |
3, 4 |
Message Type |
0x005A |
5 |
Reserved |
0x00 |
6 |
Sequence Number |
SN |
7 |
Logical Node ID |
0xFF |
8, 9 |
Status (MSB, LSB) |
0x0010 |
10 |
Data[0]: Entity |
0x02 |
11 |
Data[1]: Number of Tone IDs Supported |
0x0C |
12 |
Data[2]: DSP Channel Number |
0x0B |
13 |
Data[3]: Tone ID Value |
0x0C |
: |
: |
: |
N |
Checksum |
CS |