LORIOT AG is a Swiss start-up in the field of Internet of Things, founded in 2015. Loriot offers a complete end-to-end solution for real-world IoT applications, including gateway and sensor hardware. Typical customers are small and medium enterprises in the Internet of Things business, cities, municipalities and wirelessetwork operators.
Using Loriot with Cayenne
Cayenne makes it easy to use your LoRa device and the Loriotetwork. You will need to:
- Create / Log into your account on Loriot's portal
- Setup gateway device
- Create Cayenne Data Output
- Register your device on the Loriot portal
- Program/Flash your device
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
Note: For the examples and information shown in this section we will assume that you are using the US server. You will find the same information on whatever server you choose, just note that some of the URLs linked in this section will be different based on the server you use.
Log into the Loriot portal
To create your Loriot account, visit the Loriot Account Registration page. From here you can enter in all the required details for creating your account, including which server you will be using.
NOTE: Loriot has many servers that you can use, but you will need an account on each of them in order to use that server.
#Setup gateway device
In order for your LoRa technology devices to connect to the Loriotetwork, you must have purchased and configured a gateway device. Loriot has a Gateway page with costs and recommendations. Once you have purchased the gateway you want to use, Loriot offers guides for how to set it up for use. When logged into your account, refer to the Documentation > Gateways section on the Loriot portal for information.
Be sure that you have an appropriate Loriot gateway configured and working before continuing. Your devices will not be able to properly function without your gateway device in place.
#Create Cayenne Data Output
In order for data from your device to reach Cayenne, you must configure your devices in the Loriot portal to forward data to Cayenne. The Loriot portal groups devices in what they call Applications. If you want to use a group of devices with Cayenne, you will need to perform some configuration on the portal. You only need to perform this step once for each Application that you want to use. To set this up, click on the Applications button in the portal. The Network Applications screen appears.
From the Network Applications screen, click on theame of the Application that you want to configure. This will open the dashboard for your Application.
From the Application screen for your device, find the Data Output option and click on the Edit Output button to change it. The Application Output screen will appear.
On the Application Output screen,ext to the Data Output option select the Change button and a list of output types will appear. From the list of types, select the myDevices Cayenne option and then click on the Confirm change button to save the change.
#Manually register device
Before you can use your device on the Loriotetwork, it must be registered on the network. If you need to regsiter your device with Loriot, the following information will help guide you through this process using Loriot's portal.
Devices must be added into an Application in the Loriot portal. To enroll a new device, click on Applications and then select which Application your device will be added to. This will open your application's dashboard.
From the application dashboard screen, click on Managed devices and the Devices screen appears. From the Devices screen, you can enrollew devices or you can import existing devices.
#Enroll new device
Loriot makes enrolling a new device easy, all you need is the DevEUI for your device.
If you know your DevEUI
If you know the DevEUI for your device, select Enroll new device. In the Enroll screen that appears, enter in your DevEUI into the Device EUI field and click the Enroll button. Loriot will take care of assigning all other keys (APPKEY, APPSKEY, NWKSKEY) and identifiers (DevAddr) for your device automatically.
If you don't know your DevEUI
If you don't know your DevEUI, click on Generate new device. Loriot will generate your device's DevEUI and all other keys and identifiers needed and then add a device entry into your list of devices.
#Import existing device
If you have existing devices, select either the Import existing OTAA or Import existing ABP button, depending upon whether your devices use Over the Air Activation or Activation by Personalization. You will then need to enter in all of the required information for your device.
Note: You will only use this feature if you have an existing device deployed in the field and areot able to re-personalize the device. In all other cases, you will want to use the new device enrollement process.
#Programming the device
Some devices will come from your device supplier preprogrammed and ready to be used immediately. Other devices will require you to program the device manually. If your device is preprogrammed, it canow be deployed and connected to the network for usage.
If your device needs to be programmed, you shouldow proceed with programming/flashing the device. Because this process is different for each device, you should refer to the instructions for your device for any specific information you need to perform this step. If you need help, you can refer to the Supported devices section where you will find Product page, Datasheet and User Guides for your device.
NOTE: Be sure that your device is programmed and properly connected to the network at this time. Only after your device is programmed, online and properly forwarding data should you proceed with adding your device to Cayenne.
#Add device to Cayenne
Once your device has been registered, programmed, configured to forward data to Cayenne and is online, you can proceed with adding the device in Cayenne so that it appears in your dashboard.
From the Cayenne Dashboard, click Add New > Device / Widget.
From the list of devices & widgets that appears, select the LoRa category and then the Loriot Network option to view a list of Loriot supported devices.
After selecting the device that you wish to add, settings for that device will appear. In the following section, we’ll walk you through the settings needed for adding a previously registered device.
If your device has been previously registered on the Loriotetwork, it can be quickly & easily added to Cayenne. Once added, your device and all of its sensors will appear in your dashboard.
Items you will need:
- Which LoRa technology device is being added?
- Your device will need to have been previously registered on the network. Refer to Manual device registration if you need help with manually registering your device on a network.
- What is the unique DevEUI for the device being added?
- What is your Loriot Application ID? You can obtain your App ID from your Application's dashboard on the Loriot portal.
- What is your Loriot Security Token? Yuu can obtain your Token by clicking on Security tokens from your Application's dashboard on the Loriot portal.
To see how easy it is, let’s walk through an example of connecting an Adeunis Pulse which was previously registered under an Loriot account.
1. Choose the Network
Make sure the Loriot network is selected in the list of Networks.
2. Select the Device
Select your device from among the list supported Loriot devices. In this case, we’ll select the Adeunis Pulse.
3. Enter Settings & Add device
In order to add the device, Cayenne needs to know some information about the device and how it will be shown on the dashboard.
- Give the device aame. In our case, we’ll enter “LoRa Pulse” in the Name field.
- Enter the DevEUI for this device into the DevEUI field.
- Our device has been previously manually registered with Loriot. Make sure “Already Registered” is selected in the Activation Mode field.
- Select which server your device uses from the Loriot Server dropdown.
- Enter in the Loriot App ID for the Application this device uses on the Loriot portal.
- Enter in the Loriot Token for the Application this device uses on the Loriot portal.
- Click Add device.
The Pulse has been added to your dashboard and Cayenne will automatically add widgets for the sensors on the device. You can now track the location of your device as well as examine the current status of the water, gas, electricity & heat sensors on the device.