iprak / winix

Home Assistant component for C545 Winix Air Purifier

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Summary

A custom component to interact with Winix C545 Air Purifier. This has also been reported to work with these models: AM90, HR1000, C909

Installation

This can be installed by copying all the files from custom_components/winix/ to <config directory>/custom_components/winix/. Next add Winix integration from Add Integration and use your credentials from Winix mobile app.

  • You should now see one device and 4 entities being created.

image

  • The Air QValue sensor reports the qValue reported by Winix purifier. This value is related to air quality although I am not exactly sure what it represents.

  • The AQI sensor matches the led light on the purifier.

    • Good (Blue) = 1
    • Fair (Amber) = 2
    • Poor (Red) = 3
  • The Filter Life sensor represents the left filter life and is based on an initial life of 9 months.

  • The fan entity supports speed and preset modes

image

  • The device data is fetched every 30 seconds.
  • There are 3 new services winix.plasmawave_off, winix.plasmawave_on, plasmawave_toggle in addition to the default fan services fan.speed, fan.toggle, fan.turn_off, fan.turn_on, fan.set_preset_mode.

Note

  • If purifiers are added/removed, then you would want to restart HomeAssistant.

  • Winix does not support simultaneous login from multiple devices. If you logged into the mobile app after configuring HomeAssistant, then the HomeAssistant session gets flagged as invalid and vice-versa.

Breaking Changes

  • 1.1.0 changed the sensor implementation. The aqi sensor id might be different now.

  • 1.0.0 introduces config flow and previous yaml based setup is no longer supported. You would want to delete that setup and proceed to setup the intgeration as mentioned in Installation section.

About

Home Assistant component for C545 Winix Air Purifier

License:MIT License


Languages

Language:Python 99.6%Language:Shell 0.3%Language:Dockerfile 0.2%