Giter VIP home page Giter VIP logo

homebridge-hunter-hydrawise's Introduction

homebridge-hunter-hydrawise: Native HomeKit support for Hunter Hydrawise

Homebridge Hunter Hydrawise

Downloads Version Hunter Hydrawise@Homebridge Discord verified-by-homebridge

Hunter Hydrawise support for Homebridge.

homebridge-hunter-hydrawise is a Homebridge plugin that makes your Hunter Hydrawise irrigation controller available to Apple's HomeKit smart home platform.

Why use this plugin for Hunter Hydrawise support in HomeKit?

In a nutshell, the aim of this plugin for things to just work with minimal required configuration by users. The goal is to provide as close to a streamlined experience as you would expect from a first-party or native HomeKit solution. For the adventurous, those additional granular options are, of course, available to support more esoteric use cases or other unique needs.

What does just work mean in practice? It means that this plugin will discover all of the Hydrawise controllers connected to your Hydrawise account without the need for additional configuration beyond entering your account-specific API key. This plugin will expose those controllers and their zones as an irrigation system in HomeKit.

I rely on this plugin every day and actively maintain and support it.

I've developed a full-featured Homebridge plugin that enables the following features:

  • Control each individual zone on your irrigation controller.
  • Display when your irrigation system is off due to a rain sensor preventing watering (the irrigation system will show as off in HomeKit).
  • Show, at a glance, all the zones that are queued up to run in the next 60 minutes on your controller (each individual zone will appear active in HomeKit when it's queued to run).
  • A rich webUI for configuration.
  • MQTT support.

Installation

To get started with homebridge-hunter-hydrawise:

  • Generate a Hydrawise API key, should you need one.
  • Install homebridge-hunter-hydrawise using the Homebridge webUI. Make sure you make homebridge-hunter-hydrawise a child bridge for the best experience.
  • Configure homebridge-hunter-hydrawise and enter your API key.
  • That's it. Enjoy!

Important

Things to keep in mind regarding the Hydrawise API:

  • The Hydrawise API is rate-limited with the following constraints:
    • A limit of 3 API calls to start, stop, or suspend any zone within a 30 second interval.
    • An additional limit across the entire API of no more than 30 calls in any 5 minute period.
  • While the API provides the ability to suspend a zone, it does not provide the ability to resume a schedule.

Plugin Development Dashboard

This is mostly of interest to the true developer nerds amongst us.

License Build Status Dependencies GitHub commits since latest release (by SemVer)

homebridge-hunter-hydrawise's People

Contributors

hjdhjd avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar

homebridge-hunter-hydrawise's Issues

Add support for custom poll interval

Describe the feature request

please add an option to specify custom poll interval (like the other hydrawise plugin https://github.com/martijndierckx/homebridge-hydrawise#readme does)

FYI:
you write:

While the API provides the ability to suspend a zone, it does not provide the ability to resume a schedule.

one can resume a schedule (or all schedules): its like suspending but sending current time instead of future time.

Describe the proposed solution

option "Polling interval" or something like that.

Describe alternatives you have considered to the enhancement

Other hydrawise plugin (see above)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.