Document

TS006-1.0.0 Firmware Management Protocol

Issue link: https://read.uberflip.com/i/1464685

Contents of this Issue

Navigation

Page 8 of 13

LoRaWAN ® Firmware Management Protocol Specification TS006-1.0.0 ©2022 LoRa Alliance ® Page 9 of 14 The authors reserve the right to change specifications without notice. The RebootTime field of the answer encodes the number of seconds between sending the 235 DevRebootTimeAns message until reboot. 236 237 The DevRebootTimeAns command can also indicate an error or acknowledge a reboot 238 cancellation: 239 • A value of 0x00000000 of the RebootTime field in the DevRebootTimeAns 240 message indicates the inability of the end-device to reboot at the requested time. 241 • A value of 0xFFFFFFFF of the RebootTime field in the DevRebootTimeAns 242 message acknowledges the cancellation of a currently programmed reboot. 243 3.4 Device Reboot Countdown Commands (DevRebootCountdownReq, 244 DevRebootCountdownAns) 245 246 The DevRebootCountdownReq command is used by the Application Server to instruct an 247 end-device's application to program a hardware reboot after a given time period. If a valid 248 firmware upgrade image is present at the time of reboot, this upgrade SHALL be installed, 249 and the end-device SHALL reboot with a new firmware version. 250 251 The command's payload is: 252 253 Size (octets) 3 Field Countdown Table 6: DevRebootCountdownReq 254 A value > 0 but < 0xFFFFFF of the 24-bit integer Countdown field encodes the number of 255 seconds after which the end-device SHALL reboot, after reception of the 256 DevRebootCountdownReq command. 257 Note: The maximum allowed value of 0xFFFFFE corresponds to 258 16777214 seconds, which equates to 194 days, 4 hours, 20 minutes, 259 and 14 seconds. 260 261 • A value of 0x000000 instructs the end-device to reboot as soon as possible. 262 • A value of 0xFFFFFF instructs the end-device to cancel a currently programmed 263 reboot. 264 265 The end-device SHALL only store a single programmed reboot event, meaning that any 266 received valid DevRebootTimeReq or DevRebootCountdownReq command overwrites a 267 previously received reboot command. 268 269 The behavior of the end-device upon reception of a DevRebootCountdownReq command 270 is as follows: 271 • If the Countdown field has a value of 0x000000, the end-device SHALL reboot as 272 soon as possible. 273 • If the Countdown field has a value > 0 but < 0xFFFFFF, the behavior is as follows: 274 1. If the end-device is capable of measuring time duration in seconds, the end- 275 device SHALL reboot when the duration indicated by the Countdown field 276 has elapsed. 277

Articles in this issue

view archives of Document - TS006-1.0.0 Firmware Management Protocol