lora.device.find

The lora.device.find command is used to find and return a LoRa device.

TR50 Request

{
   "1":{
      "command":"lora.device.find",
      "params": {
	   "id": "500000000000000000000001"
	} 
   }
}

Request Parameters

Name Type Required Description
id String Yes* The ID of the LoRa device.
deviceEui String The value of the deviceEui field of the LoRa device.
thingId String The ID of the Thing that is related to the LoRa device.
thingKey String The thingKey of the device.
esn String The ESN of the device.
iccid String The ICCID of the device.
imei String The IMEI of the device.
imsi String The IMSI of the device.
meid String The MEID of the device.
msisdn String The MSISDN of the device.
thingId String The ID of the Thing that is related to the LoRa device.
*One of the above fields must be used to identify the device.

TR50 Response

If the command is sent successfully a success message is returned. Otherwise, an error and error message will be returned.

{
   "1":{
      "sucess":true,
      "params":{
	   "id":"500000000000000000000001",
	   "deviceEui":"3031323334353637",
	   "actType":"otaa",
	   "providerId":"520000000000000000000002",
	   "provider":{
		"deviceProfileId":"LORA/GenericA.1",
		"connectivityPlanId":"device/device-trial"
	    }
	}
   }
}
{  
   "1":{  
      "success":true,
      "params":{  
         "id":"500000000000000000000001",
         "orgId":"5c59b23a1c5bd9583789de03e",
         "sessionId":"5d38647f62397a4e31797252",
         "deviceEui":"3031323334353637",
         "sessionTimeout":86400,
         "actType":"otaa",
         "providerType":"actility",
         "providerId":"520000000000000000000002",
         "provider":{  
            "connectivityPlanId":"LORA/GenericA.1",
            "deviceProfileId":"device/device-trial",
            "ref":"822213"
         },
         "lastUplink":"2019-08-19T22:00:50.577Z",
         "serializedDownlinkCount":0,
         "backfilled":true,
         "createdOn":"2019-07-24T13:59:34.78Z",
         "createdBy":"SYSTEM",
         "updatedOn":"2019-07-24T13:59:34.78Z",
         "updatedBy":"SYSTEM"
      }
   }
}

Response Parameters

Name Type Description
Id String The ID of the Thing that is related to the LoRa device.
deviceEui String The device unique identifier.
sessionId String The ID of the current session the device has with deviceWISE Cloud.
orgId String The ID of the ORG the device is in.
actType String Activation type.
providerId String The ID of the LoRa provider.
sessionTimeout Integer The amount of time before the session will expire and the Lora device must reauthenticate with the IoT Portal. deviceWISE Cloud.
provider Array Provider specific information for the device.
providerType String The type of provider.
serializedDownlinkCount Integer The total number on messages sent to the device.
backfilled Boolean Indicates whether the device is added when the Lora provider is created.
lastUplink String The last time the device communicated over Lora.
createdBy String The user that created the record.
createdOn String The date and time of creation.
updatedBy String The user that last updated the record.
updatedOn String The date and time of the last update.