Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

homebridge-parrot-flower

antoineraulin13MIT0.4.1

Use HomeKit to monitor your plants with homebridge

homebridge, homebridge-plugin, plugin, parrot, flower, power, HomeKit, home, automation

readme

homebridge-parrot-flower

Français 👈

Warning: this project is a fork of @grover's homebridge-flower-sensor project.

Integrate Parrot Flower Power, the Parrot Pot or the never released Parrot H2O into HomeKit using homebridge. This plugin does not depend upon the now discontinued Parrot Cloud by talking directly to the sensors using a Bluetooth Low Energy connection.

Status

HitCount Node version npm version Build Status

Capabilities

This plugin exposes the following capabilities of the Flower Power sensor to HomeKit:

  • Soil Temperature
  • Soil Moisture
  • Ambient Light Level
  • Identifying the sensor flashes the built-in LED
  • Monitor the battery status of the Flower Power sensor
  • Provides date/time the sensor data was last retrieved
  • Provides the date/time the batteries were last changed
  • 24h average low light level sensor trigger for plant recommendations
  • 24h average low humidity level sensor trigger to remind you to water your plants

These capabilities are specific to the Parrot Pot:

  • Start watering
  • In Elgato Eve, see the type of program (manual or automatic) for watering. (Accessory type Irrigation system)
  • Water level in the tank
  • Triggering of a too low water level sensor in the tank (< 15%)

There're more capabilities planned for the future. And see the CHANGELOG for release information.

Using this plugin

To use this plugin I recommend a Raspberry Pi Zero W. You can monitor multiple Flower Power devices in one homebridge on one Raspberry Pi Zero W.

Please be aware of the limitations and coexistance with other plugins using Bluetooth:

Supported clients

This platform and the switches it creates have been verified to work with the following apps on iOS 11 (tested on iOS 13.4.1):

  • Home
  • Elgato Eve

See HomeKit Apps for a comparison table of supported features.

Credits

See CREDITS for acknowledgements to the individuals that contributed directly or indirectly to this plugin.

Some asks for friendly gestures

If you use this and like it - please leave a note by staring this package here or on GitHub.

If you use it and have a problem, file an issue at GitHub - I'll try to help.

If you tried this, but don't like it: tell me about it in an issue too. I'll try my best to address these in my spare time.

If you fork this, go ahead - I'll accept pull requests for enhancements.

License

MIT License

Copyright (c) 2017 Michael Fröhlich

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

The updates brought to the project since the fork are under the copyright of Antoine Raulin under the MIT license.

Update copyright (c) 2020 Antoine Raulin

changelog

Changelog

Version 0.4.1

  • Display the water level in the tank
  • Leak detector activated when the water level in the tank is too low (< 15%).

Version 0.4

First update since the fork.

  • This update brings the appearance of an "Irrigation system" accessory to view the watering status and the watering programming mode for a Parrot Pot (manual or automatic).

  • The accessory responsible for switching on the watering of the Parrot Pot that was previously a switch is now a Water Valve, so it appears as a sprinkler in HomeKit and takes care of the waiting time between pressing in Homekit and the actual start of watering on the pot with the display of a "Loading" message in Homekit.

  • A typing error in the humidity threshold management has been corrected.

  • Raspberry Pi installation documentation has been updated to support the latest version of Node.js and deal with the problems associated with Noble dependency.

Version 0.3

  • Parrot Pot support
    • Display remaining water tank level
    • Display configured watering mode
    • Display watering status
    • Trigger manual watering
    • Contact sensor to trigger on watering errors
  • Sped up bluetooth control
  • Improved operation with multiple Parrot Pot and Flower Power devices

Version 0.2

  • Add last updated status as in homebridge-hue
  • Add uptime support
  • Enable recommended settings setup (e.g. from Parrot App.)
  • Enable sensors to trigger rules if recommended settings are too low

Version 0.1

  • Refresh battery status once per day
  • Refresh sensor values automatically (in 10min intervals)
  • Retrieve FlowerPower device type and Color