Simplified provisioning of OTAA devices using a QR code
This is the simplified, most secure way to protect your network.
LoRa Alliance™ defines a standard device onboarding tag to simplify device provisioning step. This tag is typically printed as a QR code via a sticker pasted on the device. It allows the user to scan one or several devices with a mobile phone, a tablet or a code scanner.
The tag content includes the following mandatory information elements:
DevEUI: unique device identifier (8 bytes),
JoinEUI: unique identifier of the LoRaWAN® Join Server where the device has been pre-commissioned (8 bytes),
ProfileID: identifier of the device model to be associated with the device.
The tag may also include the owner token as an optional element. This element is provided when devices are pre-commissioned on an external Join Server by the device manufacturer. It is then used by the device owner as a proof of physical ownership during commissioning step in ThingPark Enterprise.
To learn more about QR codes, see QR codes.
Provisioning a device using an onboarding tag
To create a device using an onboarding tag, users can either:
Use a physical QR code scanner connected to the PC or tablet of the user.
Click on the camera button to open the camera QR code scanner. This option is specifically relevant for tablet users.
Copy/paste an onboarding tag to the text bar.
Note Onboarding tags can also be used for mass import of OTAA devices. To learn more, see Sample import files.
Scanning a QR code using a physical scanner
Click Devices, then Create.
Scan the QR code with the physical scanner.
-> You are redirected to the device creation form, filled with all data extracted from the QR code. This looks like this:
Note The device model is automatically filled if there is a one-to-one match between the ProfileID read from the QR code and the DeviceProfileID available in ThingPark catalog. If several profiles match the onboarding tag's ProfileID, you may manually select the proper model.
Note The device name is set to the DevEUI by default. You may change it as needed.
Go to the next step in Suite of devices' activation tasks using the device creation form
Scanning a QR code using the camera
Click Devices, then Create.
Click the
button in Using an onboarding tag section.-> If you are clicking for the first time, your browser may ask you to allow access to the camera. In that case, grant the access.
-> If your tablet or mobile phone has several cameras, you can select the one you want to use in the drop-down list on top of the QR code camera scanner.
Scan the QR with the camera.
-> You are redirected to the device creation form, filled with all data extracted from the QR code. This looks like this:
Note The device model is automatically filled if there is a one-to-one match between the ProfileID read from the QR code and the DeviceProfileID available in ThingPark catalog. If several profiles match the onboarding tag's ProfileID, you may manually select the proper model.
Note The device name is set to the DevEUI by default. You may change it as needed.
Go to the next step in Suite of devices' activation tasks using the device creation form
Pasting an onboarding tag
To perform this task, you first need to copy an onboarding tag. An onboarding tag is a serial of characters composed of JoinEUI, DevEUI, ProfileID, Owner-token (in the case of an Over-the-Air activation with an external Join Server), serial and proprietary numbers. It looks like this: LW:D0:1122334455667788:AABBCCDDEEFF0011:AABB1122:OAABBCCDDEEFF:SYYWWNNNNNN:PFOOBAR:CAF2C
Click Devices, then Create.
Paste a previously copied onboarding tag.
Press
Enter.-> You are redirected to the device creation form, filled with all data extracted from the QR code. This looks like this:
Note The device model is automatically filled if there is a one-to-one match between the ProfileID read from the QR code and the DeviceProfileID available in ThingPark catalog. If several profiles match the onboarding tag's ProfileID, you may manually select the proper model.
Note The device name is set to the DevEUI by default. You may change it as needed.
Go to the next step in Suite of devices' activation tasks using the device creation form
Suite of devices' activation tasks using the device creation form
If the permission segregation based on domains has been enabled by an Administrator user, associate your device with domains. If your user account has domain restrictions, the associated domains must match your domain restrictions without any domain prefix (only full domains can be assigned to resources). See Domains for more details.
Associate your device to your connection. A device can be associated with several connections.
- In the 'Associate Your Device With Your Connection's section, choose an existing connection in the list that you want to associate with your device.
Depending on the device location mode:
Either choose the Network geolocation mode, if you want the network to estimate the location of your device. The device must be within the range of at least three base stations to be located.
-> The network geolocation mode display looks like this:
Select one of the motion speeds that your device may take to improve its location precision. Example: if the device tracks a parcel, select vehicle speed.
Or choose the manual mode, if you want to manually configure the static position of your device.
-> The manual mode display looks like this:
Set the location using one of the following possibilities:
Either use the Search box on the top of the map using the geocoding service.
Place the marker on the map.
Set the latitude and longitude in text input above the map. The compass button allows the switch between decimal and degree minute second format).
Note The marker position and latitude/longitude inputs are synchronized by the GUI, that is, if you move the marker, the latitude/longitude is automatically updated.
Note You may use Google Maps, other supported maps or GPS geographical coordinates. If the location using Google Maps does not display, it means that the Google Maps API key has not been installed on the platform. In this case, only the latitude/longitude input is displayed.
Enable the roaming if you want your device to roam away seamlessly from home and uses base stations of the visited network to reach its home network.
Note The roaming functionality is optional on self-hosted ThingPark Enterprise. It may be activated via Cockpit. For activation-deactivation through Cockpit, contact your System Integrator.
-> The default roaming display looks like this:
If you want to create another device with the same model, activation mode, connections, additional information, JoinEUI and location mode and position, tick the Create another box.
Click Create to finish the creation process of the device.
-> If you tick the Create another box in step 5, you are redirected to the device creation page. Otherwise, your device has been successfully created.