Network events
LoRa® network event
This event is generated by Live Objects platform when a LoRa® device or network perform an action. It is a specific event for LoRa® connectivity. If you don’t use this connectivity, you are not concern by this event.
For example, when a device sends a data without confirmation, a LoRa® network event is sent by the platform with the message type UNCONFIRMED_DATA_UP.
The LoRa® network event is a trigger type in Triggers and Actions feature. These events can be mapped to supported actions (HTTP push, fifo…).
The LoRa® network event is a JSON object. Please find below a description of its fields.
| Field | Description |
|---|---|
type |
loraNetwork. The type is set by Live Objects platform. |
version |
Version number. See the existing versions in the summary. |
timestamp |
The time stamp when the event is emitted. |
devEUI |
The global end-device ID (for more information, see the chapter 6.2.1 of https://lora-alliance.org/wp-content/uploads/2020/11/lorawan1.0.3.pdf). |
appEUI |
The global application ID (for more information, see the chapter 6.1.2 of https://lora-alliance.org/wp-content/uploads/2020/11/lorawan1.0.3.pdf). |
devNonce |
Counter incremented to each emitted Join-request (for more information, see the chapter 6.2.4 of https://lora-alliance.org/wp-content/uploads/2020/11/lorawan1.0.3.pdf). |
messageType |
Message type of message emitted by the LoRa® device (for more information, see the chapter 4.2.1 of https://lora-alliance.org/wp-content/uploads/2020/11/lorawan1.0.3.pdf). List of message types: "UNCONFIRMED_DATA_UP", "CONFIRMED_DATA_UP", "UNCONFIRMED_DATA_DOWN", "CONFIRMED_DATA_DOWN", "JOIN_REQUEST", "JOIN_ACCEPT" |
payload |
Payload sent by the device |
port |
The value of FPort field (for more information, see the chapter 4.3.2 of https://lora-alliance.org/wp-content/uploads/2020/11/lorawan1.0.3.pdf). |
signal |
The description signal of the best Long Range Router (LRR). Ten field are defined in the standard:
|
result |
Only available for JOIN_ACCEPT messages. Values : "success" |
rawJoinAccept |
Encoded message. This field is used only when the message type is "JOIN_ACCEPT" |
frameHeader |
The headers' description of the received frame
|
macCommands |
The list of MAC commands emitted by the LoRa® device. Each MAC command is described in according to two fields:
|
This is an example:
{
"type":"loraNetwork",
"version":1,
"timestamp":"2018-10-13T03:08:19.965Z",
"devEUI":"0123456789ABCDEF",
"messageType":"UNCONFIRMED_DATA_UP",
"payload":"00000100000000000000000100000002000000030000000400000005000000060000000",
"port":1,
"signal": {
"rssi":-114.0,
"snr":-9.0,
"esp":-123.51,
"sf":12,
"signalLevel":3,
"gatewayCnt":3
},
"frameHeader":{
"fcnt":13890,
"adr":true,
"ack":false,
"adrAckRequest":false,
"devAddr":"1000025A",
"framePending" : true/false <=== (1)
},
"macCommands":[
{
"type":"LinkADRAns",
"rawValue":"0307"
}
]
}| 1 | For downlinks only |
LoRa® gateway status event
This event is generated by Live Objects when a LoRa® gateway status is changing.
The LoRa® gateway status event is a JSON object. Please find below a description of its fields.
| Field | Description |
|---|---|
type |
loraGatewayStatus. This field is set by Live Objects in the routed event. |
version |
Version number. See the existing versions in the summary. |
gatewayId |
Gateway identifier. |
gatewayName |
Gateway name. |
status.current |
Current status of the gateway. Either "ONLINE", "OFFLINE" or "UNKNOWN". |
status.previous |
Previous status of the gateway. Either "ONLINE", "OFFLINE" or "UNKNOWN". |
timestamp |
Timestamp for the routing event. |