/winix

Home Assistant component for C545 Winix Air Purifier

Primary LanguagePythonMIT LicenseMIT

GitHub Release License

Summary

A custom component to interact with Winix C545 Air Purifier. This has also been reported to work with these models: AM90, HR1000, C610, 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 4 services winix.plasmawave_off, winix.plasmawave_on, plasmawave_toggle and remove_stale_entities in addition to the default fan services fan.speed, fan.toggle, fan.turn_off, fan.turn_on, fan.set_preset_mode.
    • remove_stale_entities can be used to remove entities which appear unavaialble when the associated device is removed from the account.

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.