2023.8.1 hotfix

General improvements

• fix problem with entity migration in 2023.8.0 #984

Due to the short time between 2023.8.0 and 2023.8.1, and the likelihood the previous release has been skipped, the breaking changes section for 2023.8.0 is repeated below. For more details on the other changes, see the release notes for 2023.8.0.

Breaking changes in 2023.8.0

Default naming

Many sensors are now defaulting to the HA standard name for their class, to make use of standard name translations. This has resulted in some entities being renamed. A migration attempts to handle the renaming in Home Assistant's registry but it may still be necessary to update automations or some other references to entities. There may also be some cases that were missed by the migration, in which case you will have new entities created, and the old ones will become "unavailable" and will need to be deleted manually.

If you are using a version of Home Assistant older than 2023.7, some entities will be displaying only the device name the UI. #871

These are the main changes:
- carbon_dioxide: some were previously named CO2
- carbon_monoxide: some were previously named CO
- humidity: some were previously named Current humidity, but no change was made for deprecated sensors (see below)
- pm1: some were previously named PM 1.0 (translates to pm_1_0 in entity naming)
- pm10: some were previously named PM 10 (translates to pm_10 in entity naming)
- pm25: were previously named PM 2.5 (translates to pm_2_5 in entity naming)
- temperature: some were previously named Current temperature
- volatile_organic_compounds some were previously named TVOC

Humidity sensor deprecation for humidifiers and dehumidifiers

Current humidity sensors for humidifiers and dehumidifiers have been deprecated, as the humidifier entity supports reporting of current humidity as of HA 2023.7 #869

Battery level moved to separate sensor for vacuums

As of HA 2023.8, the battery_level attribute of vacuums is deprecated, to be replaced by battery sensors. To avoid the deprecation warning, this change has been made already. After this change, battery status has full history recording available, however if you have any automations reading the battery_level from the vacuum, you will need to update these to read from the battery sensor instead.

Some custom cards may not yet be updated for this change, so the battery level may disappear from the card until it is updated. #954

Poolex Q7 (and Q9 and others) use as water_heater is deprecated

After gathering more info on the preset modes available for this device, the main entity has been changed from water_heater to climate to make the cooling funtions available too. The water_heater entity is deprecated. #966

hidden mappings behaviour change

Previously a mapping could be marked hidden to hide it from the list of possible values. Now these mappings have also been made one-way, to only map device values to the UI. The main use case for these is to map unexpected values like null (missing any value) to something else for the UI. Mapping back to these unexpected values when a value is changed from the UI is not desirable behaviour for the use cases imagined for this feature, and if you need that the mapping should probably not be hidden. #914

2023.8.0

Breaking Changes

Default naming

Many sensors are now defaulting to the HA standard name for their class, to make use of standard name translations. This has resulted in some entities being renamed. A migration attempts to handle the renaming in Home Assistant's registry but it may still be necessary to update automations or some other references to entities. There may also be some cases that were missed by the migration, in which case you will have new entities created, and the old ones will become "unavailable" and will need to be deleted manually.

If you are using a version of Home Assistant older than 2023.7, some entities will be displaying only the device name the UI. #871

These are the main changes:
- carbon_dioxide: some were previously named CO2
- carbon_monoxide: some were previously named CO
- humidity: some were previously named Current humidity, but no change was made for deprecated sensors (see below)
- pm1: some were previously named PM 1.0 (translates to pm_1_0 in entity naming)
- pm10: some were previously named PM 10 (translates to pm_10 in entity naming)
- pm25: were previously named PM 2.5 (translates to pm_2_5 in entity naming)
- temperature: some were previously named Current temperature
- volatile_organic_compounds some were previously named TVOC

Humidity sensor deprecation for humidifiers and dehumidifiers

Current humidity sensors for humidifiers and dehumidifiers have been deprecated, as the humidifier entity supports reporting of current humidity as of HA 2023.7 #869

Battery level moved to separate sensor for vacuums

As of HA 2023.8, the battery_level attribute of vacuums is deprecated, to be replaced by battery sensors. To avoid the deprecation warning, this change has been made already. After this change, battery status has full history recording available, however if you have any automations reading the battery_level from the vacuum, you will need to update these to read from the battery sensor instead.

Some custom cards may not yet be updated for this change, so the battery level may disappear from the card until it is updated. #954

Poolex Q7 (and Q9 and others) use as water_heater is deprecated

After gathering more info on the preset modes available for this device, the main entity has been changed from water_heater to climate to make the cooling funtions available too. The water_heater entity is deprecated. #966

hidden mappings behaviour change

Previously a mapping could be marked hidden to hide it from the list of possible values. Now these mappings have also been made one-way, to only map device values to the UI. The main use case for these is to map unexpected values like null (missing any value) to something else for the UI. Mapping back to these unexpected values when a value is changed from the UI is not desirable behaviour for the use cases imagined for this feature, and if you need that the mapping should probably not be hidden. #914

New WiFi devices

• TH08 temperature and humidity sensor #932
• Goldair 101cm tower fan #925
• PV28-CW 8-in-1 air quality monitor #931
• BlitzWolf SHP-9 power strip #942
• ACME SH3305 powerstrip #941
• Mirabella Genio motion sensor #943
• Loginovo HDMI sync backlight #952
• Makegood dual smart switch #958
• Nedis outdoor camera #914
• MoesGo dimmer switch #927
• Holman WX1 tap timer #979
• Marpou ceiling light #967
• Kabum Smart 700 vacuum #944
• Cadence aroma diffuser #976
• Lyfco OL-A012 portable air conditioner #946
• Relay switch with 433MHz remote #947
• RL video intercom #462
• Inkbird iBBQ-4T v2 variant #750
• Ceres Plus pet feeder #507

New Bluetooth devices

• Solar garden light #605
• HU06 smart lock #973

Improvements to existing devices

• ITS 45HS heatpump: moved non-working sensors to attributes and renamed others #866, #928
• Proscenic M9 vacuum: restore use of "Customize mode" switch so mopping can be used #939
• Kogan bidet: device detection improvement #559
• YYM aroma diffuser: compatible Tellur device added #936
• Beca BAC002: device detection improvement #950
• Kogan air purifier: config properly installed #859
• CBI Astute switch: last state mapping corrected for local protocol #953
• Yinmik water quality monitor: device detection improvement #880
• PG10x alarm; device detection improvement #961
• Vivax heatpump: scale current temperature correctly, add the "quiet" switch #964
• Catit Pixi feeder: add optional fault sensors, found on compatible Nutri Meal device #960
• Poolex Q7: primary entity changed from water_heater to climate, presets added, temperature range restricted to swimming pool suitable temperatures, compatibility with Poolsana devices noted #966
• Rotenso heatpump: add name to fault sensor
• Simple switches: remove outlet device class - these can also match wall switches
• Eberg Cooly C35HD: device detection improvement #974
• Moebot S mower: support for CHARGING_PAUSE status and reduced timer range to 24h #980
• Starlight/Daizuke heatpumps: identified more dps based on compatible Pioneer WYT Diamante #820
• Kogan LX10 Vacuum: more reliably support start/pause commands #981

General improvements

• humidifier entities now support current_humidity (requires HA 2023.7 or later) #869
• fans now turn off when speed is set to 0 and on when speed is set away from 0, behaviour that was lost with the recent HA UI changes #936
• lights: RGB lights that report color as RGB rather than HSV are now properly supported #948
• tests have been updated to work with HA 2023.5 and later, where some dependency update forced a change in pytest asyncio config.
• locks: support for voice unlocking added, intercom opening properly implemented #973
• vacuums: prioritise start/pause commands over activate dp #981
• diagnostics: avoid exception when protocol is not yet negotiated #907

2023.7.0: Big endian

New Wifi devices

• Tontine electric blanket #829
• Duux Blizzard air conditioner #835
• Aquatech X6 water heater #836
• Windcalm fan #839
• Monzana Klimaanage air conditioner #840
• Goldair tower fan #844
• Home Awesone powerstrip #860
• Kogan air purifier #859
• Woods Milan air conditioner #843
• Aubess Rainpoint irrigation system #883
• GauTone PG-103 alarm #897
• Makegood double power point #904
• Garza irrigation system #918
• Yinmik water quality tester #880
• Royal Clima ventilation system #825
• ITS 4.5HD pool heatpump #866
• Sulion ceiling fan #881
• Inkbird IBS-M1S thermo-probe hub #910
• Proscenic M9 vacuum #921
• Loratap double curtain switch #920
• Sencor air conditioner #892

New Bluetooth device

• generic BLE water valve (replaces Johgee, and supports Divoo WT-03 and others also) #851
• Divoo dual water timer #882

Improvements to existing devices

• CCT, RGBCW lightbulbs, Tampa LED system, PIR spotlight, Mantra fan:
  scale brightness correctly #830
• DTS, SmartMCB, TOMPD meters: add energy_storage class to prepayment values.
• Inkbird iBBQ-4T:power is a sensor not switch, handle missing fault code. #750
• Neocool siren: adjust tones, min/max temperature scale, battery level, add alarm status #673
• Kogan LX10 vacuum: add error codes #849
• ZYM100 presence sensor: add lux sensor, detection delay #846, #919
• Rojeco feeder: improved compatibility, add battery sensor #845
• ZX-DB11 doorbell: add ringing binary sensor #763
• Lytmi backlight: improved compatibility #790, #889
• Starlight heatpump: identified more datapoints #878
• CO2 Box: add matching products #872
• Ultenic air fryer: improved mappings and naming #899
• SmartplugV2 EnergyV2: add optional connectivity binary sensor #909
• SmartplugV2 EnergyV3: add compatible product #893
• Owon PCT513 thermostat: identify more data points #875
• Rumba heater: properly expose preset_mode #922
• Linkoze button: add battery, try a different long press string #774
• Lucking HS6 lock: improve unlock detection #796
• Orion lock: improve unlock detection #798

General improvements

• Update docs for Tuya API Explorer changes
• Siren: fix volume_level #673
• Bump tinytuya to 1.12.9
• Add Czech translations #873
• Add Norwegian translations #843
• fix writing masked datapoints #877
• vscode devcontainer support #885
• clarifications and other documentation improvements #898, #903
• support for endianness in encoded dps #910

2023.6.1 Alarm control panels

Breaking changes

This build contains further translation improvements, and some changes to humidifier modes and fan preset_modes to support this.
The main changes are:

• restored the use of laundry as a dehumidifier mode, as many devices support it (previous release renamed most of these to "strong" which has been reverted)
• use the standard modes, plus laundry and purify where appropriate.
• use common set of fan preset modes from normal, nature, sleep, fresh, smart, strong, off.
  • in a couple of cases, off has been used when some other feature is off (ie for fan-only).
  • breeze mostly maps to nature, unless it was already assigned in which case fresh is used.
  • low, mid, high are generally mapped to sleep, fresh, strong. This disambiguates presets from speeds.
  • auto, manual are generally mapped to smart, normal

New WiFi Devices

• Simple six switch power strip #795
• position_blinds: a copy of simple_blindsbut with accurate position #715, #794
• Lytmi HDMI sync backlight #790
• Inkbird iBBQ-4T cooking thermometer #750
• Carro PN-04F02D fan/light switch #800
• ZX-DB11 doorbell alarm system #763
• Arlec ceiling fan and light remote control kit #806
• Daewoo DHome air conditioner #807
• Immax Neo Lite Vento fan #811
• Lucking HS6 lock #796
• Blitzwolf BW-IS6 alarm control panel #112
• Neo Coolcam siren #673
• Iebeyond ECH doorbell #815
• Costway portable airconditioner #814
• ZX-CS21 gas leak detector and alarm #679
• Mantra ceiling fan #680
• Aulifants SMES200 breaker switch #683
• Tampa LED lighting system #686

New Bluetoth Devices

• Adaprox Fingerbot Plus #795

New Zigbee Devices

• CO2 Box air quality monitor #793

Improvements to existing devices

• Petlibro feeder: improved compatibility #759
• Kogan LX10 vacuum: improved compatibility and functions #768
• Klarstein Dryfy: deprecate the fan in favor of humidifier modes.
• Proscenic A8: fixed dps assignment #803
• Weau v2: add preset mode support #808
• TOMPD-63LW: phase data is encoded in 8 bytes not 11. #577, #388
• ZX-G30: add an alarm_control_panel entity and deprecate individual buttons #796, #490
• Orion siren: mark compatibility with Elesion siren #816
• Anko fan: Fan speed is a string #22
• Weau 13kW: minor config cleanup

General improvements

• camera: init base class (also other entities, but camera was the only one that does anything in its init function) #759
• avoid applying null mappings in reverse #759, #810
• Translations for dehumidifier laundry and purify modes. #682
• cover: duplicate position to current_position for devices where it is known to be accurate. Return open for intermediate values if position is known. #715, #794
• French: add translations for climate and humidifier platforms. #805
• Add support for alarm_control_panel platform #796
• Keep the order of lists of values #808
• polling: correctly wait between polls #824

Documentation improvements

• new platforms added and platform list sorted.
• Updated Tuya portal instructions after a rearrangement of their API Explorer #823

2023.6.0 Translations

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