pySmartHashtag 0.12.0__tar.gz → 0.12.2__tar.gz

{pysmarthashtag-0.12.0/pySmartHashtag.egg-info → pysmarthashtag-0.12.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pySmartHashtag
-Version: 0.12.0
+Version: 0.12.2
 Summary: A python library to get information from Smart #1, #3 and #5 web API
 Home-page: https://github.com/dasBasti/pySmartHashtag
 Author: dasBasti

{pysmarthashtag-0.12.0 → pysmarthashtag-0.12.2/pySmartHashtag.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pySmartHashtag
-Version: 0.12.0
+Version: 0.12.2
 Summary: A python library to get information from Smart #1, #3 and #5 web API
 Home-page: https://github.com/dasBasti/pySmartHashtag
 Author: dasBasti

{pysmarthashtag-0.12.0 → pysmarthashtag-0.12.2}/pySmartHashtag.egg-info/SOURCES.txt

@@ -48,6 +48,7 @@ pysmarthashtag/tests/test_account.py
 pysmarthashtag/tests/test_actions.py
 pysmarthashtag/tests/test_authentication_backoff.py
 pysmarthashtag/tests/test_charging.py
+pysmarthashtag/tests/test_charging_states.py
 pysmarthashtag/tests/test_dc_charging.py
 pysmarthashtag/tests/test_endpoint_urls.py
 pysmarthashtag/tests/test_journal.py

{pysmarthashtag-0.12.0 → pysmarthashtag-0.12.2}/pySmartHashtag.egg-info/scm_file_list.json

@@ -1,92 +1,93 @@
 {
   "files": [
-    "requirements.txt",
-    "requirements-test.txt",
+    ".devcontainer.json",
+    ".github/copilot-instructions.md",
+    ".github/dependabot.yml",
+    ".github/workflows/python-package.yml",
+    ".github/workflows/python-publish.yml",
+    ".gitignore",
     ".pre-commit-config.yaml",
+    ".vscode/launch.json",
+    ".vscode/settings.json",
+    "AUTHORS",
+    "CODE_OF_CONDUCT.md",
     "CONTRIBUTING.md",
-    ".devcontainer.json",
-    "requirements-cli.txt",
-    "setup.py",
-    "pyproject.toml",
-    "setup.cfg",
     "ChangeLog",
-    "run.sh",
-    "CODE_OF_CONDUCT.md",
     "LICENSE",
-    "AUTHORS",
     "README.md",
-    ".gitignore",
-    ".github/copilot-instructions.md",
-    ".github/dependabot.yml",
-    ".github/workflows/python-publish.yml",
-    ".github/workflows/python-package.yml",
-    "pysmarthashtag/account.py",
-    "pysmarthashtag/const.py",
+    "pyproject.toml",
     "pysmarthashtag/__init__.py",
+    "pysmarthashtag/account.py",
+    "pysmarthashtag/api/__init__.py",
+    "pysmarthashtag/api/authentication.py",
+    "pysmarthashtag/api/client.py",
+    "pysmarthashtag/api/log_sanitizer.py",
+    "pysmarthashtag/api/ssl_context.py",
+    "pysmarthashtag/api/utils.py",
     "pysmarthashtag/cli.py",
-    "pysmarthashtag/models.py",
+    "pysmarthashtag/const.py",
+    "pysmarthashtag/control/charging.py",
     "pysmarthashtag/control/climate.py",
     "pysmarthashtag/control/journal.py",
-    "pysmarthashtag/control/charging.py",
-    "pysmarthashtag/tests/test_vin_headers.py",
-    "pysmarthashtag/tests/test_vehicle_state.py",
-    "pysmarthashtag/tests/test_actions.py",
-    "pysmarthashtag/tests/common.py",
-    "pysmarthashtag/tests/test_trackpoints.py",
-    "pysmarthashtag/tests/test_log_sanitizer.py",
-    "pysmarthashtag/tests/test_tracked_vins.py",
-    "pysmarthashtag/tests/test_charging.py",
-    "pysmarthashtag/tests/test_journal.py",
-    "pysmarthashtag/tests/test_token_lifecycle.py",
+    "pysmarthashtag/models.py",
     "pysmarthashtag/tests/__init__.py",
-    "pysmarthashtag/tests/test_ssl_context.py",
-    "pysmarthashtag/tests/test_journal_pagination.py",
-    "pysmarthashtag/tests/test_journal_control.py",
-    "pysmarthashtag/tests/test_authentication_backoff.py",
-    "pysmarthashtag/tests/test_missing_fields.py",
-    "pysmarthashtag/tests/test_dc_charging.py",
+    "pysmarthashtag/tests/common.py",
     "pysmarthashtag/tests/conftest.py",
-    "pysmarthashtag/tests/test_endpoint_urls.py",
-    "pysmarthashtag/tests/test_account.py",
-    "pysmarthashtag/tests/replys/vehicle_response.json",
+    "pysmarthashtag/tests/replys/Human_and_vehicle_relationship_does_not_exist.json",
+    "pysmarthashtag/tests/replys/api_access.json",
+    "pysmarthashtag/tests/replys/auth_context.url",
+    "pysmarthashtag/tests/replys/auth_intermediate.url",
+    "pysmarthashtag/tests/replys/auth_result.url",
+    "pysmarthashtag/tests/replys/charging_success.json",
+    "pysmarthashtag/tests/replys/climate_success.json",
+    "pysmarthashtag/tests/replys/journal_response.json",
     "pysmarthashtag/tests/replys/journal_toggle_success.json",
-    "pysmarthashtag/tests/replys/vehicle_info.json",
     "pysmarthashtag/tests/replys/login_result.json",
-    "pysmarthashtag/tests/replys/charging_success.json",
-    "pysmarthashtag/tests/replys/soc_80.json",
-    "pysmarthashtag/tests/replys/auth_result.url",
-    "pysmarthashtag/tests/replys/trackpoints_response.json",
-    "pysmarthashtag/tests/replys/api_access.json",
     "pysmarthashtag/tests/replys/ota_response.json",
+    "pysmarthashtag/tests/replys/soc_80.json",
+    "pysmarthashtag/tests/replys/soc_90.json",
     "pysmarthashtag/tests/replys/token_expired.json",
-    "pysmarthashtag/tests/replys/climate_success.json",
-    "pysmarthashtag/tests/replys/Human_and_vehicle_relationship_does_not_exist.json",
+    "pysmarthashtag/tests/replys/trackpoints_response.json",
+    "pysmarthashtag/tests/replys/vehicle_info.json",
     "pysmarthashtag/tests/replys/vehicle_info2.json",
-    "pysmarthashtag/tests/replys/soc_90.json",
-    "pysmarthashtag/tests/replys/auth_intermediate.url",
     "pysmarthashtag/tests/replys/vehicle_info_dc_charging.json",
+    "pysmarthashtag/tests/replys/vehicle_response.json",
     "pysmarthashtag/tests/replys/vehicle_result.json",
-    "pysmarthashtag/tests/replys/journal_response.json",
-    "pysmarthashtag/tests/replys/auth_context.url",
+    "pysmarthashtag/tests/test_account.py",
+    "pysmarthashtag/tests/test_actions.py",
+    "pysmarthashtag/tests/test_authentication_backoff.py",
+    "pysmarthashtag/tests/test_charging.py",
+    "pysmarthashtag/tests/test_charging_states.py",
+    "pysmarthashtag/tests/test_dc_charging.py",
+    "pysmarthashtag/tests/test_endpoint_urls.py",
+    "pysmarthashtag/tests/test_journal.py",
+    "pysmarthashtag/tests/test_journal_control.py",
+    "pysmarthashtag/tests/test_journal_pagination.py",
+    "pysmarthashtag/tests/test_log_sanitizer.py",
+    "pysmarthashtag/tests/test_missing_fields.py",
+    "pysmarthashtag/tests/test_ssl_context.py",
+    "pysmarthashtag/tests/test_token_lifecycle.py",
+    "pysmarthashtag/tests/test_tracked_vins.py",
+    "pysmarthashtag/tests/test_trackpoints.py",
+    "pysmarthashtag/tests/test_vehicle_state.py",
+    "pysmarthashtag/tests/test_vin_headers.py",
+    "pysmarthashtag/vehicle/__init__.py",
+    "pysmarthashtag/vehicle/battery.py",
     "pysmarthashtag/vehicle/climate.py",
     "pysmarthashtag/vehicle/journal.py",
+    "pysmarthashtag/vehicle/maintenance.py",
+    "pysmarthashtag/vehicle/position.py",
     "pysmarthashtag/vehicle/running.py",
     "pysmarthashtag/vehicle/safety.py",
-    "pysmarthashtag/vehicle/position.py",
-    "pysmarthashtag/vehicle/vehicle_state.py",
-    "pysmarthashtag/vehicle/battery.py",
-    "pysmarthashtag/vehicle/__init__.py",
-    "pysmarthashtag/vehicle/vehicle.py",
-    "pysmarthashtag/vehicle/trackpoints.py",
     "pysmarthashtag/vehicle/tires.py",
-    "pysmarthashtag/vehicle/maintenance.py",
-    "pysmarthashtag/api/ssl_context.py",
-    "pysmarthashtag/api/authentication.py",
-    "pysmarthashtag/api/__init__.py",
-    "pysmarthashtag/api/client.py",
-    "pysmarthashtag/api/log_sanitizer.py",
-    "pysmarthashtag/api/utils.py",
-    ".vscode/launch.json",
-    ".vscode/settings.json"
+    "pysmarthashtag/vehicle/trackpoints.py",
+    "pysmarthashtag/vehicle/vehicle.py",
+    "pysmarthashtag/vehicle/vehicle_state.py",
+    "requirements-cli.txt",
+    "requirements-test.txt",
+    "requirements.txt",
+    "run.sh",
+    "setup.cfg",
+    "setup.py"
   ]
 }

pysmarthashtag-0.12.2/pySmartHashtag.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.12.2",
+  "distance": 0,
+  "node": "g800eaf2bed8475decf036d35ccdea3178897c327",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-08-15"
+}

{pysmarthashtag-0.12.0 → pysmarthashtag-0.12.2}/pysmarthashtag/const.py

@@ -17,6 +17,12 @@ API_JOURNAL_TOGGLE_URL = "/remote-control/vehicle/status/journalLog/"
 
 OTA_SERVER_URL = "https://ota.srv.smart.com/"
 
+# Prefixes of the "seriesCodeVs" field identifying the vehicle model. They select
+# the API version to talk to and, for the #5, the scaling of some telemetry fields.
+SERIES_CODE_PREFIX_SMART_1 = "HX"
+SERIES_CODE_PREFIX_SMART_3 = "HC"
+SERIES_CODE_PREFIX_SMART_5 = "HY"
+
 # Gigya socialize endpoint used to bootstrap a Gigya session (gmid + ucid)
 # before posting accounts.login. Smart's tenant rejects accounts.login from
 # a "fresh" client without these identifiers + the gig_bootstrap cookie.

{pysmarthashtag-0.12.0 → pysmarthashtag-0.12.2}/pysmarthashtag/tests/test_account.py

@@ -137,9 +137,11 @@ async def test_get_vehicle_chargin_dc(smart_fixture: respx.Router):
     # TODO: missing 3-phase charging
     assert vehicles["TestVIN0000000002"].battery.charging_status == "DC_CHARGING"
     assert vehicles["TestVIN0000000002"].battery.is_charger_connected
-    assert vehicles["TestVIN0000000002"].battery.charging_current == ValueWithUnit(value=102.6, unit="A")
+    # VIN ...002 has a Smart #5 series code, so the raw "dcChargeIAct" of -102.6 is
+    # read as deci-ampere and scaled down to 10.26 A (issue #459).
+    assert vehicles["TestVIN0000000002"].battery.charging_current == ValueWithUnit(value=10.26, unit="A")
     assert vehicles["TestVIN0000000002"].battery.charging_voltage == ValueWithUnit(value=429, unit="V")
-    assert vehicles["TestVIN0000000002"].battery.charging_power == ValueWithUnit(value=44015, unit="W")
+    assert vehicles["TestVIN0000000002"].battery.charging_power == ValueWithUnit(value=4401, unit="W")
 
 
 @pytest.mark.asyncio

pysmarthashtag-0.12.2/pysmarthashtag/tests/test_charging_states.py

@@ -0,0 +1,119 @@
+"""Tests for the enumerated charging and charger connection states.
+
+Consumers such as the Home Assistant integration need to declare every state a
+sensor can take up front, otherwise the automation editor cannot offer them as
+trigger values. See SmartHashtag issue #439.
+"""
+
+import pytest
+
+from pysmarthashtag.vehicle.battery import (
+    CHARGER_CONNECTION_STATES,
+    CHARGING_STATES,
+    Battery,
+    ChargerConnectionState,
+    ChargingState,
+    charger_connection_state_name,
+)
+
+
+def create_vehicle_data(charger_state: str, charger_connection: str) -> dict:
+    """Create minimal vehicle data carrying the two status fields."""
+    return {
+        "vehicleStatus": {
+            "updateTime": "1716485767970",
+            "additionalVehicleStatus": {
+                "electricVehicleStatus": {
+                    "chargeLevel": "50",
+                    "chargerState": charger_state,
+                    "statusOfChargerConnection": charger_connection,
+                }
+            },
+        },
+    }
+
+
+class TestChargingStates:
+    """Test the de-duplicated list of charging states."""
+
+    def test_contains_no_duplicates(self):
+        """The exported states are unique, unlike the index based ChargingState."""
+        assert len(CHARGING_STATES) == len(set(CHARGING_STATES))
+
+    def test_covers_every_indexed_state(self):
+        """Every state reachable through a chargerState code is exported."""
+        assert set(CHARGING_STATES) == set(ChargingState)
+
+    def test_keeps_definition_order(self):
+        """The first occurrence of each state defines its position."""
+        assert CHARGING_STATES[0] == "NOT_CHARGING"
+        assert CHARGING_STATES[-1] == "DC_CHARGING"
+
+    @pytest.mark.parametrize("charger_state", range(len(ChargingState)))
+    def test_every_code_reports_an_exported_state(self, charger_state: int):
+        """Parsing any known code yields a state that consumers can enumerate."""
+        battery = Battery.from_vehicle_data(create_vehicle_data(str(charger_state), "0"))
+
+        assert battery is not None
+        assert battery.charging_status in CHARGING_STATES
+
+    def test_unknown_code_falls_back_to_unknown(self):
+        """Codes beyond the known range do not leak into the state."""
+        battery = Battery.from_vehicle_data(create_vehicle_data("99", "0"))
+
+        assert battery is not None
+        assert battery.charging_status == "UNKNOWN"
+
+    def test_negative_code_falls_back_to_unknown(self):
+        """A negative code must not wrap around to the end of the list."""
+        battery = Battery.from_vehicle_data(create_vehicle_data("-1", "0"))
+
+        assert battery is not None
+        assert battery.charging_status == "UNKNOWN"
+
+
+class TestChargerConnectionState:
+    """Test the named charger connection state."""
+
+    def test_states_are_lower_case_names(self):
+        """The exported names are usable as translation keys."""
+        assert CHARGER_CONNECTION_STATES == (
+            "not_connected",
+            "dc_connected",
+            "plugged_not_charging",
+            "charging",
+            "unknown",
+        )
+
+    @pytest.mark.parametrize("state", ChargerConnectionState)
+    def test_known_codes_map_to_exported_names(self, state: ChargerConnectionState):
+        """Every code of the enum maps to an exported name."""
+        assert charger_connection_state_name(state.value) in CHARGER_CONNECTION_STATES
+
+    def test_missing_code_stays_none(self):
+        """A vehicle that does not report the field keeps the state unset."""
+        assert charger_connection_state_name(None) is None
+
+    def test_unmapped_code_falls_back_to_unknown(self):
+        """Codes the API adds later do not break enumeration."""
+        assert charger_connection_state_name(42) == "unknown"
+
+    def test_parsed_from_vehicle_data(self):
+        """The raw code and the named state are both available after parsing."""
+        battery = Battery.from_vehicle_data(create_vehicle_data("2", "3"))
+
+        assert battery is not None
+        assert battery.charger_connection_status == 3
+        assert battery.charger_connection_state == "charging"
+
+    def test_absent_field_leaves_state_unset(self):
+        """No connection field means no state, not a wrong one."""
+        vehicle_data = create_vehicle_data("2", "0")
+        del vehicle_data["vehicleStatus"]["additionalVehicleStatus"]["electricVehicleStatus"][
+            "statusOfChargerConnection"
+        ]
+        battery = Battery.from_vehicle_data(vehicle_data)
+
+        assert battery is not None
+        assert battery.charger_connection_status is None
+        assert battery.charger_connection_state is None

{pysmarthashtag-0.12.0 → pysmarthashtag-0.12.2}/pysmarthashtag/tests/test_dc_charging.py

@@ -6,13 +6,17 @@ from pysmarthashtag.models import ValueWithUnit
 from pysmarthashtag.vehicle.battery import Battery, ChargingState, DcChargingVoltLevels
 
 
-def create_vehicle_data_with_dc_charging(charge_level: int, dc_charge_current: float) -> dict:
+def create_vehicle_data_with_dc_charging(
+    charge_level: int, dc_charge_current: float, series_code: str = "HX11"
+) -> dict:
     """Create test vehicle data with DC charging parameters.
 
     Args:
     ----
         charge_level: Battery charge level percentage (0-100)
-        dc_charge_current: DC charging current in Amps (negative for charging)
+        dc_charge_current: DC charging current as reported by the API
+            (negative for charging, deci-ampere on the Smart #5)
+        series_code: Value of the "seriesCodeVs" field selecting the vehicle model
 
     Returns:
     -------
@@ -20,6 +24,7 @@ def create_vehicle_data_with_dc_charging(charge_level: int, dc_charge_current: f
 
     """
     return {
+        "seriesCodeVs": series_code,
         "vehicleStatus": {
             "updateTime": "1716485767970",
             "additionalVehicleStatus": {
@@ -36,7 +41,7 @@ def create_vehicle_data_with_dc_charging(charge_level: int, dc_charge_current: f
                     "averPowerConsumption": "-102.3",
                 }
             },
-        }
+        },
     }
 
 
@@ -150,6 +155,69 @@ class TestDcChargingDataHandling:
         assert battery.remaining_range_at_full_charge == ValueWithUnit(value=427, unit="km")
 
 
+class TestDcChargingSmart5Scaling:
+    """Test that the Smart #5 deci-ampere DC current is scaled down (issue #459)."""
+
+    def test_smart_5_dc_current_is_divided_by_ten(self):
+        """Test that a #5 reporting 1650 deci-ampere yields 165 A instead of 1650 A."""
+        vehicle_data = create_vehicle_data_with_dc_charging(
+            charge_level=55, dc_charge_current=-1650.0, series_code="HY11"
+        )
+        battery = Battery.from_vehicle_data(vehicle_data)
+
+        assert battery is not None
+        assert battery.charging_status == "DC_CHARGING"
+        assert battery.charging_current == ValueWithUnit(value=165.0, unit="A")
+        # Voltage is unaffected by the scaling
+        assert battery.charging_voltage == ValueWithUnit(value=DcChargingVoltLevels[55], unit="V")
+        expected_power = math.floor(165.0 * DcChargingVoltLevels[55])
+        assert battery.charging_power == ValueWithUnit(value=expected_power, unit="W")
+
+    def test_smart_1_dc_current_is_not_scaled(self):
+        """Test that the #1 keeps reporting DC current in ampere."""
+        vehicle_data = create_vehicle_data_with_dc_charging(
+            charge_level=55, dc_charge_current=-165.0, series_code="HX11"
+        )
+        battery = Battery.from_vehicle_data(vehicle_data)
+
+        assert battery is not None
+        assert battery.charging_current == ValueWithUnit(value=165.0, unit="A")
+
+    def test_smart_3_dc_current_is_not_scaled(self):
+        """Test that the #3 keeps reporting DC current in ampere."""
+        vehicle_data = create_vehicle_data_with_dc_charging(
+            charge_level=55, dc_charge_current=-165.0, series_code="HC11"
+        )
+        battery = Battery.from_vehicle_data(vehicle_data)
+
+        assert battery is not None
+        assert battery.charging_current == ValueWithUnit(value=165.0, unit="A")
+
+    def test_missing_series_code_is_not_scaled(self):
+        """Test that data without a series code falls back to the unscaled V1 behaviour."""
+        vehicle_data = create_vehicle_data_with_dc_charging(charge_level=55, dc_charge_current=-165.0)
+        del vehicle_data["seriesCodeVs"]
+        battery = Battery.from_vehicle_data(vehicle_data)
+
+        assert battery is not None
+        assert battery.charging_current == ValueWithUnit(value=165.0, unit="A")
+
+    def test_smart_5_ac_current_is_not_scaled(self):
+        """Test that AC charging on a #5 is passed through unscaled."""
+        vehicle_data = create_vehicle_data_with_dc_charging(charge_level=55, dc_charge_current=0.0, series_code="HY11")
+        evStatus = vehicle_data["vehicleStatus"]["additionalVehicleStatus"]["electricVehicleStatus"]
+        evStatus["chargerState"] = "2"  # CHARGING (AC)
+        evStatus["chargeUAct"] = "230.0"
+        evStatus["chargeIAct"] = "16.000"
+        battery = Battery.from_vehicle_data(vehicle_data)
+
+        assert battery is not None
+        assert battery.charging_status == "CHARGING"
+        assert battery.charging_current == ValueWithUnit(value=16.0, unit="A")
+        assert battery.charging_voltage == ValueWithUnit(value=230.0, unit="V")
+        assert battery.charging_power == ValueWithUnit(value=230.0 * 16.0, unit="W")
+
+
 class TestChargingStateEnum:
     """Test charging state handling."""
 

{pysmarthashtag-0.12.0 → pysmarthashtag-0.12.2}/pysmarthashtag/vehicle/battery.py

@@ -4,12 +4,18 @@ import logging
 import math
 from dataclasses import dataclass
 from datetime import datetime
+from enum import IntEnum
 from typing import Any, Optional
 
+from pysmarthashtag.const import SERIES_CODE_PREFIX_SMART_5
 from pysmarthashtag.models import ValueWithUnit, VehicleDataBase, get_field_as_type
 
 _LOGGER = logging.getLogger(__name__)
 
+"""The V2 API used by the Smart #5 reports "dcChargeIAct" in deci-ampere, while the V1
+API of the #1/#3 reports it in ampere. See SmartHashtag issue #459."""
+DC_CHARGE_CURRENT_DIVIDER_SMART_5 = 10
+
 """Charging state of electric vehicle."""
 ChargingState = [
     "NOT_CHARGING",
@@ -30,6 +36,46 @@ ChargingState = [
     "DC_CHARGING",
 ]
 
+"""Every distinct value :attr:`Battery.charging_status` can take, in the order the API
+codes are defined.
+
+``ChargingState`` is indexed by the raw ``chargerState`` code and therefore repeats
+``UNKNOWN`` for the codes with no known meaning. Consumers that need to enumerate the
+possible states up front should use this de-duplicated tuple instead of hard coding a
+subset: Home Assistant, for example, only offers a sensor's states to the automation
+editor when the entity declares all of them in advance. See SmartHashtag issue #439."""
+CHARGING_STATES: tuple = tuple(dict.fromkeys(ChargingState))
+
+
+class ChargerConnectionState(IntEnum):
+    """Connection state of the charger, as reported in ``statusOfChargerConnection``."""
+
+    NOT_CONNECTED = 0
+    DC_CONNECTED = 1
+    PLUGGED_NOT_CHARGING = 2
+    CHARGING = 3
+
+
+"""Every value :attr:`Battery.charger_connection_state` can take, including the
+``unknown`` fallback used for codes the API adds later."""
+CHARGER_CONNECTION_STATES: tuple = tuple(state.name.lower() for state in ChargerConnectionState) + ("unknown",)
+
+
+def charger_connection_state_name(status: Optional[int]) -> Optional[str]:
+    """Return the stable, lower case name for a raw ``statusOfChargerConnection`` code.
+
+    Returns ``None`` if the vehicle did not report a code and ``"unknown"`` for codes
+    that are not part of :class:`ChargerConnectionState`.
+    """
+    if status is None:
+        return None
+    try:
+        return ChargerConnectionState(status).name.lower()
+    except ValueError:
+        _LOGGER.debug("Unknown charger connection status %s", status)
+        return "unknown"
+
+
 DcChargingVoltLevels = [
     370,
     374,
@@ -155,7 +201,12 @@ class Battery(VehicleDataBase):
     """Charging status of the vehicle."""
 
     charger_connection_status: Optional[int] = None
-    """Charger connection status of the vehicle."""
+    """Charger connection status of the vehicle as raw API code."""
+
+    charger_connection_state: Optional[str] = None
+    """Charger connection status of the vehicle as stable, lower case name.
+
+    Always one of :data:`CHARGER_CONNECTION_STATES` once the vehicle reported a code."""
 
     is_charger_connected: bool = False
     """Is the charger connected to the vehicle."""
@@ -210,7 +261,7 @@ class Battery(VehicleDataBase):
             charger_state = get_field_as_type(evStatus, "chargerState", int, log_missing=False)
             if charger_state is not None:
                 retval["charging_status"] = (
-                    ChargingState[charger_state] if charger_state < len(ChargingState) else "UNKNOWN"
+                    ChargingState[charger_state] if 0 <= charger_state < len(ChargingState) else "UNKNOWN"
                 )
                 retval["charging_status_raw"] = charger_state
                 retval["is_charger_connected"] = (
@@ -223,6 +274,7 @@ class Battery(VehicleDataBase):
             charger_conn = get_field_as_type(evStatus, "statusOfChargerConnection", int, log_missing=False)
             if charger_conn is not None:
                 retval["charger_connection_status"] = charger_conn
+                retval["charger_connection_state"] = charger_connection_state_name(charger_conn)
 
             charging_status = retval.get("charging_status")
             battery_percent = retval.get("remaining_battery_percent")
@@ -236,10 +288,13 @@ class Battery(VehicleDataBase):
                     # Clamp to valid index range: 0 to len(DcChargingVoltLevels) - 1
                     max_index = len(DcChargingVoltLevels) - 1
                     battery_value = max(0, min(battery_value, max_index))
+                    dc_charge_current = abs(dc_charge_i)
+                    if str(vehicle_data.get("seriesCodeVs", "")).startswith(SERIES_CODE_PREFIX_SMART_5):
+                        dc_charge_current /= DC_CHARGE_CURRENT_DIVIDER_SMART_5
                     retval["charging_voltage"] = ValueWithUnit(DcChargingVoltLevels[battery_value], "V")
-                    retval["charging_current"] = ValueWithUnit(abs(dc_charge_i), "A")
+                    retval["charging_current"] = ValueWithUnit(dc_charge_current, "A")
                     retval["charging_power"] = ValueWithUnit(
-                        math.floor(abs(dc_charge_i) * DcChargingVoltLevels[battery_value]),
+                        math.floor(dc_charge_current * DcChargingVoltLevels[battery_value]),
                         "W",
                     )
                 else:

{pysmarthashtag-0.12.0 → pysmarthashtag-0.12.2}/pysmarthashtag/vehicle/vehicle.py

@@ -4,7 +4,13 @@ import datetime
 import logging
 from typing import Optional
 
-from pysmarthashtag.const import API_BASE_URL, API_BASE_URL_V2
+from pysmarthashtag.const import (
+    API_BASE_URL,
+    API_BASE_URL_V2,
+    SERIES_CODE_PREFIX_SMART_1,
+    SERIES_CODE_PREFIX_SMART_3,
+    SERIES_CODE_PREFIX_SMART_5,
+)
 from pysmarthashtag.models import ValueWithUnit, get_element_from_dict_maybe
 from pysmarthashtag.vehicle.battery import Battery
 from pysmarthashtag.vehicle.climate import Climate
@@ -90,13 +96,13 @@ class SmartVehicle:
         self.account = account
         self.data = {}
         self.combine_data(vehicle_base, vehicle_state, charging_settings, None, fetched_at)
-        if self.data["seriesCodeVs"].startswith("HX"):
+        if self.data["seriesCodeVs"].startswith(SERIES_CODE_PREFIX_SMART_1):
             _LOGGER.debug("Selected Vehicle is Smart #1 use V1 API")
             self.base_url = API_BASE_URL
-        elif self.data["seriesCodeVs"].startswith("HC"):
+        elif self.data["seriesCodeVs"].startswith(SERIES_CODE_PREFIX_SMART_3):
             _LOGGER.debug("Selected Vehicle is Smart #3 use V1 API")
             self.base_url = API_BASE_URL
-        elif self.data["seriesCodeVs"].startswith("HY"):
+        elif self.data["seriesCodeVs"].startswith(SERIES_CODE_PREFIX_SMART_5):
             _LOGGER.debug("Selected Vehicle is Smart #5 use V2 API")
             self.base_url = API_BASE_URL_V2
         else:

{pysmarthashtag-0.12.0 → pysmarthashtag-0.12.2}/requirements-test.txt

@@ -7,7 +7,7 @@ black
 mypy
 types-setuptools
 pbr
-time_machine<3.3.0
+time_machine<3.4.0
 pre-commit
 backports.zoneinfo;python_version<"3.9"
-ruff==0.15.22
+ruff==0.16.1

pysmarthashtag-0.12.0/pySmartHashtag.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "0.12.0",
-  "distance": 0,
-  "node": "g5cb4e0529b5c1262227b520f2b68320ed5182ced",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-07-25"
-}