Aiohomematic-config is a presentation-layer library for generating and managing configuration schemas for Homematic devices. It forms a core component of the Homematic(IP) Local Home Assistant integration, abstracting complex device parameter logic into a structured format suitable for user interfaces. The library is actively maintained with frequent releases, currently at version 2026.4.2.
pip install aiohomematic-configVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to instantiate the `FormSchemaGenerator` and use it to generate a configuration schema for a hypothetical Homematic device channel. It involves setting up a `CentralUnit` (mocked for simplicity here, but would connect to a real CCU/Homegear in practice) and then calling `generate` with device and channel details to get a structured `FormSchema` object.
Upgrade your Python environment to 3.14 or later. Ensure your deployment environment (e.g., Home Assistant OS) meets this requirement.
Always install the latest version of `aiohomematic` when upgrading `aiohomematic-config`, or ensure `pip` resolves to a compatible `aiohomematic` version (e.g., `pip install aiohomematic-config 'aiohomematic>=<REQUIRED_VERSION>'`).
Always provide the explicit version of `homematicip_local` (from Home Assistant's integrations page) and the specific library versions (`aiohomematic`, `aiohomematic-config`) when seeking support.
Review any custom code that directly interacts with channel types or profile lookups to ensure compatibility with the new alias resolution, especially for channels sharing profiles (e.g., `OPTICAL_SIGNAL_RECEIVER` aliasing to `DIMMER_VIRTUAL_RECEIVER`).
Update frontend or consuming logic to properly handle new fields like `cross_validation`, `parameter_groups`, `visible_when`, `presets`, `allow_custom_value`, `subset_group_id`, `SubsetOption`, `SubsetGroup` within the `FormSchema` and `FormParameter` models.