Status request / Status response

Messages of types status_request and status_response are intended to be used as an information messages about device battery status and RF parameters.

Status messages are implementing LoRaWAN MAC-command DevStatusReq / DevStatusAns functionality.

To retrieve a device status using DevStatusReq you should perform the following steps:

1. AS sends status_request message to NS.

2. NS retrieve information from the device and send it through status_response message to AS.

Let's walk through the sequence diagram to understand how status message flow works:

This is a sequence:

• AS sends status_request message to NS

• NS sends a downlink with DevStatusReq MAC command to the device

• NS receives an uplink with DevStatusAns MAC command from the device

• NS creates status_response message for AS and sends it

Status Request

Status request - this is a message of type status_request, that was sent from AS to NS.

Metadata

You should specify the following fields of status_request message metadata before sending it:

• device - device identifier (dev_eui)
• network - network identifier that this device belongs to

It is possible to specify a gateway as an option to ask NS downlink optimization engine to use a specific gateway to send downlink message. If this gateway is not active then request will not be sent.

Params

There are no parameters in this message.

Example

{
    "meta": {
        "network": "1a3f34a3",
        "device": "ba27356cb8a25961"
    },
    "type": "status_request"
}

Status Response

Status response - this is a message of type status_response, that is sent form NS to AS.

Params

Example

{
    "meta": {
        "network": "1a3f34a3",
        "packet_hash": "5e99eb9640ea76257911d3ebeb525b07",
        "application": "64649e06824532c7",
        "device_addr": "ac1ffea9",
        "time": 1504638907.180523,
        "device": "ba27356cb8a25961",
        "packet_id": "1c87b507b5fa4ef0f610d7f1befd593d",
        "gateway": "4adc2ea8e5a8fc8f"
    },
    "params": {
        "battery": 254.0,
        "snr": 20.0,
        "rx_time": 1504638907.171101
    },
    "type": "status_response"
}