aiohomematic 2026.1.29__py3-none-any.whl

aiohomematic/translations/en.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}"
+}

aiohomematic/type_aliases.py

@@ -0,0 +1,51 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2021-2026
+"""
+Shared typing aliases for handlers and common callable shapes.
+
+This module centralizes `Callable[...]` type aliases to avoid repeating
+signatures across the code base and to satisfy mypy strict rules.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable, Coroutine, Mapping
+from typing import Any, TypeAlias
+
+ParamType = bool | int | float | str | None
+
+# Generic zero-argument handler that returns nothing
+ZeroArgHandler: TypeAlias = Callable[[], None]
+
+# Unsubscribe callback - used as return type for subscription methods
+# Single source of truth (formerly duplicated in api.py, central/__init__.py, event_bus.py)
+UnsubscribeCallback: TypeAlias = ZeroArgHandler
+
+# Device- and channel-scoped handlers
+DeviceRemovedHandler: TypeAlias = ZeroArgHandler
+DeviceUpdatedHandler: TypeAlias = ZeroArgHandler
+FirmwareUpdateHandler: TypeAlias = ZeroArgHandler
+LinkPeerChangedHandler: TypeAlias = ZeroArgHandler
+
+# Data point update handlers may accept various keyword arguments depending on
+# the data point type, hence we keep them variadic.
+DataPointUpdatedHandler: TypeAlias = Callable[..., None]
+
+# Common async/sync callable shapes
+# Factory that returns a coroutine that resolves to None
+AsyncTaskFactory: TypeAlias = Callable[[], Coroutine[Any, Any, None]]
+# Factory that returns a coroutine with arbitrary result type
+AsyncTaskFactoryAny: TypeAlias = Callable[[], Coroutine[Any, Any, Any]]
+# Coroutine with any send/throw types and arbitrary result
+CoroutineAny: TypeAlias = Coroutine[Any, Any, Any]
+# Generic sync callable that returns Any
+CallableAny: TypeAlias = Callable[..., Any]
+# Generic sync callable that returns None
+CallableNone: TypeAlias = Callable[..., None]
+
+# Service method callable and mapping used by DataPoints and decorators
+ServiceMethod: TypeAlias = Callable[..., Any]
+ServiceMethodMap: TypeAlias = Mapping[str, ServiceMethod]
+
+# Factory used by custom data point creation (make_ce_func)
+CustomDataPointFactory: TypeAlias = Callable[..., None]

aiohomematic/validator.py

@@ -0,0 +1,128 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2021-2026
+"""
+Validator functions used within aiohomematic.
+
+Public API of this module is defined by __all__.
+"""
+
+from __future__ import annotations
+
+import inspect
+
+import voluptuous as vol
+
+from aiohomematic import i18n
+from aiohomematic.const import BLOCKED_CATEGORIES, CATEGORIES, HUB_CATEGORIES, MAX_WAIT_FOR_CALLBACK, DataPointCategory
+from aiohomematic.support import (
+    check_password,
+    is_channel_address,
+    is_device_address,
+    is_host,
+    is_ipv4_address,
+    is_paramset_key,
+)
+
+channel_no: vol.All = vol.All(vol.Coerce(int), vol.Range(min=0, max=999))
+positive_int: vol.All = vol.All(vol.Coerce(int), vol.Range(min=0))
+wait_for: vol.All = vol.All(vol.Coerce(int), vol.Range(min=1, max=MAX_WAIT_FOR_CALLBACK))
+
+
+def channel_address(value: str, /) -> str:
+    """Validate channel_address."""
+    if is_channel_address(address=value):
+        return value
+    raise vol.Invalid(i18n.tr(key="exception.validator.channel_address.invalid"))
+
+
+def device_address(value: str, /) -> str:
+    """Validate channel_address."""
+    if is_device_address(address=value):
+        return value
+    raise vol.Invalid(i18n.tr(key="exception.validator.device_address.invalid"))
+
+
+def hostname(value: str, /) -> str:
+    """Validate hostname."""
+    if is_host(host=value):
+        return value
+    raise vol.Invalid(i18n.tr(key="exception.validator.hostname.invalid"))
+
+
+def ipv4_address(value: str, /) -> str:
+    """Validate ipv4_address."""
+    if is_ipv4_address(address=value):
+        return value
+    raise vol.Invalid(i18n.tr(key="exception.validator.ipv4_address.invalid"))
+
+
+def password(value: str, /) -> str:
+    """Validate password."""
+    if check_password(password=value):
+        return value
+    raise vol.Invalid(i18n.tr(key="exception.validator.password.invalid"))
+
+
+def paramset_key(value: str, /) -> str:
+    """Validate paramset_key."""
+    if is_paramset_key(paramset_key=value):
+        return value
+    raise vol.Invalid(i18n.tr(key="exception.validator.paramset_key.invalid"))
+
+
+def _channel_address_wrapper(value: str, /) -> str:
+    """Wrap channel_address for voluptuous callback."""
+    return channel_address(value)
+
+
+def _device_address_wrapper(value: str, /) -> str:
+    """Wrap device_address for voluptuous callback."""
+    return device_address(value)
+
+
+def _hostname_wrapper(value: str, /) -> str:
+    """Wrap hostname for voluptuous callback."""
+    return hostname(value)
+
+
+def _ipv4_address_wrapper(value: str, /) -> str:
+    """Wrap ipv4_address for voluptuous callback."""
+    return ipv4_address(value)
+
+
+address = vol.All(vol.Coerce(str), vol.Any(_device_address_wrapper, _channel_address_wrapper))
+host = vol.All(vol.Coerce(str), vol.Any(_hostname_wrapper, _ipv4_address_wrapper))
+
+
+def validate_startup() -> None:
+    """
+    Validate enum and mapping exhaustiveness at startup.
+
+    - Ensure DataPointCategory coverage: all categories except UNDEFINED must be present
+      in either HUB_CATEGORIES or CATEGORIES. UNDEFINED must not appear in those lists.
+    """
+    categories_in_lists = set(BLOCKED_CATEGORIES) | set(CATEGORIES) | set(HUB_CATEGORIES)
+    all_categories = set(DataPointCategory)
+    if DataPointCategory.UNDEFINED in categories_in_lists:
+        raise vol.Invalid(i18n.tr(key="exception.validator.undefined_in_lists"))
+
+    if missing := all_categories - {DataPointCategory.UNDEFINED} - categories_in_lists:
+        missing_str = ", ".join(sorted(c.value for c in missing))
+        raise vol.Invalid(
+            i18n.tr(
+                key="exception.validator.categories.not_exhaustive",
+                missing=missing_str,
+            )
+        )
+
+
+# Define public API for this module
+__all__ = tuple(
+    sorted(
+        name
+        for name, obj in globals().items()
+        if not name.startswith("_")
+        and (inspect.isfunction(obj) or inspect.isclass(obj))
+        and getattr(obj, "__module__", __name__) == __name__
+    )
+)