Datacake Docs
  • Welcome
  • Get Started
  • Changelog
  • Best practices
    • Best practices: Getting started
    • Best practices: Resolution (Timeframe)
    • Best practices: Dashboards
    • Best practices: Reports
    • Best practices: Grouping Devices
  • Datacake LNS
    • Getting Started
    • Gateways
      • Milesight LoRaWAN Gateway - UG6x
      • RAKwireless WisGate Edge Light 2
    • Devices
    • Add Devices without Gateway
  • Device
    • Product
    • Configuration
    • Claiming
    • Historical Data
    • Database
      • Configuration Fields
      • Fields
        • Manual input
        • Field Roles
        • Formulas
        • Mapping Fields
      • Data retention & Datapoints
      • Examples
        • Mapping 4-20mA Signals
        • Converting Units
  • Dashboards
    • Global Dashboards
      • Setting Homepage
    • Device Dashboards
    • Multi-Device Dashboards
    • Widgets
      • Value Widget
      • Chart Widget
      • Image Map
      • Map Widget
      • Text Widget
      • SOS Widget
      • Boolean Widget
      • iFrame Widget
      • Downlink Widget
      • Set Value Widget
      • Measurement List Widget
      • Heatmap Widget
      • Table Widget
      • Image Widget
  • Portal
    • Multi-Tenancy (Workspaces)
    • Reports
      • Energy Report
    • Administrators
    • Members
      • API Users
    • Security & Privacy
    • Billing
      • Support Packages
      • VAT Exemption / Tax ID
      • SMS Credits
      • Access Invoices
      • Unused time and Remaining time in Invoices (Prorations)
      • Codes
    • White Label
    • Rules
      • Legacy Rule Engine
        • Sending notifications via Telegram
      • New Rule Engine
        • Rule Engine Table Overview
        • Copy/Paste and Template Functionality
        • Advanced Rule Engine E-Mail and Webhook Templates
        • Time Restrictions
    • Zones
  • Cake Red
    • Get Started
    • Overview
  • LoRaWAN
    • Get Started
      • CSV Import
      • Custom LoRaWAN Device
    • Configuring LNS
      • The Things Stack (TTN / TTI) Automated Setup
      • The Things Stack (TTN / TTI) Manual Setup
      • Loriot
      • Kerlink Wanesy
      • Helium
      • ChirpStack
      • Tektelic
      • Actility ThingPark
      • Senet
      • Milesight Gateway
      • KPN
    • Downlinks (LoRaWAN)
      • Set Time Frame
    • Securing Webhooks
    • Payload Decoders
      • Location and GPS
      • Access Gateway Metadata
      • Access Measurements
      • Global Variables
    • Using Cayenne LPP
    • Converting Payload
  • Generic API Devices
    • HTTP Downlinks
  • Integrations
    • MQTT
    • Particle
      • Get Started
      • Adding Integrations
      • Decoding Payloads
      • Calling Functions
      • Templates
        • Particle Tracker One
    • Incoming Webhooks
    • Outgoing Webhooks
      • Securing Outgoing Webhooks in Datacake
    • Golioth
    • Blues Wireless Notecard
    • Sigfox
    • Swarm Asset Tracker
    • Grandcentrix Modbus Cloud Connect
    • YuDash LYNX IoT Gateway
    • Dragino NB-IoT
      • Changing NB-IoT Bands
    • Hardwario CHESTER
    • 1NCE OS
  • API
    • Exporting Data
    • Record Measurements via API
    • Node RED to Datacake
    • Generate Access Token
    • Internal MQTT
      • Get Started
      • MQTT Documentation
      • MQTT over WebSocket
      • Example Code
    • GraphQL API
      • Using GraphQL
      • Device Creation
      • Tutorials
        • Read Group via Tags
  • Guides
    • Python
    • Send Slack Notifications
    • Forward Data to Cake Red
    • Multiple Data Feeds
    • Automated Dynamic Downlinks
    • Ingesting JSON Data into Datacake API Devices
    • Working with Default HTTP Decoder on API Devices and Code Examples
    • Accessing Measurements in Decoders
    • Connecting Datacake to Notion Using Zapier
    • How to set up and use location on non-GPS devices
    • How to integrate with AWS IoT Core
    • How to Schedule Mass-Downlinks (Multicast) using Datacake Rule Engine
    • How to Map Sensor Values to Ranges or Booleans, Strings using Mapping Fields
    • Understanding Internal vs. External MQTT Brokers on Datacake
    • Sending UDP Messages between 1NCE OS and Datacake
    • Concepts of LoRaWAN Payload Decoders on Datacake
    • How to check if a value stays above or below limits for given time
Powered by GitBook
On this page
  • About this Tutorial
  • Requirements
  • Create Account
  • Create Device
  • Select Cayenne LPP Template
  • Select Device Plan
  • Select LoRaWAN Network Server
  • Enter DevEUI
  • Setting Webhook Forward
  • Debugging Connection
  • Accessing Debug Console
  • Configuration
  • How it works
  • Create Fields
  • Automated Mapping
  • Editing Payload Decoder
  • Next Steps
  • Create a Dashboard

Was this helpful?

  1. LoRaWAN

Using Cayenne LPP

How to use Cayenne LPP on Datacake

Last updated 4 years ago

Was this helpful?

About this Tutorial

If you are working with Cayenne LPP on your LoRaWAN Devices, Datacake offers a ready-to-use template.

Requirements

  • A Cayenne LPP LoRaWAN Device

  • A LoRaWAN Gateway and Network Server (like or )

  • A free Datacake Account

Create Account

This tutorial expects that you have registered on the Datacake Platform. If you haven't already done so, please head over to and create a Free Account on Datacake.

Create Device

Now navigate into the Device Overview of your Workspace and create a new device.

Select Cayenne LPP Template

After you have clicked on Adding a new Device you will see a list of available LoRaWAN Templates.

  • Use the search field and search for "Cayenne" or select "Datacake" from the list of available Manufacturers

  • Select "Cayenne LPP Starting Templates" from the list of results

Select Device Plan

The next step in adding a device is choosing a device plan.

  • When this is the first device that you are going to create, you can select "Free"

Select LoRaWAN Network Server

After you have chosen the plan you are required to set the LoRaWAN Network Server.

Datacake TTN

We have public applications for the Cayenne LPP Template on the TheThingsNetwork LoRaWAN Server. If you already have a TTN enabled gateway or TTN Network coverage in your area, you can use the LoRaWAN Server Option to Datacake without the need of setting up an Application on the TTN Console.

Read more about that option here:

Enter DevEUI

To finalize the creation of your new device, you need to enter its DevEUI and set a Name using the following dialog:

  • Name: Enter a Name for your Device - you can change this at any later time

  • Device EUI: This is the DevEUI from your Device. You can find that on your LoRaWAN Network Server or in the Code of your Device.

After you have entered this required information, you have to click on the "Add Device" button. The Device will now be created and you should see the Device-View:

Datacake TTN

If you have selected the Datacake TTN Option you need to provide not only the DevEUI but also AppEUI and AppKey in order to be able to add the Device on Datacake.

Setting Webhook Forward

Datacake receives information from the LoRaWAN Network Server via Webhook.

In order to forward Data from your LNS to Datacake, you need to set up a Webhook in the Application of the Network Server. Read more about how you configure the Webhook forward on your LNS:

Send Downlinks

By setting up the LNS it's also possible to send Downlinks to your Cayenne LPP Device. Read the following Page to know more about how you set up Downlinks for your Device:

Debugging Connection

If you have set up a Webhook on your LoRaWAN Network Server and your Device is already sending Data, you should be able to see this on Datacake.

Accessing Debug Console

For better debugging purposes, every device on Datacake has a Debug-Console that you can access from the Device-View by using the top Tab-Bar:

In this view, you will see the last 100 Messages and also some basic error logs. If data was successfully received by your device, this will look like the following:

In the above screenshot you see two messages:

  1. A successfully receive webhook data forward from TTN

  2. The Payload Decoder inside our Cayenne LPP Template was able to decode the bytes and record a measurement value into a database-field of that device.

Congratulations! You have forwarded your first Data packages from your Cayenne LPP Device to Datacake.

I see the Webhook Log but no data has been recorded?

If you don't see data being recorded into the database fields of your newly created device, that's OK as we most likely have to create fields for your particular application first.

This is covered in the next chapter.

Configuration

As the Cayenne LPP format can be used dynamically we cannot create Database Fields because we simply do not know what you are going to use it for.

So we are now going to show you how you create Database fields for the measurement values you are going to send.

How it works

By using the Cayenne LPP Template on Datacake you will have a device with an embedded payload decoder that you can use as a starting point (and modify it at any time).

This decoder transforms messages into values that can be stored in the Database of your Datacake-Device. The decoding takes place according to the Cayenne LPP specification.

Create Fields

For each Channel and Type, you want to send from your Device, you have to create a field in the Database. This looks something like the following:

So and now:

Automated Mapping

When your Device sends a value or payload (of multiple values) in the Cayenne LPP format, the decoder will turn this into a format that matches the Datacake API Structure.

This is then mapped automatically to a corresponding Database field in the "Fields"-List inside the configuration tab:

If the Field is not available in the List of "Fields", you need to create a new field and set the Identifier of that field to the Output of the payload Decoder.

Example

If the Payload Decoder Output is like:

[
    {
        "field": "ANALOG_OUTPUT_0",
        "value": 223.76
    }
]

You need to create a field with the Identifier set to ANALOG_OUTPUT_0

Editing Payload Decoder

If you want to make changes to the Payload Decoder you can access that from within the configuration view of your Device.

This will show you the decoder:

Read more about the creation and editing of Payload Decoders on Datacake:

Next Steps

Create a Dashboard

Head over to the Dashboard View using the Tab Bar of your Device and create a Dashboard that shows the measurement values of your device:

Datacake allows having 2 free devices in your Workspace. Additional Devices can be individually purchased by choosing one of the available plans. We have different plans for different use-cases available. Read more about Pricing on

https://datacake.co/pricing
Configuring LNS
Downlinks (LoRaWAN)
Payload Decoders
TTN
Loriot
https://app.dacake.de/signup