Connect Homematic IP
Create a separate connection for each Access Point. You need a configured Homematic IP installation, an available booked Access Point slot and permission to manage system connections.
Without an available slot, Select remains disabled. Use Book now / increase capacity to book another slot. After a failed setup attempt, octopancy also checks capacity before asking for a new one-time key. Reauthorizing an already paired connection does not require an additional slot.
Under Status & Control, groups supporting heating control display the Heating group badge. This does not indicate how many individual thermostats belong to the group.
If a device state cannot be confirmed when you open Status & Control, octopancy retries the read every 30 seconds while the view remains open. Once a read or a new device report confirms the state, the warning disappears. Leaving the view stops the retries. Previously reported measurements remain visible as the last known values.
Set up the connection
- Open System connections and Add integration. Choose Select for Homematic IP.
- Enter the Integration name.
- In the Homematic IP app, open its cloud-access settings and add a client to generate a one-time key. Follow the illustrated instructions in octopancy; the provider app's labels depend on its language.
- Enter the Six-character one-time key and choose Connect.
- Wait for Homematic IP connected successfully. Done closes the confirmation; Go to Locations opens location assignment. Device import follows and may still be pending. No SGTIN is required for setup.
An active connection is shown as Connected. If no check result exists, octopancy automatically checks cloud access when you open its details. This does not operate a device. Unreachable indicates a problem; the connection status does not confirm every device's state.
A compact icon list below the room name shows the detected functions: Heating control, Room temperature and Humidity, where available. They describe supported functions, not the current device state. The information icon at the top right explains why Homematic IP exposes thermostats as shared room controls rather than individual devices. Click, activate the icon with the keyboard or tap it to read the explanation.
Assign devices and rooms
Open the connection using Open connection. Your Homematic IP devices and rooms has separate Devices and Rooms card sections. A room represents a reported heating group; thermostats also appear as devices only if Homematic IP reports them individually.
Choose Assign to unit on the card, then select the location. In Device assignment, choose the unit and open Add device. Homematic rooms appear as Room group. Adding a group automatically makes its supported controls available under Status & Control, such as heating, room temperature and humidity. You do not need to create controls or technical mappings separately.
Assignment changes neither Homematic IP rooms nor heating values. See Devices and controls.
Refresh devices is in the connection's top three-dot menu. If inventory is empty, check sharing and room assignments in Homematic IP.
Assigned device and room cards show their location and unit. Go to unit opens device assignment with that unit already selected. Assign to unit is shown only while no unit is assigned.
Sensors
Smoke detectors, water sensors and recognised window/door contacts appear in device inventory. They are not presented as heating or door controls. Model identifiers and missing alarm reports are not extra captions on connection cards.
Find available state reports in the location's device view. An earlier report is not a current reachability check. Missing data means neither “no alarm” nor “closed”. Window/door contacts are identified as Window/door contact. Under Status & Control, the assigned contact appears as a compact status card showing Open, Closed, Tilted or State unknown. The timestamp identifies the last device report; new reports update the card automatically. Missing or unrecognised reports never imply Closed.
Test or pair again
Choose Test connection in the top three-dot menu. The result appears in a dialog; Done closes it and Test again repeats an unsuccessful check. This checks cloud access without operating a device. It does not verify individual device availability or webhook delivery.
If new authorisation is required, choose Reauthorize and use a new one-time key. The existing connection and assignments are preserved; pairing again does not consume another slot. Do not reuse a rejected or expired key.
Remove the connection
Open its detail page and choose Delete connection at the top. You do not need to disconnect first. After confirmation, imported devices and rooms disappear from connection and location views. Manually created areas and rooms remain.
Active and already granted future access, as well as scheduled or still running controls, can prevent deletion. This includes reservation preheating without guest access. The dialog identifies the affected function and links to its reservation or schedule. Completed executions do not prevent deletion. Deletion does not reset the Access Point or confirm revocation at Homematic IP. Changing booked capacity is a separate action.
Troubleshooting
- No capacity: Check booked slots and existing connections.
- Setup expired: Start again from provider selection.
- Pairing in progress: Wait for the success message. Submitting a form alone does not confirm a connection.