feat: set the cover closed position (#1242)

* feat: add the cover closed position configure option

* feat: estimate the cover entity's is_closed property by the cover closed position (#944)

* fix: translations

* feat: set max cover closed position as 5

* docs: modify README

* fix: remove useless spaces

custom_components/xiaomi_home/config_flow.py

@@ -75,6 +75,9 @@ from .miot.const import (
     DEFAULT_CLOUD_SERVER,
     DEFAULT_CTRL_MODE,
     DEFAULT_INTEGRATION_LANGUAGE,
+    DEFAULT_COVER_CLOSED_POSITION,
+    MIN_COVER_CLOSED_POSITION,
+    MAX_COVER_CLOSED_POSITION,
     DEFAULT_NICK_NAME,
     DEFAULT_OAUTH2_API_HOST,
     DOMAIN,
@@ -129,6 +132,7 @@ class XiaomiMihomeConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
 
     _cloud_server: str
     _integration_language: str
+    _cover_closed_position: int
     _auth_info: dict
     _nick_name: str
     _home_selected: dict
@@ -151,6 +155,7 @@ class XiaomiMihomeConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
         self._main_loop = asyncio.get_running_loop()
         self._cloud_server = DEFAULT_CLOUD_SERVER
         self._integration_language = DEFAULT_INTEGRATION_LANGUAGE
+        self._cover_closed_position = DEFAULT_COVER_CLOSED_POSITION
         self._storage_path = ''
         self._virtual_did = ''
         self._uid = ''
@@ -951,6 +956,7 @@ class XiaomiMihomeConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
                 'action_debug': self._action_debug,
                 'hide_non_standard_entities':
                     self._hide_non_standard_entities,
+                'cover_closed_position': self._cover_closed_position,
                 'display_binary_mode': self._display_binary_mode,
                 'display_devices_changed_notify':
                     self._display_devices_changed_notify
@@ -995,6 +1001,7 @@ class OptionsFlowHandler(config_entries.OptionsFlow):
     _hide_non_standard_entities: bool
     _display_binary_mode: list[str]
     _display_devs_notify: list[str]
+    _cover_closed_position: int
 
     _oauth_redirect_url_full: str
     _auth_info: dict
@@ -1015,6 +1022,7 @@ class OptionsFlowHandler(config_entries.OptionsFlow):
     _opt_lan_ctrl_cfg: bool
     _opt_network_detect_cfg: bool
     _opt_check_network_deps: bool
+    _cover_pos_new: int
 
     _trans_rules_count: int
     _trans_rules_count_success: int
@@ -1043,6 +1051,8 @@ class OptionsFlowHandler(config_entries.OptionsFlow):
         self._ctrl_mode = self._entry_data.get('ctrl_mode', DEFAULT_CTRL_MODE)
         self._integration_language = self._entry_data.get(
             'integration_language', DEFAULT_INTEGRATION_LANGUAGE)
+        self._cover_closed_position = self._entry_data.get(
+            'cover_closed_position', DEFAULT_COVER_CLOSED_POSITION)
         self._nick_name = self._entry_data.get('nick_name', DEFAULT_NICK_NAME)
         self._action_debug = self._entry_data.get('action_debug', False)
         self._hide_non_standard_entities = self._entry_data.get(
@@ -1068,6 +1078,7 @@ class OptionsFlowHandler(config_entries.OptionsFlow):
         self._action_debug_new = False
         self._hide_non_standard_entities_new = False
         self._display_binary_mode_new = []
+        self._cover_pos_new = self._cover_closed_position
         self._update_user_info = False
         self._update_devices = False
         self._update_trans_rules = False
@@ -1340,6 +1351,12 @@ class OptionsFlowHandler(config_entries.OptionsFlow):
                     ): cv.multi_select(
                         self._miot_i18n.translate(
                             'config.binary_mode')),  # type: ignore
+                    vol.Optional(
+                        'cover_closed_position',
+                        default=self._cover_closed_position  # type: ignore
+                    ): vol.All(vol.Coerce(int), vol.Range(
+                        min=MIN_COVER_CLOSED_POSITION,
+                        max=MAX_COVER_CLOSED_POSITION)),
                     vol.Required(
                         'update_trans_rules',
                         default=self._update_trans_rules  # type: ignore
@@ -1378,6 +1395,8 @@ class OptionsFlowHandler(config_entries.OptionsFlow):
             'update_lan_ctrl_config', self._opt_lan_ctrl_cfg)
         self._opt_network_detect_cfg = user_input.get(
             'network_detect_config', self._opt_network_detect_cfg)
+        self._cover_pos_new = user_input.get(
+            'cover_closed_position', self._cover_closed_position)
 
         return await self.async_step_update_user_info()
 
@@ -1926,6 +1945,7 @@ class OptionsFlowHandler(config_entries.OptionsFlow):
                     'nick_name': self._nick_name,
                     'lang_new': INTEGRATION_LANGUAGES[self._lang_new],
                     'nick_name_new': self._nick_name_new,
+                    'cover_pos_new': self._cover_pos_new,
                     'devices_add': len(self._devices_add),
                     'devices_remove': len(self._devices_remove),
                     'trans_rules_count': self._trans_rules_count,
@@ -1952,6 +1972,9 @@ class OptionsFlowHandler(config_entries.OptionsFlow):
         if self._lang_new != self._integration_language:
             self._entry_data['integration_language'] = self._lang_new
             self._need_reload = True
+        if self._cover_pos_new != self._cover_closed_position:
+            self._entry_data['cover_closed_position'] = self._cover_pos_new
+            self._need_reload = True
         if self._update_user_info:
             self._entry_data['nick_name'] = self._nick_name_new
         if self._update_devices: