Skip to content

Commit

Permalink
docs: update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
jvandenaardweg committed Dec 30, 2022
1 parent 041b501 commit f98132e
Showing 1 changed file with 7 additions and 4 deletions.
11 changes: 7 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,12 +84,15 @@ I recommend using the Homebridge UI to configure the plugin settings, as it give
The plugin allows full manual speed control from 0% to 100% and everything in between. However, your fan needs to be able to support such speed commands. It is [known](https://github.com/arjenhiemstra/ithowifi/wiki/CO2-sensors#itho-with-built-in-co2--sensor-cve-s-optima-inside) that speed commands send to CVE unit's with a built-in CO2 sensor (like the CVE-S Optima Inside) are overruled by the internal speed control of the fan. This means you can't have fine grained control over your fan speed, and are limited to "low", "medium" and "high" speed settings.

If you have such a device with a built-in CO2 sensor, please add the `device` configuration option to your config.json file and set the `co2Sensor` option to `true`. Or use the Homebridge UI to set that option. The plugin will then automatically map the speed in the Home App to the respective virtual remote commands, which will allow you to control the fan speed in 3 steps. The mapping is as follows:

| Home App speed | Virtual remote command | HomeKit Active state |
| -------------- | ---------------------- | -------------------- |
| 0% | low | inactive |
| 33% | low | active |
| 67% | medium/auto | active |
| 100% | high | active |
| 0% | low | inactive |
| 33% | low | active |
| 67% | medium/auto | active |
| 100% | high | active |

The Home App will automatically "snap" to the nearest speed setting, so you don't have to worry about setting the speed to 33% or 67% exactly.

You can also remove the CO2 sensor from the device itself. Just unplug it from the internal board. This will allow you to use the full manual speed control, but you don't receive any Carbon Dioxide reading from this sensor anymore in the Home App for the Air Quality Sensor. Make sure you have removed the `device` configuration option completely.

Expand Down

0 comments on commit f98132e

Please sign in to comment.