Skip to content

Latest commit

 

History

History
274 lines (253 loc) · 10.3 KB

README.md

File metadata and controls

274 lines (253 loc) · 10.3 KB

Xiaomi mi flora sensor

app image

Introduction

This app integrates the Xiaomi mi flora sensor and Xiaomi mi flora ropot into Homey.

Do you like the app? You can make me happy by buying me a beer!

Q&A

Q1 Why can’t the sensor be found by Homey?

  • Check if the sensor is connected to another bluetooth device. The Xiaomi Mi Flora app for example

Q1 Why are the readings from the sensors different from in the Xiaomi Mi Flora app?

  • It is caused by old firmware (2.7.0), try to update the sensors through the Xiaomi Mi Flora app

Q3 Is the app compatibel with v2.0.0?

  • The app is only compatible from v2.1.2 and up due to change to the BLE core.

Q4 Is the app compatibel with SDK 3?

  • Yes the app is compatible from v3.0.0

Usage

  1. Install app
  2. Add the device(s) to Homey.
  3. Configure the threshold in the device configuration.
  4. Make a flow with one of the cards.

You can configure the timeout between polls in the app's settings.

Cards

Device cards

Trigger cards

  1. Some device sensor has changed.
    • sensor (Moisture)
    • value (20%)
    • report (The moisture of Flora 1 has changed to: 20%.)
  2. Some device sensor is updated.
    • sensor (Moisture)
    • value (20%)
    • report (The moisture is updated to: 20%.)
  3. Sensor value is below the configured threshold.
    • sensor (Moisture)
    • value (20%)
    • report (The moisture (20%) is too low. This can be at least 30%.)
  4. Sensor value is above the configured threshold.
    • sensor (Moisture)
    • value (20%)
    • report (The moisture (20%) is too high. This must be a maximum of 15%.)

Condition cards

  1. De plant has a correct temperature.
  2. De plant has enough sunlight.
  3. De plant has enough nutrition.
  4. De plant has enough moisture.

Global cards

Trigger cards

  1. Some device sensor has changed.
    • device (Flora 1)
    • sensor (Moisture)
    • value (20%)
    • report (The moisture has changed to: 20%.)
  2. Some device sensor is updated.
    • device (Flora 1)
    • sensor (Moisture)
    • value (20%)
    • report (The moisture is updated to: 20%.)
  3. Sensor value is below the configured threshold.
    • device (Flora 1)
    • sensor (Moisture)
    • value (20%)
    • report (The moisture (20%) is too low. This can be at least 30%.)
  4. Sensor value is above the configured threshold.
    • device (Flora 1)
    • sensor (Moisture)
    • value (20%)
    • report (The moisture (20%) is too high. This must be a maximum of 15%.)
  5. Sensor value is outside the configured threshold.
    • device (Flora 1)
    • sensor (Moisture)
    • value (20%)
    • report (The moisture (20%) is too high. This must be a maximum of 15%.)
  6. Sensor gives a timeout after 3 tries.
    • device (Flora 1)
    • reason (Not in range)

Condition cards

  1. De plant has a correct temperature.
  2. De plant has enough sunlight.
  3. De plant has enough nutrition.
  4. De plant has enough moisture.

Action cards

  1. Synchronise all sensor values with Homey.

History

v1.0.0 - 09.04.2018

  • first alpha to app store.

v1.0.1 - 10.04.2018

  • add documentation
  • revert changes because it breaks the flow card.

v1.0.2 - 17.04.2018

  • moved capabilities to drivers because of RoPot missing one.
  • update capability name from fertilizer to nutritions.
  • change tags for capability in card to user preferred language.
  • add tags: report with a human readable report of the status.

v1.0.3 - 17.04.2018

  • add missing battery report translation

v1.0.4 - 18.04.2018

  • add missing icon
  • add documentation to readme

v1.0.5 - 20.04.2018

  • bump 1.0.4

v1.0.6 - 23.04.2018

  • bump 1.0.5

v1.0.7 - 27.04.2018

  • change trigger min/max with correct translation
  • fixed validation error
  • remove unused try catch
  • add trigger: 'outside threshold'
  • add documentation
  • bubble up error and throw exception, but before that add new timeout

v2.0.0 - 17.05.2018

  • make drivers compatible with com.mi.flora
  • refactoring capabilities
  • add settings explanation for threshold
  • add min/max validation for threshold

v2.0.1 - 18.05.2018

  • change app id

v2.0.2 - 18.05.2018

  • mark device as broken due to missing capability battery

v2.0.3 - 25.05.2018

  • add support for ropot condition cards

v2.0.4 - 25.05.2018

  • add information on the pairing screen

v2.0.5 - 25.05.2018

  • removed test code

v2.0.6 - 25.05.2018

  • resolved merge conflicts

v2.0.7 - 17.08.2018

  • resolved issue: #34 (Too many settings available for RoPot)

v2.0.8 - 17.08.2018

  • resolved issue: #41 (App crash due to missing condition card arguments)

v2.0.9 - 01.10.2018

  • resolved issue: #45 (Add a trigger card: Device is out of range)
  • add homeyCommunityTopicId for linking to new community forum
  • add html report for sending status report as email
  • improve error handling and prevent un-disconnected devices

v2.0.10 - 01.10.2018

  • add missing dependencies

v2.0.11 - 01.10.2018

  • add missing dependencies

v2.0.12 - 01.10.2018

  • improve settings page
  • verbose forced disconnect from BLE after error

v2.0.13 - 20.10.2018

  • filter the existing devices out of the device list on pairing
  • add readable time format to HTML report

v2.0.14 - 24.10.2018

  • throw error and stop loading if no devices can be found

v2.0.15 - 11.11.2018

  • add version number app for logging
  • improve check on available settings
  • make html rapport generating optional
  • add uuid to device settings for flora sensor

v2.0.16 - 11.11.2018

  • resolved ManagerSettings get exception
  • improve handling exceptions
  • limit timeout by 5 seconds
  • use a different strategy based on homey version

v2.0.17 - 11.12.2018

  • add BLE permission into manifest

v2.0.18 - 12.12.2018

  • removed BLE permission into manifest due to incompatibility with < v2.0.0

v2.0.19 - 21.12.2018

  • removed html report to prevent cpu warns
  • changed version number strategy because it failed with on 2.0.0
  • try to resolve not setting a timer on exception issue

v2.1.0 - 11.01.2019

v2.1.1 - 05.03.2019

  • refactor to the previous iteration strategy

v2.1.2 - 14.03.2019

  • connect to service directly

v2.1.3 - 15.03.2019

  • fixed bug that gives an error on pairing
  • moved update sequence to app to centralize
  • add callback on added device so updating starts right away

v2.1.4 - 15.03.2019

  • add identify possibility into settings
  • add initializing the retry counter before fail scenario
  • improve catching the exceptions within the handling function

v2.1.4 - 15.03.2019

  • add identify possibility into settings

v2.1.5 - 17.03.2019

  • bump version due to invalid build

v2.1.6 - 22.03.2019

  • call the callback after saving the settings to prevent throwing an error
  • change the min/max to better threshold

v2.1.7 - 20.04.2019

  • removing the update device after pairing #70
  • renaming condition cards because of unknown behaviour #71

v2.1.8 - 20.04.2019

  • bump version v2.1.7 because its is rejected from the store somehow

v2.1.9 - 27.04.2019

  • try to discovery services with every update to prevent sequence bug (only compatible with >=2.1.2 because of the timout bug

v2.1.10 - 15.05.2019

v2.1.11 - 27.07.2019

  • add german translations (thanks to JackDaniel007)

v2.1.12 - 04.02.2020

  • fixed capital case translation issues
  • fixed translation #81

v2.1.13 - 02.04.2020

v3.0.0 - 22.11.2020

  • add support for SDK 3
  • add default threshold settings
  • refactoring pair logic
  • improve brand look & feel

v3.0.1 - 04.12.2020

  • display negative temperature correctly
  • add todo for next release
  • change brand color and translations

v3.0.2 - 22.02.2021

  • add trigger card: 'Synchronise all sensor values with Homey'
  • filter known devices when pairing
  • add debounce for updating all the devices

v3.0.3 - 10.03.2021

  • bugfix when sync is in progress in action card 'Synchronise all sensor values with Homey'

v3.0.4 - 29.03.2021

  • bugfix no results when pairing and sync is in progress

v4.0.0 - 14.07.2021

  • bugfix DE translation issue #101
  • migrate capabilities to correct homey syntax #103

v4.0.1 - 19-01-2020

  • add numeric value to flowcards: #105
  • add german translations

v4.0.2 - 28-01-2020

  • add german translations
  • feedback Athom

v4.0.3 - 14-06-2022

  • add support for Xiaomi mi flora care max
  • add update device action

v4.0.4 - 14-06-2022

  • resolved path for driver

v4.0.5 - 14-06-2022

  • add debug information

v4.0.6 - 14-06-2022

  • block zero values from flora max

v4.0.7 - 30-03-2023

  • add changes for Homey 2023

v4.0.8 - 30-03-2023

  • bump version

v4.1.2 - 15-05-2024

  • add alarm capabilities

v4.2.0 - 06-10-2024

  • add support for cloud (Homey bridge)

Final note

The repository is available at: https://github.com/koktaildotcom/homey-mi-flora