Breaking changes

Some strings that represent data settings on devices have been changed to make things common for easier translation. Automations that query or set these values will need updating. Also it may take some getting used to the new names in the UI, which may not exactly match the device naming, but should still be close.

The details are as follows:

• climate devices: many preset_mode, fan_mode and some swing_mode values have changed in order to use common translations where possible, or to use the same strings across similar devices to simplify translations.
• humidifier devices: some mode values have changed to use common translations where possible.

Many of these changes are simply using an all lower case version of the string which was previously capitalised.

The HA common values are:

climate.swing_mode: off, on, vertical, horizontal, both
climate.fan_mode: off, on, auto, low, medium, high, top, middle, focus, diffuse
climate.preset_mode: none, eco, away, boost, comfort, home, sleep, activity
humidifier.mode: normal, eco, away, boost, comfort, home, sleep, auto, baby

The above have translations in many languages already built into Home Assistant, so you should straight away see the improvement if your language is not English.

New groupings created where the available options did not fit into the above:

climate.aircon_extra
fan_mode: health, medhigh, medlow, natural, quiet, sleep, strong
swing_mode: topmost, top, middle, down, downmost

climate.thermostat:
fan_mode: cycle
preset_mode: manual, program, temp_override, perm_override

climate.combo_floor:
preset_mode: cool, fan_only, heat, floor_cool, floor_heat

climate.swing_as_powerlevel:
swing_mode: stop, auto (English name changed to "Heating level")

climate.pool_heatpump:
preset_mode: smart_heat, quick_heat, quiet_heat, smart_cool, quick_cool, quiet_cool, auto

All the above values have English translations, but other languages will probably show the original value above.

New Wifi Devices

• 9-in-1 air quality monitor #753 by @syepes
• Catit Pixi pet feeder #757 by @Mikey887
• PC311TY energy meter #775 by @Doudou14
• SmartSMB SMR006 variant with 8 byte phase info instead of 10 byte #779
• Novadigital quad switch #767 by @xgustavoh
• Galaxy Projector #770
• Proscenic A8 air purifier #776
• DTS238-7 energy meter #745
• Petlibro camera pet feeder #759
• Beok TR8B thermostat #737
• Vivax Cool heatpump #773
• Poolex Q7 (new Qline variant) #777
• Etersky curtain switch #778
• Nedis mobile air conditioner #784
• Linkoze dual button wall switch #774
• Feit light dimmer #752 by @alexeyatbluescape
• Thermex IF 50 V #769 by @g470258

New Zigbee devices

• ZTH08ZTU temperature and humidity sensor #785

New Bluetooth devices

• Johgee water timer #747

Improvements to existing devices

• ZX-M100 sensor is a string #755
• CCT lightbulb: color temperature was inverted #730
• Goldair GPPH heater: handle "auto" power level for compatibility with GPPH 620 #762
• Moebot S: make auto mode optional and handle more fault states for compatibility with Parkside mower #758
• HCT611 water timer: add cloud as well as cloudy weather. Use HA common weather strings, mark more optional dps #747
• simple switch with timer: add product id for Teckin SP21 #772
• Somgom switch: add initial state dp #767
• Abalon BCM700D: make reverse switch optional for better compatibility #787
• Hydrotherm X8 water heater: flip operation mode logic so turn_on/turn_off work as expected
• Arlec thermostat smartplug: typo in mapping #791 by @YodaDaCoda

General improvements

• Include tinytuya version in diagnostics #520
• Bump tinytuya to 1.12.8
• Bump pycryptodome to 3.18
• Use Python 3.11 for tests
• Add support for translation_key for entities #682
• correct the year in the manifest #771
• French translations #780 by @Doudou14
• water_heater: add support for away_mode #769
• vacuum: internal cleanup #792
• device matching: improved debug output #792 by @YodaDaCoda
• Russian translations #769 by @g470258

New Wifi Devices

• Goldair GPDH340 dehumidifier #727
• Brennenstuhl WFD 3050 P motion activated spotlight #733
• Kogan LX10 vacuum #725, #723
• generic CCT lightbulb #730
• Stadler Form Karl #743

Improvements to existing devices

• many cover devices: set invert attribute correctly in position mapping #715
• BLE Orion lock: improve compatibility and functionality #654
• CBI Astute: fix countdown scale #719
• Moes RGB socket: remove forced update config #691

General improvements

• Lights: in color mode, return brightness based on HSV #691
• Diagnostics: fix sub device handling, output sub device info #726
• Allow hidden attribute to be set on mappings, to translate values, but hide them from the list of possible values #727
• siren: fix available_tones handling #705
• lights: use brightness to turn on if there is no switch #743

New WiFi devices

• RGBW lightbulb based on Merkury BW904 #689
• CBI Astute circuit breaker #692

Improvements to existing devices

• Zemismart roller shade: improve opened and closed detection #672
• Ditua diffuser: enable secondary entities properly #627
• Shinco 30D: improvements from compatible Klarstein DryFy Connect #690
• Energy meters; standardise units to A and kWh
• Arlec panel heated v2: fixed preset naming #578
• loratap curtain switch: map control values even when current value is None #704
• rgbcw lightbulb: use base64 rather than hex format for some unused fields

General improvements

• cover: improvements to opened, closed, closing, opening logic. #672
• device config tests: detect misspellings in secondary_entities #504, #627
• GitHub linting: output diffs from black so errors can be seen
• connection test during setup: handle subdevices #693
• lights: handle "white" parameter for switching between RGB and brightness on bulbs that don't support color temperature #689
• return empty array rather than None for no values, to avoid errors iterating #646
• Bump tinytuya to 1.12.7 #688, potential fix for #664, #653, #520, 338
• lights: use HS rather than RGBW color format #691
• device comms: use unique failure messages per call
• connection failure handling: be less eager to rotate protocol versions once it is working #653

Breaking changes

• new support for subdevices was added, and is likely to have bugs and limitations, please report them.
• state is now updated immediately instead of scheduling an update when it is
  safe to do so. If "safe" has been misjudged, this may cause issues.

New WiFi devices supported

• Unbranded illuminance sensor #626
• Ditua aroma diffuser #627
• Another 4 plug+USB powerboard #670
• Ledlux thermostat #670
• Lefant LS1 Pro vacuum #639
• WDYK 2P63A energy meter #659
• Duux Blizzard air conditioner #666
• Atomi ceiling fan #668
• Skyfan DC fan with light #665

New Zigbee devices supported

• Loratap Zigbee curtain SC500ZB-V2 #651

New Bluetooth devices supported

• PT216/PT19DB temperature/humidity sensor #434
• HCT-611 water timer #638
• Orion DL021HA lock

New IR devices supported

• Moes IR SD16Pro controlled heatpump or A/C #478
• Neo air conditioner IR controller #652

Improvements to existing devices

• Loratap curtain switch: match "continue" to the correct set of commands #646
• Hydrotherm X8: expand temperature range #663
• Mellerware vacuum: report states more accurately #584
• PHW218 pool monitor: remove scaling from ORP #580
• Loonas curtain: mark control optional for better compatibility #671
• add matching products to existing configs #667, #674, #675
• fans, let speed go down to 0 so lowest speed is not blocked by rounding #677
• Moes temperature/humidity switch: add missing functionality #645
• RGBCW light v2: mark json fields as hex rather than base64 #622
• Moes RGB socket: make timer optional for better compatibility #676
• Benexmart, wistar covers: always invert position, do not depend on reversed setting

General improvements

• Subdevices that connect via hubs are supported #651, #70.
  As this is the initial release of hub support, there are likely to be bugs and
  limitations, so please report any issues you see.
• vacuum: add Idle and Paused states, only report Docked when certain #584
• lock: in config tests, do not require that locks be lockable from HA #654
• Bump tinytuya to 1.12.6
• update state directly when sure the context is not the UI thread.
• cover: remove reversed dp handling, it was mistaken.
• cover: improved reporting of is_closed, is_closing, is_opening #672

New Devices

• Rumba bathroom heater #463
• BHT-002-GALW thermostat #464
• Smartplug with childlock (Gosund UP111_RTL) #497
• Inkbird PTH-9CW air quality monitor #528
• WDYK 3-phase energy monitor #550
• Lifubide X600 air purifier #558
• Blitzwolf SS5 dual switch with timer #633
• Mellerware City Move vacuum #584
• Princess 350 panel heater #602
• A60 lightbulb #622
• Rinkmo D2 vacuum #624
• PIR motion sensor #632
• ZY-M100 human presence sensor #636
• Moes 3-gang switch #642
• iNow+ heater element #644
• generic 30gang switch with timers #656
• 4 outlet+USB powerstrip with power on state support #657

Improvements to existing devices

• loratap curtain switch: support other simple blind / curtain devices #646

General improvements

• Handle missing dps with mask #631
• Set dpsUsed for better compatibility with device22 devices #451
• climate: avoid error when hvac_mode is None #502
• Log which file is broken when encountering config parse errors
• Add dev script to check dps against a specific config
• cover: handle missing action and command values #655
• vacuum: treat missing error as no error #584

Breaking changes

• some switch entities that were deprecated in 2023.1.0 and replaced by button entities have now been removed. Automations and UIs may need updating if not done already. #244

New devices

• Rojeco pet feeder #585
• KKMoon air quality monitor #489
• SH07-8 sprinkler controller #496
• Taxnele energy meter circuit breaker #536
• Moes motion sensor light #579
• LoraTap garage door #607
• Catit Pixi 6-meal pet feeder #614, #615
• SHerko curtain motor #583

Improvements to existing devices

• Tadiran heatpump: tweaks to also match 40A model #574
• various lights: standardize the range for brightness
• TH16 temp/humidity sensor: add display on/off control #608
• PJ1103: improve max power settings #604
• Owon hermostat: add pre-heat mapping for hvac_action #616
• Inkbird sous vide: add mapping for missing optional hvac_action #616
• smartplugv2_energyv2: add optional features for RDCBC energy monitor switch PR #599
• various energy meters: extract voltage, current and power from phase_a dp #577, #110, #388, #529
• WHM-04 doorbell: improve detection of button presses #625

General improvements

• GitHub: direct discussion to discussions and disable blank issue template.
• Hungarian translation #599
• Bump tinytuya to 1.12.4
• climate: only use whole and tenths for precision #587
• eliminate some Sonarcloud code smells
• Add mask dps config item, for extracting partial data from encoded fields. #577

New Devices

• Arlec 12 speed tower fan #542
• Arlec 6 speed floor fan #541
• Arlec 19 speed wall fan #543
• Chanfok ceiling fan with light #546
• Inkbird iBBQ-4BW cooking thermometer #548
• Simple dimming lightbulb #557
• CC curtains #523
• Yieryi YY-W9909 / pH-W3988 water quality monitor #555, #562
• Ultenic air fryer #556
• Generic warm/cool white lamp #571
• Kogan bidet #559
• Loratap RR500W switch #586
• Arlec 2400W panel heater #590
• Arlec 2200W panel heater #578, #590
• CBI Astute smartswitch #563
• Zemismart roller shade #566
• PH-W218 water quality monitor #580

Improvements to existing devices

• Shinco 30D: swap auto and continuous modes, high and low fan speeds and make secondary entities accessible #509
• Silvercrest kettle: make timer optional to improve compatibility, swap warm and boil #516
• Klarta humidifier: humidity settings off-by-one, set spray range #520
• Arlec thermostat: map manual switch and climate on/off differently #535
• RGBCW light: make timer optional to improve compatibility #549
• Ledkia fan: allow speed to go down to 0 #561
• Catit fountain: add range back to time remain sensors so they can be inverted #501
• TOMPD 63LW: make energy reset a boolean #577, #388
• Moebot: make some dps optional, and change password type #573
• YYM aroma diffuser: also support GX aroma diffuser #581
• Inkbord sous vide: make some dp optional for compatibility with Silvercrest SSVSS 1200 A1 #582
• smartswitchv1: add optional overcurrent sensor for Gosund EP2 #592

General improvements

• Bump tinytuya to 1.12.2 release
• vacuum: add stop command support #588

Breaking changes

• Home Assistant 2023.2 or later required #513

New devices

• Eurom Mon Soliel 800 heater #508
• WHM04 doorbell #504
• Shinco 30D dehumidifier #509
• Heat Storm HS-6000-GC heater #510
• Deltaco and Smatrul dual smartplugs #521, #527
• Etersky aroma diffuser #511
• ElectriQ PD45E dehumidifier #514
• Silvercrest kettle #516
• Treatlife DS03 fan/light #517
• eMylo smart meter #529
• Klarta Humea humidifier #520
• Lenovo E1 vacuum #537
• Cooper and Hunter heatpump PR #547

Improvements to exissting devices

• Hysen HY08WE-2 note compatibility with HY08WE-4
• Nedis air quality: note another compatible device PR #505
• number entities for temperature limits, power and voltage settings, illuminance settings for multiple devices given device classes #513
• mark optional dps with null mappings as non-perssisting so the null mapping can have effect
• Aspen ADV200: map brightness to 10, 50, 100% instead of equally spaced
• TOMPD 63LW: improve compatibility by marking dp 9 optional #532
• RGBCW lights: improve compatibility by allowing brightness to be optional #515
• Beok TGR81: make config compatible with Avatto WT81 #540
• Arlec thermostat: add switch for use in manual mode #535

General improvements

• add device class support to number platform #513
• snap numeric mapped values to the nearest mapping
• Bump tinytuya to 1.12.0
• wait for connection to pause before testing reconfigured device
• when connection is polling, delay between polls.