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.
- 300S
- 400S
- AP-1512HHS
- IconS
An account (E-mail/Password) created directly through Coway is required. 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.
This integration is part of the HACS default repo.
- Go to the HACS integrations page and select
+ EXPLORE & DOWNLOAD REPOSITORIES(lower right-hand corner) - Search for
Cowayand select it. - Select
Download(lower right-hand corner) - Select
Downloadonce again - Restart Home Assistant
- Follow the instructions in the
Setupsection
- Copy the
cowaydirectory fromcustom_componentsin this repository and place inside your Home Assistant'scustom_componentsdirectory. - Restart Home Assistant
- Follow the instructions in the
Setupsection
Note: If installing manually, in order to be alerted about new releases, you will need to subscribe to releases from this repository.
Navigate to Settings > Devices & Services > click the + Add Integration button > search for "Coway" (restart Home Assistant and / or clear browser cache if you can't find it)
Alternatively, click on the button below to add the integration:
Note: 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.
Coway is shipping new 400S (possibly also 300S) units, which are not reporting AQI.
The AQI sensor entity is not available for these new units.
If/when Coway's servers start reporting AQI values, 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 |
Ability to turn light on and 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 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. |