Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ZHA channel changing dialog and settings redesign #16381

Merged

Conversation

puddly
Copy link
Contributor

@puddly puddly commented May 2, 2023

Proposed change

Redesign the ZHA network settings section and incorporate a button and dialog to change the current channel:

Before

before

After

after

image

Type of change

  • Dependency upgrade
  • Bugfix (non-breaking change which fixes an issue)
  • New feature (thank you!)
  • Breaking change (fix/feature causing existing functionality to break)
  • Code quality improvements to existing code or addition of tests

Example configuration

Additional information

  • This PR fixes or closes issue: fixes #
  • This PR is related to issue or discussion:
  • Link to documentation pull request:

Checklist

  • The code change is tested and works locally.
  • There is no commented out code in this PR.
  • Tests have been added to verify that the new code works.

If user exposed functionality or configuration variables are added/changed:

@puddly puddly force-pushed the puddly/20230501-zha-channel-changing-ui branch from 8839ee1 to 6e4457a Compare May 3, 2023 18:38
@puddly puddly marked this pull request as ready for review May 4, 2023 20:51
@bramkragten bramkragten merged commit c7ec690 into home-assistant:dev May 5, 2023
6 checks passed
@Hedda
Copy link

Hedda commented Jun 5, 2023

incorporate a button and dialog to change the current channel:

@frenck please consider mentioning this in Home Assistant 2023.6 blog (it is not even mentioned in the beta release notes yet).

ZHA channel changing dialog

This experimental feature allows ZHA users to perform Zigbee channel migration directly from the UI for all supported radio types without the need to re-pair all devices or have any entities changed. ZNP (Texas Instruments) based devices currently has the best implementation of Zigbee channel changing as it allows the Zigbee Coordinator to change Zigbee channels after having a few chances to send out the broadcast to all the devices. Other Zigbee Coordinator adapters (e.g. Silicon Labs EZSP and Dresden Elektronik's deconz based radios) instead migrate/change the Zigbee channel almost immediately, giving Zigbee End Devices (e.i. battery-powered devices) a smaller window of receiving the channel change request broadcast, however, such devices still have a chance of finding the network again if they detect that they have been orphaned. Modern mains-powered devices should normally all change channels without any problems. After waiting a while for all devices to change channels automatically the general recommendation is then to perform a power cycle of devices that did not automatically change channels (usually simply by removing and replacing the battery) before just re-pairing those devices in the ZHA integration.

References:

#16381

home-assistant/core#92076

home-assistant/core#91969

home-assistant/core#88564

zigpy/zigpy#1190

PS: End-users should note that changing Zigbee channel is not a magic bullet for reception/transceiving-related issues, so might also want to refer to ZHA integration documentation's new troubleshooting section on interference and range/coverage optimization tips -> https://www.home-assistant.io/integrations/zha#zigbee-interference-avoidance-and-network-rangecoverage-optimization

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants