Implement channel migration (#220)

Author: puddly

tests/test_application.py

@@ -588,3 +588,22 @@ async def test_energy_scan(app):
         )
 
     assert results == {c: c * 3 for c in Channels.ALL_CHANNELS}
+
+
+async def test_channel_migration(app):
+    app._api.write_parameter = AsyncMock()
+    app._change_network_state = AsyncMock()
+
+    await app._move_network_to_channel(new_channel=26, new_nwk_update_id=0x12)
+
+    assert app._api.write_parameter.mock_calls == [
+        mock.call(
+            deconz_api.NetworkParameter.channel_mask, Channels.from_channel_list([26])
+        ),
+        mock.call(deconz_api.NetworkParameter.nwk_update_id, 0x12),
+    ]
+
+    assert app._change_network_state.mock_calls == [
+        mock.call(deconz_api.NetworkState.OFFLINE),
+        mock.call(deconz_api.NetworkState.CONNECTED),
+    ]

zigpy_deconz/zigbee/application.py

@@ -349,6 +349,19 @@ async def energy_scan(
         # The Conbee seems to max out at an LQI of 85, which is exactly 255/3
         return {c: v * 3 for c, v in results.items()}
 
+    async def _move_network_to_channel(
+        self, new_channel: int, new_nwk_update_id: int
+    ) -> None:
+        """Move device to a new channel."""
+        channel_mask = zigpy.types.Channels.from_channel_list([new_channel])
+        await self._api.write_parameter(NetworkParameter.channel_mask, channel_mask)
+        await self._api.write_parameter(
+            NetworkParameter.nwk_update_id, new_nwk_update_id
+        )
+
+        await self._change_network_state(NetworkState.OFFLINE)
+        await self._change_network_state(NetworkState.CONNECTED)
+
     async def add_endpoint(self, descriptor: zdo_t.SimpleDescriptor) -> None:
         """Register an endpoint on the device, replacing any with conflicting IDs."""