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
  • 1. Device Addition
  • Product definition
  • Configuration Fields
  • Batch addition of devices
  • 2. Data Ingestion Rate Guidelines for Datacake
  • 3. Workspace management
  • 4. Application of Tags
  • 5. List and Grid Views

Was this helpful?

  1. Best practices

Best practices: Getting started

Last updated 8 months ago

Was this helpful?

1. Device Addition

Product definition

Initiating your journey with the 'Product' definition is fundamental. This approach is the cornerstone of easy fleet management. By using Products, you ensure that all devices on one kind inherit essential characteristics, creating a uniform yet flexible operating environment.

All Devices belonging to one same Product have the same Payload Decoder, Fields and Dashboard. If you modify one device, all of them will reflect those changes. This enables you to manage fleets of hundreds of devices, maintaining the integrity ensuring that your whole IoT fleet stays up to date.

In the following video you will learn how to add a device to an existing product.

Configuration Fields

Configuration fields introduce a layer of customisation for the individuality of each device and offer flexibility when using the Product definition. This is important when devices require unique operational parameters, ensuring they perform their roles effectively.

If, for example, your gas tank filling measuring devices are all of the same type, however, they are installed in tanks of different heights. In this case the configuration fields allow you to define a different height value for each tank. These can be used in the payload decoder to make calculations, or they can be called within the new rule engine to trigger notifications.

Batch addition of devices

Utilising the CSV drag-and-drop feature for adding devices is more than an operational shortcut; it's a growth strategy. By integrating multiple devices simultaneously, you maintain a rhythm and coherence to your expanding network. This strategic addition ensures your system scales with purpose, keeping complexity at bay.

There is not known limit to the amount of devices you can add at once to Datacake. Make sure all DevEUIs are unique, otherwise you will get an error No valid DevEUIs were found in the CSV file.

Make sure that the order of the columns on the CSV file is correct and that there are no empty rows or columns. The order must be DevEUI, Name, Location description, Tags.

Location description and Tags are optional columns. The tags must be separated by commas in the same column of the document.

Here an example of a CSV file containing all columns mentioned:

49 54 95 75 56 55 65 66

Device 1

First Floor

Office01, Temperature

49 23 47 30 94 74 38 24

Device 2

Second Floor

Office02, CO2

For batch adding devices to the Datacake LNS you need to prepare the CSV file with the following information:

DevEUI, Name, AppEUI (or JoinEUI), AppKey, Frequency, Class, Location description, Tags.

49 54 95 75 56 55 65 66

Device 1

cd1a75ae5818dcbe

c39ebd8578c3d7ac6dfef73afb60dfba

EU_863_870_TTN

A

First Floor

Office01, Temperature

49 23 47 30 94 74 38 24

Device 2

cd1a75ae5818dcbe

f171b14be6e3494ce6da3dd8e67cbb8c

EU_863_870_TTN

A

Second Floor

Office02, CO2

Remember that DevEUI and AppEUI are strings 8 bytes long. AppKey is a 12 byte string. All of them should be provided by your device manufacturer.

We currently support the frequencies:

  • EU_863_870_TTN

  • US_902_928_FSB_2

And the devices classes:

  • A

  • C

Please make sure the frequency and class are written correctly, exactly as shown above.

Again, Location description and Tags are optional columns.

Make sure that your CSV file doesn't have a header with the titles (it should simply start with the first device). Otherwise the platform will return an Error message.

2. Data Ingestion Rate Guidelines for Datacake

To ensure optimal performance and reliability, all IoT devices connected to Datacake must adhere to the following data ingestion guidelines:

  • Minimum Ingestion Interval: Devices should not send payloads at intervals of less than 1 minute. The Datacake platform is not designed to handle high-frequency data transmission, and payloads sent at rates faster than this may result in data loss or system instability.

  • Intended Use: Datacake is optimised for IoT devices that typically transmit data a few times per day. Our infrastructure and functions are built around this usage pattern, and adhering to these guidelines will help maintain system efficiency and reliability.

Please configure your devices accordingly to prevent any potential issues with the platform features.

3. Workspace management

Implementing separate workspaces for different tenants is a practice of meaningful delegation. You can manage who gets access to what in an easy way.

If you have multiple customers/locations/departments, the easiest way to grant access to specific devices is to have different workspaces for each one of them.

This structure safeguards your devices, ensuring it remains a hub for all devices, while subsidiary workspaces function as dedicated environments tailored to specific tasks or teams. This clear delineation promotes responsible access and efficient management.

An additional advantage of employing this structure is that it ensures the receipt of a unified invoice including all devices in the master workspace, due to the fact that the billing procedure is conducted on a per-workspace basis.

4. Application of Tags

By applying tags, you facilitate targeted reporting, efficient rule-setting, and effective device visualisation.

You can set/create tags when adding the devices to the platform. You can also add them once the devices are on the platform using the Actions/Add Tags button or by navigating to each device's configuration section.

You can manage devices and sort them by type/location/owner, among others. Tags can be used to generate reports in device batches, create custom notifications in the new rules system or add them to the map widget.

The following video shows you some uses of implementing tags to your device administration.

5. List and Grid Views

Choosing between List and Grid views is a decision rooted in your information needs. This choice influences how you interact with your fleet data, prioritising the most critical metrics front and center. By customising these views, you are making a conscious decision about what metrics drive your decisions daily.

You can select the fields that are displayed under Columns (Online status, name, primary, secondary, device battery, device signal, tags, product, etc.).

Keep in mind that the selected columns are stored in the caché memory of your browser, so your customers or users within the platform will have the possibility to select the columns that are important to them. This facilitates customisation, therefore if you want your customers to see certain parameters then you will have to create custom views using global dashboards.

When having control over the devices is important, Datacake recommends you to create a master workspace, to which you will add all of your devices, while having sub-workspaces for each one of your customers. You can use the functionality to claim specific devices to those sub-workspaces.

Learn more about Products.
Learn more about Configuration Fields.
Pincode claiming