Hello,
I buy ZBT-1 and I want to install it in Home Assistant.
ZBT-1 is automaticaly recognized and I click on add devices.
When I validate the device, I have this error :
I use:
- Yunohost Bookworm with Home Assistant.
- the version of Home Assistant core is 2025.5.3
Error logs of Home Assistant:
2025-06-03 21:28:04.209 ERROR (ImportExecutor_0) [homeassistant.loader] Unexpected exception importing platform homeassistant.components.zha.config_flow
Traceback (most recent call last):
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1250, in _load_platform
cache[full_name] = self._import_platform(platform_name)
~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1282, in _import_platform
return importlib.import_module(f"{self.pkg_path}.{platform_name}")
~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/util/loop.py", line 201, in protected_loop_func
return func(*args, **kwargs)
File "/var/www/homeassistant/.local/share/uv/python/cpython-3.13.3-linux-x86_64-gnu/lib/python3.13/importlib/__init__.py", line 88, in import_module
return _bootstrap._gcd_import(name[level:], package, level)
~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
File "<frozen importlib._bootstrap>", line 1310, in _find_and_load_unlocked
File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
File "<frozen importlib._bootstrap>", line 1331, in _find_and_load_unlocked
File "<frozen importlib._bootstrap>", line 935, in _load_unlocked
File "<frozen importlib._bootstrap_external>", line 1026, in exec_module
File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/zha/__init__.py", line 8, in <module>
from zha.application.const import BAUD_RATES, RadioType
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zha/application/const.py", line 11, in <module>
import zigpy_deconz.zigbee.application
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zigpy_deconz/zigbee/application.py", line 30, in <module>
from zigpy_deconz.api import (
...<10 lines>...
)
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zigpy_deconz/api.py", line 81, in <module>
class FirmwareVersion(t.Struct, t.uint32_t):
...<3 lines>...
major: t.uint8_t
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zigpy/types/struct.py", line 95, in __init_subclass__
return cls.deserialize(cls._int_type(args[0]).serialize())[0]
TypeError: Integer structs must be subclasses of `IntStruct`
2025-06-03 21:28:04.220 ERROR (MainThread) [homeassistant.loader] Unexpected exception importing platform homeassistant.components.zha.config_flow
Traceback (most recent call last):
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1250, in _load_platform
cache[full_name] = self._import_platform(platform_name)
~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1282, in _import_platform
return importlib.import_module(f"{self.pkg_path}.{platform_name}")
~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/util/loop.py", line 201, in protected_loop_func
return func(*args, **kwargs)
File "/var/www/homeassistant/.local/share/uv/python/cpython-3.13.3-linux-x86_64-gnu/lib/python3.13/importlib/__init__.py", line 88, in import_module
return _bootstrap._gcd_import(name[level:], package, level)
~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
File "<frozen importlib._bootstrap>", line 1310, in _find_and_load_unlocked
File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
File "<frozen importlib._bootstrap>", line 1331, in _find_and_load_unlocked
File "<frozen importlib._bootstrap>", line 935, in _load_unlocked
File "<frozen importlib._bootstrap_external>", line 1026, in exec_module
File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/zha/__init__.py", line 8, in <module>
from zha.application.const import BAUD_RATES, RadioType
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zha/application/const.py", line 11, in <module>
import zigpy_deconz.zigbee.application
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zigpy_deconz/zigbee/application.py", line 30, in <module>
from zigpy_deconz.api import (
...<10 lines>...
)
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zigpy_deconz/api.py", line 81, in <module>
class FirmwareVersion(t.Struct, t.uint32_t):
...<3 lines>...
major: t.uint8_t
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zigpy/types/struct.py", line 95, in __init_subclass__
return cls.deserialize(cls._int_type(args[0]).serialize())[0]
TypeError: Integer structs must be subclasses of `IntStruct`
2025-06-03 21:28:04.222 ERROR (MainThread) [homeassistant.config_entries] Error occurred loading flow for integration zha: Exception importing homeassistant.components.zha.config_flow
2025-06-03 21:28:04.223 ERROR (MainThread) [aiohttp.server] Error handling request from ::1
Traceback (most recent call last):
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1250, in _load_platform
cache[full_name] = self._import_platform(platform_name)
~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1282, in _import_platform
return importlib.import_module(f"{self.pkg_path}.{platform_name}")
~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/util/loop.py", line 201, in protected_loop_func
return func(*args, **kwargs)
File "/var/www/homeassistant/.local/share/uv/python/cpython-3.13.3-linux-x86_64-gnu/lib/python3.13/importlib/__init__.py", line 88, in import_module
return _bootstrap._gcd_import(name[level:], package, level)
~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
File "<frozen importlib._bootstrap>", line 1310, in _find_and_load_unlocked
File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
File "<frozen importlib._bootstrap>", line 1331, in _find_and_load_unlocked
File "<frozen importlib._bootstrap>", line 935, in _load_unlocked
File "<frozen importlib._bootstrap_external>", line 1026, in exec_module
File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/zha/__init__.py", line 8, in <module>
from zha.application.const import BAUD_RATES, RadioType
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zha/application/const.py", line 11, in <module>
import zigpy_deconz.zigbee.application
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zigpy_deconz/zigbee/application.py", line 30, in <module>
from zigpy_deconz.api import (
...<10 lines>...
)
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zigpy_deconz/api.py", line 81, in <module>
class FirmwareVersion(t.Struct, t.uint32_t):
...<3 lines>...
major: t.uint8_t
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/zigpy/types/struct.py", line 95, in __init_subclass__
return cls.deserialize(cls._int_type(args[0]).serialize())[0]
TypeError: Integer structs must be subclasses of `IntStruct`
The above exception was the direct cause of the following exception:
Traceback (most recent call last):
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/config_entries.py", line 3759, in _load_integration
await integration.async_get_platform("config_flow")
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1086, in async_get_platform
platforms = await self.async_get_platforms((platform_name,))
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1163, in async_get_platforms
import_future.result()
~~~~~~~~~~~~~~~~~~~~^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1151, in async_get_platforms
platforms.update(self._load_platforms(platform_names))
~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1076, in _load_platforms
platform_name: self._load_platform(platform_name)
~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/loader.py", line 1270, in _load_platform
raise ImportError(
f"Exception importing {self.pkg_path}.{platform_name}"
) from err
ImportError: Exception importing homeassistant.components.zha.config_flow
The above exception was the direct cause of the following exception:
Traceback (most recent call last):
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/aiohttp/web_protocol.py", line 510, in _handle_request
resp = await request_handler(request)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/aiohttp/web_app.py", line 569, in _handle
return await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/aiohttp/web_middlewares.py", line 117, in impl
return await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/http/security_filter.py", line 92, in security_filter_middleware
return await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/http/forwarded.py", line 210, in forwarded_middleware
return await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/http/request_context.py", line 26, in request_context_middleware
return await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/http/ban.py", line 86, in ban_middleware
return await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/http/auth.py", line 242, in auth_middleware
return await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/http/headers.py", line 41, in headers_middleware
response = await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/helpers/http.py", line 73, in handle
result = await handler(request, **request.match_info)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/http/decorators.py", line 81, in with_admin
return await func(self, request, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/config/config_entries.py", line 233, in post
return await super().post(request, flow_id)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/http/data_validator.py", line 74, in wrapper
return await method(view, request, data, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/helpers/data_entry_flow.py", line 121, in post
result = await self._flow_mgr.async_configure(flow_id, data)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/data_entry_flow.py", line 336, in async_configure
result = await self._async_configure(flow_id, user_input)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/data_entry_flow.py", line 383, in _async_configure
result = await self._async_handle_step(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
flow, cur_step["step_id"], user_input
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
)
^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/data_entry_flow.py", line 487, in _async_handle_step
result: _FlowResultT = await getattr(flow, method)(user_input)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/components/homeassistant_hardware/firmware_config_flow.py", line 361, in async_step_confirm_zigbee
await self.hass.config_entries.flow.async_init(
...<11 lines>...
)
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/config_entries.py", line 1446, in async_init
flow, result = await self._async_init(flow_id, handler, context, data)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/config_entries.py", line 1482, in _async_init
flow = await self.async_create_flow(handler, context=context, data=data)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/config_entries.py", line 1703, in async_create_flow
handler = await _async_get_flow_handler(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
self.hass, handler_key, self._hass_config
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
)
^
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/config_entries.py", line 3780, in _async_get_flow_handler
await _load_integration(hass, domain, hass_config)
File "/var/www/homeassistant/venv/lib/python3.13/site-packages/homeassistant/config_entries.py", line 3766, in _load_integration
raise data_entry_flow.UnknownHandler from err
homeassistant.data_entry_flow.UnknownHandler
What could be the problem?
Thanks for helping 
Frédéric