home-assistant-iocare
home-assistant-iocare copied to clipboard
RobertD502
Home Assistant custom component for monitoring and controlling Coway Airmega Purifiers
Coway IoCare Home Assistant Integration
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
[!Tip] If you are unable to use the button above, manually search for Coway in HACS.
Manual
- Copy the
cowaydirectory fromcustom_componentsin this repository and place inside your Home Assistant'scustom_componentsdirectory. - Restart Home Assistant
- Follow the instructions in the
Setupsection
[!WARNING] If installing manually, in order to be alerted about new releases, you will need to subscribe to releases from this repository.
Setup
[!Tip] If you are unable to use the button above, follow the steps below:
- Navigate to the Home Assistant Integrations page (Settings --> Devices & Services)
- Click the
+ ADD INTEGRATIONbutton in the lower right-hand corner- 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 changeoption 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. |
Metadata
Owner
RobertD502
Metadata
Home Assistant custom component for monitoring and controlling Coway Airmega Purifiers