JSON File Reference

The Things Stack allows you to import end devices from V2, ChirpStack and other LoRaWAN networks using a JSON file describing those devices.

Here is an example of an OTAA device description in the devices.json file:

{
  "ids": {
    "device_id": "my-device",
    "dev_eui": "0102030405060708",
    "join_eui": "0102030405060708"
  },
  "name": "My Device",
  "description": "Living room temperature sensor",
  "lorawan_version": "MAC_V1_0_2",
  "lorawan_phy_version": "PHY_V1_0_2_REV_B",
  "frequency_plan_id": "EU_863_870_TTN",
  "supports_join": true,
  "root_keys": {
    "app_key": {
      "key": "01020304050607080102030405060708"
    }
  }
}

Multiple end devices can also be contained in a single devices.json file like so:

[
  {
    /* device 1 */
  },
  {
    /* device 2 */
  }
]

JSON End Device Format

The full specification of the JSON format is defined in the API protos.

See the EndDevice message definition for details.

The linked specification is quite extensive, and contains a lot of fields that are not required, or are only set and used internally by the Network Server. Below, the required and most commonly used fields are discussed.

"root_keys": {
  "nwk_key:": {
  "key": "<NWK_KEY_HERE>"
  }
}