Set Programming Request Flag (N) command [Release 3.5]
Description
(see command description format info here)
Function: | Sets a flag that will make the DS upgrade its firmware after the reboot |
Can be issued through: | Network (broadcasts ignored*, login required). UDP only, TCP/Telnet not supported. |
Command format: | N |
Possible replies: | A, D, F |
First introduced: | Earlier than "baseline" V3.51, not supported by Release3 firmware branch |
See also: | NetLoader |
Details
This command is only used on second-generation Devices (i.e. it is implemented on Release3.5 firmware only).
Set Programming Request Flag command programs a special word of data into the FLASH memory of the DS. When the DS reboots and the Monitor gains control it verifies the state of the flag. If the flag is set the Monitor copies new firmware file from the data FLASH memory of the DS into the program FLASH memory of the DS. After the programming is finished the Monitor resets the flag automatically. Before attempting to write into the program FLASH memory the Monitor verifies integrity of the data in the data FLASH. If the data is found to be corrupted the Monitor aborts the programming.
Set Programming Request Flag command is supposed to be used after the new application firmware file is uploaded into the data FLASH memory of the DS using Reset Upload Process (Q) and Upload Data Block (D) commands. Once the flag is set the DS should be rebooted with Reboot (E) command (to start FLASH copying process).
This command requires prior login using the Login (L) command (programming session must be opened). Denied (D) reply code is returned if the programming session is not in progress or if it doesn't belong to the sender of the command- the DS remembers the IP-address of the network host that opens the programming session and requires that all subsequent commands (that require prior login) are sent from the same IP.
Failed (F) reply code is returned if the flag could not be set (written into the FLASH memory).
* Without prior selection using Select In Broadcast Mode (W) command.