homebridge-inteo

This plugin for [Homebridge] enables integration with the InteO hub by Somfy, a commercial automation hub for curtains available in Brazil. It allows users to control their InteO-connected curtains through HomeKit after configuring them in the InteO app.

Prerequisites

Before using this plugin, ensure that:

• You have installed and configured your curtains with the InteO app.
• Your Homebridge setup is running correctly.

Installation

Install the plugin via npm:

npm install -g homebridge-inteo

Or, if you're using Homebridge UI, you can install the plugin through the Plugins tab by searching for homebridge-inteo.

Post-Installation Configuration

After installing the plugin, you need to add it to the config.json file of your Homebridge setup to ensure it's loaded correctly.

1. Open your config.json file located in the Homebridge config directory.
2. Add the following configuration to the platforms array:

{
    "platform": "InteO",
    "name": "InteO"
}

Here's an example of what your config.json might look like after adding the InteO platform:

{
    "bridge": {
        // Bridge configuration
    },
    "accessories": [
        // Accessories configuration
    ],
    "platforms": [
        {
            "platform": "InteO",
            "name": "InteO"
        }
        // Other platforms configuration
    ]
}

3. Save your config.json file and restart Homebridge for the changes to take effect.

By adding this configuration, you're telling Homebridge to load the InteO platform plugin with the specified settings. Make sure to adjust any additional configuration options as needed for your setup.

Post-Installation Steps

After installing the plugin and restarting Homebridge:

1. Go to the InteO app on your device.
2. Navigate to the virtual control of the curtain you wish to control.
3. Select a command (Up or Down). This action is necessary for the accessory to be recognized and added to Homebridge.

These steps ensure that your InteO-connected curtains are properly added to your Homebridge setup.

Configuration

The plugin features a custom UI within the Homebridge UI for easy configuration. After the plugin is installed, you can configure it directly through the Homebridge UI without editing the config.json file manually.

Accessing the Plugin Settings

1. Open the Homebridge UI in your web browser.
2. Navigate to the Plugins tab.
3. Find homebridge-inteo in your installed plugins list.
4. Click Settings to configure your devices.

Advanced Configuration

After installing the plugin and accessing the custom UI within the Homebridge UI, you can configure advanced settings for each of your InteO-connected curtains. This includes setting the timeTravel for each accessory and renaming devices for easier identification within HomeKit.

Renaming Devices and Configuring Time Travel

Initially, devices are detected with generic names. To help you easily identify each curtain within the HomeKit environment, our custom UI allows you to rename each device:

1. Renaming Devices: In the plugin settings within the Homebridge UI, find the list of detected devices. Each device can be renamed from its generic name to something more descriptive, such as "Living Room Curtain" or "Bedroom Blind."

2. Configuring Time Travel: Due to the one-way nature of Somfy RTS motors, the control of curtain position is estimated through time travel. The timeTravel setting defines the time in seconds it takes for the curtain to fully open or close. This setting is crucial for accurately reporting the curtain's position to HomeKit. For each device, you can specify its timeTravel value in the plugin's settings.

These settings ensure that your HomeKit environment accurately reflects the status and control of your curtains, providing a seamless integration between InteO and HomeKit.

Usage

Once you've completed the post-installation steps and configured your devices through the Homebridge UI, restart Homebridge. Your InteO-connected curtains should now appear in your Home app on your iOS device, ready to be controlled just like any other HomeKit accessory.

Troubleshooting

If you encounter any issues:

• Ensure your InteO hub is connected to the same network as your Homebridge server.
• Make sure all configurations are correctly set through the Homebridge UI.

License

This plugin is released under the MIT License.