PreviousNext
Over The Air (OTA) upgrade of IQRF OS and DPA
Help > DPA in Practice > Over The Air (OTA) upgrade of IQRF OS and DPA

Please follow this checklist to upgrade both IQRF OS and DPA over the air using the IQRF IDE. IQRF IDE uses public DPA commands described in this document to accomplish the upgrade. Select All at Tools/Options/Environment Options/IQMESH Network Manager/Log background DPA communication to see the commands at Terminal Log panel.

 

1 Uploading a special OTA Custom DPA Handler to the Coordinator and all Nodes

1.1 Go to Tools / IQMESH Network Manager / Control / Upload at IQRF IDE.

1.2 Browse a file CustomDpaHandler-ChangeIQRFOS-7xD-Vvvv-yymmdd.iqrf at Source File group box. The file can be found at the IQRF Startup Package in the folder Development\DPA\OTA_upgrade.

1.3 Set External EEPROM Address to 0x800 at the Upload group box.

1.4 Select All Nodes and set HWPID to 0xFFFF at the Destination Device group box.

1.5 Press the Upload button at the group box Upload to upload the selected file to the external EEPROM at all Nodes.

1.6 Press the Verify button to check the uploaded file integrity.

1.7 Upload and verify the file to the Nodes that report an integrity error until no error is reported.

1.8 Press the Load button to write the handler from EEPROM to the flash memory at all Nodes.

1.9 Select Coordinator at the Destination Device group box.

1.10 Press the Upload button at the group box Upload to upload the selected file to the external EEPROM at the Coordinator.

1.11 Press the Verify button to check the uploaded file integrity and then Load to write it to the flash memory at the Coordinator.

 

2 Enabling the special OTA Custom DPA Handler at the Coordinator and Nodes

2.1 Go to Tools / IQMESH Network Manager / Control / TR Config.

2.2 Uncheck the Source File group box if it is checked.

2.3 Select All Nodes and set HWPID to 0xFFFF at the Destination Device group box.

2.4 Press the Configure TR button at the Command group box. A TR Configuration window will open.

2.5 Enable Custom DPA Handler at the DPA tab and press Upload. Press Try Selected if the configuration wizard reports error writing configuration to some Nodes. Close the configuration window.

2.6 Press Restart at the Command group box to restart all Nodes.

2.7 Select Coordinator at the Destination Device group box.

2.8 Press the Configure TR button at the Command group box. A TR Configuration window will open.

2.9 Enable Custom DPA Handler at the DPA tab and press Upload. Close the configuration window.

2.10 Press Restart at the Command group box to restart the Coordinator.

2.11 Refresh a table at the Table View tab and check that an HWPID of all network members equals 0xC05E.

 

3  Uploading a change file to the Coordinator and all Nodes.

3.1 Go to Tools / IQMESH Network Manager / Control / Upload at IQRF IDE.

3.2 Browse a file ChangeOS-TR7x-ooo(oooo)-nnn(nnnn)-Vooo+Node+xxx-Vnnn+Node+xxx.bin (ooo specifies original IQRF OS and DPA version while nnn specifies new IQRF OS and DPA version respectively; xxx specifies required interface). The file can be found at the IQRF Startup Package in the folder Development\DPA\OTA_upgrade.

3.3 Set External EEPROM Address to 0x800 at the Upload group box.

3.4 Select All Nodes at the Destination Device group box. The HWPID is set to 0xC05E automatically.

3.5 Continue according to 1.5.-1.8.

3.6 Browse a file ChangeOS-TR7x-ooo(oooo)-nnn(nnnn)-Vooo+Coordinator+xxx-Vnnn+Coordinator+xxx.bin (ooo specifies original IQRF OS and DPA version while nnn specifies new IQRF OS and DPA version respectively; xxx specifies required interface). The file can be found at the IQRF Startup Package in the folder Development\DPA\OTA_upgrade.

3.7 Continue according to 1.9.-1.11.

 

4Finishing up

4.1 Both IQRF OS and DPA are upgraded. The network is working.

4.2 Refresh and check the network map from the Coordinator.

4.3 Follow chapter 1 to upload back your normal Custom DPA Handlers or follow chapter 2. to disable Custom DPA Handler on the devices that do not use it.

4.4 Follow chapter 2 to set an Access password and/or User Key at the TR Configuration of all devices if they were upgraded from IQRF OS 3.0x.

4.5 Enumerate the network, check it, and save the enumeration.

4.6 Backup the network and save the backup file.