Homematic(IP) Local for OpenCCU

Advanced settings

• Callback host (optional)IP address for CCU callbacks. Leave empty for auto-detection.
• Callback port (optional)Port for XML-RPC callbacks. Leave empty for automatic assignment.
• Command retry attemptsMaximum number of retry attempts for transient command failures (timeout, device unreachable). Set to 0 to disable retry.
• Command throttle intervalMinimum delay between device commands in seconds. Set to 0 to disable throttling. Ensures smooth operation for large installations.
• Disable device configuration panelHide the device configuration panel from the sidebar.
• Enable system notificationsShow notifications for connection issues and device errors in Home Assistant.
• Restore last brightness for lightsWhen enabled, lights will turn on with the last non-zero brightness level instead of default 100%.
• Listen on all network interfacesEnable if Home Assistant runs in Docker or a VM. Required when HA's IP differs from the host IP.
• Enable MQTTRequired for CUxD and CCU-Jack device support. Requires MQTT broker connected to Home Assistant.
• MQTT prefixMQTT topic prefix configured in CCU-Jack. Leave empty if not using CCU-Jack MQTT bridge.
• Experimental featuresEnable experimental features to try out new functionality. These features may change or be removed in future versions.
• Program markersFilter programs by marker in description (HAHM, HX, INTERNAL). Leave empty to import all programs.
• Enable program importImport CCU programs as button entities to trigger them from Home Assistant.
• Create sub-device entitiesSplits devices with multiple channel groups into a main device with sub-devices. Entities are assigned to their corresponding sub-device based on channel group.
• System variable markersFilter system variables by marker in description (HAHM, HX, INTERNAL). Leave empty to import all variables.

CCU connection

• CCU hostname/IP address
• Integration instance nameUnique identifier for this Home Assistant installation. Allows multiple Home Assistant instances to connect to the same CCU simultaneously. Has no relation to the CCU hostname/IP. Do not change after setup — entities would be recreated.
• CCU passwordCase sensitive. Allowed characters: A-Z, a-z, 0-9 and .!$():;#-
• Skip automatic backend detectionEnable this option if you use non-standard ports or if backend detection hangs. You will manually configure interfaces and ports in the next step.
• CCU usernameCase sensitive. User must have administrator role

TLS and interface selection

• Enable Homematic (Bidcos-RF)
• Enable BidCos-Wired (HM-Wired)
• Enable CCU-Jack
• Configure custom portsEnable to configure non-standard ports on the next page. Otherwise, ports are automatically set based on TLS setting.
• Enable CUxD
• Enable Homematic IP
• Use TLS (encrypted connection)Enable TLS for encrypted communication with your CCU.
• Verify TLS certificateVerify the CCU's TLS certificate. Disable for self-signed certificates.
• Enable groups (heating groups)

Also asked when changing the connection.

OpenCCU-Loom daemon (Beta)

• Daemon hostname/IP address
• Integration instance name
• Daemon port (blank = 8119)Not used when connecting through an openccu-lite box: the box's web server port applies (443 with TLS, 80 without).
• Use TLS (HTTPS/WSS)Only when the daemon serves HTTPS (a certificate is configured in its north.rest.tls settings). Out of the box the daemon serves plain HTTP on 8119; with TLS on against it the connection fails. Through an openccu-lite box, TLS refers to the box's web server instead.
• Verify TLS certificate
• Create sub-device entitiesSplits devices with multiple channel groups into a main device with sub-devices. Entities are assigned to their corresponding sub-device based on channel group.

Port configuration

• HM-RF portStandard ports: 2001 (non-TLS), 42001 (TLS)
• BidCos-Wired portStandard ports: 2000 (non-TLS), 42000 (TLS)
• HmIP-RF portStandard ports: 2010 (non-TLS), 42010 (TLS)
• JSON-RPC portStandard ports: 80 (non-TLS), 443 (TLS). Set to 0 to use defaults.
• Groups path
• Groups portStandard ports: 9292 (non-TLS), 49292 (TLS)

Reauthenticate CCU connection

• CCU passwordCase sensitive. Allowed characters: A-Z, a-z, 0-9 and .!$():;#-
• CCU usernameCase sensitive. User must have administrator role

Reconfigure connection

• CCU hostname/IP address
• CCU passwordCase sensitive. Allowed characters: A-Z, a-z, 0-9 and .!$():;#-
• CCU usernameCase sensitive. User must have administrator role

After setup

• Callback host (optional)IP address for CCU callbacks. Leave empty for auto-detection.
• Callback port (optional)Port for XML-RPC callbacks. Leave empty for automatic assignment.
• Command retry attemptsMaximum number of retry attempts for transient command failures (timeout, device unreachable). Set to 0 to disable retry.
• Command throttle intervalMinimum delay between device commands in seconds. Set to 0 to disable throttling. Ensures smooth operation for large installations.
• Disable device configuration panelHide the device configuration panel from the sidebar.
• Enable system notificationsShow notifications for connection issues and device errors in Home Assistant.
• Restore last brightness for lightsWhen enabled, lights will turn on with the last non-zero brightness level instead of default 100%.
• Listen on all network interfacesEnable if Home Assistant runs in Docker or a VM. Required when HA's IP differs from the host IP.
• Enable MQTTRequired for CUxD and CCU-Jack device support. Requires MQTT broker connected to Home Assistant.
• MQTT prefixMQTT topic prefix configured in CCU-Jack. Leave empty if not using CCU-Jack MQTT bridge.
• Experimental featuresEnable experimental features to try out new functionality. These features may change or be removed in future versions.
• Create sub-device entitiesSplits devices with multiple channel groups into a main device with sub-devices. Entities are assigned to their corresponding sub-device based on channel group.
• UN-IGNORE parametersRe-enable hidden device parameters as entities. See documentation for available parameters.
• Report cover position from group channelUse the group channel to report cover position. Enable this for covers that report incorrect positions on their individual channels.
• CCU hostname/IP address
• CCU passwordCase sensitive. Allowed characters: A-Z, a-z, 0-9 and .!$():;#-
• CCU usernameCase sensitive. User must have administrator role
• Enable Homematic (Bidcos-RF)
• Enable BidCos-Wired (HM-Wired)
• Enable CCU-Jack
• Configure custom portsEnable to configure non-standard ports on the next page. Otherwise, ports are automatically set based on TLS setting.
• Enable CUxD
• Enable Homematic IP
• Use TLS (encrypted connection)Enable TLS for encrypted communication with your CCU.
• Verify TLS certificateVerify the CCU's TLS certificate. Disable for self-signed certificates.
• Enable groups (heating groups)
• HM-RF portStandard ports: 2001 (non-TLS), 42001 (TLS)
• BidCos-Wired portStandard ports: 2000 (non-TLS), 42000 (TLS)
• HmIP-RF portStandard ports: 2010 (non-TLS), 42010 (TLS)
• JSON-RPC portStandard ports: 80 (non-TLS), 443 (TLS). Set to 0 to use defaults.
• Groups path
• Groups portStandard ports: 9292 (non-TLS), 49292 (TLS)
• Daemon hostname/IP address
• Daemon port (blank = 8119)Not used when connecting through an openccu-lite box: the box's web server port applies (443 with TLS, 80 without).
• API bearer token
• Use TLS (HTTPS/WSS)Only when the daemon serves HTTPS (a certificate is configured in its north.rest.tls settings). Out of the box the daemon serves plain HTTP on 8119; with TLS on against it the connection fails. Through an openccu-lite box, TLS refers to the box's web server instead.
• Verify TLS certificate
• openccu-lite box tokenThe openccu-lite box API token this entry connects with (scope addon:openccu-loom or Full access, from the box's token page). Paste a new one to replace it; left empty, the stored token stays.
• Allow non-admin users to edit schedulesWhen enabled, non-admin users can edit device schedules via the schedule cards. Admin users always have full access.
• Program markersComma separated list of markers for programs to enable fetching. To reset, set to a space.
• Enable program scanEnable scanning and fetching of CCU programs
• System variable markersComma separated list of markers for system variables to enable fetching. To reset, set to a space.
• Enable system variable scanEnable scanning and fetching of CCU system variables
• Scan interval (seconds)Interval in seconds between scans for programs and system variables