
2.0 Software
(Continued)
GL
Get Length
Returns the length of the current message in multiples of 32
bytes.
The returned value includes the message directory informa-
tion (64 bytes for the first block and 32 bytes for every other
block), message data, and the entire last block of the mes-
sage, even if the message occupies only a portion of the
last block. Since a flash block includes 4096 bytes, the re-
turned length may be bigger than the actual message length
by up to 4095 bytes.
The minimum length of a message is one block, i.e., an
empty message occupies 4 kbytes (the message length is:
4096/32
e
128).
Example
GL
Byte sequence:
Microcontroller
19 AA AA
CompactSPEECH 19 02
00
Description:
Get the length of the current message.
The CompactSPEECH responds:
512
i.e., the message occupies 16384 (512
*
32) bytes
GMS
Get Memory Statustype
Returns the estimated total remaining recording time in sec-
onds as a 16-bit unsigned integer. This estimate assumes
5.2 kbit/s with no silence compression: a real recording may
be longer, according to the amount of silence detected and
compressed.
The return value is dependent on the value of the type pa-
rameter as follows:
0: The remaining recording time is returned.
1: Returns 0. (For compatibility only.)
2: Same as 0. (For compatibility only.)
The return value is unpredictable for any other value oftype.
Example
GMS 0
Byte sequence:
Microcontroller
12 00 AA AA
CompactSPEECH 12 00 01
40
Description:
Return the remaining recording
time.
The CompactSPEECH responds:
320 seconds
GMT
Get Message Tag
Returns the 16-bit tag associated with the current message.
If the current message is undefined, ERRDVALID is report-
ed.
Example
GMT
Byte sequence:
Microcontroller
04 AA AA
CompactSPEECH 04 00 0E
Description:
Get the current message tag.
In a system where the message tag is
encoded as described in the DMS
command, the CompactSPEECH return
value indicates that the message is a new
ICM in mailbox Number 6.
GNM
Get Number of MessagestagDref tagDmask
Returns the number of messages whose message tags
match the tagDref parameter. Only bits set in tagDmask
are compared, i.e., a match is considered successful if:
message tag and tagDmask
e
tagDref and tagDmask
where and is a bitwise AND operation.
The tagDref and tagDmask parameters are each two
bytes; the return value is also 2-bytes long.
For example, if tagDref
e
42
16
, and tagDmask
e
3F
16
,
the number of existing old messages whose user-defined
tag is 2 is returned. See Section 2.6.1 for a description of
message-tag encoding. IftagDmask
e
0, the total number
of all existing messages is returned, regardless of the
tagDref value.
Example
GNM
FFFE 0003
Byte sequence:Microcontroller
11 FF FE 00 03 AA AA
CompactSPEECH 11 FF FE 00 03 00 05
Description:
Get the number of messages which have
bit 0 cleared, and bit 1 set, in their message
tags.
CompactSPEECH responds that there are
five messages which satisfy the request.
http://www.national.com
35