Orbit B-hyve for Home Assistant

This integration lets Home Assistant control Orbit B-hyve hose timers locally over Bluetooth Low Energy. Only a subset of official-app features is implemented.

This project is unofficial and not endorsed by Orbit. It's intended for local control of B-hyve devices you own. It may be useful when you have little or no internet connectivity, or when you cannot use the official Android or iOS apps.

Use at your own risk. The author is not responsible for bricked hardware, high water bills, unhappy soaked pets, or any other undesirable outcome.

Installation

HACS (recommended)

Quickstart

Manually

1. Open HACS in Home Assistant → Integrations.
2. Open the menu (⋮) → Custom repositories.
3. Add this repository URL, category Integration, then Add.
4. Search for Orbit B-hyve (or this repo name), open it, and Download.
5. Restart Home Assistant to load the integration.

Manual Installation (not recommended)

1. Copy the folder custom_components/bhyve_ble/ from this repository into config/custom_components/ directory (so you have config/custom_components/bhyve_ble/manifest.json)
2. Restart Home Assistant to load the integration.

Configuration

1. In Home Assistant navigate to Settings → Devices & services → Add integration and choose Orbit B-hyve.
2. Click the + Add Integration button.
3. Search for B-hyve.
4. If you cannot find Orbit B-hyve in the list then be sure to clear your browser cache and/or perform a hard-refresh of the page.
5. Network key step: set a unique identifier used to talk to your hose timers. This is analogous to your B-hyve account in the official app.
6. Configure — Put the timer in pairing mode (press the “b” hex button five times quickly), choose the BLE address from the dropdown

Usage

Each hose timer exposes a switch per output port to start and stop watering. The default maximum runtime is ten minutes unless you turn it off earlier.

Device info, battery, and related sensors are filled in when the device reports them.

Development

Run tests

Use a Python environment where Home Assistant is installed so import homeassistant works (for example pip install homeassistant in a venv). From the repository root:

pytest -q tests

pytest.ini sets pythonpath = custom_components so bhyve_ble resolves like it does under Home Assistant.