ADR Algorithm Improvement
Send the following POST request to /api/networkSettings endpoint:
curl --location 'https://{host}}/api/networkSettings' \
--header 'x-Authorization: Bearer {Token}' \
--header 'Content-Type: application/json' \
--data '{
"id": {
"id": "{id}"
},
"createdTime": 0,
"additionalInfo": null,
"entityId": {
"entityType": "{entity_type}}",
"id": "{entity_id}"
},
"rxWindow": 0,
"rxDelay": 0,
"rx2DataRate": -1,
"rx2Frequency": 0,
"rx1DataRateOffset": 0,
"adrInterval": 1,
"installationMargin": 0,
"cfList": [],
"chMaskCtrlDataList": null,
"newChIndex": 0,
"newChFrequency": 0,
"newChMaxDr": 0,
"newChMinDr": 0,
"pingSlotDr": 0,
"pingSlotFreq": 0,
"beaconFreq": 0,
"clearDlQueueUponJoin": false,
"adrMinDr": null,
"adrMaxDr": null,
"adrMinTxPower": null,
"adrMaxTxPower": null,
"adrGracePeriod": null,
"downlinkDwellTime": null,
"uplinkDwellTime": null,
"maxEIRP": null,
"adrNbTransRanges": {
"0": {
"minNbTrans": 1,
"maxNbTrans": 3
},
"1": {
"minNbTrans": 1,
"maxNbTrans": 3
}
},
"adrConservativeSlope": true,
"fcntCheck": true
}'
{host}
= Network Server or OAM host{id}
= id{entity_type}
= APPLICATION or DEVICE{entity_id}
= APPLICATION ID or DEVICE ID{minNbTrans}
= Nb Trans value: 1-3 (value couldn’t be higher than Max NbTrans){maxNbTrans}
= Nb Trans value: 1-3 (value couldn’t be lower than Min NbTrans)
- Data Range allowed: DR0 - DR15
- Min NbTrans: 1-3 (value couldn’t be higher than Max NbTrans)
- Max NbTrans: 1-3 (value couldn’t be lower than Min NbTrans)
Changes in ADR section in Network Settings body for POST methods:
- ADR setting fields to be removed:
"adrMaxNbTrans": 0,
"adrMinNbTrans": 0,
}
- ADR setting fields to be added:
"adrConservativeSlope": true,
"adrNbTransRanges": {
"0": {
"maxNbTrans": 0,
"minNbTrans": 0
},
"1": {
"maxNbTrans": 0,
"minNbTrans": 0
},
"2": {
"maxNbTrans": 0,
"minNbTrans": 0
}
...
}
...
}
Other fields in Network Settings body remain unchanged.
To check the NbTrans Ranges send the following GET request to /api/networkSettings endpoint:
curl --location 'https://{host}}/api/networkSettings/{entity_type}/{entity_id}' \
--header 'x-Authorization: Bearer {Token}}' \
--data ''
{host}
= Network Server or OAM host{id}
= id{entity_type}
= APPLICATION or DEVICE