Skip to content

VincentCATILLON/home-assistant-honey-instruments

Repository files navigation

Honey Instruments

Honey Instruments Integration for Home Assistant

HACS Action Validate with hassfest Ruff

Custom integration for Home Assistant to retrieve data from Honey Instruments connected beehive scales.

Sensors

Sensor Type Unit Description
Weight Weight kg Current hive weight
Weight variation (1h) Weight kg Weight change over the last hour
Weight variation (24h) Weight kg Weight change over the last 24 hours
Weight variation (7d) Weight kg Weight change over the last 7 days
Internal humidity Humidity % Internal probe humidity
Internal temperature Temperature °C Internal hive temperature
External temperature Temperature °C External probe temperature
Balance battery voltage Voltage mV Balance battery level
Sensor battery voltage Voltage mV Sensor probe battery level
Signal strength Signal dB Communication signal strength
Last update Timestamp Last data update from the device
Latitude Position Device latitude
Longitude Position Device longitude
Version Sigfox, LoRa, Satellite Connection type
Status Sigfox, LoRa, Satellite Device status

Prerequisites

  1. A Honey Instruments connected beehive scale
  2. Your Honey Instruments account credentials (email + password)
  3. Enable Service API on your account at cloud.honeyinstruments.com/account/services

Installation

HACS (recommended)

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Or manually:

  1. Open HACS in your Home Assistant instance
  2. Click the three dots in the top right corner and select Custom repositories
  3. Add this repository URL and select Integration as category
  4. Click Download on the Honey Instruments integration
  5. Restart Home Assistant

Manual

  1. Copy the custom_components/honey_instruments folder into your config/custom_components/ directory
  2. Restart Home Assistant

Configuration

  1. Go to Settings > Devices & Services > Add Integration
  2. Search for Honey Instruments
  3. Enter your email and password
  4. Your devices and sensors will be automatically discovered

Options

After setup, you can configure the polling interval via Settings > Devices & Services > Honey Instruments > Configure.

The default scan interval is 3600 seconds (1 hour). You can set it between 600 seconds (10 minutes) and 86400 seconds (24 hours).

Development

Setup

scripts/setup

Run Home Assistant locally

scripts/develop

Home Assistant will be available at http://localhost:8123.

VS Code

A task is available in VS Code: Run Home Assistant on port 8123.

License

This project is licensed under the MIT License - see the LICENSE file for details.