Skip to content

RobertD502/home-assistant-iocare

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Coway IoCare Home Assistant Integration

hacs_badge GitHub manifest version (path)

Buy Me A Coffee Donate using Liberapay

A lot of work has been put into creating the backend and this integration. If you enjoy this integration, consider donating by clicking on one of the supported methods above.

*All proceeds go towards helping a local animal rescue.

Confirmed Working Models

Installation

An account (E-mail/Password) created directly through Coway is required.

Warning

As of late 2022, Coway has required accounts to be migrated to a "Coway account". With that said, this integration will only work if you have migrated your account to a Coway account.

With HACS

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Tip

If you are unable to use the button above, manually search for Coway in HACS.

Manual

  1. Copy the coway directory from custom_components in this repository and place inside your Home Assistant's custom_components directory.
  2. Restart Home Assistant
  3. Follow the instructions in the Setup section

Warning

If installing manually, in order to be alerted about new releases, you will need to subscribe to releases from this repository.

Setup

Open your Home Assistant instance and start setting up a new integration.

Tip

If you are unable to use the button above, follow the steps below:

  1. Navigate to the Home Assistant Integrations page (Settings --> Devices & Services)
  2. Click the + ADD INTEGRATION button in the lower right-hand corner
  3. Search for Coway

Caution

Coway has implemented password checks which prompts users to change or ignore changing passwords that are 60 or more days old. If you want to skip changing your password, select the Skip password change option during setup. Otherwise, when the time comes, you will need to manually login using the IoCare app and change your password followed by reauthentication of the integration within Home Assistant.

Devices

Caution

Coway is shipping newer units, which are not reporting an AQI.

If the AQI sensor entity is not created for your purifier, it is one of the newer units.

If/when Coway's servers start reporting AQI values for these units, AQI sensor entities will be made available.

Each purifier is exposed as a device in Home Assistant.

Each purifier has the following entities:

Entity Entity Type Additional Comments
Purifier Fan Ability of controlling power, speed, and preset mode (Auto Mode, Night Mode)
Current timer Select Ability to set timer to OFF, 1 hour, 2 hours, 4 hours, or 8 hours. Setting a timer can only be done when a purifier is powered ON
Light Switch Only for non-250S purifiers. Ability to turn light on and off. Controlling the light can only be done when a purifier is powered ON
Light Select Only for 250S purifiers. Ability to set the light to Off, On, and AQI Off. Controlling the light can only be done when a purifier is powered ON
AQI Sensor Air Quality Index
MAX2 Filter Sensor Percentage of MAX2 filter life remaining
Pre Filter Sensor Percentage of Pre filter remaining
Particulate Matter 10 Sensor Not available for IconS purifiers.
Particulate Matter 2.5 Sensor Only available for IconS and 250S purifiers.
Timer remaining Sensor Shows the current amount of time left on a timer. This is a string in the form of hours:minutes
Indoor air quality Sensor Shows the current indoor air quality based on Coway's scale. The state can be Good, Moderate, Unhealthy, or Very Unhealthy. Not available for IconS purifiers.
Pre-filter wash frequency Select Shows current pre-filter wash frequency setting and allows you to change it.
Smart mode sensitivity Select Shows current smart mode sensitivity setting and allows you to change it.

About

Home Assistant custom component for monitoring and controlling Coway Airmega Purifiers

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%