A humidifier entity is a device whose main purpose is to control humidity, i.e. a humidifier or dehumidifier. Derive entity platforms from
Properties should always only return information from memory and not do I/O (like network requests). Implement
async_update()to fetch data.
|target_humidity||int||None||The target humidity the device is trying to reach.|
|max_humidity||int||Returns the maximum humidity.|
|min_humidity||int||Returns the minimum humidity.|
|mode||string||The current active preset. Requires |
|available_modes||list||The available modes. Requires |
|supported_features||int||(abstract method)||Bitmap of supported features. See below.|
|is_on||bool||Whether the device is on or off.|
|device_class||string||None||Either DEVICE_CLASS_HUMIDIFIER or DEVICE_CLASS_DEHUMIDIFIER|
A device can have different modes of operation that it might want to show to the user. They could be viewed as presets or some device states with reduced or enhanced functionality for special conditions, i.e. "auto" or "baby". There are a couple of built-in modes that will offer translations, but you're also allowed to add custom modes if that better represents the device.
|No preset is active, normal operation|
|Device is running an energy-saving mode|
|Device is in away mode|
|Device turn all valve full up|
|Device is in comfort mode|
|Device is in home mode|
|Device is prepared for sleep|
|Device is controlling humidity by itself|
|Device is trying to optimize for babies|
Supported features constants are combined using the bitwise or (
|The device supports different modes.|
If the current mode does not allow to adjust target humidity, the device should automatically change its mode to the one which makes it possible upon this call.