> 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/device-profiles.md).

# Device Profiles

Shared radio and MAC settings for groups of LoRaWAN devices.

A **device profile** defines the radio and protocol behaviour for a group of devices: frequency region, LoRaWAN MAC version, activation method (OTAA or ABP) and Class B / Class C support. Every device must use a profile, so create profiles before adding devices.

The **Device profiles** tab lists all profiles with their **Name**, **Region**, **MAC version**, **OTAA** and **Class B / Class C** support. Use the search to find a profile by name or region.

## Add a device profile

Click **+ Add device profile**. The dialog has a navigation on the left: **General**, **Join & activation**, **Class B**, **Class C** and **ABP parameters**. The badges next to the items show the current state (e.g. *OTAA*, *Off*).

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FwmBfb8h6DAMtbXnHLV20%2Fprofile-general.png?alt=media&amp;token=0d571466-1ce7-47e8-b9a8-ae19815bd7b9" alt="Add device profile, General"><figcaption><p>General section</p></figcaption></figure>

### General

| Field                            | Required | Default       | Description                                                                                     |
| -------------------------------- | -------- | ------------- | ----------------------------------------------------------------------------------------------- |
| **Name**                         | Yes      |               | e.g. `EU868 OTAA Class A sensors`.                                                              |
| **Description**                  | No       |               | Optional notes.                                                                                 |
| **Region**                       | Yes      | EU868         | Frequency plan. Must match your gateways and devices.                                           |
| **MAC version**                  | Yes      | LoRaWAN 1.0.3 | LoRaWAN version of the devices: 1.0.0, 1.0.1, 1.0.2, 1.0.3, 1.0.4 or 1.1.0.                     |
| **Regional parameters revision** | Yes      | A             | Regional parameters specification revision supported by the devices (see the device datasheet). |
| **Region config ID**             | No       |               | Optional, for a specific region configuration of the network server.                            |

Supported regions: EU868, US915, CN779, EU433, AU915, CN470, AS923, AS923-2, AS923-3, AS923-4, KR920, IN865, RU864, ISM2400.

### Join & activation

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FMhbShox0LAT7KpMqEEGx%2Fprofile-join.png?alt=media&amp;token=02c37a1a-5e01-4d33-9c5b-6b9151a403cf" alt="Join &#x26; activation and classes"><figcaption><p>Join &#x26; activation, Class B and Class C</p></figcaption></figure>

| Setting                               | Default | Description                                                          |
| ------------------------------------- | ------- | -------------------------------------------------------------------- |
| **OTAA**                              | On      | Over-the-air activation. Turn off for ABP devices.                   |
| **Flush queue on activate**           | On      | Clear pending downlinks after a (re)join.                            |
| **Allow roaming**                     | Off     | Allow the devices to be served via roaming.                          |
| **Auto-detect measurements**          | On      | Automatically detect the measurements sent by the devices.           |
| **Uplink interval, s**                | 0       | Expected interval between uplinks.                                   |
| **Device-status request interval, s** | 0       | How often the server requests the device status (battery, margin).   |
| **RX1 delay, s**                      | 0       | Delay of the first receive window.                                   |
| **ADR algorithm ID**                  | default | Adaptive Data Rate algorithm. Leave empty for the default algorithm. |

### Class B

Turn on **Supports Class B** for devices with scheduled receive windows (ping slots). Additional fields appear: **Class B timeout, s**, **Ping-slot periodicity**, **Ping-slot DR** and **Ping-slot frequency, Hz**.

### Class C

Turn on **Supports Class C** for devices that listen continuously (usually mains-powered, e.g. actuators). Set the **Class C timeout, s**.

### ABP parameters

Used only when OTAA is off: **RX1 delay**, **RX1 DR offset**, **RX2 DR** and **RX2 frequency, Hz**. Use the values configured in the device firmware.

Click **Add profile** to save.

{% hint style="warning" %}
Choose the **Region** and **MAC version** that match your hardware. Wrong values prevent devices from joining or communicating.
{% endhint %}
