aiohomematic 2026.1.29__py3-none-any.whl

aiohomematic/store/visibility/rules.py

@@ -0,0 +1,307 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2021-2026
+"""
+Static visibility rules for Homematic parameters.
+
+This module contains all static mappings and constants that determine parameter
+visibility, including:
+
+- MASTER paramset relevance by channel and device
+- Parameters to ignore/un-ignore per device model
+- Hidden parameters that are created but not displayed by default
+- Event suppression rules for specific devices
+
+These rules are used by ParameterVisibilityRegistry to make visibility decisions.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+import re
+from typing import Final, TypeAlias
+
+from aiohomematic.const import CLICK_EVENTS, Parameter
+
+# =============================================================================
+# Type Aliases
+# =============================================================================
+
+ModelName: TypeAlias = str
+ChannelNo: TypeAlias = int | None
+ParameterName: TypeAlias = str
+
+# =============================================================================
+# MASTER Paramset Relevance Rules
+# =============================================================================
+# Define which additional parameters from MASTER paramset should be created as
+# data points. By default these are also in HIDDEN_PARAMETERS, which prevents
+# them from being displayed. Usually these entities are used within custom data
+# points, not for general display.
+
+RELEVANT_MASTER_PARAMSETS_BY_CHANNEL: Final[Mapping[ChannelNo, frozenset[Parameter]]] = {
+    None: frozenset({Parameter.GLOBAL_BUTTON_LOCK, Parameter.LOW_BAT_LIMIT}),
+    0: frozenset({Parameter.GLOBAL_BUTTON_LOCK, Parameter.LOW_BAT_LIMIT}),
+}
+
+CLIMATE_MASTER_PARAMETERS: Final[frozenset[Parameter]] = frozenset(
+    {
+        Parameter.HEATING_VALVE_TYPE,
+        Parameter.MIN_MAX_VALUE_NOT_RELEVANT_FOR_MANU_MODE,
+        Parameter.OPTIMUM_START_STOP,
+        Parameter.TEMPERATURE_MAXIMUM,
+        Parameter.TEMPERATURE_MINIMUM,
+        Parameter.TEMPERATURE_OFFSET,
+        Parameter.WEEK_PROGRAM_POINTER,
+    }
+)
+
+# {model: (channel_numbers, parameters)}
+RELEVANT_MASTER_PARAMSETS_BY_DEVICE: Final[Mapping[ModelName, tuple[frozenset[ChannelNo], frozenset[Parameter]]]] = {
+    "ALPHA-IP-RBG": (frozenset({1}), CLIMATE_MASTER_PARAMETERS),
+    "ELV-SH-TACO": (frozenset({2}), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HM-CC-RT-DN": (frozenset({None}), CLIMATE_MASTER_PARAMETERS),
+    "HM-CC-VG-1": (frozenset({None}), CLIMATE_MASTER_PARAMETERS),
+    "HM-TC-IT-WM-W-EU": (frozenset({None}), CLIMATE_MASTER_PARAMETERS),
+    "HmIP-BWTH": (frozenset({1, 8}), CLIMATE_MASTER_PARAMETERS),
+    "HmIP-DRBLI4": (
+        frozenset({1, 2, 3, 4, 5, 6, 7, 8, 9, 13, 17, 21}),
+        frozenset({Parameter.CHANNEL_OPERATION_MODE}),
+    ),
+    "HmIP-DRDI3": (frozenset({1, 2, 3}), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIP-DRSI1": (frozenset({1}), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIP-DRSI4": (frozenset({1, 2, 3, 4}), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIP-DSD-PCB": (frozenset({1}), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIP-FCI1": (frozenset({1}), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIP-FCI6": (frozenset(range(1, 7)), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIP-FSI16": (frozenset({1}), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIP-HEATING": (frozenset({1}), CLIMATE_MASTER_PARAMETERS),
+    "HmIP-MIO16-PCB": (frozenset({13, 14, 15, 16}), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIP-MOD-RC8": (frozenset(range(1, 9)), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIP-RGBW": (frozenset({0}), frozenset({Parameter.DEVICE_OPERATION_MODE})),
+    "HmIP-STH": (frozenset({1}), CLIMATE_MASTER_PARAMETERS),
+    "HmIP-WGT": (frozenset({8, 14}), CLIMATE_MASTER_PARAMETERS),
+    "HmIP-WTH": (frozenset({1}), CLIMATE_MASTER_PARAMETERS),
+    "HmIP-eTRV": (frozenset({1}), CLIMATE_MASTER_PARAMETERS),
+    "HmIPW-DRBL4": (frozenset({1, 5, 9, 13}), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIPW-DRI16": (frozenset(range(1, 17)), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIPW-DRI32": (frozenset(range(1, 33)), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIPW-FIO6": (frozenset(range(1, 7)), frozenset({Parameter.CHANNEL_OPERATION_MODE})),
+    "HmIPW-STH": (frozenset({1}), CLIMATE_MASTER_PARAMETERS),
+}
+
+# =============================================================================
+# Event Suppression Rules
+# =============================================================================
+# Ignore events for some devices to reduce noise in event streams.
+
+IGNORE_DEVICES_FOR_DATA_POINT_EVENTS: Final[Mapping[ModelName, frozenset[Parameter]]] = {
+    "HmIP-PS": CLICK_EVENTS,
+}
+
+IGNORE_DEVICES_FOR_DATA_POINT_EVENTS_LOWER: Final[Mapping[ModelName, frozenset[Parameter]]] = {
+    model.lower(): frozenset(events) for model, events in IGNORE_DEVICES_FOR_DATA_POINT_EVENTS.items()
+}
+
+# =============================================================================
+# Hidden Parameters
+# =============================================================================
+# Data points that will be created but should be hidden from UI by default.
+
+HIDDEN_PARAMETERS: Final[frozenset[Parameter]] = frozenset(
+    {
+        Parameter.ACTIVITY_STATE,
+        Parameter.CHANNEL_OPERATION_MODE,
+        Parameter.CONFIG_PENDING,
+        Parameter.DIRECTION,
+        Parameter.ERROR,
+        Parameter.HEATING_VALVE_TYPE,
+        Parameter.LOW_BAT_LIMIT,
+        Parameter.MIN_MAX_VALUE_NOT_RELEVANT_FOR_MANU_MODE,
+        Parameter.OPTIMUM_START_STOP,
+        Parameter.SECTION,
+        Parameter.STICKY_UN_REACH,
+        Parameter.TEMPERATURE_MAXIMUM,
+        Parameter.TEMPERATURE_MINIMUM,
+        Parameter.TEMPERATURE_OFFSET,
+        Parameter.UN_REACH,
+        Parameter.UPDATE_PENDING,
+        Parameter.WORKING,
+    }
+)
+
+# =============================================================================
+# Ignored Parameters
+# =============================================================================
+# Parameters within the VALUES paramset for which we don't create data points.
+
+IGNORED_PARAMETERS: Final[frozenset[ParameterName]] = frozenset(
+    {
+        "ACCESS_AUTHORIZATION",
+        "ADAPTION_DRIVE",
+        "AES_KEY",
+        "ALARM_COUNT",
+        "ALL_LEDS",
+        "ARROW_DOWN",
+        "ARROW_UP",
+        "BACKLIGHT",
+        "BEEP",
+        "BELL",
+        "BLIND",
+        "BOOST_STATE",
+        "BOOST_TIME",
+        "BOOT",
+        "BULB",
+        "CLEAR_ERROR",
+        "CLEAR_WINDOW_OPEN_SYMBOL",
+        "CLOCK",
+        "CMD_RETL",  # CUxD
+        "CMD_RETS",  # CUxD
+        "CONTROL_DIFFERENTIAL_TEMPERATURE",
+        "DATE_TIME_UNKNOWN",
+        "DECISION_VALUE",
+        "DEVICE_IN_BOOTLOADER",
+        "DOOR",
+        "EXTERNAL_CLOCK",
+        "FROST_PROTECTION",
+        "HUMIDITY_LIMITER",
+        "IDENTIFICATION_MODE_KEY_VISUAL",
+        "IDENTIFICATION_MODE_LCD_BACKLIGHT",
+        "INCLUSION_UNSUPPORTED_DEVICE",
+        "INHIBIT",
+        "INSTALL_MODE",
+        "LEVEL_REAL",
+        "OLD_LEVEL",
+        "OVERFLOW",
+        "OVERRUN",
+        "PARTY_SET_POINT_TEMPERATURE",
+        "PARTY_TEMPERATURE",
+        "PARTY_TIME_END",
+        "PARTY_TIME_START",
+        "PHONE",
+        "PROCESS",
+        "QUICK_VETO_TIME",
+        "RAMP_STOP",
+        "RELOCK_DELAY",
+        "SCENE",
+        "SELF_CALIBRATION",
+        "SERVICE_COUNT",
+        "SET_SYMBOL_FOR_HEATING_PHASE",
+        "SHADING_SPEED",
+        "SHEV_POS",
+        "SPEED",
+        "STATE_UNCERTAIN",
+        "SUBMIT",
+        "SWITCH_POINT_OCCURED",
+        "TEMPERATURE_LIMITER",
+        "TEMPERATURE_OUT_OF_RANGE",
+        "TEXT",
+        "USER_COLOR",
+        "USER_PROGRAM",
+        "VALVE_ADAPTION",
+        "WINDOW",
+        "WIN_RELEASE",
+        "WIN_RELEASE_ACT",
+    }
+)
+
+# Precompiled regex patterns for wildcard parameter checks
+IGNORED_PARAMETERS_END_PATTERN: Final = re.compile(r".*(_OVERFLOW|_OVERRUN|_REPORTING|_RESULT|_STATUS|_SUBMIT)$")
+IGNORED_PARAMETERS_START_PATTERN: Final = re.compile(
+    r"^(ADJUSTING_|ERR_TTM_|HANDLE_|IDENTIFY_|PARTY_START_|PARTY_STOP_|STATUS_FLAG_|WEEK_PROGRAM_)"
+)
+
+
+def parameter_is_wildcard_ignored(*, parameter: ParameterName) -> bool:
+    """Check if a parameter matches common wildcard patterns."""
+    return bool(IGNORED_PARAMETERS_END_PATTERN.match(parameter) or IGNORED_PARAMETERS_START_PATTERN.match(parameter))
+
+
+# =============================================================================
+# Un-Ignore Rules by Device
+# =============================================================================
+# Parameters that are normally ignored but should be created for specific devices.
+
+UN_IGNORE_PARAMETERS_BY_DEVICE: Final[Mapping[ModelName, frozenset[Parameter]]] = {
+    "HmIP-DLD": frozenset({Parameter.ERROR_JAMMED}),
+    "HmIP-SWSD": frozenset({Parameter.DIRT_LEVEL, Parameter.SMOKE_LEVEL, Parameter.SMOKE_DETECTOR_ALARM_STATUS}),
+    # Text display parameters for HmIP-WRCD
+    "HmIP-WRCD": frozenset(
+        {Parameter.DISPLAY_DATA_COMMIT, Parameter.DISPLAY_DATA_ID, Parameter.DISPLAY_DATA_STRING, Parameter.INTERVAL}
+    ),
+    "HM-OU-LED16": frozenset({Parameter.LED_STATUS}),
+    "HM-Sec-Win": frozenset({Parameter.DIRECTION, Parameter.WORKING, Parameter.ERROR, Parameter.STATUS}),
+    "HM-Sec-Key": frozenset({Parameter.DIRECTION, Parameter.ERROR}),
+    "HmIP-PCBS-BAT": frozenset({Parameter.OPERATING_VOLTAGE, Parameter.LOW_BAT}),  # Override HmIP-PCBS
+    # RF thermostats need WEEK_PROGRAM_POINTER for climate presets
+    "BC-RT-TRX-CyG": frozenset({Parameter.WEEK_PROGRAM_POINTER}),
+    "BC-RT-TRX-CyN": frozenset({Parameter.WEEK_PROGRAM_POINTER}),
+    "BC-TC-C-WM": frozenset({Parameter.WEEK_PROGRAM_POINTER}),
+    "HM-CC-RT-DN": frozenset({Parameter.WEEK_PROGRAM_POINTER}),
+    "HM-CC-VG-1": frozenset({Parameter.WEEK_PROGRAM_POINTER}),
+    "HM-TC-IT-WM-W-EU": frozenset({Parameter.WEEK_PROGRAM_POINTER}),
+}
+
+UN_IGNORE_PARAMETERS_BY_MODEL_LOWER: Final[dict[ModelName, frozenset[Parameter]]] = {
+    model.lower(): frozenset(parameters) for model, parameters in UN_IGNORE_PARAMETERS_BY_DEVICE.items()
+}
+
+# =============================================================================
+# Ignore Rules by Device
+# =============================================================================
+# Parameters to ignore for specific device models.
+
+IGNORE_PARAMETERS_BY_DEVICE: Final[Mapping[Parameter, frozenset[ModelName]]] = {
+    Parameter.CURRENT_ILLUMINATION: frozenset({"HmIP-SMI", "HmIP-SMO", "HmIP-SPI"}),
+    Parameter.LOWBAT: frozenset(
+        {
+            "HM-LC-Sw1-DR",
+            "HM-LC-Sw1-FM",
+            "HM-LC-Sw1-PCB",
+            "HM-LC-Sw1-Pl",
+            "HM-LC-Sw1-Pl-DN-R1",
+            "HM-LC-Sw1PBU-FM",
+            "HM-LC-Sw2-FM",
+            "HM-LC-Sw4-DR",
+            "HM-SwI-3-FM",
+        }
+    ),
+    Parameter.LOW_BAT: frozenset({"HmIP-BWTH", "HmIP-PCBS"}),
+    Parameter.OPERATING_VOLTAGE: frozenset(
+        {
+            "ELV-SH-BS2",
+            "HmIP-BDT",
+            "HmIP-BROLL",
+            "HmIP-BS2",
+            "HmIP-BSL",
+            "HmIP-BSM",
+            "HmIP-BWTH",
+            "HmIP-DR",
+            "HmIP-FDT",
+            "HmIP-FROLL",
+            "HmIP-FSM",
+            "HmIP-MOD-OC8",
+            "HmIP-PCBS",
+            "HmIP-PDT",
+            "HmIP-PMFS",
+            "HmIP-PS",
+            "HmIP-SFD",
+            "HmIP-SMO230",
+            "HmIP-WGT",
+        }
+    ),
+    Parameter.VALVE_STATE: frozenset({"HmIP-FALMOT-C8", "HmIPW-FALMOT-C12", "HmIP-FALMOT-C12"}),
+}
+
+IGNORE_PARAMETERS_BY_DEVICE_LOWER: Final[dict[ParameterName, frozenset[ModelName]]] = {
+    parameter: frozenset(model.lower() for model in s) for parameter, s in IGNORE_PARAMETERS_BY_DEVICE.items()
+}
+
+# =============================================================================
+# Channel-Specific Parameter Rules
+# =============================================================================
+# Some devices have parameters on multiple channels, but we want to use it only
+# from a certain channel.
+
+ACCEPT_PARAMETER_ONLY_ON_CHANNEL: Final[Mapping[ParameterName, int]] = {
+    Parameter.LOWBAT: 0,
+}

aiohomematic/strings.json

@@ -0,0 +1,237 @@
+{
+  "exception.central.create_devices.no_clients": "CREATE_DEVICES failed: No clients initialized. Not starting central {name}.",
+  "exception.central.decorators.backend_system_handler.args_exception": "ARGS-EXCEPTION backend_system_handler [{reason}]",
+  "exception.central.decorators.backend_system_handler.identify_central_failed": "EXEC_BACKEND_SYSTEM_CALLBACK failed: Problem with identifying central: {reason}",
+  "exception.central.decorators.event_handler.args_exception": "ARGS-EXCEPTION event_handler [{reason}]",
+  "exception.central.get_client.interface_missing": "GET_CLIENT failed: Missing client for interface_id {interface_id} on central {name}",
+  "exception.central.get_client.interface_type_missing": "GET_CLIENT failed: Missing client for interface {interface} on central {name}",
+  "exception.central.get_client.no_parameter": "GET_CLIENT failed: Either interface_id or interface must be provided on central {name}",
+  "exception.central.rpc_server.invalid_xml": "Invalid XML: {error}",
+  "exception.central.rpc_server.parse_error": "Parse error: {error}",
+  "exception.central.start.failed": "Failed to start central unit {name}: {reason}",
+  "exception.central.validate_config.no_clients": "VALIDATE_CONFIG: No clients defined.",
+  "exception.client.add_link.failed": "ADD_LINK failed for {sender}/{receiver}/{name}/{description}: {reason}",
+  "exception.client.client_config.no_connection": "No connection to {interface_id}",
+  "exception.client.client_config.unable_to_connect": "Unable to connect {reason}",
+  "exception.client.get_all_device_data.failed": "GET_ALL_DEVICE_DATA failed: Unable to fetch device data for interface {interface}",
+  "exception.client.get_install_mode.failed": "GET_INSTALL_MODE failed for {interface_id}: {reason}",
+  "exception.client.get_link_peers.failed": "GET_LINK_PEERS failed for {address}: {reason}",
+  "exception.client.get_links.failed": "GET_LINKS failed for {address}: {reason}",
+  "exception.client.get_metadata.failed": "GET_METADATA failed for {address}/{data_id}: {reason}",
+  "exception.client.get_paramset.failed": "GET_PARAMSET failed for {address}/{paramset_key}: {reason}",
+  "exception.client.get_value.failed": "GET_VALUE failed for {channel_address}/{parameter}/{paramset_key}: {reason}",
+  "exception.client.interface_config.port_required": "VALIDATE interface config failed: Port must defined for interface {interface}",
+  "exception.client.json_ccu.get_paramset.failed": "GET_PARAMSET failed for {address}/{paramset_key}: {reason}",
+  "exception.client.json_ccu.get_value.failed": "GET_VALUE failed for: {channel_address}/{parameter}/{paramset_key}: {reason}",
+  "exception.client.json_ccu.set_value.unknown_type": "SET_VALUE failed: Unable to identify parameter type {channel_address}/{paramset_key}/{parameter}",
+  "exception.client.json_post.connector_certificate_error": "Connector certificate error: {reason}",
+  "exception.client.json_post.connector_error": "Connector error: {reason}",
+  "exception.client.json_post.http_status": "HTTP status: {status}",
+  "exception.client.json_post.login_failed": "Error while logging in",
+  "exception.client.json_post.method_unsupported": "POST: method '{method} not supported by the backend.",
+  "exception.client.json_post.no_credentials": "No credentials set",
+  "exception.client.json_post.no_response": "POST method failed with no response",
+  "exception.client.json_post.no_session": "ClientSession not initialized",
+  "exception.client.json_rpc.circuit_open": "Circuit breaker is open for {url} - requests temporarily blocked",
+  "exception.client.parameter.not_found": "Parameter {parameter} could not be found: {interface_id}/{channel_address}/{paramset_key}",
+  "exception.client.parameter.operation_unsupported": "Parameter {parameter} does not support the requested operation {operation}",
+  "exception.client.parameter.value_above_max": "Value {value} for parameter {parameter} exceeds maximum {max_value}",
+  "exception.client.parameter.value_below_min": "Value {value} for parameter {parameter} is below minimum {min_value}",
+  "exception.client.paramset_key.invalid": "Parameter paramset_key is neither a valid ParamsetKey nor a channel address.",
+  "exception.client.put_paramset.failed": "PUT_PARAMSET failed for {channel_address}/{paramset_key}/{values}: {reason}",
+  "exception.client.remove_link.failed": "REMOVE_LINK failed for {sender}/{receiver}: {reason}",
+  "exception.client.report_value_usage.failed": "REPORT_VALUE_USAGE failed: {address}/{value_id}/{ref_counter}: {reason}",
+  "exception.client.rx_mode.unsupported": "Unsupported rx_mode: {rx_mode}",
+  "exception.client.script.missing": "Script file for {script} does not exist",
+  "exception.client.set_install_mode.failed": "SET_INSTALL_MODE failed for {interface_id}: {reason}",
+  "exception.client.set_metadata.failed": "SET_METADATA failed for {address}/{data_id}/{value}: {reason}",
+  "exception.client.set_value.failed": "SET_VALUE failed for {channel_address}/{parameter}={value}: {reason}",
+  "exception.client.update_device_firmware.failed": "UPDATE_DEVICE_FIRMWARE failed: {reason}",
+  "exception.client.xmlrpc.circuit_open": "Circuit breaker is open for {interface_id} - requests temporarily blocked",
+  "exception.client.xmlrpc.http_connection_state_error": "HTTP connection state error on {interface_id}: {reason}",
+  "exception.client.xmlrpc.method_unsupported": "XmlRPC.__ASYNC_REQUEST: method '{method} not supported by the backend.",
+  "exception.client.xmlrpc.no_connection": "No connection to {interface_id}",
+  "exception.client.xmlrpc.no_connection_with_reason": "No connection to {context}: {reason}",
+  "exception.client.xmlrpc.null_proxy_unsupported": "XML-RPC not supported on {interface_id} - use JSON-RPC methods instead",
+  "exception.client.xmlrpc.os_error": "OSError on {interface_id}: {reason}",
+  "exception.client.xmlrpc.ssl_error": "SSLError on {interface_id}: {reason}",
+  "exception.config.check.callback_host.invalid": "Invalid callback hostname or ipv4 address",
+  "exception.config.check.callback_port_xml_rpc.invalid": "Invalid xml rpc callback port",
+  "exception.config.check.host.invalid": "Invalid hostname or ipv4 address",
+  "exception.config.check.instance_name.separator": "Instance name must not contain {sep}",
+  "exception.config.check.json_port.invalid": "Invalid json port",
+  "exception.config.check.password.invalid": "Password is not valid",
+  "exception.config.check.password.required": "Password is required",
+  "exception.config.check.primary_interface.missing": "No primary interface ({interfaces}) defined",
+  "exception.config.check.username.empty": "Username must not be empty",
+  "exception.config.invalid": "Invalid configuration: {failures}",
+  "exception.create_central.failed": "Not able to create a central: {reason}",
+  "exception.model.action_select.value_not_in_value_list": "ACTION_SELECT {name} (unique_id={unique_id}): Value not in value list",
+  "exception.model.custom.climate.set_temperature.invalid": "SET_TEMPERATURE failed: Invalid temperature: {temperature} (min: {min}, max: {max})",
+  "exception.model.custom.definition.create_custom_data_point.failed": "_CREATE_CUSTOM_DATA_POINT: unable to create custom data point: {reason}",
+  "exception.model.custom.light.invalid_brightness": "Invalid brightness specified for data_point {full_name}: {value}. Must be 0.0-1.0.",
+  "exception.model.custom.light.invalid_color": "Invalid color specified for data_point {full_name}: {value}",
+  "exception.model.custom.light.invalid_duration_unit": "Invalid duration unit specified for data_point {full_name}: {value}",
+  "exception.model.custom.light.invalid_on_time": "Invalid on time specified for data_point {full_name}: {value}",
+  "exception.model.custom.light.invalid_repetitions": "Invalid repetitions specified for data_point {full_name}: {value}",
+  "exception.model.custom.siren.invalid_duration_unit": "Invalid duration unit specified for data_point {full_name}: {value}",
+  "exception.model.custom.siren.invalid_light": "Invalid light specified for data_point {full_name}: {value}",
+  "exception.model.custom.siren.invalid_repetitions": "Invalid repetitions specified for data_point {full_name}: {value}",
+  "exception.model.custom.siren.invalid_soundfile": "Invalid soundfile specified for data_point {full_name}: {value}",
+  "exception.model.custom.siren.invalid_soundfile_index": "Soundfile index must be 1-189, got {index}",
+  "exception.model.custom.siren.invalid_tone": "Invalid tone specified for data_point {full_name}: {value}",
+  "exception.model.custom.siren.invalid_volume": "Invalid volume specified for data_point {full_name}: {value}. Must be 0.0-1.0.",
+  "exception.model.custom.text_display.invalid_alignment": "Invalid alignment specified for data_point {full_name}: {value}",
+  "exception.model.custom.text_display.invalid_background_color": "Invalid background color specified for data_point {full_name}: {value}",
+  "exception.model.custom.text_display.invalid_display_id": "Invalid display ID specified for data_point {full_name}: {value}. Must be 1-5.",
+  "exception.model.custom.text_display.invalid_icon": "Invalid icon specified for data_point {full_name}: {value}",
+  "exception.model.custom.text_display.invalid_interval": "Invalid interval specified for data_point {full_name}: {value}. Must be 1-15.",
+  "exception.model.custom.text_display.invalid_repeat": "Invalid repeat count specified for data_point {full_name}: {value}. Must be 0-15.",
+  "exception.model.custom.text_display.invalid_sound": "Invalid sound specified for data_point {full_name}: {value}",
+  "exception.model.custom.text_display.invalid_text_color": "Invalid text color specified for data_point {full_name}: {value}",
+  "exception.model.data_point.subscribe_handler.already_registered": "REGISTER_DATA_POINT_UPDATED_CALLBACK failed: hm_data_point: {full_name} is already registered by {custom_id}",
+  "exception.model.device.export_device_definition.failed": "EXPORT_DEVICE_DEFINITION failed: {reason}",
+  "exception.model.event.create_event.failed": "CREATE_EVENT_AND_APPEND_TO_CHANNEL: Unable to create event: {reason}",
+  "exception.model.generic.create_data_point.failed": "CREATE_DATA_POINT_AND_APPEND_TO_CHANNEL: Unable to create data_point: {reason}",
+  "exception.model.hub.number.invalid_value": "SYSVAR.NUMBER failed: Invalid value: {value} (min: {min}, max: {max})",
+  "exception.model.number.invalid_value": "NUMBER failed: Invalid value: {value} (min: {min}, max: {max}, special:{special})",
+  "exception.model.select.value_not_in_value_list": "Value not in value_list for {name}/{unique_id}",
+  "exception.model.week_profile.copy_schedule.profile_count_mismatch": "Copy schedule profile is only: No of schedule profile must be identical",
+  "exception.model.week_profile.copy_schedule.same_device_invalid": "Copy schedule profile on same device is only possible with defined and different source/target profiles",
+  "exception.model.week_profile.schedule.unsupported": "Schedule is not supported by device {name}",
+  "exception.model.week_profile.source_profile.not_loaded": "Source profile {source_profile} could not be loaded.",
+  "exception.model.week_profile.validate.base_temperature_out_of_range": "VALIDATE_PROFILE: Base temperature {base_temperature} not in valid range (min: {min}, max: {max})",
+  "exception.model.week_profile.validate.endtime_missing": "VALIDATE_PROFILE: ENDTIME is missing.",
+  "exception.model.week_profile.validate.overlap": "VALIDATE_PROFILE: Timespans are overlapping with a previous slot for start time: {start} / end time: {end}",
+  "exception.model.week_profile.validate.profile_name_invalid": "Not a valid profile name: {profile_name}",
+  "exception.model.week_profile.validate.sequence_rising": "VALIDATE_PROFILE: Time sequence must be rising. {time} is lower than the previous value {previous} for profile: {profile} / week day: {weekday} / slot no: {no}",
+  "exception.model.week_profile.validate.slot_missing": "VALIDATE_PROFILE: slot no {no} is missing in profile: {profile} / week day: {weekday}",
+  "exception.model.week_profile.validate.slot_type_missing": "VALIDATE_PROFILE: slot type {slot_type} is missing in profile: {profile} / week day: {weekday} / slot no: {no}",
+  "exception.model.week_profile.validate.start_before_end": "VALIDATE_PROFILE: Start time {start} must be lower than end time {end}",
+  "exception.model.week_profile.validate.starttime_missing": "VALIDATE_PROFILE: STARTTIME is missing.",
+  "exception.model.week_profile.validate.temperature_missing": "VALIDATE_PROFILE: TEMPERATURE is missing.",
+  "exception.model.week_profile.validate.temperature_out_of_range_for_profile_slot": "VALIDATE_PROFILE: Temperature {temperature} not in valid range (min: {min}, max: {max}) for profile: {profile} / week day: {weekday} / slot no: {no}",
+  "exception.model.week_profile.validate.temperature_out_of_range_for_times": "VALIDATE_PROFILE: Temperature {temperature} not in valid range (min: {min}, max: {max}) for start time: {start} / end time: {end}",
+  "exception.model.week_profile.validate.time_convert_failed": "Failed to convert time {time}. Format must be hh:mm.",
+  "exception.model.week_profile.validate.time_invalid_format": "Time {time} is not valid. Format must be hh:mm with min: {min} and max: {max}",
+  "exception.model.week_profile.validate.time_out_of_bounds_profile_slot": "VALIDATE_PROFILE: Time {time} must be between {min_time} and {max_time} for profile: {profile} / week day: {weekday} / slot no: {no}",
+  "exception.model.week_profile.validate.too_few_slots": "VALIDATE_PROFILE: Too few slots in profile: {profile} / week day: {weekday}",
+  "exception.model.week_profile.validate.too_many_slots": "VALIDATE_PROFILE: Too many slots in profile: {profile} / week day: {weekday}",
+  "exception.startup.validation_failed": "AioHomematic startup validation failed: {reason}",
+  "exception.store.device_description.not_found": "Description not found for {address} on interface {interface_id}",
+  "exception.store.session_recorder.ttl_positive": "default_ttl_seconds must be positive",
+  "exception.support.boolean.invalid_type": "Invalid literal for boolean. Not a string.",
+  "exception.support.check_or_create_directory.failed": "Unable to create directory {directory}: {reason}",
+  "exception.support.get_local_ip.resolve_failed": "Can't resolve host for {host}:{port}: {reason}",
+  "exception.support.host_empty": "Host cannot be empty",
+  "exception.support.host_invalid": "Invalid host format: {host}. Must be a valid hostname or IP address",
+  "exception.validator.categories.not_exhaustive": "BLOCKED_CATEGORIES/CATEGORIES/HUB_CATEGORIES are not exhaustive. Missing categories: {missing}",
+  "exception.validator.channel_address.invalid": "CHANNEL_ADDRESS is invalid",
+  "exception.validator.custom_definition.invalid": "Custom data point definition schema is invalid",
+  "exception.validator.device_address.invalid": "DEVICE_ADDRESS is invalid",
+  "exception.validator.hostname.invalid": "Hostname is invalid",
+  "exception.validator.ipv4_address.invalid": "IPv4_address is invalid",
+  "exception.validator.paramset_key.invalid": "PARAMSET_KEY is invalid",
+  "exception.validator.password.invalid": "Password is invalid",
+  "exception.validator.undefined_in_lists": "DataPointCategory.UNDEFINED must not be present in BLOCKED_CATEGORIES/CATEGORIES/HUB_CATEGORIES",
+  "issue.fetch_data_failed": "Failed to fetch device data from interface {interface_id}",
+  "issue.ping_pong_mismatch": "Ping-pong mismatch detected on {interface_id} ({mismatch_type}: {mismatch_count} mismatches)",
+  "log.backend_detection.detect_backend.backend_type": "DETECT_BACKEND: Detected backend type: {backend}",
+  "log.backend_detection.detect_backend.found_interfaces": "DETECT_BACKEND: Found interfaces via JSON-RPC: {interfaces}",
+  "log.backend_detection.detect_backend.found_version": "DETECT_BACKEND: Found version '{version}' on port {port}",
+  "log.backend_detection.detect_backend.json_rpc_fallback": "DETECT_BACKEND: JSON-RPC query failed, using detected interface",
+  "log.backend_detection.detect_backend.no_backend_found": "DETECT_BACKEND: No backend found on host {host}",
+  "log.backend_detection.detect_backend.probing": "DETECT_BACKEND: Probing {host}:{port} (TLS={tls}, interface={interface})",
+  "log.backend_detection.detect_backend.starting": "DETECT_BACKEND: Starting detection for host {host} (timeout={total_timeout}s)",
+  "log.backend_detection.detect_backend.total_timeout": "DETECT_BACKEND: Detection timed out after {total_timeout}s for host {host}",
+  "log.backend_detection.json_rpc.auth_failed": "DETECT_BACKEND: Authentication failed at {url}",
+  "log.backend_detection.json_rpc.connection_failed": "DETECT_BACKEND: Connection failed at {url}",
+  "log.backend_detection.json_rpc.interface_not_present": "DETECT_BACKEND: Interface '{interface}' is installed but not running - skipping",
+  "log.backend_detection.json_rpc.interface_present": "DETECT_BACKEND: Interface '{interface}' is present and running",
+  "log.backend_detection.json_rpc.is_present_failed": "DETECT_BACKEND: Failed to check if interface '{interface}' is present: {reason}",
+  "log.backend_detection.json_rpc.query_failed": "DETECT_BACKEND: JSON-RPC query failed at {url} - {exc_type}: {reason}",
+  "log.backend_detection.json_rpc.querying": "DETECT_BACKEND: Querying JSON-RPC at {url}",
+  "log.backend_detection.json_rpc.unknown_interface": "DETECT_BACKEND: Unknown interface '{interface}', skipping",
+  "log.backend_detection.xml_rpc.probe_error": "DETECT_BACKEND: XML-RPC probe error for {host}:{port} - {exc_type}: {reason}",
+  "log.backend_detection.xml_rpc.probe_failed": "DETECT_BACKEND: XML-RPC probe failed for {host}:{port} - {exc_type}: {reason}",
+  "log.backend_detection.xml_rpc.probe_timeout": "DETECT_BACKEND: XML-RPC probe timeout for {host}:{port}",
+  "log.central.accept_device_in_inbox.no_client": "ACCEPT_DEVICE_IN_INBOX failed: No primary client available for {device_address} on {name}",
+  "log.central.create_client.no_connection": "CREATE_CLIENT failed: No connection to interface {interface_id} [{reason}]",
+  "log.central.create_clients.already_created": "CREATE_CLIENTS: Clients for {name} are already created",
+  "log.central.create_clients.created_count_failed": "CREATE_CLIENTS failed: Created {created} of {total} clients",
+  "log.central.create_clients.interface_not_available": "CREATE_CLIENTS failed: Interface: {interface} is not available for the backend {name}",
+  "log.central.create_clients.no_interfaces": "CREATE_CLIENTS failed: No interfaces for {name} defined",
+  "log.central.create_clients.no_primary_identified": "CREATE_CLIENTS failed: No primary client identified for {name}",
+  "log.central.rename_device.not_found": "RENAME_DEVICE failed: Device {device_address} not found on {name}",
+  "log.central.restart_clients.restarted": "RESTART_CLIENTS: Central {name} restarted clients",
+  "log.central.rpc_server.background_task_failed": "Background task {task_name} failed: {error}",
+  "log.central.rpc_server.error": "ERROR failed: interface_id = {interface_id}, error_code = {error_code}, message = {msg}",
+  "log.central.rpc_server.method_failed": "XML-RPC method {method_name} failed",
+  "log.central.rpc_server.protocol_error": "XML-RPC protocol error: {error}",
+  "log.central.rpc_server.unexpected_error": "Unexpected error handling XML-RPC request",
+  "log.central.scheduler.check_connection.attempting_reconnect": "CHECK_CONNECTION: RPC stable for {name} - attempting full reconnection",
+  "log.central.scheduler.check_connection.connection_loss_detected": "CHECK_CONNECTION: Connection loss detected for {name} - starting staged reconnection",
+  "log.central.scheduler.check_connection.failed": "CHECK_CONNECTION failed: {exc_type} [{reason}]",
+  "log.central.scheduler.check_connection.no_clients": "CHECK_CONNECTION failed: No clients exist. Trying to create clients for server {name}",
+  "log.central.scheduler.check_connection.no_connection": "CHECK_CONNECTION failed: no connection: {reason}",
+  "log.central.scheduler.check_connection.reconnect_failed": "CHECK_CONNECTION: Reconnection failed for {name} - will retry",
+  "log.central.scheduler.check_connection.reconnect_success": "CHECK_CONNECTION: Reconnection successful for {name} - interfaces: {interfaces}",
+  "log.central.scheduler.check_connection.rpc_check_passed": "CHECK_CONNECTION: First RPC check passed for {name} - starting warmup",
+  "log.central.scheduler.check_connection.rpc_stable": "CHECK_CONNECTION: Second RPC check passed for {name} - services stable",
+  "log.central.scheduler.check_connection.rpc_unstable": "CHECK_CONNECTION: RPC became unavailable during warmup for {name} - retrying",
+  "log.central.scheduler.check_connection.tcp_check_timeout": "CHECK_CONNECTION: TCP port check timeout ({timeout}s) for {name} - restarting check",
+  "log.central.scheduler.check_connection.tcp_port_available": "CHECK_CONNECTION: TCP port {host}:{port} available for {name}",
+  "log.central.set_system_variable.not_found": "SET_SYSTEM_VARIABLE failed: Variable {legacy_name} not found on {name}",
+  "log.central.validate_config_and_get_system_information.client_failed": "VALIDATE_CONFIG_AND_GET_SYSTEM_INFORMATION failed for client {interface}: {reason}",
+  "log.client.circuit_breaker.state_transition": "CIRCUIT_BREAKER: {old_state} → {new_state} for {interface_id} (failures={failure_count}, successes={success_count})",
+  "log.client.create_backup_and_download.completed": "CREATE_BACKUP_AND_DOWNLOAD: Backup completed: {filename} ({size} bytes)",
+  "log.client.create_backup_and_download.failed": "CREATE_BACKUP_AND_DOWNLOAD: Backup creation failed",
+  "log.client.create_backup_and_download.idle": "CREATE_BACKUP_AND_DOWNLOAD: Unexpected idle status during backup",
+  "log.client.create_backup_and_download.running": "CREATE_BACKUP_AND_DOWNLOAD: Backup still running ({elapsed:.1f}s elapsed)",
+  "log.client.create_backup_and_download.timeout": "CREATE_BACKUP_AND_DOWNLOAD: Backup timed out after {max_wait_time:.1f}s",
+  "log.client.is_callback_alive.no_events": "IS_CALLBACK_ALIVE: Callback for {interface_id} has not received events for {seconds}s",
+  "log.client.json_rpc.accept_device_in_inbox.failed": "ACCEPT_DEVICE_IN_INBOX for {device_address} failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.create_backup_start.failed": "CREATE_BACKUP_START failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.create_backup_status.failed": "CREATE_BACKUP_STATUS failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.do_login.max_attempts_reached": "DO_LOGIN failed: Max failed login attempts ({max_attempts}) reached. Consider checking credentials.",
+  "log.client.json_rpc.do_login.no_credentials": "DO_LOGIN failed: No credentials set",
+  "log.client.json_rpc.do_login.rate_limited": "DO_LOGIN: Rate limited after {attempts} failed attempts. Waiting {wait_time:.1f} seconds.",
+  "log.client.json_rpc.download_backup.error": "DOWNLOAD_BACKUP failed: {reason}",
+  "log.client.json_rpc.download_backup.failed": "DOWNLOAD_BACKUP failed: HTTP status {status}",
+  "log.client.json_rpc.download_backup.no_session": "DOWNLOAD_BACKUP failed: No session ID available",
+  "log.client.json_rpc.download_firmware.error": "DOWNLOAD_FIRMWARE failed: {reason}",
+  "log.client.json_rpc.download_firmware.failed": "DOWNLOAD_FIRMWARE failed: HTTP status {status}",
+  "log.client.json_rpc.download_firmware.no_session": "DOWNLOAD_FIRMWARE failed: No session ID available",
+  "log.client.json_rpc.get_all_system_variables.parse_failed": "GET_ALL_SYSTEM_VARIABLES failed: {exc_type} [{reason}] Failed to parse SysVar {legacy_name}",
+  "log.client.json_rpc.get_backend_info.failed": "GET_BACKEND_INFO failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.get_inbox_devices.decode_failed": "GET_INBOX_DEVICES failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.get_program_descriptions.decode_failed": "GET_PROGRAM_DESCRIPTIONS failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.get_service_messages.decode_failed": "GET_SERVICE_MESSAGES failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.get_system_update_info.decode_failed": "GET_SYSTEM_UPDATE_INFO failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.get_system_variable_descriptions.decode_failed": "GET_SYSTEM_VARIABLE_DESCRIPTIONS failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.rename_channel.failed": "RENAME_CHANNEL for {channel_address} failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.rename_device.failed": "RENAME_DEVICE for {device_address} failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.set_system_variable.value_contains_html": "SET_SYSTEM_VARIABLE: Value ({value}) contains html tags. These are filtered out when writing.",
+  "log.client.json_rpc.trigger_firmware_update.failed": "TRIGGER_FIRMWARE_UPDATE failed: Unable to decode json: {reason}",
+  "log.client.json_rpc.trigger_firmware_update.not_triggered": "TRIGGER_FIRMWARE_UPDATE: {message}",
+  "log.client.json_rpc.trigger_firmware_update.success": "TRIGGER_FIRMWARE_UPDATE: {message}",
+  "log.client.reconnect.reconnected": "RECONNECT: re-connected client {interface_id}",
+  "log.client.update_device_firmware.result": "UPDATE_DEVICE_FIRMWARE: Executed firmware update for {device_address} with result '{result}'",
+  "log.client.update_device_firmware.try": "UPDATE_DEVICE_FIRMWARE: Trying firmware update for {device_address}",
+  "log.core.signal.shutdown": "Got signal: {sig}. Shutting down central",
+  "log.metrics.observer.counter_key_limit": "METRICS OBSERVER: Counter key limit reached, dropping: {metric_key}",
+  "log.metrics.observer.gauge_key_limit": "METRICS OBSERVER: Gauge key limit reached, dropping: {metric_key}",
+  "log.metrics.observer.latency_key_limit": "METRICS OBSERVER: Latency key limit reached, dropping: {metric_key}",
+  "log.model.custom.definition.validate_failed": "The custom data point definition could not be validated. {path}, {msg}",
+  "log.model.custom.text_display.send_text.burst_limit_warning": "SEND_TEXT: {full_name}: Burst limit warning active - command may be rate-limited",
+  "log.model.device.channel_description_not_found": "INIT_DEVICE: Skipping channel {address} - description could not be retrieved from CCU",
+  "log.model.generic_data_point.send_value.not_writable": "SEND_VALUE: writing to non-writable data_point {full_name} is not possible",
+  "log.model.hub.update.progress_completed": "Hub firmware update completed: {old_version} -> {new_version}",
+  "log.model.hub.update.progress_poll_error": "Error polling update status (CCU may be rebooting): {error}",
+  "log.model.hub.update.progress_timeout": "Hub firmware update monitoring timed out after {timeout}s",
+  "log.store.dynamic.pending_pong_mismatch": "Pending PONG mismatch: There is a mismatch between send ping events and received pong events for instance {interface_id}. Possible reason 1: You are running multiple instances with the same instance name configured for this integration. Re-add one instance! Otherwise this instance will not receive update events from your CCU. Possible reason 2: Something is stuck on the CCU or hasn't been cleaned up. Therefore, try a CCU restart. Possible reason 3: Your setup is misconfigured and this instance is not able to receive events from the CCU.",
+  "log.store.dynamic.unknown_pong_mismatch": "Unknown PONG Mismatch: Your instance {interface_id} receives PONG events, that it hasn't send. Possible reason 1: You are running multiple instances with the same instance name configured for this integration. Re-add one instance! Otherwise the other instance will not receive update events from your CCU. Possible reason 2: Something is stuck on the CCU or hasn't been cleaned up. Therefore, try a CCU restart.",
+  "log.store.session_recorder.activate.already_running": "ACTIVATE: Recording session is already running.",
+  "log.store.session_recorder.deactivate.already_running": "DEACTIVATE: Recording session is already running.",
+  "log.support.check_password.invalid_chars": "CHECK_CONFIG: password contains not allowed characters. Use only allowed characters. See password regex: {pattern}"
+}