Skip to content

zyonse/homebridge-dreo

Repository files navigation

Homebridge Dreo Plugin

verified-by-homebridge NPM Version npm

Homebridge plugin for Dreo brand smart devices. Dreo Fans on Amazon (Affiliate link)

Compatability

Confirmed Working

Fans

  • DR-HAF001S
  • DR-HAF003S
  • DR-HAF004S
  • DR-HCF003S
  • DR-HPF001S
  • DR-HPF002S
  • DR-HTF001S
  • DR-HTF002S
  • DR-HTF004S
  • DR-HTF005S
  • DR-HTF007S
  • DR-HTF011S

Heaters

  • DR-HSH004S
  • DR-HSH006S
  • DR-HSH009S
  • ‎DR-HSH017S

Humidifiers

  • DR-HM713S

Please open an issue if you have another model that works or doesn't work. If you have another device type and can help me test some code out I would definitely be open to adding support.

Supported Features

Fans

  • Fan Speed: Fan speed is displayed as a percentage value with steps that are equivalent to those of the Dreo app. (for example, a fan with speeds 1-6 will have steps at 17%, 33%, 50% etc)

  • Oscillate: Toggles fan oscillation

  • Temperature Sensor: Displays current temperature sensor reading. (for supported devices, check your devices capabilities) Because the Dreo fan temperature sensors are not entirely accurate, you can also set a specific temperature offset for your devices.

  • Child Lock: Lock physical fan controls

Heaters

Heaters are displayed as a thermostat accessory with the following control mappings

  • Heat Mode: Controls Dreo 'Eco' mode
  • Cool Mode: Controls Dreo 'Fan Only' mode
  • Auto Mode: Controls Dreo 'Heat' speeds, represented as an offset from the minimum temperature (for example, a heater with speeds 1-3 and a minimum temp of 41F can be controlled by setting temperature to 41, 42, 43)
  • Current Temperature: Displays current temperature sensor reading
  • Fan Speed: Controls heater vent angle
  • Oscillate: Toggles heater vent oscillation
  • Child Lock: Lock physical heater controls
  • Hardware Display: Changes temperature unit on physical hardware display

Humidifiers

To see Humidifier "Water Level" and "Fog Level" in HomeKit, you will need to select Show as Separate Tiles in HomeKit. An then name the Switches accordingly, i.e. Sleep Mode & Warm Mist.

  • Auto Mode: Controls Dreo Manual Mode, as HomeKit hides Humidity slider in Auto Mode. You can adjust Mist Level, which reflects the Dero Manual Mode in the Dreo app.
  • Humidity Mode: Controls Dreo Auto Mode & Sleep Mode mode. HomeKit do not support Sleep Mode, But you can switch between Sleep Mode and Auto Mode using the 'Sleep' switch in HomeKit.
  • Fan Speed: Controls the Mist Level of the humidifier. Humidifier will automatically switch to Manual Mode if this is adjusted in HomeKit.
  • Sleep Mode: This is a switch that will toggle the humidifier into Sleep Mode.
    • Note: Do not forget to rename this switch as HomeKit will name it as a Switch by default.
  • Warm Mist: This is a switch turns on the humidifier's Warm Mist.
    • Note: Do not forget to rename this switch as HomeKit will name it as a Switch by default.

Sensors

  • Humidity Sensor: Displays current humidity sensor reading.
  • Water Level Sensor: It's a binary sensor. Displays 100% if the Humidifier has any water in the tank. If no water, it will display 0%. Dero humidifiers do not have a water level sensor.

Installation

npm install -g homebridge-dreo

(Or install through the Homebridge UI)

Configuration

Provide your Dreo app login credentials

"platforms": [
  {
    "options": {
      "email": "[email protected]",
      "password": "00000000"
    },
    "hideTemperatureSensor": false,
    "temperatureOffset": 0,
    "name": "Dreo Platform",
    "platform": "DreoPlatform"
  }
]

Contributing

If you'd like to add support for a new device type, you might find this writeup from @JeffSteinbok (HomeAssistant plugin maintainer) useful for tracing the Dreo App:

https://github.com/JeffSteinbok/hass-dreo/blob/main/contributing.md

Special thanks

homebridge-tp-link-tapo: Similar repo that helped me figure out some of the http request functions necessary for this project.

About

Apple HomeKit integration for Dreo Smart Devices

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Contributors 10