2025.1.2 Stayin' alive

Highlights

• a couple of longstanding bugs with connection handling have been fixed, which should hopefully keep your devices online for longer and have them recover more reliably when they do go offline.

Breaking changes

• "device22" devices are no longer auto detected when the protocol is 3.3. If your devices stop working after the upgrade, please try setting them to the new 3.22 protocol before filing a bug report.
• Electriq DESD9LW dehumidifier: deprecated humidity sensor has been removed, use the humidity from the humidifier entity.
• Eeese Carl: tank sensor has reverted to how it was before 2024.12.2. If you have this device, and the behaviour from the past 3 releases was correct for you, then file a request for a new device, as it is not compatible with devices of other users.

New devices

• Rohnson R-9530 dehumidifier #2767
• Ketotek KTEM06 pro energy meter #2770
• PetSnowy Snow+ litter box #2806 by @davidjmdev
• Jiahong ET44W thermostat #2718 by @yaro24
• Atorch AT4PTW DIN rail thermostat #2774

Improvements to existing devices

• Qnect USB powerstrip: add compatible Gosund PM03 T-AR model #2858 by @rclarkmorrow
• Matsee V2 energy meter: use translations for direction #1708
• Eeese Carl: reverted a change to the tank sensor in 2024.12.2 #2866
• Ledvance Planon: allow separate switching of lights #2683

General improvements

• tinytuya library bumped to latest 1.16.1 #2859 by @dependabot
• Translations added for "direction" (in/out) binary sensors #2770, #1708
• device communication: ignore HA poll requests even in polling mode #653 #1804
• device communication: add 3.22 as a separate protocol for "device22" devices #1804

Development improvements

• Deprecations tagged with dates, to make managing them easier

2025.1.1 Hidden text

Highlights

• Text entities are now supported. This gap in the entity model was quietly filled by HA in the December 2022, and it went unnoticed until now.
• Entities can now be marked "hidden". This will cause them to be disabled by default, and users will need to manually enable them to use them in Home Assistant. The intention is to use this for advanced configuration options that most users should not touch.
• 23 new devices, improvements to 7 devices, plus bulk improvements to lights, air quality sensors, thermostats and one heater.

New Devices

• TV-TYA238-AK-2MP TV sync backlight #2690
• Siguro Air Master purifier #2700
• Sai Me Tei towel rail #2708
• Protmex PT-19DW climate sensor alarm clock #2712
• Inventor Rise Pro dehumidifier #2720
• LSC Smart Connect dual band outdoor camera #2723
• Generic RGB "Dreamlight" garland #2724
• essentials Smart Home bathroom heater #2789 by @Privatecoder
• Gosund SW2 dimmer #2812 by @jcconnell
• Dunwore F60 floor thermostat #2739
• LSC Smart Connect pet feeder #2743
• Wenzhi WZ-M100-W presence sensor #2776 by @salbr
• Clofte Duo 400 humidifier #2752 by @mikita-liaukovich-epam
• GW Motor roller blind #2788 by @Privatecoder
• Rohnson SmartChef XL air fryer #2746
• Delixing KCL-M1802A-M aroma diffuser #2756
• Quad powerstring with timers: add initial state selector for Powersav compatibility #2853 by @rclarkmorrow
• Absina EV charger #2816 by @ralsinn
• Gosund WP9-RTL 3 outlet powerstrip with USB #2821 by @rclarkmorrow
• OGACFO floor humidifier #2826 by @ShawnBuckley
• Homebase oscillating fan #2833 by @choppedpork
• Sunred Smart Triangle Dark patio wall heater #2837 by @gurtjun
• BLE KB150A keypad lock #2824 by @josefelixh

Improvements to existing devices

• Air quality sensors: state based icons added #1708
• lights: add text entities for directly setting scenes (disabled by default) #2795
• lights: add translations for common scenes #1708
• Asakuki diffuser: add named color support #2807
• SmartplugV2 EnergyV2: add compatible Almo plug #2808
• Thermostats and heaters: correct degree character
• HDMI ambient 65" light: fix lower lights range #2818
• EMS water heater: reduce max temperature according to manual #2832 by @Waz-Cpt
• RGBCW lightbulb: add compatible Arlec Grid Connect download #2840 by @DLV111
• TYTE-D1: use correct switch for climate, fix some naming #2863 by @ShawnBuckley

General improvements

• vacuum: support new VacuumActivity based activity property #2647
• text entity support added #2795
• support for marking uninteresting entities as hidden by default (can be manually enabled by the user)
• improvements to Italian translations #2804 by @Alokin90

Development improvements

• cloud config flow: improve logging
• tinytuya downgraded back to 1.15.1 (due to mystereous reports starting after last release)

2025.1.0 New year, new format

Highlights

• no more confusing primary_entity holding a single entity, and secondary_entities holding a list. Now a single entities entry holds a list of all the entities linked to the device.
• products listings now support manufacturer, model and model_id to be specified separately in the config (to be used in the UI in future).

Breaking changes

• Previously deprecated switch and number entities that were replaced by valve entities in 2024.8 have now been removed.
• Using primary_entity and secondary_entities in a config will now raise deprecation warnings. Support for these tags will be removed in a future release, so if you maintain your own configs, please update them to use a single entities list instead.
• Air quality sensors have been standardized and translated. This may have caused some changes to status strings. If you read the status in automations, the comparison values may need updating.

New Devices

• Mayborn (aka Tommy Tippee) GroClock Connect #2601
• EARU K6H-3A-W thermostat #2602
• PowerAsia 6inch recessed lighting #2577
• Fresco Hydrate Ultra pet fountain #2702 by @Fuechslein
• Etna VW644MC dishwasher #2603
• Scheeair Nova 100 ventilation fan #2614
• Hysen HT101RF thermostat #2620
• Cecotec Readywarm 8400 heater #2701 by @stquinn
• ZYM100W v2 presence sensor #2744 by @felipecrs
• Woox R7246 IR remote with climate sensors #2717 by @szupi-ipuzs
• HISB80A energy meter #2726 by @estevao90
• Ledvance Smart+ Planon LED panel #2728 by @akop
• 3A Nue fan and light #2737 by @vytux-com
• Wasserstein AquaPal water monitor #2633
• A03 siren #2635
• Zemismart ZMAi-90 energy monitor smart switch #2651
• airx H8 humidifier #2710 by @City-Zero
• Brilliant Smart security motion lights #2672
• C30W gas leak detector #2676
• Clean Air Optima CA-702 dehumidifier #2680
• Treatlife mmWave presence sensor #2684

Improvements to existing devices

• Deltaco SH-LWSM: improve naming of effects #2704
• Lefant M213: add product details
• RGBCW lightbulb: add local product id for Lifun RGBCW bulbs
• Qlima D812: add product id and new entities #2477
• Matsee 2-way energy meter: scale power factor consistently #2713
• Matsee 2-way energy meter: add compatible PJ-1203A zigbee device #2714 by @markoceri
• HIRCR remote: fix typo in config name
• Moes Indoor PTZ: improve compatibility #2727
• Gautone PG103: use events for alarms and power warnings #1059
• Silvercrest kettle: handle missing warm dp #2722
• Moe dual dimmer: add compatible Totebox dimmer plug #2715
• Ustellar UT99911: improve attribute naming #2732 by @neilmartin83
• Cecotec BigDry 4000: fix tank empty detection, remove non-working UV #2736 by @Alokin90
• Wilfa Haze HU400BC: rename air clean to heating #2539 by @Smiie-2
• Jianhong ET-72W: rename calibration sensors and child lock #181
• Goodcell EV charger: add another compatible Feyree FEL4-3 #2628
• Tongou QCB2: improve compatibility for QCB2-CB #2642
• iPettie W5: add compatbile PetLibro PLAF101 #2644
• Reiga ceiling fan: add clone CasaFan Eco Genuino #2773 by @tshiex

General improvements

• improve handling of hidden mappings and embedded conditions #2701
• small optimisation to config loading
• less verbose error reporting when connections are lost
• less verbose debug logging when merely accessing mappings #2722
• limited dps info is now logged by the cloud config flow #2419
• devices now appear as available if they returned empty data #1804
• translations added for Air quality sensors #1708

Development improvements

• eliminate references to primary and secondary in favour of all entities
• rename helpers/mixin.py to entity.py (as recommended in new HA Quality Scale)
• quality_scale.yaml added to track opportunities for improvement
• merge primary_entity and secondary_entities into a single entities list
• Issue template: add advice about checking existing issues for HA deprecations
• tinytuya updated to 1.16.0
• egg-info directories added to .gitignore #2757 by @dvoijen
• improved test output and include coverage

2024.12.2 End of year housekeeping

Highlights

• WTH bug: None is no longer appended to switch (and some other entity) names.
• climate entities now support swing_horizontal_mode where the device has independant vertical and horizontal swing control.
• area class is now supported for sensors and numbers
• duration class is now supported for numbers too
• 18 new devices, 23 other improvements to existing devices in addition the bulk addition of area and duration classes and swing_horizontal_mode above
• 24 duplicate configs eliminated

Breaking changes

• HA 2024.12 or later is now required #2513, #2596, #2648
• Config merges should be generally backward compatible, but there may be minor differences in the entities which may require manual updates to automations or hand crafted UIs.
• swing mode for some air conditioners/heat pumps has been split into vertical and horizontal on/off controls using the new swing_horizontal_mode. Automations that set or triggered on vertical, horizontal or both may need to be updated.

New Devices

• Lucci Connect fan #2586 by @daviddreher2
• Moes PTZ indoor security camera #2543
• EzaIoT R9 Lite thermostat #2631 by @janouskovec
• Sboard III mini Weigand I/F #2544
• Aygrochy inline ventilation #2555 by @Kenneth-Audenaert
• Qlima D812 dehumidifier #2477
• WL-RTCZ-05Z human presence sensor #2546
• LSC Smart Connect garden spotlights #2480
• Hauschen smart mirror #2681 by @xtaria
• Eberg Rico R12E2 dehumidifier #2634 by @nerodoxus
• Edge Theory cold plunge #2554 by @tompapajr
• Dr Heater DR008 thermostat #2612 by @ThinkDualBrain
• Xoca DAC2121C energy meter #2652 by @AlexK98
• ZPmeter water meter without valve control #2692 by @keskival
• Axen/Arrielli KW100W combo heat pump #2561
• Speaka TV mount #2568
• Aeratron AE3+ ceiling fan #2574
• BNETA F1-D pet feeder #1083

Improvements to existing device

• ZYM-100W presence sensor: use dp 1 for presence instead of dp 104 #2645
• Aubess 1-gang switch: add fault sensor for compatible T34 #2655 by @AlexK98
• HY combo heat pump: rename child lock to night mode #2510
• Zigbee door sensor: add optional tamper sensor #2659 by @PHeonix25
• EzaIoT thermostat smartplug: fix temperature range #2661 by @Steefph
• Andersson GSH: add compatible Devola Intelligent heater #2665 by @jaimbo
• Klarstein Dryfy Pro Connect: new product id added #2666 by @chris-garbas
• IPS Pro heatpump: new product id added #2666 by @chris-garbas
• Electriq CD20 Pro: deprecated fan entity to replace with select
• Eurom Wall Design Heat 2000: remove legacy type shadowed by separate config
• Kogan bladeless fan: map fresh preset to fresh instead of nature
• Royal air conditioner: use product id from original report #1016
• Akai dryer: make drying time adjustable #2667 by @YodaDaCoda
• Diivoo DWV010: use more sensors from the device #2678 by @jannisan
• SmartMCB SMT006 V2: add charge energy entity from compatible EARU EAMPDW-TY63 #2694
• Kolanky EV charger: fix charging time unit #2675
• Various air conditioners: separate swing into independent vertical and horizontal control #2648
• Avatto blinds: invert direction per usual Tuya behaviour, modify action logic to avoid getting stuck, add problem sensor and direction select #2699
• Zemismart SDM01: make connectivity optional, add class and translation to sensors #2556
• LSC Smart Connect RGB-CCT lightbulb: config renamed to make it available
• VTA Plus Axial fan heater: config renamed to make it available
• Eeese Carl, Otto: fix tank status bit index #2703 by @cnrd

Removed device configs

• Alecoair D12 Home: merged into Shinco 30D
• Alecoair D14: merged into Alecoair D16
• Alecoair D25 Traditio: merged into Greenmigo Alpha Q25 pro
• Avatto ME81: merged into Beok TGR81
• Beca BHT6000: merged into Beca BHT002
• Dcenta dual meter: merged into Matsee 2way meter
• Smartcurtain ACS WT: merged into Dooya curtain
• Eeese Emil: merged into Eeese Adam
• Klarstein Dryfy Pro: merged into Electriq CD20 Pro
• Feit RGB: merged into generic RGBWW lightbulb
• Feyree 3phase: merged into Goodcell EV charger
• Heatstorm HS1500: merged into Heatstorm HS6000GC
• Ironzon lock: merged into Ailrinni fingerprint lock
• Yueqing combo curtain: merged into Loonas curtain
• Momcozy white noise: merged into Loycco sound nightlight
• Thermoval TVT40: merged into Saswell C16 thermostat
• Reiga 52: merged into Ovlaim ceiling fan with light
• Zedar R600: merged into Kabum Smart700 v2023 vacuum
• Moes RFIR: merged into S11 RFIR remote
• Nedis mobile: merged into Goldair portable airconditioner
• Nince RGB: merged into generic RGB LED strip
• Rotenso RONI: merged with Royal air conditioner
• Tellur USB: merged with Woox R4028 power strip
• Peteme lighting: merged with generic Zigbee smart bulb

General improvements

• Use new UnitOfArea enum instead of old constant #2596
• Use new OptionsFlow API #2513
• Add new area class to vacuum "Cleaned area" sensors #2596
• Add duration class to timer number entities (unadvertised change in HA 2023.11 or so)
• Add translations for multiple switch, outlet, voltage, current and power entities. #1708
• climate: Add support for new swing_horizontal_mode #2648
• Entity naming: query underlying class for device class translation support #1856

Development improvements

• unit test added for string values mapped to integers #2586
• utils: common functionality refactored, flexible handling of config filenames given on command-line extended to all utils
• utils: filter same config matching itself from duplicate reports
• Update tests not to use deprecated STATE_CLASS constants due to be removed in HA 2025.1

2024.12.1 a more stable config flow

Highlights

This release is primarily to fix two issues in the config flow, one a longstanding complaint from HA in the log that does not have any real effect, the other an issue in the previous change to consider local product ids as well as cloud ones when the device cannot be automatically discovered locally.

One new device and one improvement to an existing device were also added in the timeframe since 2024.12.0.

New devices

• Poolex Ice Spa 70 heat pump #2541

Improvements to existing devices

• Beca BHT-002 thermostat: add hvac_action where supported, dynamic detection of external thermometer #2640 by GvidasLTU

General improvements

• config_flow: handle the case where device cannot be automatically found on local network during cloud config flow #2643
• config_flow: avoid I/O in the main loop by removing a complex attempt to make a generator into an async generator. #2584

Development improvements

• CI workflows now use Python 3.13 to match HA 2024.12

2024.12.0 Matching products

Breaking changes

• ZYM100M: the deprecated status sensor has been removed. Use the motion and occupancy binary sensors instead
• Jiahong ET72W: energy sensor is removed and replaced with a runtime sensor, which is what it was actually measuring.

Highlights

• Lights with only brightness can now turn off again
• configs can now be matched by product id
• 20 new devices, improvements to 8 devices plus some general improvements

New devices

• Deltaco SH-LW5M LED strip #2542 by @Ladida1
• Friedrich Uni-Fit UCT12A30/UCT14A30 #2524 by @ncd7
• Freidrich Uni-Fit UCT08B10A #2524 by @ncd7
• Richelieu under cabinet lighting #2524 by @ncd7
• Myuet ME82 thermostat #2526 by @blitzdose
• Eeese Emil dehumidifier #2539 by @PipoCanaja
• EM3390TF weather station #2557 by @flapedriza
• Omnibreeze DC2313R tower fan #2566 by @bwarden
• Zemismart SPM01 zigbee energy meter #2494
• Goldair Portable air conditioner #2567 by @BenJamesAndo
• Medion X10 SW vacuum #2503
• Basic IR remote controller #847, #1887
• TOMPD-63WIFI #2618 by @AlexK98
• Morento HY4866-WF #2581 by @md1986
• Brizlabs string lights #2610 by @TimPasquini
• Tech Inc. 3m Neon light strip #2604 by @etamtlosz
• Cecotec BigDry 4000 dehumidifier #2591 by @darth-hp
• Mypin 6L video pet feeder #857
• Neptun Smart water leak control system #2260
• Asahom outdoor lights #2255
• HY multifunction heat pump #2510
• Siguro DH-F300W dehumidifier #2518

Improvements to existing devices

• Smartplug V2 Energy V2: add compatible STY-63TM energy meter id #2570 by @netmaxt3r
• Matsee 2way V2: improve compatibility #2573
• Eurom Sani: add Eurom Sani LBH-63A product #2572 by @Jordi1990
• ZYM100M presence: fix illumination units #2593
• ZYM100M presence: remove deprecated sensor #2595
• Moes temperature and humidity: unknown dp identified #2617 by @AlexK98
• TOMPD 63LW: add new variant with factory reset, power factor and frequency entities #2619 by @AlexK98
• Meaco Aerte Two: improve compatibility for 12L model #2626
• Jiahong ET72W: "energy" sensor is actually a runtime sensor #181

General improvements

• config flow: log the local productKey if it differs from cloud product id
• mask: reimplement as documented, outside of the mapping
• setup/unload: simplify by looping over all_entities rather than primary and secondary separately
• light: force lights with only brightness dp to appear off at 0 brightness #2589
• config flow: use product id to match configs if available #847
• mapping: fix available flags within conditional mappings #2567
• diagnostics: fix redaction of sensitive dps with id > 9 #2547
• icons: improve uv_sterilization icon #2591

Development improvements

• device config tests now allow all dps to be marked optional if there is a product id to match against #847

2024.11.4: Bring the color back

Highlights

• fixes a regression in light brightness handling in 2024.11.3
• 1 new device, 3 existing devices improved

New devices

• Wenzhi W35 human presence sensor #2491

Improvements to existing devices

• PlantsIO Ivy: mark brightness as unavailable with auto-brightness on #2168
• PlantsIO Ivy: mark location dps as sensitive #2347
• Ecostrad Accent iQ: improve config to modern standard #2551
• SNT957W TDE temperature alarm: improve compatibility #2545 by @szupi-ipuzs

General improvements

• Reduce errors logged when devices are offline for extended periods
• light: handle brightness correctly when color mode is changing at the same time. #2552

Development improvements

• Simple Security policy documented
• Dependabot actions enabled
• remove noise from debug log where possible values are checked by HA
• improve debug logging for lights

2024.11.3 Color names

Highlights

• translations now support placeholders, to allow things like "Switch 1", "Switch 2" to share the same translation.
• lights with lists of named colors are now supported as RGB lights.

Breaking changes

• Requires HA 2024.11.0 or later
• fault codes have been moved from primary entities into the problem binary_sensor for many devices.
• Some timer entity names have standardised. Migration should take care of keeping history intact and avoid zombie entities, but any references in automations, scripts or manual config may need updating.

New Devices

• KCVents VT-501 heat recovery ventilator #2450 by @perimos
• New WideTech 7-speed fan #2484 by @r08ertliu
• Curry Smarter roller shutter #2464
• GHome ceiling fan and light switch #2466
• RZTL Aqua Pro humidifier #2509 by @akc-kyiv
• AF3W pet feeder #2370
• Nince RGB LED strip #2497 by @AppelBoomHD
• HLG Infinity alarm #2521 by @brunohenriquy
• Spa Electrics Iris light controller #2472
• Zemismart 3-phase energy meter #2489
• Create VTA+ fan heater #2469 by @MigSo
• EZAIoT thermostat #2490 by @Steefph
• AirRobo P20 vacuum #2531 by @witulu

Improvements to existing devices

• Many devices: standardize problem binary_sensors to contain fault code, where fault code was on primary entity, it has moved.
• Plikc Neve: add support for Plikc Neve Pro W #2483, #2485 by @Tbaile
• Digoo HAMB: rename some entities to match their function #2399
• Sulion ceiling fan remote: merged with identical Arlec ceiling fan remote
• PC321-TY: add Owon branded product #2394
• Raykube A1 Pro Max: compatibility improvement #2500 by @johnnyaug
• Unknown 2way meter: swap total and daily measurements #2481 by @giacomitti
• Multiple timers and energy produced/consumed entities now use translations #2481
• Smoke detector: use correct dp for battery level #2520
• Klarstein Amazonia: remove non-working options #2433
• Tesvor S6 vacuum: compatibility improvement #2519
• Afyeev EV chargers (16 and 32A): don't scale temperature #2108
• Many climate devices: hvac_action logic simplified, as "off" is now automatically handled internally.
• Blitzwolf BWSH2 humidifier, Dynasty BTX fireplace, Gratkit filament dryer, Modernflames Orion fireplace, Tesla S300 purifier, Touchstone Sideline fireplace: use new named_color light support #2472
• Avatto TRV06 radiator valve: additional entities #2457, #2465 by @ciscolyon69
• TYTE-D1: correct current_temperature scale #2534 by @rale
• Eurom Sani towel radiator: fix hvac_action type #2529
• Simple switch timer v2: add compatible Kruidvat switch #2530
• Many devices: improved consistency of optional dp marking

General improvements

• config_flow: improve guidance for hub connected sub devices #1951
• options: remove sub-device cid from options flow, as it is used to form the unique_id for the device, so changing it makes a new device in the registry.
• config_flow: match devices fully asynchronously #2501
• translation placeholder support added #2514
• alarm_control_panel: support new alarm_state enum based state reporting #2445
• light: improve rgbhsv brightness handling #2497
• light: add named_color support #2472
• config_flow: use node_id in preference to uuid if available #1951

Development improvements

• Added a test for consistent marking of optional dps.

2024.11.2 - more bugfixing

General improvements

• fixed issue with hub detection when hub has no local key #2475
• improved handling of connections when errors are encountered in the receive loop #1804, #1013

2024.11.1 - bugfix

2024.11.1 - a small urgent release

Highlights

• fixes an issue with the previous release's changes that were supposed to fix connection issues #1804, #1013, #2354
• one new device, improvements to 9 devices

New Devices

• Kilo Plus air purifier #2458 by @broyuken

Improvements to existing devices

• Afyeev 16A charger: use power sensor that works, add product id #2453 by @pimpalaputty
• Weaja gas alarm: fix alarm units, standardise % LEL unit #2434
• ZX GS21 gas alarm: standardise % LEL unit #2434
• Kerui 200W/300W cameras: fix PTZ button types #2410
• Moes star projector: remove config category from main switch #2428
• Digoo HAMB alarm: improve compatibility #2399
• RSE TYWFH301 gate: make raw return_status available, add Home Gate NI600z/800z compatible products #2462
• Avatto TRV06 radiator: improve compatibility #2457
• Klarstein Amazonia: flip door sensor #2433

General improvements

• fix for incorrect closing of connections when reconfiguring devices #2474 by @czarau

Development improvements

• new device template: guide users to the log to find product id since previous release