"""Air treatment — purifiers, ACs and HRV/ventilation filters. Data module of the suggested-setups signature catalog — see ``helpers/signatures/_model.py`` for the direction semantics and the method contract (every entry cites and is verified against the integration's source; drift-probed weekly).""" from __future__ import annotations from ._model import ConsumableSignature, IntegrationSignature from ._shared import ( FILTER_LIFE_PERCENT, PRE_FILTER_CLEANING_PERCENT, VENTILATION_FILTER_OPERATING_TIME, VENTILATION_FILTER_REMAIN, ) # One object for the AC-only integrations whose climate entity runs through # these HVAC modes (gree, midea_ac) — shared here, next to its users, so the # verbatim-duplicate tripwire holds without a _shared.py entry. _AC_FILTER_CLEANING_RUNTIME = ConsumableSignature( (), "Filter Cleaning", "runtime_hours", delta_units=100, entity_domain="climate", on_states=("auto", "cool", "dry", "fan_only", "heat"), ) SIGNATURES: dict[str, IntegrationSignature] = { "hass_dyson": IntegrationSignature( name="Dyson", verified="2026-07-18 / 2026-09-27 (live keys, deep clean) @ cmgrayb/hass-dyson main", source=( "cmgrayb/hass-dyson sensor.py (verified @ 3dde06e): the live " "filter sensors are DysonHEPAFilterLifeSensor tk " "'hepa_filter_life' and DysonCarbonFilterLifeSensor tk " "'carbon_filter_life' (PERCENTAGE; the carbon one only when the " "device reports a separate carbon filter) — one any-low task " "covers both filters. The older DysonFilterLifeSensor (tk " "'filter_life') is never instantiated; the catalog matched the " "live sensors only through the _filter_life suffix until " "2026-09-27. Humidifiers: DysonNextCleaningCycleSensor tk " "'next_cleaning_cycle' (cltr, HOURS until the deep-clean cycle, " "i.e. the citric-acid descale; unknown at 0) → Descale Appliance " "24 h ahead. The filter reset is only the service " "hass_dyson.reset_filter (no button)." ), tasks=( ConsumableSignature(("hepa_filter_life", "carbon_filter_life"), "Replace Filter", "percent_left"), ConsumableSignature(("next_cleaning_cycle",), "Descale Appliance", "duration_left"), ), ), "dreo": IntegrationSignature( name="Dreo", verified="2026-07-18 @ JeffSteinbok/hass-dreo main", source=( "JeffSteinbok/hass-dreo sensor.py (translation_key 'filter_life', unit '%', humidifiers with FILTERTIME support)." ), tasks=(FILTER_LIFE_PERCENT,), ), "vesync": IntegrationSignature( name="VeSync (Levoit)", verified="2026-07-19 @ core/dev vesync/sensor.py", source="core vesync: tk 'filter_life', PERCENTAGE, MEASUREMENT (Levoit purifiers).", tasks=(FILTER_LIFE_PERCENT,), ), "daikin": IntegrationSignature( name="Daikin AC", verified="2026-09-25 @ home-assistant/core dev (+ tag 2026.7.0)", source=( "home-assistant/core homeassistant/components/daikin/climate.py " "(AC-only integration, so the climate entity IS an air " "conditioner). hvac_action is only mapped for COOL/HEAT/OFF " "(HA_STATE_TO_CURRENT_HVAC) and is None in fan_only, dry and " "heat_cool — the former hvac_action-attribute runtime missed " "every hour in those modes and never reached its 'fan'/'drying' " "states. Runtime on the climate STATE instead: DAIKIN_TO_HA_STATE " "maps fan/dry/cool/hot/auto to fan_only/dry/cool/heat/heat_cool — " "every mode except off moves air through the filter. Interval per " "Daikin's official guidance (clean filters every 2 weeks; ≈100 " "runtime-hours at typical in-season use)." ), tasks=( ConsumableSignature( (), "Filter Cleaning", "runtime_hours", delta_units=100, entity_domain="climate", on_states=("cool", "dry", "fan_only", "heat", "heat_cool"), ), ), ), "gree": IntegrationSignature( name="Gree AC", verified="2026-09-25 @ home-assistant/core dev (+ tag 2026.7.0)", source=( "home-assistant/core homeassistant/components/gree/climate.py " "(AC-only integration, so the climate entity IS an air " "conditioner). The entity NEVER sets hvac_action (0 hits at " "2026.7.0 and dev) — the former hvac_action-attribute runtime " "never accumulated. Runtime on the climate STATE instead: " "HVAC_MODES maps Mode.Auto/Cool/Dry/Fan/Heat to " "auto/cool/dry/fan_only/heat and _attr_hvac_modes = " "[*HVAC_MODES_INVERSE, HVACMode.OFF] — every mode except off " "moves air through the filter. Interval per Daikin's official " "guidance (clean filters every 2 weeks; ≈100 runtime-hours at " "typical in-season use)." ), tasks=(_AC_FILTER_CLEANING_RUNTIME,), ), "comfoconnect": IntegrationSignature( name="Zehnder ComfoAirQ", verified="2026-07-19 @ core/dev comfoconnect/sensor.py", source=("core comfoconnect: key 'days_to_replace_filter', UnitOfTime.DAYS (name-style, no tk → suffix match)."), tasks=( # 168 canonical hours = warn at 7 days remaining (unit 'd' → ÷24). ConsumableSignature(("days_to_replace_filter",), "Replace Ventilation Filter", "duration_left", below_hours=168), ), ), "renson": IntegrationSignature( name="Renson Endura Delta", verified="2026-07-19 @ core/dev renson/sensor.py", source="core renson: tk 'filter_change', DURATION, DAYS, MEASUREMENT.", tasks=(ConsumableSignature(("filter_change",), "Replace Ventilation Filter", "duration_left", below_hours=168, resets=(("filter_change", "reset_filter"),)),), ), "philips_airpurifier_coap": IntegrationSignature( name="Philips AirPurifier (CoAP)", verified="2026-07-19 @ kongo09/philips-airpurifier-coap master sensor.py+const.py", source=( "HACS philips-airpurifier-coap: PhilipsFilterSensor reports " "PERCENT when the filter total is known, else HOURS remaining — " "the LG dual-unit pattern, split per direction. tks: pre_filter " "(cleaning cycle), hepa_filter / active_carbon_filter / " "nanoprotect_filter (replacements), wick (humidifier " "evaporation wick)." ), tasks=( PRE_FILTER_CLEANING_PERCENT, ConsumableSignature(("pre_filter",), "Filter Cleaning", "duration_left", below_hours=72), ConsumableSignature( ("hepa_filter", "active_carbon_filter", "nanoprotect_filter"), "Replace Filter", "percent_left", ), ConsumableSignature( ("hepa_filter", "active_carbon_filter", "nanoprotect_filter"), "Replace Filter", "duration_left", below_hours=72, ), # Humidifier models: the evaporation wick (tk 'wick'), same # dual-unit shape as the filters. ConsumableSignature(("wick",), "Replace Wick", "percent_left"), ConsumableSignature(("wick",), "Replace Wick", "duration_left", below_hours=72), ), ), "dirigera_platform": IntegrationSignature( name="IKEA DIRIGERA (STARKVIND)", verified="2026-07-19 @ sanjoyg/dirigera_platform main sensor.py", source=( "HACS dirigera_platform: STARKVIND 'Filter Elapsed Time' sensor " "(suffix filter_elapsed_time, MINUTES, DURATION) counts UP and " "resets on IKEA's filter-change reset -> usage_above at 4,320 h " "(= IKEA's 259,200-minute filter lifetime). The sibling " "'Filter Lifetime' sensor is the constant total — unusable." ), tasks=(ConsumableSignature(("filter_elapsed_time",), "Replace Filter", "usage_above", above_hours=4320),), ), "ha_blueair": IntegrationSignature( name="Blueair", verified="2026-07-19 @ dahlb/ha_blueair master sensor.py (HACS default)", source=( "HACS ha_blueair: name-derived 'Filter Life' / 'Wick Life' / " "'Water Refresher Life' (PERCENTAGE). Verified % REMAINING: the " "device-aws coordinator returns 100 - filter_usage_percentage. " "A filter_expired problem binary also exists (adoption path)." ), tasks=( FILTER_LIFE_PERCENT, ConsumableSignature(("wick_life",), "Replace Wick", "percent_left"), ConsumableSignature(("water_refresher_life",), "Replace Water Refresher", "percent_left"), ), ), "coway": IntegrationSignature( name="Coway IoCare", verified="2026-07-19 @ robertd502/home-assistant-iocare main sensor.py (HACS default)", source=( "HACS coway: name-derived entities, % remaining — 'Pre filter' " "(AIRMEGA odor variant: 'Charcoal filter') and 'MAX2 filter' " "(AP-1512HHS EU/UK models: 'HEPA filter'); both name variants " "listed as keys." ), tasks=( ConsumableSignature(("pre_filter", "charcoal_filter"), "Filter Cleaning", "percent_left"), ConsumableSignature(("max2_filter", "hepa_filter"), "Replace Filter", "percent_left"), ), ), "winix": IntegrationSignature( name="Winix", verified="2026-09-02 @ iprak/winix main sensor.py (HACS default)", source=( "HACS winix: tk 'filter_life' (PERCENTAGE) — % remaining derived " "from filter hours vs the model's max filter life " "(wrapper.filter_max_life; was filter_alarm_duration before 2026-09)." ), tasks=(FILTER_LIFE_PERCENT,), ), "duco": IntegrationSignature( name="Duco ventilation", verified="2026-07-20 @ home-assistant/core dev", source=("core duco: tk 'filter_remaining' (DURATION, DAYS) — the box's own filter countdown."), tasks=(ConsumableSignature(("filter_remaining",), "Replace Ventilation Filter", "duration_left", below_hours=168),), ), "flexit_bacnet": IntegrationSignature( name="Flexit Nordic", verified="2026-07-20 @ home-assistant/core dev", source=( "core flexit_bacnet: tk 'air_filter_operating_time' " "(TOTAL_INCREASING, HOURS — counts UP, reset on filter change) → " "usage_above at 4380 h (Flexit: change the filter every 6-12 " "months). An 'air_filter_polluted' problem binary also exists " "(adoption path)." ), tasks=( VENTILATION_FILTER_OPERATING_TIME, ), ), "tradfri": IntegrationSignature( name="IKEA Trådfri (STARKVIND)", verified="2026-07-20 @ home-assistant/core dev", source=( "core tradfri: tk 'filter_life_remaining' (MEASUREMENT, HOURS " "remaining) — STARKVIND purifiers on the NATIVE IKEA gateway " "(the DIRIGERA path is covered separately)." ), tasks=(ConsumableSignature(("filter_life_remaining",), "Replace Filter", "duration_left", below_hours=72),), ), "dyson_local": IntegrationSignature( name="Dyson (local)", verified="2026-07-20 @ libdyson-wg/ha-dyson main sensor.py (HACS default)", source=( "HACS dyson_local (libdyson-wg — the maintained fork): " "name-derived 'Filter Life' (HOURS remaining) and 'Filter Life " "Percentage' / 'Carbon Filter Life' / 'HEPA Filter Life' / " "'Combined Filter Life' (PERCENTAGE, value/4300 h budget). The " "percent suffixes end in _filter_life too — the unit-aware " "matcher routes each entity to the right direction (the " "lg_thinq dual-unit pattern). button.py (verified @ 41c3338): " "'Reset Filter Life' (no translation_key → suffix " "_reset_filter_life, CONFIG) exists only on Pure Cool Link units " "(hasattr filter_life) and resets the 'filf' hours behind both " "'Filter Life' (h) and 'Filter Life Percentage'; the Pure Cool " "carbon/HEPA/combined % sensors have no reset. Humidify+Cool: " "'Next Deep Clean' (HOURS until the citric-acid deep-clean cycle, " "libdyson cltr) → Descale Appliance." ), tasks=( # The Pure Cool "combined" sensor is NAMED plain 'Filter Life' # (suffix _filter_life) but reports PERCENT, while older models' # 'Filter Life' reports HOURS — the same suffix appears in BOTH # key tuples and the unit check routes each entity. ConsumableSignature( ( "filter_life_percentage", "carbon_filter_life", "hepa_filter_life", "filter_life", ), "Replace Filter", "percent_left", resets=(("filter_life_percentage", "reset_filter_life"),), ), ConsumableSignature( ("filter_life",), "Replace Filter", "duration_left", below_hours=72, resets=(("filter_life", "reset_filter_life"),), ), ConsumableSignature(("next_deep_clean",), "Descale Appliance", "duration_left"), ), ), "venstar": IntegrationSignature( name="Venstar thermostat", verified="2026-07-20 @ home-assistant/core dev", source=( "core venstar CONSUMABLE_ENTITIES: key 'filterHours' carries tk " "'filter_install_time' (HOURS of filter RUNTIME, counts UP, " "user-reset on change) — 300 h ≈ the typical 1-3-month " "furnace-filter guidance. The sibling 'filterDays'/tk " "'filter_usage' (CALENDAR days since install) ships alongside it " "and is skipped: same duty, weaker wear proxy, and two " "same-direction signatures of one task name would collide in " "discovery's per-device dedupe." ), tasks=(ConsumableSignature(("filter_install_time",), "Replace Filter", "usage_above", above_hours=300),), ), # ─── Round 14 (2026-09-25): purifier/HRV filters from the HACS + ──── # ─── core 2026.9/dev sweep ─────────────────────────────────────────── "meross_lan": IntegrationSignature( name="Meross LAN (MAP100 purifier)", verified="2026-09-25 @ krahabb/meross_lan master", source=( "HACS meross_lan sensor.py MLFilterMaintenanceSensor " "(Appliance.Control.FilterMaintenance; entitykey mc.KEY_FILTER " "'filter', PERCENTAGE, DIAGNOSTIC, no translation_key). " "helpers/entity.py names it entitykey.replace('_', ' ')" ".capitalize() = 'Filter' (channel 0 is dropped) under " "has_entity_name → suffix _filter. The value is the payload's " "'life' — REMAINING: the emulator (emulator/mixins/fan.py) starts " "it at 100 and counts it down, and a real MAP100 push quoted in " "issue #388 reads life: 100 on a fresh filter. No other " "meross_lan entity key ends in 'filter' (the match is " "platform-scoped)." ), tasks=(ConsumableSignature(("filter",), "Replace Filter", "percent_left"),), ), "tuya_local": IntegrationSignature( name="Tuya Local", verified="2026-09-25 @ make-all/tuya-local main", source=( "HACS tuya_local (not in the HACS default store) entity.py: " "_attr_translation_key = config.translation_key; devices/*.yaml " "carry 'translation_key: filter_life' with unit '%' in 57 device " "configs (purifiers, humidifiers, dehumidifiers, robot vacuums, " "fans) — the Tuya 'filter' DP, REMAINING life (it sits next to a " "'Filter remaining' days DP on the Honeywell/Stadler Form " "configs; a used-hours DP was moved off filter_life in #6202). " "The duration-unit filter_life variants (d/h/min/s) are NOT " "signed: some count UP without the 'invert' mapping " "(fresco_hydrateultra_petfountain v1 vs v2). 'entity: lock' in " "these configs is the CHILD lock — no lock signature. Resets " "(verified @ 986d71e): 37 of the '%' configs carry a button with " "translation_key 'filter_reset' (e.g. ap402_airpurifier.yaml), two " "robot vacuums a name-only 'Reset filter' button (suffix " "_reset_filter); the press writes the yaml's reset DP. A device " "with several matching buttons gets none wired." ), tasks=( ConsumableSignature( ("filter_life",), "Replace Filter", "percent_left", resets=(("filter_life", "filter_reset"), ("filter_life", "reset_filter")), ), ), ), "govee": IntegrationSignature( name="Govee (purifiers)", verified="2026-09-25 @ lasswellt/govee-homeassistant main", source=( "HACS govee (lasswellt) sensor.py GoveeFilterLifeSensor: tk " "'sensor_filter_life', PERCENTAGE, MEASUREMENT, DIAGNOSTIC — " "'remaining filter life %' from the devices.capabilities.property " "instance 'filterLifeTime' (models/state.py; H7124/H7126). " "LaggAt/hacs-govee shares the 'govee' domain but ships lights " "only — no conflicting entity." ), tasks=(ConsumableSignature(("sensor_filter_life",), "Replace Filter", "percent_left"),), ), "duux": IntegrationSignature( name="Duux", verified="2026-09-25 @ SSmale/Duux-Home-Assistant master", source=( "HACS duux sensor.py DuuxFilterLifeSensor (Bright 2 purifier): " "key 'filter', tk 'filter_life', PERCENTAGE, MEASUREMENT — " "translations name it 'HEPA Filter remaining lifespan' " "(REMAINING; fixtures/devices.json reports filter: 80)." ), tasks=(FILTER_LIFE_PERCENT,), ), "komfovent": IntegrationSignature( name="Komfovent ventilation", verified="2026-09-25 @ lnagel/hass-komfovent main", source=( "HACS komfovent sensor.py: key 'filter_clogging' (Modbus register " "917, PERCENTAGE, MEASUREMENT; KomfoventSensor sets " "translation_key = key). Clogging climbs to 100 % (warning 0x81 " "'Change Air Filter'); the 'Clean Filters Calibration' button " "resets it after a change → alert_above 90 % with auto-resolve. " "button.py (verified @ e5be948): tk 'clean_filters' (name 'Clean " "Filters Calibration', CONFIG) writes register 1051 = 1, the " "'Reset filters counter'." ), tasks=( ConsumableSignature( ("filter_clogging",), "Replace Ventilation Filter", "alert_above", delta_units=90, resets=(("filter_clogging", "clean_filters"),), ), ), ), "pluggit": IntegrationSignature( name="Pluggit ventilation", verified="2026-09-25 @ Tvalley71/pluggit main", source=( "HACS pluggit device_map.py: key ATTR_FILTER_REMAIN " "'filter_remain' (DURATION, unit 'd'; entity.py's translation_key " "property returns the key) — Modbus register 554 = filter days " "REMAINING (device.py derives the replace level from lifetime − " "remain; the translated state 0 reads 'Replace the filter now'). " "Absent on Servo_flow units (not_component_class). Button key " "'filter_reset' (ATTR_FILTER_RESET, translation_key = key) → " "set_filter_reset writes register 558 = 1, restoring the " "remaining days (verified @ ee0e13d)." ), tasks=(VENTILATION_FILTER_REMAIN,), ), "dantherm": IntegrationSignature( name="Dantherm ventilation", verified="2026-09-25 @ Tvalley71/dantherm main", source=( "HACS dantherm — the same code base as pluggit (device_map.py " "key 'filter_remain', DURATION, unit 'd', Modbus register 554 = " "filter days REMAINING; translation_key = key) and the same " "'filter_reset' button → register 558 (verified @ da9dfaa)." ), tasks=(VENTILATION_FILTER_REMAIN,), ), "ha_carrier": IntegrationSignature( name="Carrier Infinity", verified="2026-09-25 @ dahlb/ha_carrier main", source=( "HACS ha_carrier sensor.py FilterUsedSensor: entity_name 'Filter " "Remaining' (carrier_entity.py sets _attr_name = entity_name " "under has_entity_name, no translation_key → suffix " "_filter_remaining), PERCENTAGE = 100 − status.filter_used → " "REMAINING." ), tasks=(ConsumableSignature(("filter_remaining",), "Replace Filter", "percent_left"),), ), "localthings": IntegrationSignature( name="Samsung (Local Things)", verified="2026-09-25 @ mbillow/localthings main", source=( "HACS localthings registry/capabilities: every % filter sensor " "is Samsung's filterUsage = % USED (common.filter_usage_percent: " "filterStatus flips to 'wash' at 100); entity.py's " "translation_key defaults to the descriptor key. " "airconditioner.AIR_FILTER 'air_filter_usage' (AC + dehumidifier " "washable dust filter) → Filter Cleaning, gated on its AC-only " "sibling 'air_filter_usage_hours' because fridge.AIR_FILTER " "reuses the 'air_filter_usage' key for the fridge's deodorizing " "filter; air_purifier.HEPA_FILTER 'hepa_filter_usage' + " "air_purifier.FILTER 'filter_progress' (counts UP, 100 = change) " "→ Replace Filter; range_hood.HOOD_FILTER 'hood_filter_usage' → " "Clean Grease Filter (mirrors the core smartthings entry). " "Skipped: the shared water-filter key 'filter_usage' (fridge, " "dishwasher, water purifier AND the AMF microfiber lint unit on " "the washer registry — one key, different duties). Reset " "(verified @ 2e942fc): 'air_filter_reset' (common." "filter_reset_button, filterReset 'On' to the same " "/filter/airdustfilter resource; measured on a RAC board, #449). " "The hepa/hood resets are only extrapolated upstream and stay " "unwired." ), tasks=( ConsumableSignature( ("air_filter_usage",), "Filter Cleaning", "alert_above", delta_units=90, require_sibling_keys=("air_filter_usage_hours",), resets=(("air_filter_usage", "air_filter_reset"),), ), ConsumableSignature(("hepa_filter_usage", "filter_progress"), "Replace Filter", "alert_above", delta_units=90), ConsumableSignature(("hood_filter_usage",), "Clean Grease Filter", "alert_above", delta_units=90), ), ), "flexit": IntegrationSignature( name="Flexit (Modbus)", verified="2026-09-25 @ home-assistant/core dev", source=( "core flexit (Modbus CI66; config flow since 2026.9, the sensor " "and binary_sensor platforms are on dev = 2026.10): tk " "'air_filter_operating_time' (DURATION, HOURS, TOTAL_INCREASING; " "flexit_modbus Measurements.filter_running_hours, input register " "8 — the filter timer behind the filter alarm, not a unit " "runtime) → usage_above at 4380 h, mirroring flexit_bacnet. A " "'filter_alarm' problem binary also exists (adoption path)." ), tasks=( VENTILATION_FILTER_OPERATING_TIME, ), ), # ─── Round 15 part 2 (2026-09-27): HACS HRVs, ACs, thermostats, ────── # ─── fragrance diffusers ───────────────────────────────────────────── "genvex_connect": IntegrationSignature( name="Genvex Connect / Nilan gateway", verified="2026-09-27 @ superrob/genvexconnect main (70a1c55) + superrob/genvexnabto 1.5.4", source=( "HACS genvex_connect entity.py: translation_key = the genvexnabto " "value key (plain str constants, every entity). sensor.py: " "'filter_days_left' (unit 'd', 'Days left until filter change'; " "Nilan CTS400/CTS602/CTS602light) → duration_left 7 days; " "'filter_days' (unit 'd', 'Days since filter change'; Genvex " "Optima 270/314, counts up until the reset) → usage_above 4,380 h " "like the other HRV filter timers. The two never exist on one " "model. button.py 'filter_reset' (CONFIG, created when the model " "provides FILTER_RESET — every model above) writes the setpoint 1. " "The DHW 'sacrificial_anode' enum ('service' state) is left out: " "its meaning is only inferred from the option names." ), translation_keys_authoritative=True, tasks=( ConsumableSignature( ("filter_days_left",), "Replace Ventilation Filter", "duration_left", below_hours=168, resets=(("filter_days_left", "filter_reset"),), ), ConsumableSignature( ("filter_days",), "Replace Ventilation Filter", "usage_above", above_hours=4380, resets=(("filter_days", "filter_reset"),), ), ), ), "nilan": IntegrationSignature( name="Nilan (CTS602 Modbus)", verified="2026-09-27 @ veista/nilan master (6cdbbfe)", source=( "HACS nilan sensor.py: translation_key = the map name on every " "sensor; 'days_to_air_filter_change' (UnitOfTime.DAYS, input " "register air_flow_to_filt_day, bus version >= 9) → duration_left " "7 days. 'days_since_air_filter_change' is the same duty from the " "other side and is not signed twice; the DHW 'anode_state' raw " "register (2 = Service) is left out (meaning unconfirmed). No " "filter-reset button (button.py has only sync_time)." ), translation_keys_authoritative=True, tasks=(ConsumableSignature(("days_to_air_filter_change",), "Replace Ventilation Filter", "duration_left", below_hours=168),), ), "ha_comfoconnectpro": IntegrationSignature( name="Zehnder ComfoConnect Pro (Modbus)", verified="2026-09-27 @ hstrohmaier/ha_comfoconnectpro main (e03e4b6)", source=( "HACS ha_comfoconnectpro const.py: 'filter_days_remaining' (input " "register 25, unit 'd' → DURATION; translation_key = key for every " "generated entity) — days until the filter change, the ComfoAir " "Q's own countdown → duration_left 7 days like the core " "comfoconnect entry. The 'filter_dirty' binary is the same duty " "(not signed twice). No reset entity." ), translation_keys_authoritative=True, tasks=(ConsumableSignature(("filter_days_remaining",), "Replace Ventilation Filter", "duration_left", below_hours=168),), ), "heru": IntegrationSignature( name="Östberg HERU", verified="2026-09-27 @ toringer/home-assistant-heru master (ec1294f)", source=( "HACS heru const.py (name-based entities under has_entity_name, no " "translation_key): 'Filter days left' (input register 3x00020, " "unit spelled out as 'days') → suffix _filter_days_left, " "duration_left 7 days; button 'Reset filter timer' (coil " "0x00006) → suffix _reset_filter_timer resets it." ), tasks=( ConsumableSignature( ("filter_days_left",), "Replace Ventilation Filter", "duration_left", below_hours=168, resets=(("filter_days_left", "reset_filter_timer"),), ), ), ), "midea_ac": IntegrationSignature( name="Midea Smart AC (msmart-ng)", verified="2026-09-27 @ mill1000/midea-ac-py main (d433bbb)", source=( "HACS midea_ac climate.py (AC and commercial AC devices only): " "_OPERATIONAL_MODE_TO_HVAC_MODE maps auto/cool/dry/heat/fan to " "auto/cool/dry/heat/fan_only, off otherwise — every mode except " "off moves air through the filter → the same engine-runtime duty " "as gree, with its cadence (Daikin's guidance: clean filters every " "2 weeks ≈ 100 runtime hours at in-season use). The unit's own " "'filter_alert' binary (supports_filter_reminder only) is " "device_class problem → problem-sensor adoption." ), tasks=(_AC_FILTER_CLEANING_RUNTIME,), ), "nest_legacy": IntegrationSignature( name="Nest (legacy API)", verified="2026-09-27 @ tronikos/nest_legacy main (018eb74)", source=( "HACS nest_legacy sensor.py: tk 'filter_runtime' (thermostats with " "an air filter; SECONDS, DURATION, TOTAL_INCREASING) = the " "FilterReminder trait's filterRuntime, the HVAC runtime on the " "current filter → usage_above 300 h, the furnace-filter cadence of " "the venstar duty. Nest's own reminder is the problem-class " "'filter_replacement_needed' binary (adoption path); Protect " "'replace_by' is a DATE sensor (no direction)." ), tasks=(ConsumableSignature(("filter_runtime",), "Replace Filter", "usage_above", above_hours=300),), ), "pura": IntegrationSignature( name="Pura fragrance diffusers", verified="2026-09-27 @ natekspencer/ha-pura main (6166f16)", source=( "HACS pura sensor.py: tk 'fragrance_remaining' (car/mini) and " "'bay_fragrance_remaining' (wall/plus, one per bay with the " "placeholder {bay}), PERCENTAGE — pypura's bay.remaining.percent, " "else (expectedLifeHours − runtime) / expectedLife → % REMAINING. " "Two-bay diffusers get one task per vial." ), tasks=( ConsumableSignature( ("fragrance_remaining", "bay_fragrance_remaining"), "Replace Air Freshener", "percent_left", per_entity=True, ), ), ), }