overkiz: Add select for partial position (garage door)

The Somfy Dexxo smart io (io:DiscreteGarageOpenerWithPartialPositionIOComponent)
supports a third position state: partial. This state is meant to be
used to ventilate the garage.

This commit adds a select entity for the position state. The
implementation is very similar to the already existing position state
for gate's with a pedestrian position.

Note: For the updates to work properly, we'd still need
iMicknl/ha-tahoma#167 /
iMicknl/ha-tahoma#271 to be implemented.
See Somfy-Developer/Somfy-TaHoma-Developer-Mode#26
for discussion with Somfy.

Author: fetzerch

homeassistant/components/overkiz/select.py

@@ -41,6 +41,17 @@ def _select_option_open_closed_pedestrian(
         }[OverkizCommandParam(option)]
     )
 
+def _select_option_open_closed_partial(
+    option: str, execute_command: Callable[..., Awaitable[None]]
+) -> Awaitable[None]:
+    """Change the selected option for Open/Closed/Partial."""
+    return execute_command(
+        {
+            OverkizCommandParam.CLOSED: OverkizCommand.CLOSE,
+            OverkizCommandParam.OPEN: OverkizCommand.OPEN,
+            OverkizCommandParam.PARTIAL: "setPartialPosition",  # FIXME
+        }[OverkizCommandParam(option)]
+    )
 
 def _select_option_memorized_simple_volume(
     option: str, execute_command: Callable[..., Awaitable[None]]
@@ -73,6 +84,18 @@ def _select_option_active_zone(
         select_option=_select_option_open_closed_pedestrian,
         translation_key="open_closed_pedestrian",
     ),
+    OverkizSelectDescription(
+        key=OverkizState.CORE_OPEN_CLOSED_PARTIAL,
+        name="Position",
+        icon="mdi:content-save-cog",
+        options=[
+            OverkizCommandParam.OPEN,
+            OverkizCommandParam.PARTIAL,
+            OverkizCommandParam.CLOSED,
+        ],
+        select_option=_select_option_open_closed_partial,
+        translation_key="open_closed_partial",
+    ),
     OverkizSelectDescription(
         key=OverkizState.IO_MEMORIZED_SIMPLE_VOLUME,
         name="Memorized simple volume",

homeassistant/components/overkiz/strings.json

@@ -64,6 +64,13 @@
           "closed": "[%key:common::state::closed%]"
         }
       },
+      "open_closed_partial": {
+        "state": {
+          "open": "[%key:common::state::open%]",
+          "partial": "Partial",
+          "closed": "[%key:common::state::closed%]"
+        }
+      },
       "memorized_simple_volume": {
         "state": {
           "highest": "Highest",