Allow external radio types

[puddly]

This will need a corresponding PR to Core (https://github.com/puddly/core/tree/puddly/zha-external-radio-libs) but will allow for pre-alpha radio libraries (Ziggurat, ZBOSS, BLZ, and ESPZB) to be used in Home Assistant.

You first need to modify your radio library's pyproject.toml file to register it with zigpy:

[project.entry-points."zigpy.radio"]
your_radio_type = "your_radio_module.zigbee.application:ControllerApplication"

And then just add a description to the ControllerApplication subclass:

class ControllerApplication(zigpy.application.ControllerApplication):
    DISPLAY_NAME = "Friendly Name"
    DESCRIPTION = "Very short description string"

     def __init__(self, ...

Unfortunately, HA Core provides no simple way to install custom dependencies other than a custom component. I'll make a custom component later (if one doesn't already exist) so you can add something like this to configuration.yaml:

# A custom component, unfortunately, to install dependencies
zha_custom_radio_libraries:
  - "git+https://github.com/zigpy/zigpy-ziggurat"

That's it. The Python module will self-register and show up in ZHA config flows, etc.

---

This is fundamentally a development tool so expect breakage if you rely on it 😄.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.42%. Comparing base (a2ddc14) to head (1852b3f).

Additional details and impacted files

@@           Coverage Diff           @@
##              dev     #461   +/-   ##
=======================================
  Coverage   97.41%   97.42%           
=======================================
  Files          50       50           
  Lines       10419    10433   +14     
=======================================
+ Hits        10150    10164   +14     
  Misses        269      269           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[puddly]

I've slightly expanded the scope of this PR to clean up and entirely remove the RadioType enum. Instead, we can have structured information within the Gateway object accessible via an API call.

[fangzheli]

Thanks @puddly for working on this — external radio type support would be a big deal for zigpy-blz.

We currently maintain a custom ZHA component to patch BLZ radio support into ZHA, which requires tracking every HA Core release. This PR would let us drop that entirely and ship as a standalone zigpy-blz package (now on PyPI).

We tested this PR locally with a Third Reality BL702 dongle — the Gateway successfully resolves and connects to zigpy-blz through external_radio_libraries. Happy to help with further testing as this moves forward.

[Copilot]

Pull request overview

This PR refactors ZHA’s radio selection to support externally provided zigpy radio libraries (discovered via Python entry points), enabling experimentation with pre-alpha radio backends without hard-coding them into ZHA.

Changes:

• Introduces a RadioLibrary registry with entry-point discovery (zigpy.radio) alongside built-in radios.
• Updates Gateway initialization to resolve/import the selected radio controller dynamically (off the event loop).
• Removes the hard-coded RadioType enum and updates tests/fixtures accordingly.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
zha/zigbee/device.py	Uses the selected radio library’s display name when coordinator model is unknown.
zha/application/helpers.py	Adds RadioLibrary + external radio discovery via entry points.
zha/application/gateway.py	Switches radio selection from enum to dynamic registry and imports controller in executor.
zha/application/const.py	Removes the hard-coded RadioType enum and related imports.
tests/test_gateway.py	Updates gateway tests and adds coverage for external radio discovery/behavior.
tests/conftest.py	Adjusts gateway test harness mocking to align with dynamic controller resolution.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Hedda]

Any status updates on this support to allow external radios?

For reference also see this related PR for zigpy -> zigpy/zigpy#1836

• Add radio library metadata for the zigpy.radio entry point zigpy#1836

[puddly]

@Hedda I appreciate your enthusiasm but as you can see, this PR was updated just a few days ago. If there's any update, it will be here.