Device Configuration Panel¶

The Homematic Device Configuration Panel is a sidebar panel in Home Assistant for editing device parameters, managing direct links between devices, and configuring schedules — directly from the Home Assistant UI.

The configuration panel is only visible to Home Assistant admin users. Non-admin users can edit device schedules via the Climate Schedule Card and Schedule Card when enabled in the integration options (see Schedule Editing for Non-Admin Users).

Panel Availability¶

The device configuration panel is enabled by default and appears in the Home Assistant sidebar as HM Device Configuration (or HM Gerätekonfiguration in German) once the integration is loaded.

Disabling the Panel¶

If you want to hide the panel from the sidebar:

1. Go to Settings → Devices & Services
2. Find Homematic(IP) Local for OpenCCU and click Configure
3. Select Advanced Options
4. Enable Disable device configuration panel
5. Click Submit

Panel Structure¶

The panel is organized into three main tabs:

Devices Tab¶

Device List¶

The device list shows all configurable devices grouped by their RF interface (HmIP-RF, BidCos-RF, BidCos-Wired). Use the search bar to filter by name, address, or model.

Each device entry displays:

Status icons indicate the device's current state:

An interface is the radio protocol used by the device. HmIP-RF is used by modern HomematicIP devices, BidCos-RF by classic Homematic devices, and BidCos-Wired by wired devices. The interface determines how the CCU communicates with the device.

Click on a device to open the Device Detail view.

Device Detail¶

The device detail view shows all information about a single device and provides access to its channels.

Device information:

Available actions:

• Direct Links — Manage peer-to-peer connections to other devices (more info)
• Schedules — Edit time-based automation schedules (more info)
• Change History — View a log of past configuration changes (more info)

Channels¶

A device consists of one or more channels. Each channel represents a distinct function of the device — for example, a two-button switch has separate channels for each button.

Each channel shows its type (e.g. SWITCH, DIMMER, CLIMATECONTROL_REGULATOR) and offers Configure, Export, and Import buttons.

Maintenance Channel¶

Channel 0 is a special maintenance channel present on every device. It shows:

Editing Parameters¶

The parameter editor provides a form-based interface for editing device configuration values (MASTER paramset).

Workflow¶

1. Select a device from the device list
2. Choose a channel to configure
3. The panel auto-generates a form with appropriate controls:
4. Sliders for numeric parameters (e.g. temperature offset)
5. Toggles for boolean parameters (e.g. button lock)
6. Dropdowns for enum parameters (e.g. display mode)
7. Presets for common value combinations (e.g. time intervals)
8. Adjust values as needed
9. Click Save to write changes to the device via the CCU

Writing to device MASTER parameters uses the device's internal storage. Excessive writes can degrade the device's EEPROM. The panel is designed for configuration changes, not for frequent state updates.

What is a Paramset?¶

A paramset is a collection of configuration parameters stored on the device. The MASTER paramset contains device settings that persist across restarts — for example, the temperature offset of a thermostat or the LED brightness of a switch. These are not runtime values (like the current temperature), but configuration values that change the device's behavior.

Session Management¶

Changes are tracked in an in-memory session with undo/redo support:

• Undo: Revert the last parameter change
• Redo: Re-apply a reverted change
• Reset to Defaults: Restore factory default values for all parameters
• Discard: Discard all pending changes without writing
• Save: Opens a confirmation dialog showing all changes (old → new values) before applying

Easymode¶

The panel uses Easymode to simplify the parameter editor:

• Conditional visibility: Some parameters are only shown when relevant (e.g. a threshold parameter only appears when the related feature is enabled)
• Preset dropdowns: Common value combinations are offered as a dropdown (e.g. selecting a "Staircase light" mode applies multiple parameters at once)
• Grouped parameters: Related parameters are combined into a single control

These simplifications match the behavior of the CCU WebUI — only parameters with human-readable names are shown.

Parameter Validation¶

The panel validates your changes in real-time:

• Range checks: Values must be within the allowed min/max range
• Cross-validation: Related parameters are checked together (e.g. maximum must be greater than minimum)
• Invalid fields are highlighted with an error message

Export / Import¶

Export¶

Export the current paramset configuration of a channel as a JSON file. This serves as a backup or as a template for other devices of the same model.

Import¶

Import a previously exported JSON configuration into a channel of the same device model. Only writable parameters that exist on the target channel are applied.

Direct Links¶

Direct links (also called peerings or Direktverknüpfungen) connect two device channels for direct peer-to-peer communication — without the CCU as intermediary.

A wall switch directly controls a light actuator. When you press the switch, the command goes directly to the light via radio — even if the CCU is offline.

Advantages of Direct Links¶

• Fast response: No detour through the CCU
• Reliable: Works even when the CCU is temporarily unavailable
• Configurable: Different behavior for short and long button presses

Browsing Links¶

Select a device to see all existing direct links grouped by channel. Each link shows:

• Direction: Whether the device is the sender or receiver
• Partner: The linked device, model, and channel
• Link name: Optional user-provided label

Creating Links¶

1. Click Add Link on a device
2. Select the channel on your device
3. Choose whether this device is the sender or receiver
4. Search and select the partner device and channel (only compatible channels are shown)
5. Optionally enter a link name
6. Confirm to create the link

Configuring Links¶

Click on an existing link to edit its parameters:

• Profile selection: Choose from predefined easymode profiles (e.g. "Dimmer on/off", "Staircase light", "Toggle") — each profile pre-configures parameters for a common use case
• Short/Long keypress tabs: Configure different behavior for short and long button presses
• Time parameters: Combined time selectors for delays and durations
• Level parameters: Percent sliders with "Last value" support (use the value that was last set)

Removing Links¶

Select a link and click Delete to remove the direct link from the CCU.

Schedules¶

The panel integrates schedule management for devices with week profile support.

Climate Schedules¶

For thermostat devices (e.g. HmIP-eTRV, HmIP-WTH):

• Visual weekly grid: Color-coded temperature blocks for each day of the week
• Profile selection: Switch between up to 6 schedule profiles (P1–P6)
• Active profile: Set which profile the thermostat actually follows
• Per-day editing: Click a day to add, move, or delete temperature blocks
• Copy/Paste: Copy a day's schedule to other days
• Undo/Redo: Revert or re-apply changes
• Import/Export: Save and restore schedules as JSON

A profile is a complete weekly schedule. Most thermostats support multiple profiles (e.g. "Normal", "Energy saving", "Holiday"). The active profile is the one the device currently follows. Selecting a different profile in the dropdown loads its data for viewing/editing and activates it on the device.

Device Schedules¶

For non-climate devices (switches, lights, covers, valves):

• Event list: Shows all scheduled events grouped by weekday
• Event editor: Configure each event with:
• Time: Fixed time (e.g. 06:00) or astronomical (relative to sunrise/sunset)
• Weekdays: Which days the event applies to
• Level: Target state (On/Off for switches, 0–100% for dimmers/covers)
• Duration: How long the action lasts (optional)
• Ramp time: Gradual transition time for lights (optional)
• Target channels: Which channels to control (for multi-channel devices)

For a more visual schedule editing experience, use the dedicated Lovelace cards:

- [Climate Schedule Card](climate_schedule_card.md) for thermostats
- [Schedule Card](schedule_card.md) for switches, lights, covers, and valves

Change History¶

The change history keeps a persistent log of all parameter changes made through the panel.

Each entry shows:

Click an entry to expand the details and see each parameter's old and new value.

The history is stored via Home Assistant's storage system with a 500-entry limit per config entry. When the limit is reached, the oldest entries are removed automatically.

The Clear History button permanently deletes all entries (with confirmation).

Integration Tab¶

The Integration dashboard monitors the health and performance of the Homematic(IP) Local integration.

System Health¶

Shows the current state of the integration:

Device Statistics¶

A quick overview of your device fleet:

Command Throttle¶

The command throttle is a protective mechanism that limits how fast commands are sent to the CCU.

Homematic devices communicate via radio. If too many commands are sent in quick succession, they can interfere with each other — causing missed commands or delayed responses. The throttle ensures commands are spaced out, especially during automations or scenes that control many devices at once.

Under normal operation, the queue is empty and "Throttled" shows "No". If the queue grows or throttling is active, it means many commands are being processed — this is expected during scenes or large automations.

Incidents¶

Incidents are logged communication events that occurred between the integration and the CCU or devices. These are not bugs and typically do not require any action from you.

An incident does not mean something is broken. It is a normal diagnostic log entry — similar to a flight recorder. Common incidents include:

- A device temporarily not responding (e.g. battery-powered device in sleep mode)
- A brief communication timeout during heavy radio traffic
- A device reconnecting after a power cycle

These events are automatically resolved and logged for informational purposes only. **Do not open a GitHub issue** because of incidents — they are expected behavior in a wireless environment.

If the incident list is empty, that's ideal — it means no communication irregularities were recorded.

The Clear Incidents button removes all logged incidents.

Cache Management¶

The integration caches device metadata (parameter descriptions, channel information) to speed up startup. If you suspect the cache is outdated (e.g. after a CCU firmware update), you can clear it:

• Clear Cache: Purges all cached device data. The integration will re-fetch everything from the CCU on the next restart.

Clearing the cache does not affect your device configurations or automations. It only forces the integration to re-read device metadata from the CCU.

OpenCCU Tab¶

The OpenCCU dashboard provides direct access to CCU system administration features. It is organized into sub-tabs.

System Information¶

Shows details about the connected CCU hardware:

Actions:

• Create Backup: Downloads a CCU configuration backup file. Shows progress and reports filename and size on completion.

Messages¶

The Messages sub-tab shows three categories of system notifications. A badge on the tab indicates the total number of active messages.

Inbox¶

New devices that have been detected but not yet accepted into the system. Click Accept to add a device — you'll be asked to confirm and optionally provide a name.

Service Messages¶

Service messages are system notifications from the CCU about device states that may need attention:

Each message shows the device name, address, message type, description, timestamp, and a counter (how often it occurred). Quittable messages can be acknowledged with the Acknowledge button.

Most service messages resolve themselves (e.g. a battery-powered device reconnects after waking up). The messages are informational — they don't necessarily require immediate action.

Alarm Messages¶

Alarm messages are critical notifications that indicate a condition requiring attention (e.g. sabotage detection, sensor errors). Each alarm shows:

• Device name and description
• Last trigger time
• Occurrence counter
• Acknowledge button to clear the alarm

Signal Quality¶

A sortable and filterable table showing the radio signal quality of all devices:

Use the filter bar (shown when more than 10 devices) to search by name/model or filter by interface, reachability, or battery status.

For more details, see [About RSSI values](../troubleshooting/rssi_fix.md).

Firmware¶

A sortable and filterable table showing firmware status for all devices:

Click Refresh Firmware Data to fetch the latest firmware information from the CCU.

Firmware updates are managed by the CCU, not by this integration. The panel shows the status for informational purposes. To perform updates, use the CCU WebUI or the device's own update mechanism.

Install Mode¶

Install mode puts the CCU into pairing mode, allowing new devices to join the network.

• Click Activate next to the desired interface (HmIP-RF or BidCos-RF)
• The CCU enters pairing mode for 60 seconds (a countdown is shown)
• Put your new device into pairing mode during this time (see the device's manual)
• Once paired, the device appears in the Inbox

Only interfaces that are actually configured in the integration are shown. If you don't see an interface, check your integration configuration.

Schedule Editing for Non-Admin Users¶

By default, only admin users can edit device schedules. You can allow non-admin household members to edit schedules via the schedule cards (Climate Schedule Card and Schedule Card).

Enabling¶

1. Go to Settings → Devices & Services
2. Find Homematic(IP) Local for OpenCCU and click Configure
3. Select Schedule editing
4. Enable Allow non-admin users to edit schedules
5. Click Submit

How it works¶

• Non-admin users can edit schedules through the Lovelace schedule cards
• The backend enforces permissions — if a non-admin user tries to edit a schedule without this option enabled, the card shows an "insufficient permissions" error
• All other operations (device configuration, direct links, system administration) remain admin-only
• Read operations (viewing schedules, device parameters) are always available to all authenticated users

The configuration panel itself remains admin-only. This setting only affects the schedule cards on dashboards.

Deep-Linking¶

Navigate directly to a specific device, channel, or link view via URL hash parameters. The panel supports browser back/forward navigation for seamless browsing.

Troubleshooting¶

Panel not visible in sidebar¶

1. Verify the panel is not disabled in Advanced Options
2. Confirm you are logged in as an admin user
3. Reload the browser (Ctrl+F5)

Parameters not saving¶

1. Check that the device is reachable (not UNREACH)
2. Check Home Assistant logs for XML-RPC errors
3. Wait for CONFIG_PENDING to clear on the device

Empty parameter list for a channel¶

• The channel may not have visible MASTER parameters
• Parameters without CCU translations are filtered out (matching CCU WebUI behavior)

See Also¶

• Week Profiles — Schedule data format and actions
• Climate Schedule Card — Visual thermostat schedule editor
• Schedule Card — Visual device schedule editor
• Status Cards — System health, device status, and messages cards
• Actions Reference — All available service actions
• About RSSI values — Understanding signal strength