Hold Duration Value
Description
1
to
31536000
(one year)
The message will be considered expired if a Swarm satellite
has not come into view within the specified number of seconds.
The maximum duration is one year from the current time.
Any other value
An error message (
$TD ERR,0*xx
) is returned.
<expire_time>
is an epoch second date after which the message will be expired if it has not
been sent.
Hold Duration Value
Description
Any other value
An error message (
$TD ERR,0*xx
) is returned.
1577836800
to
4102444799
(2020-01-01 00:00:00 to
2099-12-31 23:59:59)
The message will be considered expired if the Tile is unable to
send it before the specified time. If the specified time is greater
than
1577836800
and less than or equal to the current UTC
time, the message will not be queued and an expired message
$TD HOLDTIMEEXPIRED,0*xx
will be returned immediately.
<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
BADDATA
message to be returned.
<msg_id>
is assigned by the Tile, 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 indicates the message has not been placed in the queue and therefore has no ID. The value
should be treated as a simple arbitrary number.
Example:
Sending a message from the Tile in ASCII:
June 2020
Swarm Tile Manual - Rev 1.00
62/63
