<expire_time>
is an epoch second date after which the message will be expired if it has not
been sent.
Expiration Time Value
Description
<cur_time> + 60 secs
to
<cur_time> + 34819200
secs
The message will be considered expired if not sent before
the specified time. The epoch seconds must lie between
60 seconds in the future and 13 months in the future. If not
within this range an error will indicate it is too short or too
long.
<string|data>
may be expressed one of two different ways. If all the data to be sent is in the
ASCII character range from 0x20 (space) to 0x7e (tilde), then the data may be sent as a string.
A string is specified by enclosing the data in double quotes, e.g., "Hello, world". It is permissible
for the string to contain double quotes within the string, e.g., "Today is a "new" day". If the data
to be sent includes one or more character outside the 0x20 to 0x7e range, then it must be
specified as pairs of hex characters ('0'..'9', 'A'..'F', 'a'..'f'), and must be a multiple of 2. Sending
'Hello' as hex would be 48656C6C6F. Illegal characters or an odd number of characters will
cause a
CMD_BADPARAMVALUE
message to be returned.
<msg_id>
is assigned by the device, and is an unsigned 64-bit value comprised of the device
ID, a day of year counter, and a message of day counter. Responses that have a 0 as the
message ID indicate the message has not been placed in the queue and therefore has no ID.
The value should be treated as a simple arbitrary number.
© 2022 SWARM TECHNOLOGIES
SWARM M138 MODEM PRODUCT MANUAL · REV 1.20 · FEBRUARY 2022
PAGE
77
