Handling MAC Commands

End Device Transmit Parameters Request (TXParamSetupReq)

The network server requests a modification of the maximum continuous time of a packet over the air (dwell time) to a setting that is lower than the regional limitation using the TXParamSetupReq command. The maximum allowed Effective Isotropic Radiated Power (EIRP) is modified to a setting lower than the regional limitation using the same command.

Note

This command is only to be handled by end devices operating in certain regions. Find if the TXParamSetupReq command is supported in a given region in the ‘Data Rate and End-device Output Power encoding’ subsection for the region in Section 2 of the RP002-1.0.4 LoRaWAN® Regional Parameters specification.

If the TXParamSetupReq command is not supported in the region where the end device operates, the end device must not send an answer. If the command is supported, the end device must change its settings to the requested settings if they are lower than the regional limit. Find the dwell time limitation for a given region in the ‘Data Rate and End-device Output Power encoding’ subsection for the region in Section 2 of the RP002-1.0.4 LoRaWAN Regional Parameters specification. The end device then must respond using a TXParamSetupAns command, as described in section End Device Transmit Parameters Answer of the Sending Messages Book. The TXParamSetupAns is sent to confirm receipt of the request and does not contain any payload.

Learn more in Section 5.8, ‘End-Device Transmit Parameters’ (page 40) of the LoRaWAN Link Layer Specification v1.0.4.

Warning

If the TXParamSetupAns command needs sending, it must be sent with every single uplink until a Class A downlink is received back from the network server to avoid connectivity loss.

If your device uses Activation by Personalization (ABP), the settings updated by this command must not be altered when the device is reset, and therefore should be stored in non-volatile memory (NVM).

Read more in section Handling Commands That Modify Downlink Parameters.