
2-44
2—SOFTWARE
ISD-SR3000
Voice Solutions in Silicon
Note
: If a message is found, it becomes the current message and 1 (TRUE) is returned. If no message is
found, the current message remains unchanged and 0 (FALSE) is returned.
If Dir is not 0, and the current message is undefined, the return value is unpredictable. After the com-
mand execution, the current message may either remain undefined or change to any existing mes-
sage. The only exception is when the GTM command is executed just after the DM command. (See
the DM command for further details.)
Example
: Assuming the user arranged the message tag as an indication number received from the AAW
command (using the upper byte to notate the topic number and the lower byte as the token number), the
following will set the message pointer to the message with Tag_Ref = [0x02 0x06],
n
oting a previously
added voice tag message associated with acoustic word 6 in topic 2. The results show that the pointer is
set to the desired message
.
GTM
Get Tagged Message
Opcode:
0x09
Syntax:
GTM Tag_Ref Tag_Mask Dir [Result]
Type:
Synchronous
Description:
Selects the current message, according to instructions in Dir, to be the first, nth next or
nth previous message, which complies with the equation:
message tag
and
tag_mask
=
tag_ref
and
tag_mask
where “and” is a bitwise AND operation.
Dir is one of the following:
0: Selects the first (oldest) message.
-64: Selects the last (newest) message.
n: Selects the nth next message starting from the current message.
–n: Selects the nth previous message starting from the current message.
To select the nth message with a given tag to be the current message, you must first
select the first message that complies with the above equation, and then issue another
GTM command with n – 1 as a parameter, to skip to the nth message.
The result value Result reports 1 when the message pointer is set. If the message
pointer is not set, Result reports 0.
Parameters:
Tag_Ref (2 bytes), Tag_Mask (2 bytes), Dir (1 byte) and Result (1 byte)
Source
Byte Sequence
Code
GTM 0206 FFFF 00 AA
Host Controller
09
02
06
FF
FF
00
AA
ISD-SR3000
09
02
06
FF
FF
00
01