Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Current »

The following will help guide in how to upload Devices into your own Organization instance on our Azure Chirpstack LNS. This will allow you to directly upload Device IDs and register hardware for use with Chirpstack without having to contact myDevices.

This article covers how to upload Devices. You may also wish to see our Gateway article for information on how to upload those.

Things you will need to get started

  • Your IoT Console credentials - You will use the IoT Console to upload Device IDs so that they are recognized within the dashboard app.

  • Your Chirpstack Login credentials - You will need to use the Chirpstack console to register the device for use with the network. See also: Request access to Chirpstack

How to add Devices

Devices need to be registered in both the IoT Console as well as in the Chirpstack console. This is necessary so that both the dashboard app and the network server recognize the hardware. For all the hardware sold and shipped my myDevices we do this for you, however if you want to bring your own hardware these steps are necessary.

Currently, Devices can only be added individually in Chirpstack console. If you want them batch added you will need to submit a request for us to process the batch for you.

Coming soon: We are working on giving our partners the ability to batch add devices into both the Device Registry and into Chirpstack from a single step in the IoT Console Upload wizard! Stay tuned.

Step 1: Add Devices to IoT Console

In this step you will add the Devices IDs to the IoT Console so that they are recognized by the dashboard app.

<QUICK VIDEO SHOWING THIS>

  1. Log into the IoT Console.

  2. Go to the Device Registry screen.

  3. Select Upload Devices.

  4. Complete adding the Devices through the Upload Devices dialog.

    1. For Device Type please select the correct Template for use with this device. If there is any doubt which to use please Contact Us.

    2. Select the Chirpstack network server you are using. Commonly this will be myDevices CSIO (US) for the US-based Chirpstack instance. Please reference the Chirpstack information you received from us if you forget which instance to use.

    3. Under Select an Upload Option specify the Device IDs. Manual Input will let you specify an individual sensors and CSV Upload will let you upload a batch of IDs.

Step 2: Register Devices on Chirpstack

In this step you will register an individual device on Chirpstack so that it can be used with the network.

<QUICK VIDEO SHOWING THIS>

  1. Log into the Chirpstack console.

  2. Select Applications.

  3. In the list of Applications shown, click on the Application Name link.

  4. On the Applications> DEVICES screen that appears, select CREATE.

  5. Enter the General information on the device.

    1. For Device EUI specify the 16 digit DevEUI for the device.

    2. For Device-profile select the profile that corresponds with the gateway and hardware class for this device. See our tips below if you are ensure what to select here.

  6. Select CREATE DEVICE which will advance you to the next screen.

  7. Specify the Application Key and select SET DEVICE KEYS to finish setting up your device.

Your device is ready after adding your device to both the IoT Console and to Chirpstack. If you encounter any troubles with the device connecting, you can use the Chirpstack console to troubleshoot or change configuration settings as needed.

Batch adding Devices for Chirpstack use

Currently, Devices can only be added individually within Chirpstack console. If registering individually is too large a task, you can contact us and we can batch register them to your Chirpstack instance for you.

To do so, Contact us with the details for your device registration.

Please be sure to provide all the information we need to register your hardware.

  • Include all the Hardware IDs

  • Include Device / Device Type & Model

  • Include your Organization information and Device-profile information (the same data you would require when registering hardware in the IoT Console and Chirpstack Console is the information we would need as well).

Tips for selecting Device Profiles / which Device Class to use

Depending upon the complexity of your organization, you may see several Device-Profiles to choose from. You should select the profile which most closely matches with the hardware being added.

1: Match the sensor to the correct Frequency and Gateway

For example, if you are adding a device that uses the EU868 band and is being connected to an EU UDP gateway you should look for something such as “EU868-UDP”.

See: List of frequencies by country

2: Match the sensor to the correct Device Class

In some cases you may see a profile for Class A versus Class C devices. If you are uncertain which Class of device the sensor is, please refer to the manufacturer datasheets and information. You may find this type of resource linked in our dashboard under the Resources tab in Device Settings.

As a sort of general rule:

  • Class A for battery powered devices that wake up to communicate and have long battery life.

  • Class C for devices are often hardwired and stay awake so that they can react quickly to commands, such as actuators or valves.

  • No labels