Instances

Room concept

Creating HAP instances for each room

Adding HAP instance in HomeKit as a bridge

---

Room concept

HAP, the Homekit Accessory Protocol, does not know a room concept. So when you add one or more devices to a bridge the will appear at the same room as the bridge in your HomeKit client application. Thereof the user experience will be very confused, once you have more than a few devices, you want to integrate.

To overcome, HAP-HomeMatic is concepted to fire up multiple bridges (so called HAP instances). In the next steps we will creating instances in HAP-HomeMatic, link each of them to a specific HomeMatic-room and integrate them afterwards as so called bridges within HomeKit in a iOS app (e.g. Apple Home or Eve) - meaning one bridge per room.

Creating HAP instances for each room

• During the installation wizzard you may add a instance for each of your rooms, add these instances to HomeKit and put them into rooms.

ℹ️ From this time on adding a new device to an instance will place this device into the same room as your HAP instance (so called Bridge within HomeKit).

To add an HAP instance,

• choose Edit HomeKit instance in the left menubar and click on the New-button on the right bottom,
• enter the room name to be appeared in HomeKit in the field HomeKit instance name, avoid any special characters!
• assign the HomeMatic room from the drop-down field,
• and repeat the last three steps for each room you want to use within your HomeKit app:

• After pushing the Finish-button, the new instance will be created and appears in the HomeKit-Instances list. The PIN given here you will need in the next step within your iOS app:

Adding HAP instance in HomeKit as a bridge

Our new room "Flur/floor" is now within HAP-HomeMatic as a HAP instance available.

• On the receiver side, meaning in our HomeKit app like Home or Eve, we need to add the instance as a new so called bridge, recognized as a room within iOS:

• Please enter under 5. the PIN given from your HomeKit-Instances list.

ℹ️ From revision 0.55 onwards, a QR-code for easier adding to HomeKit will be provided. The link to the supercode can be accessed by clicking on the link in the list.

---