LoRa Basics Modem and LoRa Edge documentation

Scenario - Unclaiming a Device

Introduction

To use the LoRa Cloud™ Device Join service, a device with an LR111x chip must be claimed via the LoRa Cloud web portal or API. Once claimed, the device will be available for use by a LoRaWAN Network Server via a Join Request. To transfer a device to a new owner, the original owner must unclaim the device.

In contrast to join services where the join server is embedded in (or is programmatically tied to) a LoRaWAN network server, owners should understand that they will never see the root keys for the device. With the LoRa Cloud Device Join service, a PIN (an owner verification code) is provided as an authorization code for claiming a device. That device is then associated with the owner’s account.

Compatibility

LoRa Basics Modem

LoRa Basics Modem-E

Prerequisites

Common:

  • The owner of the device must have its DevEUI/ChipEUI.

Prerequisites for LoRa Basics™ Modem:

  • No additional requirements

Prerequisites for LoRa Basics Modem-E:

  • No additional requirements

Step-by-Step Procedure

  1. The device owner submits an unclaim request with DevEUI/ChipEUI data to the LoRa Cloud Device Join service via the API or the LoRa Cloud web portal.

  2. The LoRa Cloud Device Join service determines whether the device has been previously claimed and reserved for the owner who submitted the unclaim request.

  3. If claimed and reserved for the owner, the LoRa Cloud Device Join service returns a notice that the device has been successfully unclaimed.

  4. If not claimed or not reserved for the owner, the LoRa Cloud Device Join service returns a notice that the device has not been successfully unclaimed.

@startuml device_unclaimbox Device #LightBlue    participant "End-Device Application" as App #LightBlue    participant "<color #000000 >LR111x</color>" as LoRa  #00ADEF end box box LoRaWAN #AAAAAA    participant "Gateway" as GW #LightGrey    participant "Network Server" as NS  #LightGrayend boxbox LoRa Cloud Services #00ADEF     participant "<color #000000 >LoRa Cloud Device Join</color>" as JS #00ADEFend boxactor Owner as Owner #LightBluelegend left|=             |= Owner || <#00ADEF>    | Semtech || <#ADD8E6>    | Customer || <#D3D3D3>    | Ecosystem |endlegend== Unclaiming - Success ==Owner -> JS : DevEUI/ChipEUIJS -> Owner : OK== Unclaiming - Fail == Owner -> JS : DevEUI/ChipEUIJS -> Owner : Fail@enduml

Used By

Device owner

Troubleshooting

An unclaim request may fail for the following reasons:

  • There is a typo in the DevEUI/ChipEUI

  • The chip was never claimed

  • The chip has been claimed by a different owner

References