Add invert_day_night attribute to Weather device (#1801)

* Add `invert_day_night` attribute to Weather device

* Update weather.py

* Update weather_test.py

* Update weather.md

Author: farmio

docs/changelog.md

@@ -15,6 +15,7 @@ nav_order: 2
 ### Devices
 
 - ExposeSensor: `cooldown` is extended to wait for connection if not established.
+- Weather: Add `invert_day_night` option to invert day/night value.
 
 ### Internals
 

docs/weather.md

@@ -39,20 +39,21 @@ The weather device is basically a set of sensors that you can obtain from your w
 
 - **xknx** is the XKNX object.
 - **name** is the name of the object.
-- **group_address_temperature** KNX address of current outside temperature.
+- **group_address_temperature** KNX address of current outside temperature. **DPT 9.001**
 - **group_address_brightness_south** KNX address for the brightness to south **DPT 9.004**.
 - **group_address_brightness_west** KNX address for the brightness to west **DPT 9.004**.
 - **group_address_brightness_east** KNX address for the brightness to east **DPT 9.004**.
 - **group_address_wind_speed** KNX address for current wind speed. **DPT 9.005**
 - **group_address_wind_bearing** KNX address for current wind bearing. **DPT 5.003**
-- **group_address_rain_alarm** KNX address for reading if rain alarm is on/off.
-- **group_address_wind_alarm** KNX address for reading if wind alarm is on/off.
-- **group_address_frost_alarm** KNX address for reading if frost alarm is on/off.
-- **group_address_day_night** KNX address for reading a day/night object.
+- **group_address_rain_alarm** KNX address for reading if rain alarm is on/off. **DPT 1**
+- **group_address_wind_alarm** KNX address for reading if wind alarm is on/off. **DPT 1**
+- **group_address_frost_alarm** KNX address for reading if frost alarm is on/off. **DPT 1**
+- **group_address_day_night** KNX address for reading day/night state. By default the value True represents day and False represents night. **DPT 1**
 - **group_address_air_pressure** KNX address reading current air pressure. **DPT 9.006 or 14.058**
 - **group_address_humidity** KNX address for reading current humidity. **DPT 9.007**
 - **sync_state** Periodically sync the state.
 - **device_updated_cb** Callback for each update.
+- **invert_day_night** Invert the day/night state.
 
 ```python
 

test/devices_tests/weather_test.py

@@ -320,11 +320,15 @@ async def test_cloudy_winter(self) -> None:
             == WeatherCondition.CLOUDY
         )
 
-    async def test_day_night(self) -> None:
+    @pytest.mark.parametrize("invert_day_night", [False, True])
+    async def test_day_night(self, invert_day_night: bool) -> None:
         """Test day night mapping."""
         xknx = XKNX()
         weather: Weather = Weather(
-            name="weather", xknx=xknx, group_address_day_night="1/3/20"
+            name="weather",
+            xknx=xknx,
+            group_address_day_night="1/3/20",
+            invert_day_night=invert_day_night,
         )
 
         weather.process(
@@ -333,8 +337,12 @@ async def test_day_night(self) -> None:
                 payload=GroupValueWrite(value=DPTBinary(0)),
             )
         )
-
-        assert weather.ha_current_state() == WeatherCondition.CLEAR_NIGHT
+        if invert_day_night:
+            assert weather.ha_current_state() == WeatherCondition.EXCEPTIONAL
+            assert weather.day_night is True
+        else:
+            assert weather.ha_current_state() == WeatherCondition.CLEAR_NIGHT
+            assert weather.day_night is False
 
     def test_weather_default(self) -> None:
         """Test default state mapping."""

xknx/devices/weather.py

@@ -103,6 +103,7 @@ def __init__(
         group_address_humidity: GroupAddressesType = None,
         sync_state: bool | int | float | str = True,
         device_updated_cb: DeviceCallbackType[Weather] | None = None,
+        invert_day_night: bool = False,
     ) -> None:
         """Initialize Weather class."""
         super().__init__(xknx, name, device_updated_cb)
@@ -211,6 +212,7 @@ def __init__(
             device_name=self.name,
             feature_name="Day/Night",
             after_update_cb=self.after_update,
+            invert=invert_day_night,
         )
 
         self._air_pressure = RemoteValueByLength(
@@ -314,7 +316,7 @@ def frost_alarm(self) -> bool | None:
 
     @property
     def day_night(self) -> bool | None:
-        """Return day or night."""
+        """Return day or night. `True` for day and `False` for night."""
         return self._day_night.value
 
     @property