update: profile: add a new network event reason for profile update

Signed-off-by: Tatiana Leon <Tatiana.Leon@digi.com>

Author: tatianaleon

digi/xbee/devices.py

@@ -11774,6 +11774,9 @@ def __init__(self, code, description):
         self.__code = code
         self.__description = description
 
+    def __str__(self):
+        return "%s (%d)" % (self.__description, self.__code)
+
     @property
     def code(self):
         """
@@ -11829,11 +11832,15 @@ class NetworkEventReason(Enum):
     ROUTE = (0x04, "Hop of a network route")
     READ_INFO = (0x05, "Read XBee information")
     FIRMWARE_UPDATE = (0x06, "The firmware of the device was updated")
+    PROFILE_UPDATE = (0x07, "New profile applied to the device")
 
     def __init__(self, code, description):
         self.__code = code
         self.__description = description
 
+    def __str__(self):
+        return "%s (%d)" % (self.__description, self.__code)
+
     @property
     def code(self):
         """

digi/xbee/profile.py

@@ -30,7 +30,7 @@
 from digi.xbee.firmware import UpdateConfigurer, EXTENSION_GBL, EXTENSION_XML, \
     EXTENSION_EBIN, EXTENSION_EHX2, EXTENSION_OTB, EXTENSION_OTA, \
     EXTENSION_EBL, update_local_firmware, update_remote_firmware
-from digi.xbee.devices import XBeeDevice, RemoteXBeeDevice
+from digi.xbee.devices import XBeeDevice, RemoteXBeeDevice, NetworkEventReason
 from digi.xbee.exception import XBeeException, FirmwareUpdateException, \
     InvalidOperatingModeException
 from digi.xbee.filesystem import LocalXBeeFileSystemManager, \
@@ -1408,11 +1408,11 @@ def restore_after_update(self, net_changed, protocol_changed_by_settings, port_s
         if net_changed or protocol_changed_by_settings:
             if not self._xbee.is_remote():
                 # Clear the full network as it is no longer valid.
-                self._xbee.get_network().clear()
+                self._xbee.get_network()._clear(NetworkEventReason.PROFILE_UPDATE)
             else:
                 # Remove node from the network as it might be no longer part of it.
                 self._xbee.get_local_xbee_device().get_network(). \
-                    remove_device(self._xbee)
+                    _remove_device(self._xbee, NetworkEventReason.PROFILE_UPDATE)
 
         self._configurer.progress_cb(self._configurer.TASK_RESTORE,
                                      done=self._configurer.restore_total)

doc/user_doc/discovering_the_xbee_network.rst

@@ -826,6 +826,8 @@ As well, ``NetworkEventReason`` enumerates the network modification causes:
   information.
 * ``NetworkEventReason.FIRMWARE_UPDATE``: The node was updated/removed, or the
   network cleared after a firmware update.
+* ``NetworkEventReason.PROFILE_UPDATE``: The node was updated/removed, or the
+  network cleared after applying a profile.
 * ``NetworkEventReason.MANUAL``: The node was manually added/updated/removed, or
   the network cleared.