Adding Devices

Adding Devices using the Console

To create a device, first open the application you wish to add the device in. Go to End devices in the left menu and click on + Add end device to reach the end device registration page.

Using the LoRaWAN Device Repository

The LoRaWAN device repository contains device profiles, LoRaWAN information, codecs, and more, for many LoRaWAN devices. Using the device repository to add devices in The Things Stack automatically uses the correct LoRaWAN version and regional parameters version, which means less information for you to find!

In addition to the written instructions below, a video with instructions for adding a device using the device repository is available on The Things Network youtube channel.

To use the device repository, make sure the From the LoRaWAN Device Repository tab is selected. Then, select the Brand, Model, Hardware Version, Software Version, and Region for your device.

Choose a Frequency plan appropriate for your region. Your device and gateway must use the same frequency plan to communicate.

Enter a JoinEUI/AppEUI if provided by your manufacturer. If your device is programmable, you may use all 0’s, and then program the same JoinEUI/AppEUI in the device.

Enter your DevEUI.

If your manufacturer provides an AppKey, enter it. Otherwise, use the generate button to create one, and program it in to your device.

Finally, give your device a unique End device ID, and click the Register end device button to create the end device.

The device is now activated, and will appear as connected in The Things Stack once it sends an uplink.

Manually Create End Device

If your device is not in the device repository, you may manually register it.

Make sure the Manually tab is selected.

Choose the Activation Mode.

Select the device LoRaWAN version.

If using Over-the-Air-Activation (OTAA) and an External Join Server, tick the External Join Server button.

The Network Server, Application Server, and Join Server addresses should correctly point to the address of The Things Stack deployment you are using.

Click the Start button to proceed to the Basic Settings page.

Give your device a unique End device ID.

Enter a JoinEUI/AppEUI if provided by your manufacturer. If your device is programmable, you may use all 0’s, and then program the same JoinEUI/AppEUI in the device.

Enter your DevEUI.

Name and Description are optional fields to help you identify your device.

Click Network Layer Settings to proceed to the next page.

Choose a Frequency plan appropriate for your region. Your device and gateway must use the same frequency plan to communicate.

Choose the Regional Parameters version provided by the manufacturer of your device. This should be specified in the data sheet as Regional Parameters or PHY version.

If your device supports Class B or Class C features, you may enable them using the checkboxes.

There are also advanced settings to configure Frame counter width and RX2 settings, but these should not be necessary for most devices.

Click the Join settings button to proceed to the next page.

If your manufacturer provides an AppKey, enter it. Otherwise, use the generate button to create one, and program it in to your device.

There are also advanced settings to configure Net ID, Application Server ID, and KEK Labels, but these are not necessary for most devices.

Finally, click Add end device to register the end device.

Adding Devices in Bulk

It is also possible to import end devices in bulk, using a file format defined in the JSON file reference. See the following video from The Things Network youtube channel for instructions.

Set Device Location in the Console

Once you have added your end device to The Things Stack, you can also set its location to be displayed on a map widget by clicking Change location settings.

The end device location can be manually set by pinning on the map widget, or entering the Latitude, Longitude and Altitude values.

Adding Devices using the CLI

First, list the available frequency plans and LoRaWAN versions:

$ ttn-lw-cli end-devices list-frequency-plans
$ ttn-lw-cli end-devices create --help

Over-The-Air-Activation (OTAA) Device

To create an end device using over-the-air-activation (OTAA):

$ ttn-lw-cli end-devices create app1 dev1 \
  --dev-eui 0004A30B001C0530 \
  --app-eui 800000000000000C \
  --frequency-plan-id EU_863_870 \
  --root-keys.app-key.key 752BAEC23EAE7964AF27C325F4C23C9A \
  --lorawan-version 1.0.3 \
  --lorawan-phy-version 1.0.3-a

This will create a LoRaWAN 1.0.3 end device dev1 in application app1 with the EU_863_870 frequency plan.

The end device should now be able to join the private network.

Activation By Personalization (ABP) Device

It is also possible to register an ABP activated device using the --abp flag as follows:

$ ttn-lw-cli end-devices create app1 dev2 \
  --frequency-plan-id EU_863_870 \
  --lorawan-version 1.0.3 \
  --lorawan-phy-version 1.0.3-a \
  --abp \
  --session.dev-addr 00E4304D \
  --session.keys.app-s-key.key A0CAD5A30036DBE03096EB67CA975BAA \
  --session.keys.nwk-s-key.key B7F3E161BC9D4388E6C788A0C547F255

Set Device Location with the CLI

Once you have added your end device to The Things Stack, you can also set its location.

Set your end device’s location with:

$ APP_ID="your-application-id" 
$ DEVICE_ID="your-device-id"
$ ttn-lw-cli end-devices set $APP_ID $DEVICE_ID \
  --location.latitude 43.84 \
  --location.longitude 18.32 \
  --location.altitude 500 \

You can also set the end device location to be updated from various sources with the --location.source flag. The source of the location data can be the registry, GPS data, results of the LoRa RSSI geolocation, etc.

The CLI will return something like:

{
  "ids": {
    "device_id": "dev1",
    "application_ids": {
      "application_id": "app1"
    },
    "dev_eui": "0004A30B001C0530",
    "join_eui": "800000000000000C"
  },
  "created_at": "2020-05-27T15:50:38.567Z",
  "updated_at": "2020-12-25T11:16:20.592Z",
  "locations": {
    "user": {
      "latitude": 43.84,
      "longitude": 18.32,
      "altitude": 500,
      "source": "SOURCE_REGISTRY"
    }
  }
}