README (1433B)
1 # ha-hunterbtt 2 3 Extremely vibe-coded Hunter BTT integration for Home Assistant. 4 5 Experimental. Minimal testing performed with a BTT-101, firwmare 5.0.1.4. 6 7 To install, place `custom_components/hunter_btt` in your HA 8 `config/custom_components` directory. 9 10 # behavior 11 12 BTTs are battery powered Bluetooth devices. To save power, the integration only 13 polls once per day while the valve is closed, and once every 30 minutes while 14 the valve is open. 15 16 The firmware requires a duration to be specified when opening the valve. This 17 is the 'manual duration' control, which should be set to the correct value 18 before opening the valve. (Or, if you intend to stop it manually, simply set it 19 to some long sentinel value. Just know that that is your fallback in case of 20 issues.) 21 22 ```yaml 23 actions: 24 - action: number.set_value 25 target: 26 entity_id: number.hunter_btt_manual_duration 27 data: 28 value: 30 29 - action: valve.open_valve 30 target: 31 entity_id: valve.hunter_btt_valve 32 ``` 33 34 # known issues 35 36 "Characteristic 0000ffa5-... was not found!" has been seen with Bluetooth 37 proxies that use ESP32 / ESP-IDF. It's hitting an internal limit and truncating 38 the service list. In your ESPHome device config, raise the limit as follows: 39 40 ``` 41 esp32: 42 framework: 43 type: esp-idf 44 sdkconfig_options: 45 CONFIG_BT_GATTC_MAX_CACHE_CHAR: "64" 46 ``` 47 48 # development 49 50 ``` 51 uv run ruff format 52 uv run ruff check 53 uv run mypy 54 uv run pytest 55 ```