
2.0 Software
(Continued)
Bits 5–7
0
To generate a single-frequency tone encode
the bits as follows:
Bit 0
0
Bits 1–5
3–30
The value in bits 1–5 is multiplied by 100 to
generate
the
required
(300 Hz–3000 Hz).
frequency
Bits 6, 7
0
The CompactSPEECH does not check for the
validity of the tone specification. Invalid specifi-
cation yields unpredictable results.
Example
GT 0D20
Byte sequence:
Microcontroller
0D 20
CompactSPEECH 0D 20
Description:
Generate a single-frequency 1600 Hz
tone.
GTD
Get Time and DaytimeDdayDoption
Returns the time and day as a 2-byte value. timeDdayD
option may be one of the following:
0: Get the system time and day.
1: Get the current message time-and-day stamp.
Any other timeDdayDoption
stamp of the current message.
returns the time-and-day
Time of day is encoded as follows:
Bits 0–2
Day of the week (1 through 7).
Bits 3–7
Hour of the day (0 through 23).
Bits 8–13
Minute of the hour (0 through 59).
Bits 14–15
00: The time was not set before the current
message was recorded.
11: The time was set, i.e., the SETD (Set Time
of Day) command was executed.
Note:
If the current message is undefined, and timeDdayDoption is 1, an
ERRDINVALID error is reported.
Example
GTD 1
Byte sequence:
Microcontroller
0E 01 AA AA
CompactSPEECH 0E 01 E8 29
Description:
Get the current message time-and-day
stamp.
The CompactSPEECH responds that the
message was created on the first day of
the week at 5:40 AM. The return value
also indicates that the SETD command
was used to set the system time and day
before the message was recorded.
Note:
If the SAS command is used to announce the
time-and-day stamp, ‘‘Monday’’ is announced
as the first day of the week. For an external
vocabulary, the announcement depends on
the vocabulary definition.
(See theIVS User’s Manual for more
details.)
GTM
Get Tagged MessagetagDref tagDmask dir
Selects the current message, according to instructions in
dir, to be the first, n
th
next or n
th
previous message which
complies with the equation:
message tag and tagDmask
e
tagDref and tagDmask
where and is a bitwise AND operation.
dir is one of the following:
0:
Selects the first (oldest) message.
128: Selects the last (newest) message.
Selects the n
th
next message starting from the cur-
rent message.
Selects the n
th
previous message starting from the
current message.
n:
-n:
Note:
To select the nth message with a given tag to be the current mes-
sage you must first select the first message that complies with the
above equation, and then issue another GTM command with n
b
1
as a parameter, to skip to the nth message.
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 command execution the current
message may either remain undefined or change to any existing
message. The only exception is when the GTM command is exe-
cuted just after the DM command. (See the DM command descrip-
tion for further detail.)
To access the nth message, when n
l
127, a sequence of GTM
commands is required.
http://www.national.com
37