Upload devices to your own Chirpstack instance

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.

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.

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.

1. Log into the Chirpstack console.

2. Select Applications.

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

   Open

   

    

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.

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.

Tips for selecting Device Profiles / which Device Class to use

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.