Documentation

Mistake on this page? Email us

Request delivery modes

Device Management ensures command delivery to all devices, including low-bandwidth devices that may be available only occasionally, independent of the connectivity technology you use, using a queuing mechanism.

When an application or user issues a command:

  • For active mode devices, Device Management attempts to deliver the command immediately. If the device is not available, Device Management places the command in a queue.
  • For queue mode devices, Device Management places the message in a queue and attempts to deliver it when the device sends a registration update to Device Management.

For information about sending requests to devices and collecting data from devices, please see Collecting data from devices.

Guaranteed delivery to a queue mode device

In queue mode (UDP_QUEUE mode), a device tells the service not to call. For devices in this mode, Device Management attempts to deliver queued messages only when the device wakes up and registers to Device Management.

  1. A queue mode device registers to Device Management.
  2. The web application requests Device Management send a read command to the device.
  3. Device Management queues the command and responds with 202 Accepted.
  4. The device wakes up and connects to Device Management.
  5. Device Management looks for queued commands for the device and makes the first delivery attempt.
  6. The device receives and processes the first command and provides a response.
  7. Device Management sends an AsyncIDResponse event to the web application.
  8. If the queue contains additional commands, Device Management tries to send the next command. If the device does not respond, Device Management assumes the device went back to sleep and waits for the device to reconnect.

Guaranteed delivery to UDP_QUEUE mode device

Guaranteed delivery to an active mode device

For active mode devices (TCP mode), Device Management attempts to deliver a command to the device immediately:

  1. An active mode device registers and is assumed to be connected.
  2. The web application requests Device Management send a read command to the device.
  3. Device Management queues the command and responds with 202 Accepted.
  4. Device Management tries to deliver the command immediately to the device but discovers the device is not connected. If there is no response from the device within the set time, the delivery attempt stops. The command stays in the queue as the first item to be sent. Any subsequent requests from the web application are also added to the back of the queue for delivery.
  5. The device reconnects to Device Management.
  6. Device Management discovers queued commands and attempts to deliver the first command at the head of the queue.
  7. The device receives the command and provides a response.
  8. Device Management sends an AsyncIDResponse event to the web application.
  9. If the queue contains additional commands, Device Management tries to send the next command. If the device does not respond, Device Management assumes the device went back to sleep and waits for the device to reconnect.

Guaranteed delivery to TCP mode device