@@ -9,6 +9,12 @@ the GitHub release body should be rendered from the matching version section her
 
 ### Added
 
+- Added a separate **SmartClient / ShineMonitor** source for read-only device
+  analysis. It collects exact-identity cloud readings, setting descriptions,
+  available daily history and raw-packet fingerprints without changing the collector
+  endpoint or sending control commands. Existing SmartESS/DESSMonitor defaults
+  and active learning are unchanged; this source does not yet offer active
+  verification or a built-in map for previously unsupported PV inverters.
 - Added protocol-level fallback profiles for unknown SMG models reporting
   protocol 1, 2, or 11. Protocols 1 and 11 expose 30 compatible basic controls;
   the July 2024 GM6200 protocol-2 document supplies a separate 54-capability
@@ -68,6 +74,15 @@ the GitHub release body should be rendered from the matching version section her
 
 ### Fixed
 
+- Collector protocol hints no longer label SmartClient/SmartValue devices as
+  SmartESS merely because they expose the same metadata fields. Cloud source
+  selection remains explicit and independent of those hints.
+- Device-learning credentials preserve intentional password whitespace before
+  cloud authentication.
+- Modbus exception `03` no longer claims that a rejected write was necessarily
+  outside the inverter's allowed setting range. Diagnostics distinguish the
+  profile's UI bounds from the device's unexplained rejection; write validation
+  and confirmation behavior are unchanged.
 - Schema-driven Modbus polling now reports a failed cycle when every runtime
   block fails, instead of publishing an empty successful snapshot. Cached
   settings cannot hide the failure; valid partial telemetry remains available,
 
@@ -0,0 +1,18 @@
+"""EyeBond's shared signature codec; callers own endpoint and action policy."""
+
+from __future__ import annotations
+
+import hashlib
+
+
+def password_signature(salt: str, password: str, action: str) -> str:
+    """Sign the caller's exact login suffix without choosing an auth profile."""
+
+    password_hash = hashlib.sha1(password.encode("utf-8")).hexdigest()
+    return hashlib.sha1((salt + password_hash + action).encode("utf-8")).hexdigest()
+
+
+def session_signature(salt: str, secret: str, token: str, action: str) -> str:
+    """Sign an exact suffix, including the caller's source/client metadata."""
+
+    return hashlib.sha1((salt + secret + token + action).encode("utf-8")).hexdigest()
@@ -22,6 +22,7 @@
 from urllib.parse import quote
 from urllib.request import Request, urlopen
 
+from .cloud_signing import password_signature, session_signature
 from .collector_identity import pn_is_same_identity
 
 
@@ -451,7 +452,7 @@ def build_login_url(
     _required_token(password, "dessmonitor_password_invalid")
     action = _login_action(username=username, company_key=company_key)
     salt = _salt_millis()
-    sign = _sha1_lower(salt + _sha1_lower(password) + action)
+    sign = password_signature(salt, password, action)
     return f"{_normalized_base_url(base_url)}?sign={sign}&salt={salt}{action}"
 
 
@@ -534,7 +535,7 @@ def build_signed_action_url(
         + f"&_app_version_={quote(app_version, safe='')}"
     )
     salt = _salt_millis()
-    sign = _sha1_lower(salt + session.secret + session.token + suffix)
+    sign = session_signature(salt, session.secret, session.token, suffix)
     return (
         f"{_normalized_base_url(base_url)}?sign={sign}&salt={salt}"
         f"&token={quote(session.token, safe='')}{suffix}"
 
@@ -122,18 +122,21 @@ def _user_error_from_exception_code(
     native_minimum = capability.native_minimum
     native_maximum = capability.native_maximum
     if native_minimum is not None and native_maximum is not None:
-        allowed_range = f"Allowed profile range: {native_minimum} to {native_maximum}."
+        allowed_range = f"Profile UI range: {native_minimum} to {native_maximum}."
     elif native_minimum is not None:
-        allowed_range = f"Allowed profile minimum: {native_minimum}."
+        allowed_range = f"Profile UI minimum: {native_minimum}."
     elif native_maximum is not None:
-        allowed_range = f"Allowed profile maximum: {native_maximum}."
+        allowed_range = f"Profile UI maximum: {native_maximum}."
     else:
-        allowed_range = "The inverter may enforce a narrower range than the current profile metadata."
+        allowed_range = ""
 
     return ValueError(
         f"illegal_data_value:{capability.key}:"
-        f"The inverter rejected {capability.display_name!r} as out of range. "
-        f"{allowed_range}"
+        f"The inverter rejected the write request for {capability.display_name!r} "
+        "(Modbus exception 03: illegal data value). This response does not "
+        "identify an allowed setting range; the request format or a "
+        "device-specific restriction may need checking. "
+        f"{allowed_range}".rstrip()
     )
 
 
 
@@ -20,6 +20,7 @@
       "cloud_learning_source_intro": "Choose the compatible cloud service Home Assistant should use for this check.",
       "cloud_learning_source_smartess": "SmartESS API",
       "cloud_learning_source_dessmonitor": "DESSMonitor API",
+      "cloud_learning_source_smartclient": "SmartClient / ShineMonitor",
       "cloud_learning_source_valuecloud": "ValueCloud API",
       "cloud_learning_metadata_done": "The read-only device analysis finished.",
       "local_register_observation_available": "Optionally observe local readings for about {minutes} minutes in the background. This only gathers review evidence and adds no entities or controls.",
@@ -388,13 +389,13 @@
       "support_workflow_pending_step_2": "Send the ZIP file to the developer.",
       "support_workflow_pending_step_3": "Only move on to local drafts after the developer reviews the evidence.",
       "support_workflow_pending_advanced_hint": "Treat local drafts as a second-stage tool here. First confirm connectivity or send the support evidence.",
-      "support_workflow_smartess_pending_level_label": "SmartESS collector evidence",
-      "support_workflow_smartess_pending_summary": "The collector exposed SmartESS metadata, but no local inverter driver is matched yet.",
-      "support_workflow_smartess_pending_next_action": "Create a support archive and send the ZIP file to the developer. SmartESS app support can still rely on a separate cloud-normalized identity even when the local descriptor is generic, missing, or incomplete.",
+      "support_workflow_smartess_pending_level_label": "Collector protocol metadata",
+      "support_workflow_smartess_pending_summary": "The collector returned protocol metadata, but no local inverter driver is matched yet.",
+      "support_workflow_smartess_pending_next_action": "Create a support archive and send the ZIP file to the developer. The manufacturer's app may identify this inverter through its cloud even when the local descriptor is incomplete.",
       "support_workflow_smartess_pending_step_1": "Create a support archive.",
       "support_workflow_smartess_pending_step_2": "Send the ZIP file to the developer.",
-      "support_workflow_smartess_pending_step_3": "Treat the local SmartESS descriptor as collector evidence only until a built-in mapping is confirmed.",
-      "support_workflow_smartess_pending_advanced_hint": "Do not treat a generic or missing local SmartESS descriptor as proof that the inverter is unsupported in the SmartESS app.",
+      "support_workflow_smartess_pending_step_3": "Treat the local protocol descriptor as collector evidence only until a built-in mapping is confirmed.",
+      "support_workflow_smartess_pending_advanced_hint": "Protocol metadata alone does not identify the cloud app or prove a local register map. Select the app you actually use when collecting cloud evidence.",
       "support_workflow_family_fallback_level_label": "Read-only unverified SMG family",
       "support_workflow_family_fallback_summary": "This inverter is using the generic SMG family fallback. Built-in writes are intentionally disabled until the exact model is verified.",
       "support_workflow_family_fallback_next_action": "Create a support archive and send the ZIP file to the developer. This will help confirm the exact SMG-family model and move it beyond the read-only fallback.",
 
@@ -20,6 +20,7 @@
       "cloud_learning_source_intro": "Выберите совместимый облачный сервис для этой проверки.",
       "cloud_learning_source_smartess": "SmartESS API",
       "cloud_learning_source_dessmonitor": "DESSMonitor API",
+      "cloud_learning_source_smartclient": "SmartClient / ShineMonitor",
       "cloud_learning_source_valuecloud": "ValueCloud API",
       "cloud_learning_metadata_done": "Анализ устройства только для чтения завершён.",
       "local_register_observation_available": "При желании можно около {minutes} минут собирать локальные показания в фоне. Это только данные для проверки: сущности и элементы управления не добавляются.",
@@ -388,13 +389,13 @@
       "support_workflow_pending_step_2": "Отправьте ZIP-файл разработчику.",
       "support_workflow_pending_step_3": "Переходите к локальным черновикам только после того, как разработчик просмотрит собранные данные.",
       "support_workflow_pending_advanced_hint": "Рассматривайте локальные черновики здесь как инструмент второго этапа. Сначала подтвердите соединение или отправьте подтверждающие данные.",
-      "support_workflow_smartess_pending_level_label": "Есть признаки SmartESS",
-      "support_workflow_smartess_pending_summary": "Коллектор вернул метаданные SmartESS, но локальный драйвер инвертора пока не сопоставлен.",
-      "support_workflow_smartess_pending_next_action": "Создайте архив поддержки и отправьте ZIP-файл разработчику. Поддержка в приложении SmartESS всё ещё возможна через отдельное облачное сопоставление устройства, даже если локальный идентификатор общий, пустой или неполный.",
+      "support_workflow_smartess_pending_level_label": "Есть данные протокола коллектора",
+      "support_workflow_smartess_pending_summary": "Коллектор вернул данные протокола, но локальный драйвер инвертора пока не определён.",
+      "support_workflow_smartess_pending_next_action": "Создайте архив поддержки и отправьте ZIP-файл разработчику. Приложение производителя может определять этот инвертор через облако, даже если локальные данные неполные.",
       "support_workflow_smartess_pending_step_1": "Создайте архив поддержки.",
       "support_workflow_smartess_pending_step_2": "Отправьте ZIP-файл разработчику.",
-      "support_workflow_smartess_pending_step_3": "Считайте локальный идентификатор SmartESS только данными коллектора, пока не будет подтверждено встроенное сопоставление.",
-      "support_workflow_smartess_pending_advanced_hint": "Не считайте общий или пустой локальный идентификатор SmartESS доказательством того, что устройство не поддерживается приложением SmartESS.",
+      "support_workflow_smartess_pending_step_3": "Данные протокола коллектора ещё не подтверждают поддержку инвертора.",
+      "support_workflow_smartess_pending_advanced_hint": "Эти данные не определяют облачное приложение или локальную карту регистров. Для сбора облачных данных выбирайте приложение, которым вы пользуетесь.",
       "support_workflow_family_fallback_level_label": "Непроверенное read-only устройство семейства SMG",
       "support_workflow_family_fallback_summary": "Для этого инвертора используется общий fallback-профиль семейства SMG. Встроенные записи намеренно отключены, пока точная модель не подтверждена.",
       "support_workflow_family_fallback_next_action": "Создайте архив поддержки и отправьте ZIP-файл разработчику. Это поможет подтвердить точную модель семейства SMG и вывести устройство из read-only fallback-режима.",
 
@@ -20,6 +20,7 @@
       "cloud_learning_source_intro": "Виберіть сумісний хмарний сервіс для цієї перевірки.",
       "cloud_learning_source_smartess": "SmartESS API",
       "cloud_learning_source_dessmonitor": "DESSMonitor API",
+      "cloud_learning_source_smartclient": "SmartClient / ShineMonitor",
       "cloud_learning_source_valuecloud": "ValueCloud API",
       "cloud_learning_metadata_done": "Аналіз пристрою лише для читання завершено.",
       "local_register_observation_available": "За бажанням можна близько {minutes} хвилин збирати локальні показання у фоні. Це лише дані для перевірки: сутності та елементи керування не додаються.",
@@ -388,13 +389,13 @@
       "support_workflow_pending_step_2": "Надішліть ZIP-файл розробнику.",
       "support_workflow_pending_step_3": "Переходьте до локальних чернеток лише після того, як розробник перегляне зібрані дані.",
       "support_workflow_pending_advanced_hint": "Розглядайте локальні чернетки тут як інструмент другого етапу. Спочатку підтвердьте з'єднання або надішліть докази підтримки.",
-      "support_workflow_smartess_pending_level_label": "Є ознаки SmartESS",
-      "support_workflow_smartess_pending_summary": "Колектор повернув метадані SmartESS, але локальний драйвер інвертора поки не зіставлено.",
-      "support_workflow_smartess_pending_next_action": "Створіть архів підтримки та надішліть ZIP-файл розробнику. Підтримка в застосунку SmartESS усе ще можлива через окреме хмарне зіставлення пристрою, навіть якщо локальний ідентифікатор загальний, порожній або неповний.",
+      "support_workflow_smartess_pending_level_label": "Є дані протоколу колектора",
+      "support_workflow_smartess_pending_summary": "Колектор повернув дані протоколу, але локальний драйвер інвертора поки не визначено.",
+      "support_workflow_smartess_pending_next_action": "Створіть архів підтримки та надішліть ZIP-файл розробнику. Застосунок виробника може визначати цей інвертор через хмару, навіть якщо локальні дані неповні.",
       "support_workflow_smartess_pending_step_1": "Створіть архів підтримки.",
       "support_workflow_smartess_pending_step_2": "Надішліть ZIP-файл розробнику.",
-      "support_workflow_smartess_pending_step_3": "Сприймайте локальний ідентифікатор SmartESS лише як дані колектора, доки не буде підтверджено вбудоване зіставлення.",
-      "support_workflow_smartess_pending_advanced_hint": "Не сприймайте загальний або порожній локальний ідентифікатор SmartESS як доказ того, що пристрій не підтримується застосунком SmartESS.",
+      "support_workflow_smartess_pending_step_3": "Дані протоколу колектора ще не підтверджують підтримку інвертора.",
+      "support_workflow_smartess_pending_advanced_hint": "Ці дані не визначають хмарний застосунок або локальну карту регістрів. Для збору хмарних даних обирайте застосунок, яким ви користуєтеся.",
       "support_workflow_family_fallback_level_label": "Неперевірений read-only пристрій сімейства SMG",
       "support_workflow_family_fallback_summary": "Для цього інвертора використовується загальний fallback-профіль сімейства SMG. Вбудовані записи навмисно вимкнені, доки точну модель не буде підтверджено.",
       "support_workflow_family_fallback_next_action": "Створіть архів підтримки та надішліть ZIP-файл розробнику. Це допоможе підтвердити точну модель сімейства SMG і вивести пристрій із read-only fallback-режиму.",
 
@@ -276,6 +276,10 @@ async def _async_continue_after_learning_source(self, coordinator) -> ConfigFlow
 
     def _control_discovery_source_option_label(self, source_id: str) -> str:
         labels = {
+            "smartclient": self._tr(
+                "common.dynamic.cloud_learning_source_smartclient",
+                "SmartClient / ShineMonitor",
+            ),
             "smartess": self._tr(
                 "common.dynamic.cloud_learning_source_smartess",
                 "SmartESS API",
@@ -377,7 +381,8 @@ async def async_step_shadow_learning_credentials(
         errors: dict[str, str] = {}
         defaults = dict(user_input or {})
         username = str(defaults.get("username") or "").strip()
-        password = str(defaults.get("password") or "").strip()
+        # Whitespace can be part of the cloud password and its signed hash.
+        password = str(defaults.get("password") or "")
         if user_input is not None:
             if not username:
                 errors["username"] = "required"