LoRa is a wireless technology developed to create the low-power, wide-area networks (LPWANs) required for machine-to-machine (M2M) and Internet of Things (IoT) applications. The technology offers a very compelling mix of long range, low power consumption and secure data transmission and is gaining significant traction in IoT networks being deployed by wireless network operators.
A network based on LoRa wireless technology can provide coverage that is greater in range compared to that of existing cellular networks. In fact, many mobile network operators have chosen to complement their existing cellular/wireless networks with a LPWAN based on LoRa technology because it is easy to plug into their existing infrastructure and also allows them to offer their customers a solution to serve more IoT battery-operated applications.
LoRa technology originally developed by Semtech is now utilized by the over 400 members of the LoRa Alliance, a non-profit organization focused on standardizing LoRa Technology for IoT/M2M and creating a strong ecosystem to scale the technology. To date, the alliance has developed a global LPWAN specification, known as LoRaWAN™, to help standardize LPWANs and foster the adoption of these networks to enable IoT, M2M, smart city, and industrial applications.
LoRaWAN™ is a protocol specification based on the LoRa technology developed by the LoRa Alliance. LoRaWAN targets the basic needs of LoRa usage for IoT by providing Addressing, Routing and Security.
Topology of a LoRaWAN network consists of several elements.
- End Nodes: End nodes are elements such as sensors, which are usually remotely located.
- Concentrator / Gateway: Gateways are access points for for end nodes (e.g. sensors), aggregating data and communicating that data to a central network server via standard IP connections. Several gateways can be co-located in an area and can transparently share a single connection to the network server.
- Network Server: The LoRa Network Server acts to eliminate duplicate packets, manages security and data rates.
- Application Server: Application Servers manage payload security and performs analysis to utilize sensor data. Cayenne operates as an Application Server.
LoRa devices have a unique identifier (DevEUI) that is assigned to the device by the chip manufacturer. This identifier is used to uniquely identify the device on the network. Cayenne will need to know the DevEUI for your device, regardless of whether it is already registered, or if the device needs to be activated for the first time.
The Cayenne Low Power Payload (LPP) provides a convenient and easy way to send data over LPWAN networks such as LoRaWAN. The Cayenne LPP is compliant with the payload size restriction, which can be lowered down to 11 bytes, and allows the device to send multiple sensor data at one time.
Additionally, the Cayenne LPP allows the device to send different sensor data in different frames. In order to do that, each sensor data must be prefixed with two bytes:
- Data Channel: Uniquely identifies each sensor in the device across frames, eg. “indoor sensor”
- Data Type: Identifies the data type in the frame, eg. “temperature”.
| 1 Byte | 1 Byte | N Bytes | 1 Byte | 1 Byte | M Bytes | ... |
| Data1 Ch. | Data1 Type | Data1 | Data2 Ch. | Data2 Type | Data2 | ... |
A downlink message can be sent from the Cayenne dashboard to the end node in order to perform some action on that device. Before being able to send a downlink command, the user must first inform Cayenne of the current state of the actuator by sending an uplink message using either the Analog Output or Digital Output data types. Upon receiving the uplink message, Cayenne will automatically populate the appropriate actuator widget (Analog = Slider Widget, Digital = Button Widget) on the specified channel.
When the user sends the message to the device by either clicking the button or moving the slider, Cayenne will encode the message using the following payload structure:
| 1 Byte | 2 Bytes | 1 Byte |
| Data Ch. | Data (.01 Precision) | 0xff |
The message will then be routed to the network server where it will sit in a queue until the next uplink message is sent by the device (Class A devices only). Once released from the queue, the device will accept the downlink message and the corresponding action will take place. At this point, the device should send another uplink message confirming the current state of the actuator.
For digital output, the button widget will remain in a loading state until the device confirms the updated state by sending a new uplink message on the corresponding channel.
Data Types conform to the IPSO Alliance Smart Objects Guidelines, which identifies each data type with an “Object ID”. However, as shown below, a conversion is made to fit the Object ID into a single byte.
LPP_DATA_TYPE = IPSO_OBJECT_ID - 3200
Each data type can use 1 or more bytes to send the data according to the following table.
| Type | IPSO | LPP | Hex | Data Size | Data Resolution per bit |
| Digital Input | 3200 | 0 | 0 | 1 | 1 |
| Digital Output | 3201 | 1 | 1 | 1 | 1 |
| Analog Input | 3202 | 2 | 2 | 2 | 0.01 Signed |
| Analog Output | 3203 | 3 | 3 | 2 | 0.01 Signed |
| Illuminance Sensor | 3301 | 101 | 65 | 2 | 1 Lux Unsigned MSB |
| Presence Sensor | 3302 | 102 | 66 | 1 | 1 |
| Temperature Sensor | 3303 | 103 | 67 | 2 | 0.1 °C Signed MSB |
| Humidity Sensor | 3304 | 104 | 68 | 1 | 0.5 % Unsigned |
| Accelerometer | 3313 | 113 | 71 | 6 | 0.001 G Signed MSB per axis |
| Barometer | 3315 | 115 | 73 | 2 | 0.1 hPa Unsigned MSB |
| Gyrometer | 3334 | 134 | 86 | 6 | 0.01 °/s Signed MSB per axis |
| GPS Location | 3336 | 136 | 88 | 9 | Latitude : 0.0001 ° Signed MSB |
| Longitude : 0.0001 ° Signed MSB | |||||
| Altitude : 0.01 meter Signed MSB |
| Payload (Hex) | 03 67 01 10 05 67 00 FF | |
| Data Channel | Type | Value |
| 03 ⇒ 3 | 67 ⇒ Temperature | 0110 = 272 ⇒ 27.2°C |
| 05 ⇒ 5 | 67 ⇒ Temperature | 00FF = 255 ⇒ 25.5°C |
Frame N
| Payload (Hex) | 01 67 FF D7 | |
| Data Channel | Type | Value |
| 01 ⇒ 1 | 67 ⇒ Temperature | FFD7 = -41 ⇒ -4.1°C |
Frame N+1
| Payload (Hex) | 06 71 04 D2 FB 2E 00 00 | |
| Data Channel | Type | Value |
| 06 ⇒ 6 | 71 ⇒ Accelerometer | X: 04D2 = +1234 ⇒ +1.234G |
| Y: FB2E = -1234 ⇒ -1.234G | ||
| Z: 0000 = 0 ⇒ 0G | ||
| Payload (Hex) | 01 88 06 76 5f f2 96 0a 00 03 e8 | |
| Data Channel | Type | Value |
| 01 ⇒ 1 | 88 ⇒ GPS | Latitude: 06765f ⇒ 42.3519 |
| Longitude: F2960a ⇒ -87.9094 | ||
| Altitude: 0003E8 ⇒ 10 meters | ||
| Payload (Hex) | 01 00 64 ff | |
| Data Channel | Value | Reserved |
| 01 ⇒ 1 | 0064 ⇒ 1.00 | ff ⇒ reserved |
For full information about IPSO Smart Objects, see http://www.ipso-alliance.org/.
IPSO Smart Objects are based on the object model specified in OMA LightWeight M2M [1] Chapter 6,
Identifiers and Resources.
An IPSO Smart Object is a specified collection of reusable resources (See Table 2, Reusable Resources)
that has a well-known object ID (See Table 1, Smart Objects) and which represents a particular type of
physical sensor, actuator, connected object or other data source. The reusable resources,which make up
the Smart Object, represent static and dynamic properties of the connected physical object and the
embedded software contained therein.
This document defines a set of IPSO Smart Objects, which conform to the OMA LWM2MObject Model, and
which can be used as data objects, or web objects, to represent common sensors, actuators, and data
sources.
Although OMA LWM2M is based on the IETF CoAP [2] protocol, these objects may be used with other
transport protocols (e.g. HTTP [3] with REST [4]) by supporting the Content-Types and access methods
defined in [1].
IPSO Smart Objects Guideline - Starter Pack - Version 1.0 ©2014 IPSO Alliance
The following section provides information extracted from the IPSO Smart Objects specifications. It includes all of the Data Types (object ID) that can be used with Cayenne LPP. Therefore, the current implementation is limited to the data types listed in the Data Types section.
For full specification, see http://www.ipso-alliance.org/so-starter-pack/.
For full specification, see http://www.ipso-alliance.org/so-expansion-pack/.
#define LPP_DIGITAL_INPUT 0 // 1 byte
#define LPP_DIGITAL_OUTPUT 1 // 1 byte
#define LPP_ANALOG_INPUT 2 // 2 bytes, 0.01 signed
#define LPP_ANALOG_OUTPUT 3 // 2 bytes, 0.01 signed
#define LPP_LUMINOSITY 101 // 2 bytes, 1 lux unsigned
#define LPP_PRESENCE 102 // 1 byte, 1
#define LPP_TEMPERATURE 103 // 2 bytes, 0.1°C signed
#define LPP_RELATIVE_HUMIDITY 104 // 1 byte, 0.5% unsigned
#define LPP_ACCELEROMETER 113 // 2 bytes per axis, 0.001G
#define LPP_BAROMETRIC_PRESSURE 115 // 2 bytes 0.1 hPa Unsigned
#define LPP_GYROMETER 134 // 2 bytes per axis, 0.01 °/s
#define LPP_GPS 136 // 3 byte lon/lat 0.0001 °, 3 bytes alt 0.01m
// Data ID + Data Type + Data Size
#define LPP_DIGITAL_INPUT_SIZE 3
#define LPP_DIGITAL_OUTPUT_SIZE 3
#define LPP_ANALOG_INPUT_SIZE 4
#define LPP_ANALOG_OUTPUT_SIZE 4
#define LPP_LUMINOSITY_SIZE 4
#define LPP_PRESENCE_SIZE 3
#define LPP_TEMPERATURE_SIZE 4
#define LPP_RELATIVE_HUMIDITY_SIZE 3
#define LPP_ACCELEROMETER_SIZE 8
#define LPP_BAROMETRIC_PRESSURE_SIZE 4
#define LPP_GYROMETER_SIZE 8
#define LPP_GPS_SIZE 11
This chapter describes the C++ class definition of the reference myDevices implementation, followed with by the implementation details.
class CayenneLPP {
public:
CayenneLPP(uint8_t size);
~CayenneLPP();
void reset(void);
uint8_t getSize(void);
uint8_t* getBuffer(void);
uint8_t copy(uint8_t* buffer);
uint8_t addDigitalInput(uint8_t channel, uint8_t value);
uint8_t addDigitalOutput(uint8_t channel, uint8_t value);
uint8_t addAnalogInput(uint8_t channel, float value);
uint8_t addAnalogOutput(uint8_t channel, float value);
uint8_t addLuminosity(uint8_t channel, uint16_t lux);
uint8_t addPresence(uint8_t channel, uint8_t value);
uint8_t addTemperature(uint8_t channel, float celsius);
uint8_t addRelativeHumidity(uint8_t channel, float rh);
uint8_t addAccelerometer(uint8_t channel, float x, float y, float z);
uint8_t addBarometricPressure(uint8_t channel, float hpa);
uint8_t addGyrometer(uint8_t channel, float x, float y, float z);
uint8_t addGPS(uint8_t channel, float latitude, float longitude, float meters);
private:
uint8_t *buffer;
uint8_t maxsize;
uint8_t cursor;
};
CayenneLPP::CayenneLPP(uint8_t size) : maxsize(size)
Initialize the payload buffer with the given maximum size.
{
buffer = (uint8_t*) malloc(size);
cursor = 0;
}
CayenneLPP::~CayenneLPP(void)
{
free(buffer);
}
void CayenneLPP::reset(void)
Reset the payload, to call before building a frame payload
{
cursor = 0;
}
uint8_t CayenneLPP::getSize(void)
Returns the current size of the payload
{
return cursor;
}
uint8_t CayenneLPP::getBuffer(void)*
Return the payload buffer
{
return buffer;
}
uint8_t CayenneLPP::copy(uint8_t dst)*
{
memcpy(dst, buffer, cursor);
return cursor;
}
uint8_t CayenneLPP::addDigitalInput(uint8_t channel, uint8_t value)
{
if ((cursor + LPP_DIGITAL_INPUT_SIZE) > maxsize) {
return 0;
}
buffer[cursor++] = channel;
buffer[cursor++] = LPP_DIGITAL_INPUT;
buffer[cursor++] = value;
return cursor;
}
uint8_t CayenneLPP::addDigitalOutput(uint8_t channel, uint8_t value)
{
if ((cursor + LPP_DIGITAL_OUTPUT_SIZE) > maxsize) {
return 0;
}
buffer[cursor++] = channel;
buffer[cursor++] = LPP_DIGITAL_OUTPUT;
buffer[cursor++] = value;
return cursor;
}
uint8_t CayenneLPP::addAnalogInput(uint8_t channel, float value)
{
if ((cursor + LPP_ANALOG_INPUT_SIZE) > maxsize) {
return 0;
}
int16_t val = value * 100;
buffer[cursor++] = channel;
buffer[cursor++] = LPP_ANALOG_INPUT;
buffer[cursor++] = val >> 8;
buffer[cursor++] = val;
return cursor;
}
uint8_t CayenneLPP::addAnalogOutput(uint8_t channel, float value)
{
if ((cursor + LPP_ANALOG_OUTPUT_SIZE) > maxsize) {
return 0;
}
int16_t val = value * 100;
buffer[cursor++] = channel;
buffer[cursor++] = LPP_ANALOG_OUTPUT;
buffer[cursor++] = val >> 8;
buffer[cursor++] = val;
return cursor;
}
uint8_t CayenneLPP::addLuminosity(uint8_t channel, uint16_t lux)
{
if ((cursor + LPP_LUMINOSITY_SIZE) > maxsize) {
return 0;
}
buffer[cursor++] = channel;
buffer[cursor++] = LPP_LUMINOSITY;
buffer[cursor++] = lux >> 8;
buffer[cursor++] = lux;
return cursor;
}
uint8_t CayenneLPP::addPresence(uint8_t channel, uint8_t value)
{
if ((cursor + LPP_PRESENCE_SIZE) > maxsize) {
return 0;
}
buffer[cursor++] = channel;
buffer[cursor++] = LPP_PRESENCE;
buffer[cursor++] = value;
return cursor;
}
uint8_t CayenneLPP::addTemperature(uint8_t channel, float celsius)
{
if ((cursor + LPP_TEMPERATURE_SIZE) > maxsize) {
return 0;
}
int16_t val = celsius * 10;
buffer[cursor++] = channel;
buffer[cursor++] = LPP_TEMPERATURE;
buffer[cursor++] = val >> 8;
buffer[cursor++] = val;
return cursor;
}
uint8_t CayenneLPP::addRelativeHumidity(uint8_t channel, float rh)
{
if ((cursor + LPP_RELATIVE_HUMIDITY_SIZE) > maxsize) {
return 0;
}
buffer[cursor++] = channel;
buffer[cursor++] = LPP_RELATIVE_HUMIDITY;
buffer[cursor++] = rh * 2;
return cursor;
}
uint8_t CayenneLPP::addAccelerometer(uint8_t channel, float x, float y, float z)
{
if ((cursor + LPP_ACCELEROMETER_SIZE) > maxsize) {
return 0;
}
int16_t vx = x * 1000;
int16_t vy = y * 1000;
int16_t vz = z * 1000;
buffer[cursor++] = channel;
buffer[cursor++] = LPP_ACCELEROMETER;
buffer[cursor++] = vx >> 8;
buffer[cursor++] = vx;
buffer[cursor++] = vy >> 8;
buffer[cursor++] = vy;
buffer[cursor++] = vz >> 8;
buffer[cursor++] = vz;
return cursor;
}
uint8_t CayenneLPP::addBarometricPressure(uint8_t channel, float hpa)
{
if ((cursor + LPP_BAROMETRIC_PRESSURE_SIZE) > maxsize) {
return 0;
}
int16_t val = hpa * 10;
buffer[cursor++] = channel;
buffer[cursor++] = LPP_BAROMETRIC_PRESSURE;
buffer[cursor++] = val >> 8;
buffer[cursor++] = val;
return cursor;
}
uint8_t CayenneLPP::addGyrometer(uint8_t channel, float x, float y, float z)
{
if ((cursor + LPP_GYROMETER_SIZE) > maxsize) {
return 0;
}
int16_t vx = x * 100;
int16_t vy = y * 100;
int16_t vz = z * 100;
buffer[cursor++] = channel;
buffer[cursor++] = LPP_GYROMETER;
buffer[cursor++] = vx >> 8;
buffer[cursor++] = vx;
buffer[cursor++] = vy >> 8;
buffer[cursor++] = vy;
buffer[cursor++] = vz >> 8;
buffer[cursor++] = vz;
return cursor;
}
uint8_t CayenneLPP::addGPS(uint8_t channel, float latitude, float longitude, float meters)
{
if ((cursor + LPP_GPS_SIZE) > maxsize) {
return 0;
}
int32_t lat = latitude * 10000;
int32_t lon = longitude * 10000;
int32_t alt = meters * 100;
buffer[cursor++] = channel;
buffer[cursor++] = LPP_GPS;
buffer[cursor++] = lat >> 16;
buffer[cursor++] = lat >> 8;
buffer[cursor++] = lat;
buffer[cursor++] = lon >> 16;
buffer[cursor++] = lon >> 8;
buffer[cursor++] = lon;
buffer[cursor++] = alt >> 16;
buffer[cursor++] = alt >> 8;
buffer[cursor++] = alt;
return cursor;
}
Using a public LoRa network is the easiest way to get started using LoRa. In order to get started using a public LoRa network, you will want to first verify that yours sensors will be covered by an appropriate Network Operator. Once you know which network operator you will connect with, you can purchase devices that work on that network. You will then need an account with that operator so that you can add your devices to the network.
In order to activate a LoRa device on a network, you will need to have an account with that network. Using Cayenne, you will not need your account information if the device has already been registered on the network. If you wish to use Cayenne to help activate the device on the network, however, you will need your account information handy so that you can provide this information in order to authenticate with the network and activate the device.
Cayenne currently supports the following LoRa networks. The list of networks that work with Cayenne will keep growing.
- Actility
- Everynet
- Kerlink
- Loriot
- machineQ
- Objenious
- OrbiWise
- Semtech
- Senet
- Stream
- The Things Network
About Actility
Actility is an industry leader in Machine to Machine (M2M) large scale infrastructure with ThingPark®, the new generation standard-based M2M communication platform. Actility is a winner of the French Ministry of Research competition, has obtained the Grand Prix of the Tremplin Entreprise and has been rewarded by Innov’ Eco and CleanTech République for its particularly innovative approach in its Internet Of Things (IoT) solutions.
Using Actility with Cayenne
Cayenne makes it easy to use your LoRa device and the Actility network. You will need to:
- Create / Log into your account on Actility's ThingPark portal
- Setup gateway device
- Create Cayenne Routing Profile
- Register your device on the ThingPark portal
- Program/Flash your device
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
To create your ThingPark account, visit the Actility ThingPark Partner's Portal and click on Try or the Create free account button to begin the process of creating your account.
Once your account has been created, you can log into your account from the Partner portal.
After logging into your account you will see the ThingPark Partner dashboard page. You will primarily use the Device Manager screen for the remainder of the documentation when configuring your account and devices to communicate with Cayenne. To access this screen, open the side menu and select the Device Manager link.
After selecting the Device Manager link, your Device Manager screen will open.
Tip: Take note of which server your account is using. For most people this will probably be dev1.thingpark.com. You will need to know which server you are using later when adding a device to Cayenne.
In order for your LoRa devices to connect to the Actility network, you must have purchased and configured a gateway device. When using the Actility network, we recommend that you purchase and configure one of the following gateway devices:
- For use in the European Union, we recommend the Multitech Conduit EU868
- You can purchase a Multitech Conduit EU868 here
- For use in the United States of America, we recommend the Multitech Conduit US915
- You can purchase a Multitech Conduit US915 here
Be sure that you have an appropriate Actility gateway configured and working before continuing. Your devices will not be able to properly function without your gateway device in place.
<iframe width="480" height="270" src="https://www.youtube.com/embed/rpZo-GKd7mY" frameborder="0" allowfullscreen></iframe>
In order for data from your device to reach Cayenne, you must create an Application Server that points to Cayenne in the Actility portal. You will also need to add an AS Routing Profile that uses this server. You only need to perform this step once. Any devices that you wish to add to Cayenne will then need to be configured to use the routing profile or Cayenne will not receive their data.
Begin by creating the Application Server. From the device manager, select the Application Servers entry and from the screen that appears, click on the Create button to begin creating a new server.
Give the new entry an appropriate name that you can refer to later, such as "Cayenne". After proceeding, you will see the Application Server screen where you can enter in information for the application server. From this screen, click on the Add button located in the Add a route section.
In the Route section that gets added to the screen, click on the Add button to start adding a destination.
In the Add Destination dialog that appears, enter in the Cayenne Actility URL and then click on the Add button to save your changes.
https://lora.mydevices.com/v1/networks/actility/uplink
Now that the Application Server has been setup, we need to create the AS Routing Profile. To create this profile select the AS routing profiles entry on the portal. From the screen that appears, click on the Create button to begin creating a new profile.
Give your profile an appropriate name, such as "Cayenne" so that you can refer to it later when you configure your devices. After giving your profile a name, you will see the AS Routing Profile screen. Click on the Add button located in the Destinations section.
From the Add Destinations dialog that appears, be sure that the Type dropdown is set to Application Server. In the Destinations dropdown, be sure to select the Application Server you created earlier for Cayenne.
After saving your changes, you will be returned to the previous screen. Be sure to click on the Save button to save the changes to your profile. You may now continue with creating a device that uses this profile.
Before you can use your LoRa device on the Actility network, it must be registered on the network. The following information will help guide you through this process using Actility's ThingPark portal and the Device Manager screen.
Create new device
<iframe width="480" height="270" src="https://www.youtube.com/embed/hxhRwEalGvk" frameborder="0" allowfullscreen></iframe>
To get started with a new device, right-click on the Devices entry in the portal and select Create device from the menu that appears.
The New device dialog will appear. To create a new device using the Actility portal, you will need to enter in all required information for completing the device creation. The process begins by selecting an appropriate activation mode from the Device activation field.
Actility supports two activation modes (OTAA, APB). In most cases, you will want to select Over the Air Activation (OTAA). Let's cover the information needed for both methods.
After selecting the OTAA activation mode, the list of fields will update to show you required fields. You will need to fill in all require fields to register & activate your device with Actility. Below you will find notes on the fields seen for OTAA and specific notes as they relate to what needs to be selected in order to work with Cayenne.
- Device identification
-
Device EUI: Enter the DevEUI for your device. This ID should come with the information included with your device, or can be found in the device configuration.
-
Device Address: Skip – When selecting OTAA activation, the device address will automatically be generated based on the DevEUI.
-
Device Profile: Actility uses this profile to correctly decode the payload, based on the device type, and display it on their dashboard. Be sure to select the correct profile for your device and which network it will be using.
TIP: You can refer to the Actility Device Profiles section where we have more details on which Device Profile to select for devices.
-
- Application layer
-
Application EUI: Enter the AppEUI. The AppEUI is a global application ID that uniquely identifies the application provider (i.e., owner) of the device.
TIP: If you do not have an Applicate EUI, you can create one yourself. It must be a unique string composed of 16 alphanumeric characters.
-
Application key: Enter the Appkey. The AppKey is a key specific for the end-device that is assigned by the application owner to the end-device and most likely derived from an application-specific root key exclusively known to and under the control of the application provider.
TIP: If you do not have an Applicate key, you can create one yourself. It must be a unique string composed of 32 alphanumeric characters.
-
Thingpark cloud config: Skip – Cayenne does not require this optional field.
-
- Network
- Connectivity plan: Select an appropriate Actility plan here for activating your device under.
- AS routing profile: Select the Cayenne route that you created earlier from the dropdown here. This will forward the information from your device to Cayenne so that once your device is online, Cayenne will receive its information.
- Administrative data
- Device name: Used by Actility. Cayenne does not use this information.
- Marker: Used by Actility. Cayenne does not use this information.
- Administrative info: Used by Actility. Cayenne does not use this information.
- Administrative location: Used by Actility. Cayenne does not use this information.
- Complete the device creation by clicking the Create button to create the device.
Once added, you will see your new device listed in the device list on the portal.
Once your device has been created, continue by making sure that your device has been programmed/flashed.
After selecting the APB activation mode, the list of fields will update to show you required fields. You will need to fill in all require fields to register & activate your device with Actility. Below you will find notes on the fields seen for APB and specific notes as they relate to what needs to be selected in order to work with Cayenne.
- Device identification
-
Device EUI: Enter the DevEUI for your device. This ID should come with the information included with your device, or can be found in the device configuration.
-
Device Address: When using APB, you will need to manually enter the hardware address here.
-
Device Profile: Actility uses this profile to correctly decode the payload, based on the device type, and display it on their dashboard. Be sure to select the correct profile for your device and which network it will be using.
TIP: You can refer to the Actility Device Profiles section where we have more details on which Device Profile to select for devices.
-
Application session key: Enter the AppSKey. The AppSKey is an application session key specific for the end-device. It is used by both the network server and the end-device to encrypt and decrypt the payload field of application-specific data messages.
-
Network session key: Enter the NwkSKey. The NwkSKey is a network session key specific for the end-device. It is used by both the network server and the end-device to calculate and verify the MIC (message integrity code) of all data messages to ensure data integrity. It is further used to encrypt and decrypt the payload field of a MAC only data messages.
-
- Application layer
-
Application EUI: Enter the AppEUI. The AppEUI is a global application ID that uniquely identifies the application provider (i.e., owner) of the device.
TIP: If you do not have an Applicate EUI, you can create one yourself. It must be a unique string composed of 16 alphanumeric characters.
-
Application key: Enter the Appkey. The AppKey is a key specific for the end-device that is assigned by the application owner to the end-device and most likely derived from an application-specific root key exclusively known to and under the control of the application provider.
TIP: If you do not have an Applicate key, you can create one yourself. It must be a unique string composed of 32 alphanumeric characters.
-
Thingpark cloud config: Skip – Cayenne does not require this optional field.
-
- Network
- Connectivity plan: Select an appropriate Actility plan here for activating your device under.
- AS routing profile: Select the Cayenne route that you created earlier from the dropdown here. This will forward the information from your device to Cayenne so that once your device is online, Cayenne will receive its information.
- Administrative data
- Device name: Used by Actility. Cayenne does not use this information.
- Marker: Used by Actility. Cayenne does not use this information.
- Administrative info: Used by Actility. Cayenne does not use this information.
- Administrative location: Used by Actility. Cayenne does not use this information.
- Complete the device creation by clicking the Create button to create the device.
Once added, you will see your new device listed in the device list on the portal.
Once your device has been created, continue by making sure that your device has been programmed/flashed.
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 can now be deployed and connected to the network for usage.
If your device needs to be programmed, you should now 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.
<iframe width="480" height="270" src="https://www.youtube.com/embed/u6QuVJCUTo4" frameborder="0" allowfullscreen></iframe>
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 Actility Network option to view a list of Actility 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 Actility network, 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?
- Which Actility ThingPark Server are you using?
- Your Actility ThingPark Email and ThingPark Password.
To see how easy it is, let’s walk through an example of connecting an Adeunis LoRa Pulse which was previously registered under an Actility account.
1. Choose the Network
Make sure the Actility network is selected in the list of Networks.
2. Select the Device
Select your device from among the list supported Actility 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 a name. 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 Actility. Select
Already Registeredin the Activation Mode field. -
From the ThingPark Server field, be sure to select the correct environment that you are using.
TIP: If you don't find your ThingPark environment in the dropdown, please ask Actility for your ThingPark DX Profile, and manually enter it. It should be suffixed with
-apisuch asmycompany-api. -
Enter your ThingPark Email and ThingPark Password into the corresponding fields.
-
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.
When setting up your device on Actility's ThingPark portal, you must select the correct Device Profile for your device. Below are some guidelines on which profile to select.
- For devices used in European Union:
- Select the Profile LoRaWAN 1.0 class A - Rx2-SF12
- For devices use in United States of America:
- Select the Profile LoRaWAN 1.0 class A -US- Rx2-SF12
- Exceptions to the above:
-
If you are using the NKE Watteco SmartPlug, use the class C version of above configs depending on which region you are in.
For example, with the SmartPlug being used in the US, select LoRaWAN 1.0 class C (-US-) Rx2-SF12 And in the EU, select LoRaWAN 1.0 class C - Rx2-SF12
-
About Everynet
Everynet is a global IoT connectivity company, with a vision to make it simple to connect everyTHING. Providing very low cost network infrastructure and a Core Network Platform that together will offer the lowest device connection fee. An Innovative Everynet Partner Program that can facilitate participation in a Global Shared Network ensuring that devices are not limited by lack of coverage and a disruptive business model that has options to enable monetization of each network via third parties whilst serving network owner IoT needs. Everynet believe that two key barriers to large scale IoT deployment are cost and end device availability and work with both MNO and private network partners to ensure that these barriers are removed. Everynet is a contributor member of the LoRa Alliance and plays an active role in the activities of the Alliance.
Using Everynet with Cayenne
Cayenne makes it easy to use your LoRa technology device and the Everynet network. You will need to:
- Create / Log into your account on the Everynet portal
- Setup gateway device
- Create Application
- Register your device on the Everynet portal
- Program/Flash your device
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
To create your Everynet account, visit the Everynet Portal. Click on Sign Up to get started.
In order for your LoRa technology devices to connect to the Everynet network, you should purchase and configure a gateway device. You can find additional information on supported gateways on the Everynet Gateways page.
Be sure that your devices are covered by the Everynet network, including having an appropriate gateway configured and working if needed, before continuing. Your devices will not be able to properly function without your gateway device in place.
If you need to register a new gateway device, you can do so from the Everynet portal. To begin this process, log into your account and select the Gateway Management option.
Expand the + menu and select the type of gateway that you will be adding.
On the Gateway data screen that appears, fill in the necessary information to add your gateway.
In order for data from your device to reach Cayenne, you must configure your devices in the Everynet portal to forward data to Cayenne. The Everynet portal groups devices in what they call Applications. If you want to use a group of devices with Cayenne, you will need to configure your Application to use Cayenne. You only need to perform this step once for each Application that you want to use.
To create an application, log into the Everynet Portal and make sure the Applications tab is selected. Select the + button to add a new application.
From the Application Server Data screen that appears, fill in the information needed to create the new application.
- Give the application a name, such as
Cayenne. - Enter in an Application EUI or click on the button to have one generated.
- From the Application interface select
Everynet Core API. - In the Application Server URL enter
http://mydevices.adapter.eu-west-1.everynet.io/. - Click on Submit to complete your application and you will see your new application listed.
TIP: You may be able to find more help on setting up Cayenne with Everynet on the Everynet myDevices doc page.
Once you have an application that you want to use, you can then add your devices to it.
Before you can use your LoRa technology device on the Everynet network, it must be registered on the network using the Everynet portal. The following information will help guide you through this process.
Log into the Everynet portal
Start by going to the Everynet Portal and logging into your account. Once logged in, you can proceed with registering a new device.
Register new device
To get started with a new device, click on the Device Management tab. From the Device Management screen, click on the + add device button to begin adding a new device.
From the Device data screen that appears, you must specify the data needed to register the device. Be sure to select the appropriate Application or your device data will not be forwarded to Cayenne.
Once added, your device will then appear in the list of devices shown on the Device Management screen.
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 can now be deployed and connected to the network for usage.
If your device needs to be programmed, you should now 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.
TIP: You should see data being reported on the Everynet portal's device list for your device. If you do not, double check the values entered for your device and consider programming/flashing the device again.
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, click LoRa and select the Everynet Network option to view a list of Everynet 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.
Once your device has been previously registered on the Everynet network, 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 the network.
- What is the unique DevEUI for the device being added?
- What is your unique Everynet account API Key?
To see how easy it is, let’s walk through an example of connecting an Adeunis LoRa Pulse which was previously registered under an Everynet account.
1. Choose the Network
Make sure the Everynet network is selected in the list of Networks.
2. Select the Device
Select your device from among the list supported Everynet 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 a name. In our case, we’ll enter “mDotBox” in the Name field.
- Enter the DevEUI for this device into the DevEUI field.
- Our device has been previously manually registered with Everynet. Make sure
Already Registeredis selected in the Activation Mode field. - 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.
About Kerlink
Kerlink specialises in network solutions for the Internet of Things (IoT). Its mission is to provide its clients – telecom carriers, businesses and public authorities – with network solutions (equipment, software and services) dedicated to the Internet of Things.
Using Kerlink with Cayenne
Cayenne makes it easy to use your LoRa device and the Kerlink network. You will need to:
- Setup gateway device
- Setup traffic forwarding to Cayenne
- Manually register device
- Program/Flash your device
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
In order for your LoRa technology devices to connect to the Kerlink network, you must have purchased and configured a gateway device. Kerlink supports several different gateway devices.
- NOTE: At this time, connection between Kerlink and Cayenne is only supported with the Kerlink Wirnet Station SPN.
Be sure that you have your gateway configured and working before continuing. Your devices will not be able to properly function without your gateway device in place.
Adding LoRa devices and forwarding their data to Cayenne must be configured on the Kerlink gateway device. You can do so using the gateway's web interface.
Log into the gateway device.
Connect with your browser to the URL / IP Address of your gateway device.
TIP: If needed you can use a network scanner, such as the Fing app to identify devices on your network.
Possible security warning seen on connection
When connecting to your gateway device, you may find that your web browser complains about the connection not being secure. Depending upon which browser you are using and its security settings, you may need to take actions to proceed and access the gateway content.
Connected to gateway device
As soon as you are connected to the gateway device, you will see the landing screen for your device. You can proceed with configuring the gateway to forward data to Cayenne.
In order for data from your devices to reach Cayenne, you must configure your gateway device to forward data to Cayenne. You will need to perform this step on each Kerlink gateway device. Once logged into your Kerlink gateway interface, click on the HTTP transmitter option located in the Configuration section.
In the HTTP transmitter screen that appears, enter in the following information:
-
Click on the Enable checkbox to enable the fields shown here.
-
In the Address field enter in the uplink URL for the Kerlink network.
https://lora.mydevices.com/v1/networks/kerlink/uplink/ -
Click Save to save the changes.
Your gateway is now configured to forward data to Cayenne. You can now proceed with adding devices.
Before you can use your device on the Kerlink network, it must be registered on the network. To accomplish this, devices can be added to the gateway under what Kerlink calls "Fleet devices". The following information will help guide you through this process.
Click on the Fleet option located near the top of the gateway menu. The Fleet screen appears and from here you can add devices.
Kerlink supports two activation modes (OTAA, ABP). In most cases, you will want to select Over the Air Activation (OTAA). Let’s cover the information needed for both methods.
Below you will find notes on the fields seen for OTAA and specific notes as they relate to what needs to be selected in order to work with Cayenne.
-
Dev EUI: Enter the DevEUI for your device. This ID should come with the information included with your device, or can be found in the device configuration.
-
App EUI: Enter the AppEUI. The AppEUI is a global application ID that uniquely identifies the application provider (i.e., owner) of the device.
TIP: If you do not have an Applicate EUI, you can create one yourself. It must be a unique string composed of 16 alphanumeric characters.
-
App key: Enter the Appkey. The AppKey is a key specific for the end-device that is assigned by the application owner to the end-device and most likely derived from an application-specific root key exclusively known to and under the control of the application provider.
TIP: If you do not have an Applicate key, you can create one yourself. It must be a unique string composed of 32 alphanumeric characters.
-
Class C: Select whether or not your device operates in continuous listening mode. If not, leave this option unselected.
TIP: Class C is a continuous listening mode making sense for devices that are connected to the electrical network. In this mode the network can at anytime transmit downlink message to the device. An example of such a device is the NKE Watteco SmartPlug.
After filling in the fields for you device, click on the Add button to add the device. Once added, you will see your new device listed on the Fleet screen.
Once your device has been created, continue by making sure that your device has been programmed/flashed.
Below you will find notes on the fields seen for ABP and specific notes as they relate to what needs to be selected in order to work with Cayenne.
-
Dev Addr: When using ABP, you will need to manually enter the hardware address here.
NOTE: Kerlink's ABP fields does not ask you to enter the Dev EUI for the device. In order to properly add a device using ABP in Cayenne, an extra step is needed. Be sure to refer to the Add your device to your Cayenne dashboard section in order to make sure that your device is properly added to Cayenne.
-
NwkSKey: Enter the Network Session Key. The NwkSKey is a network session key specific for the end-device. It is used by both the network server and the end-device to calculate and verify the MIC (message integrity code) of all data messages to ensure data integrity. It is further used to encrypt and decrypt the payload field of a MAC only data messages.
-
AppSKey: Enter the Application Session Key. The AppSKey is an application session key specific for the end-device. It is used by both the network server and the end-device to encrypt and decrypt the payload field of application-specific data messages.
-
Class C: Select whether or not your device operates in continuous listening mode. If not, leave this option unselected.
TIP: Class C is a continuous listening mode making sense for devices that are connected to the electrical network. In this mode the network can at anytime transmit downlink message to the device. An example of such a device is the NKE Watteco SmartPlug.
After filling in the fields for you device, click on the Add button to add the device. Once added, you will see your new device listed on the Fleet screen.
Once your device has been created, continue by making sure that your device has been programmed/flashed.
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 can now be deployed and connected to the network for usage.
If your device needs to be programmed, you should now 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.
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 Kerlink Network option to view a list of 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 Kerlink network, 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?
To see how easy it is, let’s walk through an example of connecting an Adeunis Pulse which was previously registered on our Kerlink gateway device.
1. Choose the Network
Make sure the Kerlink network is selected in the list of LoRaWAN Networks.
2. Select the Device
Select your device from among the list supported the Kerlink network 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 a name. In our case, we’ll enter “LoRa Pulse” in the Name field.
-
Enter the DevEUI for this device into the DevEUI field.
NOTE: If your device was configured for Activation By Personalization (ABP), you will need to take a special step here - Cayenne asks for the DevEUI but this information is not currently provided with Kerlink and ABP. To work around this issue, enter in 8 zeros (00000000) followed by the Dev Addr used during the register device with ABP step on the gateway. Without performing this step, your ABP device will not work with Cayenne. This step is not necessary when using OTAA.
-
Our device has been previously manually registered with the Kerlink network. Make sure
Already Registeredis selected in the Activation Mode field. -
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.
About Loriot
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 wireless network operators.
Using Loriot with Cayenne
Cayenne makes it easy to use your LoRa device and the Loriot network. 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.
In order for your LoRa technology devices to connect to the Loriot network, 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.
<iframe width="480" height="270" src="https://www.youtube.com/embed/euB4Axp1e2M" frameborder="0" allowfullscreen></iframe>
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 the name 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, next 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.
Before you can use your device on the Loriot network, 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.
<iframe width="480" height="270" src="https://www.youtube.com/embed/q6o1AzSuo9c" frameborder="0" allowfullscreen></iframe>
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 enroll new devices or you can import existing devices.
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.
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 are not able to re-personalize the device. In all other cases, you will want to use the new device enrollement process.
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 can now be deployed and connected to the network for usage.
If your device needs to be programmed, you should now 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.
<iframe width="480" height="270" src="https://www.youtube.com/embed/AwFwQ4cVpIg" frameborder="0" allowfullscreen></iframe>
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 Loriot network, 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 a name. 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 Registeredis 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.
About machineQ
machineQ is an IoT platform from Comcast Corp. CMCSA, a leading cable multi-service operator in the U.S. The machineQ platform will see Comcast working with some specified commercial business partners to use their networks and facilitate the gathering, transmitting and analyzing of data collected from connected devices.
Using machineQ with Cayenne
Cayenne makes it easy to use your LoRa device and the machineQ network. You will need to:
In order for data from your devices to reach Cayenne, you must configure traffic forwarding on the machineQ platform. When configuring data forwarding be be sure to use the Cayenne machineQ URL:
https://lora.mydevices.com/v1/networks/machineq/uplink
Once your device has been manually registered on the machineQ platform, 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 Actility Network option to view a list of Actility 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 machineQ network, 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.
- What is the unique DevEUI for the device being added?
- Your machineQ Email and machineQ Password.
To see how easy it is, let’s walk through an example of connecting an Adeunis LoRa Pulse which was previously manually registered under a machineQ account.
1. Choose the Network
Make sure the machineQ network is selected in the list of Networks.
2. Select the Device
Select your device from among the list supported machineQ 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 a name. In our case, we’ll enter “LoRa Pulse” in the Name field.
- Enter the DevEUI for this device into the DevEUI field.
- Our device will have been previously manually registered with machineQ. Select
Already Registeredin the Activation Mode field. - Enter your machineQ Email and machineQ Password into the corresponding fields.
- 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.
About Objenious
Objenious, a Bouygues Telecom subsidiary, has selected LoRaWAN® technology, a global standard, in order to provide the best support to these businesses through every step of their transformation. Objenious also provides a network, an IoT platform called SPOT (stands for Smart Portal of Things) and tailored services to meet businesses needs.
Using Objenious with Cayenne
Cayenne makes it easy to use your LoRa device and the Objenious network. You will need to:
- Create / Log into your account on the Objenious SPOT portal
- Register your device on the SPOT portal
- Setup traffic forwarding to Cayenne
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
Note: At present the Objenious SPOT portal is currently shown in French only. The documentation shown in this section will reference the SPOT portal in French, but the steps should be easy enough to follow along.
To get an account with Objenious, you will need to work directly with Objenious. Although there is an account creation link on the SPOT portal, it requires an Activation Code that you must first obtain from Objenious.
Log into the SPOT portal
Once you have your account, you can proceed with the logging into the SPOT portal. After logging in, you will see your Dashboard and from there you can proceed with setting things up to connect with Cayenne.
Before you can use your LoRa device on the Objenious network, it must be registered on the network. The following information will help guide you through this process using Objenious's SPOT portal and the CAPTEURS screen.
Import Devices
To get started with adding new devices, click on the CAPTEURS link in the side menu shown on the SPOT dashboard. From the screen that appears, click on the IMPORTER DES CAPTEURS button.
In order to import devices into Objenious, you will need to download and fill in a template file. Download the template by clicking on the Téléchargez le template button. Fill in the required information for the devices that you wish to import and save the template.
Note: Take note of which Groupe (code) you specify your devices get imported to. Later when you setup data forwarding to Cayenne, you will need to do so for each group of devices you want to forward data.
Note: If you need more information on this step, or run into trouble importing your devices, you may wish to refer to Objenious' FAQ document (FRENCH) that contains a wealth of helpful information.
To complete importing your devices, click on CHOISIR UN FICHIER and browse to the template file that contains the devices you wish to importn. Click on the IMPORTER button and then the ACCEPTER button.
Note: You will see the status of your device import and any errors down below in the history section on the Import screen. If you run into any errors, you can expand the details for that import attempt and then try again.
Once your devices have been imported, they should appear on the GESTION DES CAPTEURS screen.
Note: that it can take up to 48 hours for newly imported devices to be activated on Objenious. In the meantime, you will see your device shown in the list of devices, but you will see an activation error shown in the status (STATUT) field. Once your device is ready to be used, you will see a green EN ACTIVITÉ status shown next to your device.
Once your device has been imported and is ready to be used, you can proceed with setting up data forwarding to Cayenne.
In order for Cayenne to be able to able to receive your device’s information, you will need to setup forwarding. When devices are imported into Objenious, they are imported into a group (Groupe). This setup will need to be performed once for each group of devices in your account.
To perform this step, expand the CONFIGURATION option in the side menu and select Scénarios et alertes. On the SCÉNARIOS ALERTES screen that appears, click on the CRÉER UN SCÉNARIO button to begin creating a new scenario.
On the CHOIX DU SCÉNARIO page that appears, scroll down and select the HTTP Push Route (ROUTAGE) option. Then click on the SUIVANT button to continue to the next step.
On the Parameters screen (PARAMÉTRAGE DU SCÉNARIO), make the following choices:
-
Enter a name for the route in the name (NOM DU SCENARIO) field, such as
Cayenne Forward. -
From the group (GROUPE) field, select which group of devices you want this rule to apply. In the example shown here, our group is named MyDevices. Yours will be named differently.
-
From the list of device types (TYPE DE CAPTEUR) select All (TOUS).
-
In the destination URL field (ENVOI D'UNE REQUÊTE HTTP) enter in Cayenne's Objenious uplink URL.
https://lora.mydevices.com/v1/networks/objenious/uplink -
Under CONTENU be sure to select the MESSAGE option. This is required so that Cayenne receives the entire payload data and not just decoded values.
-
Finally, click on the create scenario (Créer le scénario) button to complete the creation.
You will then see your completed route shown on the SCÉNARIOS ALERTES screen. Your group is now configured to forward data to Cayenne. You can now proceed with adding your devices in 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 Objenious option to view a list of 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 Objenious, 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 the network.
- What is the unique DevEUI for the device being added?
To see how easy it is, let’s walk through an example of connecting an Adeunis Pulse which was previously registered under a Objenious account.
1. Choose the Network
Make sure Objenious is selected in the list of Networks.
2. Select the Device
Select your device from among the list supported Objenious 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 a name. 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 Objenious. Make sure
Already Registeredis selected in the Activation Mode field. - 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.
About OrbiWise
OrbiWise is a leading solution provider for Low-Power Wide–Area wireless Networks optimized for connected objects based on LoRa(TM) technology.
Using OrbiWise with Cayenne
Cayenne makes it easy to use your LoRa device and the OrbiWise network. You will need to:
- Create / Log into your account on the OrbiWise portal
- Setup gateway device
- Register your device on the Orbiwise portal
- Setup traffic forwarding to Cayenne
- Program/Flash your device
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
To get an account with OrbiWise, you will need to work directly with OrbiWise. Accounts are not created manually through any sign up process.
In order for your LoRa technology devices to connect to the OrbiWise network, you should purchase and configure a gateway device. Currently, you will obtain and use a Tektelic gateway that has been configured for OrbiWise and Cayenne. OrbiWise will perform this configuration for you. Since your gateway will be preconfigured to work with Cayenne, you will not need to configure any Cayenne-specific data forwarding for each device connected to that gateway.
Be sure that your devices are covered by an appropriate OrbiWise gateway, including having the gateway configured and working for Cayenne, before continuing. Your devices will not be able to properly function without your gateway device in place.
If you obtain your gateway from OrbiWise, your gateway may already be configured and registered. In such instances, you probably do not need to register your device prior to using it. If, however, you need to register your device you can do so using your OrbiWise portal.
To view the gateways under your account, log into your customer-specific OrbiWise portal and select My Gateways > List Of Gateways. You will then see the current list of gateways for your account.
To register a new gateway, click on the Add Gateway button and the Add Gateway dialog appears. The only information you'll need is the Gateway ID for the gateway you'll be adding. Enter this ID into the Gateway ID field and click Add Gateway to add your gateway.
Before you can use your device on the OrbiWise network, it must be registered on the network using the OrbiWise portal. The following information will help guide you through this process.
Register new device
Start by going to your customer-specific OrbiWise portal and logging into your account. Once logged in, you can proceed with registering a new device. From the My Devices menu, select List of Devices and the My Devices screen appears.
From the My Devices screen, click on the Add Device button to begin the process of adding a new device. The Add New Device dialog appears, allowing you to enter in the required information to add and activate your device. Depending upon the Registration type that you will be using (Join Procedure or Presonalized), the information you need to provide will be slightly different.
After selecting the Registration type > Join Procedure option, the list of fields will update to show you required fields needed for Join Procedure registration. This registration process is similar to Over the Air Activation that may see with other LoRa networks. You will need to fill in all require fields to register & activate your device with OrbiWise. Below you will find notes on the fields seen for Join Procedure registration and specific notes as they relate to what needs to be selected in order to work with Cayenne.
-
Device EUI: Enter the DevEUI for your device. This ID should come with the information included with your device, or can be found in the device configuration.
-
Application EUI: Enter the AppEUI. The AppEUI is a global application ID that uniquely identifies the application provider (i.e., owner) of the device.
NOTE: The OrbiWise portal is currently under active development. Currently there is a bug in the OrbiWise portal wherein although the AppEUI field is required for Join Procedure registration, this field may not be present on the dialog. To work around this, perform the following steps:
- First select the Registration type > Personalized option to temporarily display the fields for the Personalized registration mode.
- Enter in the AppEUI information into the field that does appear there. You only need to enter in the AppEUI here.
- Then return to the Join Precedure tab by clicking back on Join Procedure.
- You can then continue with registering using the Join Procedure registration fields.
-
Comment: Optional. We recommend you enter in the device name, or a description so that you can easily refer to it on the OrbiWise dashboard.
-
Complete the device registration by clicking the Add Device button.
After selecting the Registration type > Personalized option, the list of fields will update to show you required fields needed for Personalized registraiton. This registration process is similar to Activation by Personalization that may see with other LoRa networks. You will need to fill in all require fields to register & activate your device with OrbiWise. Below you will find notes on the fields seen for Personalized registration and specific notes as they relate to what needs to be selected in order to work with Cayenne.
-
Device EUI: Enter the DevEUI for your device. This ID should come with the information included with your device, or can be found in the device configuration.
-
Application EUI: Enter the AppEUI. The AppEUI is a global application ID that uniquely identifies the application provider (i.e., owner) of the device.
TIP: If you do not have an Applicate EUI, you can create one yourself. It must be a unique string composed of 16 alphanumeric characters.
-
Comment: Optional. We recommend you enter in the device name, or a description so that you can easily refer to it on the OrbiWise dashboard.
-
DevAddr: When using Personalized registration, you will need to manually enter the 4 byte hardware address here.
-
NwkSKey: Enter the NwkSKey. The NwkSKey is a network session key specific for the end-device. It is used by both the network server and the end-device to calculate and verify the MIC (message integrity code) of all data messages to ensure data integrity. It is further used to encrypt and decrypt the payload field of a MAC only data messages.
-
Complete the device creation by clicking the Add Device button.
In order for data from your device to reach Cayenne, you must configure forwarding from within the settings found in your user-specific OrbiWise portal. You only need to perform this step once from the portal. To set this up, open the Applications menu and select HTTP Push configuration.
From the HTTP Push configuration screen we find the settings needed to forward data to Cayenne. To set this up, enter the following information:
- Hostname:
https://lora.mydevices.com - Port:
443 - Path prefix:
/v1/networks/ubiq/uplink - Host Username: Enter anything you want here. OribiWise requires this field, but it is not used by Cayenne.
- Host Password: Enter anything you want here. OribiWise requires this field, but it is not used by Cayenne.
- Click on the Start button to start the forwarding service.
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 can now be deployed and connected to the network for usage.
If your device needs to be programmed, you should now 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.
TIP: You should see data being reported on the OrbiWise portal's Data > Show Packets page. If you do not, double check the values entered for your device and consider programming/flashing the device again.
Once your device has been registered, programmed, and connected to a gateway that is forwarding data to Cayenne, 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, click LoRa and select the OrbiWise Network option to view a list of OrbiWise 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.
Once your device has been previously registered on the OrbiWise network, 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 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 the network.
- What is the unique DevEUI for the device being added?
- If you wish to use downlink commands, you will need to know your user-specific OrbiWise Server address as well as your Login and Password.
To see how easy it is, let’s walk through an example of connecting an Multitech mDotBox which was previously registered under a OrbiWise account.
1. Choose the Network
Make sure the OrbiWise network is selected in the list of Networks.
2. Select the Device
Select your device from among the list supported OrbiWise devices. In this case, we’ll select the Multitech mDotBox.
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 a name. In our case, we’ll enter “mDotBox” in the Name field.
-
Enter the DevEUI for this device into the DevEUI field.
-
Our device has been previously manually registered with OrbiWise. Make sure
Already Registeredis selected in the Activation Mode field. -
(Optional) Enter in your OrbiWise account information to take advantage of downlink commands.
- Enter the name of your customer-specific OrbiWise portal (e.g.
us.xyz.orbiwise.com) into the OrbiWise Server field. - Enter your OrbiWise Login and OrbiWise Password into the corresponding fields.
- Enter the name of your customer-specific OrbiWise portal (e.g.
-
Click Add LoRa device.
The Multitech mDotBox device 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 various sensors on the device.
About Semtech
Semtech Corporation is a leading supplier of high performance analog and mixed-signal semiconductors and advanced algorithms for high-end consumer, enterprise computing, communications, and industrial equipment. Products are designed to benefit the engineering community as well as the global community.
Using Semtech with Cayenne
Cayenne makes it easy to use your LoRa device and the Semtech network. You will need to:
- Create / Log into your account on Semtech's IoT portal
- Setup gateway device
- Setup traffic forwarding to Cayenne
- Register your device on the Semtech portal
- Program/Flash your device
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
To create your Semtech account, visit the Semtech's IoT Portal and select your region from the list to get started. After selecting the region, you will be asked
NOTE: Semtech has many servers that you can use, but you will need an account on each of them in order to use that server. For the purposes of this walkthrough, we will be using the North America server.
In order for your LoRa technology devices to connect to the Semtech network, you must have purchased and configured a gateway device. Once you have your gateway, it must be added to your account on the Semtech dashboard.
Be sure that you have an appropriate gateway configured and working before continuing with adding devices. Your devices will not be able to properly function without your gateway device in place.
If you need to register a new gateway device, you can do so from the Semtech portal. To begin this process, select the Gateways option to open the My Gateways screen. From here, click on the Add Gateway button to begin the process of adding a new gateway.
On the Add Gateway screen that appears, give the gateway a nickname and enter the Gateway ID of the device.
In order for data from your devices to reach Cayenne, you must configure the Semtech portal to forward data to Cayenne. You only need to perform this step once globally for your account. To perform this step, click on the Applications option on the dashboard. On the Device Routing Feeds screen that appears, click on the Create button to create a new device routing feed.
In the Applications screen that appears, select the Edit Default Push Config button.
Note: We recommend that you change the Global Push Config as shown here. However, the Semtech portal also allows you to create a new Application. If you do so, you will want to change the Push Settings with the changes shown here. You must also remember to later add your devices to this application as well. If you change the Global push config, you will not need to take that extra step.
Enter the following values onto the Global Push Configuration screen:
-
Hostname:
https://lora.mydevices.com -
Port:
443 -
Path prefix:
/v1/networks/semtech/uplink -
Enter your Semtech account Username and Password into the corresponding fields.
-
Click Save Application to save the changes.
-
Back on the Applications screen, click the Start Default Push button.
Your account is now configured to forward device data to Cayenne. You can now proceed with adding devices to it.
Before you can use your device on the Semtech network, it must be registered on the network. To accomplish this, devices must be added via the Semtech portal. The following information will help guide you through this process.
-
Click on Devices option on the dashboard to open the My Devices screen.
-
Click on Add Device to open the Add New Device popup dialog.
-
Refer to the Add New Device dialog. You can enter in all the required details for adding your device directly here. The Semtech network supports both OTAA and APB activation.
-
Click OK to complete adding your device. You will see your new device shown on the My Devices screen.
Note: If you chose to use an Application instead of the modifying the Global Push Config as suggested earlier, don't forget to select an application for your device that is setup to forward data to Cayenne. If using the Global Push Config, no additional steps are needed.
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 can now be deployed and connected to the network for usage.
If your device needs to be programmed, you should now 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.
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 LoRaWAN category and then the Semtech Network option to view a list of 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 Semtech network, 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 the network.
- What is the unique DevEUI for the device being added?
To see how easy it is, let’s walk through an example of connecting an Adeunis Pulse which was previously registered under a Semtech network account.
1. Choose the Network
Make sure the Semtech network is selected in the list of LoRaWAN Networks.
2. Select the Device
Select your device from among the list of supported Stream network 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 a name. 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 the Semtech network. Make sure
Already Registeredis selected in the Activation Mode field. -
Select which server your device uses from the Semtech Server dropdown.
-
If you wish to use downlink commands, you will need to enter your Semtech Login and Semtech Password.
Note: If your device is using the Global Push Config, this will be your account Login and Password. However, if your device uses a separate Application config, you will enter the Host Username and Host Password as found in the Application's Push Config.
-
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 sensors on the device.
About Senet
Senet, a contributing member of the LoRa® Alliance, is the first and only public provider in North America of low-power wide-area networks (LPWANs) with its class-leading LoRa® modulation for IoT and M2M applications.
Using Senet with Cayenne
Cayenne makes it easy to use your LoRa technology device and the Senet network. You will need to:
- Create / Log into your account on the Senet portal
- Setup gateway device
- Register your device on the Senet portal
- Setup traffic forwarding to Cayenne
- Program/Flash your device
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
To create your Senet account, visit the Senet Portal. Click on the Create New Account to get started.
In order for your LoRa technology devices to connect to the Senet network, you should purchase and configure a gateway device. When using the Senet network, it is recommended that you use a MultiConnect Conduit gateway device. You can find links to an appropriate version of this device on the Multitech MultiConnect Conduit page.
Be sure that your devices are covered by the Senet network, including having an appropriate gateway configured and working if needed, before continuing. Your devices will not be able to properly function without your gateway device in place.
If you need to register a new gateway device, the Senet portal has instructions and the software for doing so. To begin this process, log into your Senet account and click on the Register Devices button. Select Gateway from the dialog that appears to begin the process of adding your gateway device.
Note: Currently only the MultiTech Conduit gateway can be registered through the Senet Portal.
The Register Gateway dialog that appears will walk you through the process of adding your gateway device. You can refer to Senet's own gateway documentation if you need help with this step.
Before you can use your LoRa technology device on the Senet network, it must be registered on the network using the Senet portal. The following information will help guide you through this process.
Log into the Senet portal
Start by going to the Senet portal and logging into your account. Once logged in, you can proceed with registering a new device.
Register new device
<iframe width="480" height="270" src="https://www.youtube.com/embed/CrY-wAw58Ts" frameborder="0" allowfullscreen></iframe>
To get started with a new device, click on the Register Devices button. From the dialog that appears, select the Device option.
From the Register Device dialog that appears, enter in the Device EUI (or allocate one from here) and a description for the device. Click Register New Device to complete registering the device.
Your device will now appear in the list of devices shown on your dashboard. You can now setup device forwarding to Cayenne.
<iframe width="480" height="270" src="https://www.youtube.com/embed/k7V0FzuFf-I" frameborder="0" allowfullscreen></iframe>
In order for Cayenne to be able to able to receive your device’s information, you will need to setup packet forwarding. To do so, expand the settings for the device and click on the cogwheel icon. The Edit Device screen appears.
TIP: Alternatively you can click on the device tile itself and then select the cogwheel icon that also appears on the Device screen.
From the Edit Device dialog we can setup the device so that it forwards data to Cayenne. To do so, perform the following:
-
Select the NOTIFICATION TARGET tab. This will expose the fields needed for forwarding.
-
Open the Forward To dropdown and select the myDevices Cayenne profile.
-
Before data will begin forwarding, be sure that the Status slider is set to Enabled.
-
Make sure that the RF Data checkbox is selected to see signal strength data for your device in Cayenne.
-
Click Save to save the changes.
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 can now be deployed and connected to the network for usage.
If your device needs to be programmed, you should now 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.
TIP: You should see data being reported on the Senet portal's device list for your device. If you do not, double check the values entered for your device and consider programming/flashing the device again.
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, click LoRa and select the Senet Network option to view a list of Senet 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.
Once your device has been previously registered on the Senet network, 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 the network.
- What is the unique DevEUI for the device being added?
- What is your unique Senet account API Key?
To see how easy it is, let’s walk through an example of connecting an Multitech mDotBox which was previously registered under a Senet account.
1. Choose the Network
Make sure the Senet network is selected in the list of Networks.
2. Select the Device
Select your device from among the list supported Senet devices. In this case, we’ll select the Multitech mDotBox.
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 a name. In our case, we’ll enter “mDotBox” in the Name field.
-
Enter the DevEUI for this device into the DevEUI field.
-
Our device has been previously manually registered with Senet. Make sure
Already Registeredis selected in the Activation Mode field. -
Enter your unique Senet Account API Key for your Senet account. This will allow Cayenne to send downlink commands to your device.
TIP: If you have not generated your API Key it can be found on the Senet Portal under your Account Information.
Note: Once generated on the Senet Portal, your API key is not shown to you again. Be sure to copy & save off your API key for later reference! Failing to do so may cause you to need to regenerate your key. If you do so, remember that you will need to update the settings for all previously added devices in Cayenne as well.
-
Click Add device.
The Multitech mDotBox device 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 various sensors on the device.
About Stream
Stream Technologies is the company behind IoT-X, a Connectivity Enablement, Management & Billing platform.
Designed for all operators of Cellular, Satellite & Low Power Wide Area networks, IoT-X is offered as a Platform as a Service (PaaS) and is fast being adopted by established network operators and new entrants into the M2M/IOT sector.
Using Stream with Cayenne
Cayenne makes it easy to use your LoRa device and the Stream network. You will need to:
- Create / Log into your account on Stream's IoT-X portal
- Setup gateway device
- Setup traffic forwarding to Cayenne
- Create Application
- Register your device on the IoT-X portal
- Program/Flash your device
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
To register and configure your devices to work with Stream, you will need to use Stream's IoT-X portal. To get an account with Stream and to use the IoT-X portal, you will need to work directly with Stream. Accounts are not created manually through any sign up process.
TIP: If you need help logging into your Stream IoT-X account, you can refer to Stream's Quick-Start Guide which includes information on logging in and what to do if you need help.
In order for your LoRa technology devices to connect to the Stream network, you must have purchased and configured a gateway device. The Stream network supports a few different gateway devices. Refer to the Add a LoRa Gateway process on the IoT-X portal and to Stream's Adding a Gateway documentation for more information.
Be sure that you have an appropriate gateway configured and working before continuing. Your devices will not be able to properly function without your gateway device in place.
If you need to register a new gateway device, you can do so from the IoT-X portal. To begin this process, log into your account and expand the LoRa side menu. Select the Gateways option to open the LoRa Gateways screen. From here, click on the Add Gateway button to begin the process of adding a new gateway.
On the Add a LoRa Gateway screen that appears, select the gateway device that you are adding and enter in the required information.
TIP: Stream has in-depth documentation on registering your gateway available if you should need help with this process.
In order for data from your devices to reach Cayenne, you must configure the IoT-X portal to forward data to Cayenne. You only need to perform this step once globally for your account. To perform this step, expand the Services menu and select the Data Routing option. On the Device Routing Feeds screen that appears, click on the Create button to create a new device routing feed.
In the Add Data Routing Destination dialog that appears, enter in the following information:
-
Give the feed a Name such as "Cayenne".
-
Expand the Output Type dropdown and select the HTTPS POST option.
-
In the URL field enter in Cayenne's Stream uplink URL.
https://lora.mydevices.com/v1/networks/stream/uplink -
Click Add to complete creation of your routing feed.
Your account is now configured to forward device data to Cayenne. You can now proceed with creating an application and adding devices to it.
The IoT-X portal groups devices in what they call Applications. Before you can add devices you must have an application.
TIP: Setting up Data forwarding to Cayenne is done globally to your account in Stream. If you already have an Application that you want to use for your devices, you do not need to create an additional application. You can skip to adding devices in that case.
To create an application, log into the IoT-X portal and expand the LoRa side menu. Select the Applications option to open the LoRa Applications screen. Click on the Create an Application button to begin the process of adding an application.
On the Add a LoRa Application screen that appears, enter in the required information for creating a new application.
TIP: Stream has in-depth documentation on creating a LoRa Application available if you should need help with this process.
Once you have an application that you want to use, you can then add your devices to it.
Before you can use your device on the Stream network, it must be registered on the network. To accomplish this, devices must be added into an Application in IoT-X portal. The following information will help guide you through this process.
-
Expand the LoRa side menu. Select the Applications option to open the LoRa Applications screen.
-
Click on the name of the application you want to add the device to. The screen that appears will show you the details of your application, any existing registered devices and an Add a Device panel from which you can add new devices.
-
Refer to the Add a Device panel on the application screen. You can enter in all the required details for adding your device directly here. The Stream network supports both OTAA and APB activation.
TIP: If you need help with this part of the process you can refer to Stream's Adding devices to LoRa Applications documentation.
-
Click Add to complete adding your 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 can now be deployed and connected to the network for usage.
If your device needs to be programmed, you should now 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.
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 LoRaWAN category and then the Stream Network option to view a list of 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 Stream network, 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?
To see how easy it is, let’s walk through an example of connecting an Adeunis Pulse which was previously registered under a the Stream network account.
1. Choose the Network
Make sure the Stream network is selected in the list of LoRaWAN Networks.
2. Select the Device
Select your device from among the list of supported Stream network 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 a name. 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 the Stream network. Make sure
Already Registeredis selected in the Activation Mode field. - 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 sensors on the device.
About The Things Network
The Things Network is building a global, open, crowd-sourced Internet of Things data network which is owned and operated by its users. It is based on the technology called LoRaWAN which is perfect for the Internet of Things as it is low energy, long range and low bandwidth. The entire city of Amsterdam was covered with this network in less than 6 weeks and inspired hundreds of cities around the world to do the same.
Using The Things Network with Cayenne
Cayenne makes it easy to use your LoRa device and The Things Network. You will need to:
- Create / Log into your account on The Things Network portal
- Setup gateway device
- Create Application and configure Integration
- Register your device on The Things Network portal
- Program/Flash your device
- Add your device to your Cayenne dashboard
We will walk you through these steps in the following sections.
To create your account, visit The Things Network Sign Up page. From here you can enter in all the required details for creating your account.
Open The Things Network Console
Once you have your account and have signed in, you will want to access the Console which is where you can configure your Applications and Gateway devices. To access the console, expand your user menu and select the CONSOLE option. This will open the Console page.
In order for your LoRa technology devices to connect to The Things Network, you must have purchased and configured a gateway device. The Things Network has a Gateway page with information on hardware supported, including their own Gateway device (Coming Soon) that you can use.
Be sure that you have an appropriate gateway configured and working before continuing. Your devices will not be able to properly function without your gateway device in place.
If you need to register a new gateway device, you can do so from The Things Network console. To begin this process, log into your account and open the Console page. Select the Gateways link to open the Gateways screen. From here, select the register gateway link to begin the process of registering a new gateway.
You will then be guided through setting up your gateway device.
TIP: The Things Network has in-depth documentation on registering your gateway available if you should need help with this process.
In order for data from your device to reach Cayenne, you must configure your devices in The Things Network portal to forward data to Cayenne. The Things Network portal groups devices in what they call Applications. If you want to use a group of devices with Cayenne, you will need to configure your Application to use the Cayenne. You only need to perform this step once for each Application that you want to use.
To create an application, click add application in the console. The Add Application screen appears.
On the Add Application, fill in the required information to create your new Application.
Tip: If you need help with this part of the process, you can refer to The Things Network documentation on this step.
Once you have an application that you want to use, you can then proceed with configuring it to work with Cayenne.
To configure your Application to forward data to Cayenne you will need to add an Integration. To add the Cayenne integration, perform the following steps:
TIP: If you need additional help with this step you can also refer to The Things Network Add an Integration documentation for generic help on adding integrations.
-
Open your existing Application in the console.
-
Select Integrations from the top-right menu.
-
Click the add integration link.
-
Click to select the Cayenne integration option shown in the list. A list of options for the Cayenne Integration will then be shown.
-
Configure the Cayenne integration by entering in a Process ID. This can be any string of text that you want, such as "cayenne-ID".
-
Complete the Cayenne integration by selecting the Access Key to be used for downlink commands. In most cases you will simply need to select the default key for your application.
-
Click Add Integration to complete the setup.
Your application is now configured to forward data to Cayenne. You can now proceed with adding devices that use the application.
Before you can use your device on The Things Network, it must be registered on the network. To accomplish this, devices must be added into an Application in The Things Network console. The following information will help guide you through this process.
-
In the Console, from the Application or an application’s Devices screen, click register device.
-
Fill in the required information for registering your device.
TIP: If you need help with this part of the process you can refer to The Things Network device registration documentation.
-
Click Register to complete adding your 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 can now be deployed and connected to the network for usage.
If your device needs to be programmed, you should now 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.
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 Things Network option to view a list of 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 Things Network, 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?
To see how easy it is, let’s walk through an example of connecting an Adeunis Pulse which was previously registered under a The Things Network account.
1. Choose the Network
Make sure The Things Network is selected in the list of Networks.
2. Select the Device
Select your device from among the list supported The Things Network 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 a name. 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 The Things Network. Make sure
Already Registeredis selected in the Activation Mode field. - 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.