aiohomematic-config 2026.2.1

Presentation-layer library for Homematic device configuration UI.

aiohomematic-config

Presentation-layer library for Homematic device configuration UI.

Transforms Homematic device paramset descriptions into UI-optimized structures. No RPC knowledge, no CCU access -- operates purely on data structures from aiohomematic.

Installation

pip install aiohomematic-config

Quick Start

from aiohomematic_config import FormSchemaGenerator

generator = FormSchemaGenerator(locale="en")
schema = generator.generate(
    descriptions=descriptions,
    current_values=current_values,
    channel_type="HEATING_CLIMATECONTROL_TRANSCEIVER",
)
# schema is a Pydantic model, JSON-serializable
print(schema.model_dump_json(indent=2))

Key Components

Component	Purpose
FormSchemaGenerator	ParameterData + values -> JSON form schemas
ParameterGrouper	Flat parameter list -> grouped sections
LabelResolver	Technical parameter IDs -> human-readable labels
ConfigSession	Change tracking, undo/redo, dirty state
ConfigExporter	Serialize/deserialize device configurations
WidgetType mapping	ParameterType -> appropriate UI widget

License

MIT License - see LICENSE for details.