> For the complete documentation index, see [llms.txt](https://docs.widgelix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.widgelix.com/lorawan-network-server/devices.md).

# Devices

Register LoRaWAN end devices with OTAA or ABP keys.

The **Devices** tab contains the end devices registered on the network server. These are radio registrations; the decoded data, dashboards and actions live on the [asset](https://docs.widgelix.com/assets/assets-list.md) with the same DevEUI.

The list shows **DevEUI**, **Name**, **Description**, **Device profile** and **Last seen**. Use the search to find devices by name or ID.

## Add a device

Click **+ Add device**. The dialog has a navigation on the left: **General**, **Options**, **Tags**, **Variables**, **OTAA keys** and **ABP activation** (marked *n/a* while the selected profile uses OTAA).

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FNSoPDjaspoxl7XdgO9gV%2Fdevice-general.png?alt=media&amp;token=aba41374-26c7-4d0d-9929-6814c88f8d02" alt="Add device, General"><figcaption><p>General section (demo values)</p></figcaption></figure>

### General

| Field              | Required | Description                                                                                                                                                           |
| ------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **DevEUI**         | Yes      | Pick an existing platform asset from the list, or click **Enter DevEUI manually** and type the 16 hex characters. Use **Select from platform assets** to switch back. |
| **Name**           | Yes      | Device name. Filled automatically when you pick an asset.                                                                                                             |
| **Device profile** | Yes      | A [device profile](https://docs.widgelix.com/lorawan-network-server/device-profiles.md) created before.                                                               |
| **Description**    | No       | Optional notes.                                                                                                                                                       |
| **JoinEUI**        | For OTAA | JoinEUI (AppEUI) of the device.                                                                                                                                       |

{% hint style="info" %}
Picking the DevEUI from your platform assets links the network-server registration to the existing asset, so its data appears on the asset's dashboard immediately.
{% endhint %}

### Options

| Setting                      | Description                                                                                                       |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Skip frame-counter check** | Accept uplinks with reset frame counters. Less secure, use only for testing or devices that reset their counters. |
| **Disabled**                 | Ignore uplinks from this device without deleting it.                                                              |

### Tags and Variables

* **Tags**: key–value metadata forwarded with every uplink. Click **+ Add** to add an entry.
* **Variables**: values available to the payload codec.

### OTAA keys

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2F4ImSuJyXIFQHTk764meI%2Fdevice-otaa-keys.png?alt=media&amp;token=07e0c164-e2f8-45ab-8181-d845c61a1a2b" alt="OTAA keys"><figcaption><p>OTAA keys and ABP activation</p></figcaption></figure>

| Key           | Description                                                               |
| ------------- | ------------------------------------------------------------------------- |
| **AppKey**    | Application root key, 32 hex characters.                                  |
| **NwkKey**    | Network root key, **LoRaWAN 1.1 only**. For 1.0.x devices leave it empty. |
| **GenAppKey** | Optional.                                                                 |

Each key field has a **Show** (eye) button, and AppKey/NwkKey have a **Generate** button that creates a random key. Enter the keys exactly as configured on the device or printed on its label, or generate a key and program it into the device.

{% hint style="warning" %}
If your browser offers to autofill these fields with a saved login or password, decline it. Browser autofill can put your email into JoinEUI or a saved password into AppKey. Always check the values before saving.
{% endhint %}

### ABP activation

For devices that use activation by personalization (profile with OTAA off):

| Field                                            | Description                                                                                      |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| **DevAddr**                                      | Device address, 8 hex characters.                                                                |
| **AppSKey**                                      | Application session key.                                                                         |
| **NwkSEncKey**, **SNwkSIntKey**, **FNwkSIntKey** | Network session keys. For LoRaWAN 1.0.x devices, enter the device's NwkSKey in all three fields. |
| **FCntUp**, **NFCntDown**, **AFCntDown**         | Frame counters.                                                                                  |

Click **Add device** to save.

## OTAA or ABP?

| Method                 | When to use                                                   |
| ---------------------- | ------------------------------------------------------------- |
| **OTAA** (recommended) | Production. Devices join securely and get fresh session keys. |
| **ABP**                | Testing, legacy devices or devices without OTAA support.      |

The activation method must match the device profile and the device configuration.

## Edit or delete a device

* **Edit** to change the name, profile, keys or options. The DevEUI cannot be changed.
* **Delete** to remove the device from the network server. The asset in Widgelix is not deleted.
