<commit_before># Adaptive Data Rate (ADR)

For each node you can set the desired power, data rate and channels (frequencies)
to be used for uplink transmissions.

Please note that this functionality must be enabled in the device and requested
by the server.

## Device Configuration

For each OTAA device you can define which ADR parameters shall be requested when
the device joins the network:
 - **Set ADR** can be used to request or disable ADR for this device;
 - **Set Power** defines the power (in dBm) to be requested;
 - **Set Data Rate** defines the data rate;
 - **Set Channels** defines the set of channels.

See the [Administration Guide](doc/Administration.md) for more details on the
server administration.

## Link Configuration

For each connected node (link) you can define ADR paramaters to be requested by
the server. Initally, this is the Device Configuration.

The server administration also displays the last accepted node settings:
 - **Use ADR** indicates whether the node can do ADR;
 - **Use Power** indicates the last accepted TX power setting (in dBm);
 - **Use Data Rate** indicates the data rate;
 - **Use Channels** indicates the set of channels.

The ADR request to change these settings is sent to the device only when both
**Set ADR** and **Use ADR** are `ON`, when all ADR settings are defined (not null)
and when some ADR parameter differs from the last accepted setting.
<commit_msg>Documentation: One more clarification<commit_after># Adaptive Data Rate (ADR)

For each node you can set the desired power, data rate and channels (frequencies)
to be used for uplink transmissions.

Please note that this functionality must be enabled in the device and requested
by the server.

## Device Configuration

For each OTAA device you can define which ADR parameters shall be requested when
the device joins the network:
 - **Set ADR** can be used to request or disable ADR for this device;
 - **Set Power** defines the power (in dBm) to be requested;
 - **Set Data Rate** defines the data rate;
 - **Set Channels** defines the set of channels.

See the [Administration Guide](doc/Administration.md) for more details on the
server administration.

## Link Configuration

For each connected node (link) you can define ADR paramaters to be requested by
the server. Initally, this is the Device Configuration.

The server administration also displays the node settings:
 - **Use ADR** indicates whether the node can do ADR;
 - **Use Power** indicates the last accepted TX power setting (in dBm);
 - **Use Data Rate** indicates the data rate;
 - **Use Channels** indicates the set of channels.

The ADR request to change these settings is sent to the device only when both
**Set ADR** and **Use ADR** are `ON`, when all ADR settings are defined (not null)
and when some ADR parameter differs from the last accepted setting.

If the device does not support (or allow) some of the requested settings, the
entire request will fail. When a request fails, the requested ADR parameter(s) that
caused the failure will be cleared (set to null) and no other parameter will become
effective.

{'fraction_non_alphanumeric': 0.06467181467181467, 'fraction_numerical': 0.0, 'mean_word_length': 4.397569444444445, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2695112', 'n_tokens_mistral': 798, 'n_tokens_neox': 775, 'n_words': 482}