Skip to content

Bug: BleakCharacteristicNotFoundError for Petkit Eversweet 3 Wireless (W4X) #73

@Benjamin45590

Description

@Benjamin45590

Hi there,

First of all, thank you so much for this amazing integration and all your hard work on this project!

I am opening this issue because I'm having trouble setting up my fountain. When trying to configure the Petkit BLE integration with a Petkit Eversweet 3 Wireless (Model W4X), the setup fails during the initialization step. The device is successfully detected via Bluetooth, but the integration throws a BleakCharacteristicNotFoundError because it cannot find the specific UUID 0000aaa1-0000-1000-8000-00805f9b34fb.

Note: The W4X model is completely wireless (no physical buttons on the base or the main module). I have successfully performed a factory reset via the official app (removing the device to clear the encryption secret), but Home Assistant still fails to communicate with it due to this missing characteristic.

Environment

  • Home Assistant Core: 2026.6 b0
  • Integration version: 1.2
  • Device: Petkit Eversweet 3 Wireless (W4X)

Traceback / Logs

Enregistreur: custom_components.petkit_ble.config_flow
Source: custom_components/petkit_ble/config_flow.py:190
intégration: Petkit BLE (documentation, problèmes)

Failed to check device init status for Petkit_W4X
Failed to check device init status for A4:C1:38:E3:26:6E
Traceback (most recent call last):
  File "/config/custom_components/petkit_ble/config_flow.py", line 190, in async_step_init_device
    initialized, device_id = await client.async_check_initialized()
                             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/config/custom_components/petkit_ble/ble_client.py", line 506, in async_check_initialized
    await self._connect()
  File "/config/custom_components/petkit_ble/ble_client.py", line 305, in _connect
    await self._client.start_notify(BLE_NOTIFY_UUID, self._on_notify)
  File "/usr/local/lib/python3.14/site-packages/bleak/__init__.py", line 892, in start_notify
    characteristic = _resolve_characteristic(char_specifier, self.services)
  File "/usr/local/lib/python3.14/site-packages/bleak/__init__.py", line 432, in _resolve_characteristic
    raise BleakCharacteristicNotFoundError(char_specifier)
bleak.exc.BleakCharacteristicNotFoundError: Characteristic 0000aaa1-0000-1000-8000-00805f9b34fb was not found!

Thanks a lot !

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions