
NO.:
W62410 API
VERSION:
A
PAGE
30
0.14 The MonitorLine command.
Description:
The
MonitorLine
command allows the host to monitor the telephone line for various telephony
signals like the presence of signals, call progress tones and incoming DTMF tones. Every 30 ms
the CHIPSET updates the status of the line monitor status register. By repeated sending of this
command, the host can have an accurate idea of the status of the telephone line at that moment.
The “C” return parameter becomes and stays “1” when there has been a continuous tone detected,
within the frequency band of 300 Hz to 720 Hz and exceeding the preset threshold (“continuous
tone coefficient” parameter). The “C” flag will only be set when at least “continuous tone time”
number of successive frames of 30 milliseconds have exceeded the threshold setting. If this
continuous tone stops, this flag will be immediately reset to “0”. The default number for
“continuous tone time” is 10. So the “C” flag will become high when at least 0.3 seconds of
continuous tone has been detected.
The “P” return parameter
becomes immediately “1” if a tone has been detected within the
frequency range of 300 Hz to 720 Hz and exceeded the preset threshold (“continuous tone
coefficient” parameter). This flag stays “1” as long as this tone exceeded the preset threshold,
otherwise it is immediately reset again.
The “V” return parameter is very similar to the “P” return parameter. The difference is that the
frequency range is now the full frequency range of 0 Hz to 4 kHz to detect the presence of tones
and the “V” flag will be set high when the “VAD threshold” has been exceeded.
The “D” return parameter becomes “1” as soon as one or more DTMF tones have been detected.
The DTMF code is stored in a 16 level deep FIFO buffer. Therefore, this flag stays high, as long
as there is DTMF data present in the FIFO buffer. Due to the FIFO buffer, it is not necessary for
the host to check the telephone line at a very rapid rate. The FIFO buffer takes care that no
DTMF codes will be lost (the DTMF codes are stored in chronological order). Each time the D
flag is set high the four bits of the DTMF field contains a valid DTMF code. This code is then
removed out of the FIFO buffer freeing up place for a new DTMF code to be received. The host
has nothing to do to manage the DTMF FIFO buffer. Everything is automatically handled by the
CHIPSET.
The “K” will be set high when there is currently a DTMF tone detected. This flag can be useful
when a detection of the end of a DTMF tone is required (like a key-release function). Be careful
that the detection of the DTMF tone has no relevance to the eventual DTMF codes already
residing inside the DTMF FIFO buffer of the CHIPSET.
The “W” return parameter is set high when a recording of an ICM approaches the end of the
maximum allowed recording time. See the
SetMaxLengthRecording
command for more
explanation of this feature.
The “I” and “F” return parameters are related to the CallerID support of the CHIPSET. If an
incoming CallerID has been decoded then the “I” flag is set high. However, it is possible that the
CallerID information has been badly decoded because of bad telephone line conditions. If so,
then the CRC inside the CallerID information will reflect this. If the calculated CRC by the
CHIPSET is different from the received CRC then the “F” flag will be set high to indicate a
potential corrupt CallerID message.
The “Vp” flag will be set high as long as there are voice prompts playing.
Some of the above return parameters can be very useful to decide if a telephone message has
been ended and thus to stop the recording.
Command
High Byte
MonitorLine
0
0
0
0
0
Returned value
High Byte
Status
V
p
K W I
F
Remarks:
V
p
= Will be set high when a voice prompt is playing. It will be reset to zero when the
voice prompt has finished playing.
K
= 1 bit, when set high a DTMF detection is in progress.
The above information is the exclusive intellectual property of Winbond Electronics and shall not be
disclosed, or reproduced without permission from Winbond.
Low byte
0
0
0
0
0
0
0
1
1
1
0
Low byte
0
0
V 0 C P D
DTMF