Teadmistebaas

HubConnect 2.0

Installation Instructions

Multi-Platform, Real-Time Device Intercommunication

Minimum System Requirements:

• Hubitat Hub (Coordinator). - AND -

• Hubitat Hub (Remote) - OR -

• SmartThings Hub (Remote)

Please note that the HubConnect apps are not released under any open-source license. Please be sure to read the license agreement before installing.

Overview:

• Install HubConnect Remote Client and HubConnect Remote Hub driver on all remote hubs, including

  SmartThings.

• Install HubConnect Server for Hubitat on the designated “Server / Coordinator Hub”.

• Install HubConnect Server Instance on the designated “Server / Coordinator Hub”.

• Install HubConnect Remote Hub driver on the designated “Server / Coordinator Hub”.

• Install all HubConnect drivers.

• Create connections from HubConnect Server for Hubitat, exchanging the Key to the Remote Client.

• Select devices to share with the connected hub.

Detailed Instructions:

Perform the following steps in the exact order they appear.

Before installing HubConnect please be sure to download a current backup of ALL hubs in which HubConnect will be installed. This will ensure that you have a reliable recovery strategy.

Install HubConnect Remote Client code. (Hubitat)....

Perform this step on all Hubitat hubs in which the HubConnect Remote Client will be installed.

Install the HubConnect Remote Client (remote) app:

1. In the left menu, click Apps Code.

2. Visit the hubconnect.to and copy the import URL for the HubConnect Remote Client.

3. Click Import located near the top-right of the page.

4. Paste the URL that was copied in step 2.

5. Click Import

6. Click oAuth

7. Click Update in the dialog window.

8. Click Save.

9. Repeat for all other hubs.

Install the HubConnect Remote Hub driver:

1. In the left menu, click Drivers Code, then select the HubConnect Remote

   Hub driver.

2. Visit the hubconnect.to and copy the import URL for the Remote Hub driver.

3. Click Import located near the top-right of the page.

4. Paste the URL that was copied in step 2.

5. Click Import

6. Click Save.

7. Repeat for all other hubs.

Required; Install all drivers:

All of the drivers have been upgraded with HubConnect 2.0. Follow the steps outlined

in section #2 “Install the HubConnect Remote Hub driver” above.
All of the drivers can be found in the download section at hubconnect.to

Once the remote hub apps and drivers have been installed, proceed to install the server hub.

Install HubConnect Server code. (Hubitat)...

Install the HubConnect Server for Hubitat app:

1. In the left menu, click Apps Code.

2. Visit the hubconnect.to and copy the import URL for the HubConnect Server for Hubitat.

3. Click Import located near the top-right of the page.

4. Paste the URL that was copied in step 2.

5. Click Import

6. Click Save.

2. Install the HubConnect Server Instance app:

1. In the left menu, click Apps Code.

2. Visit the hubconnect.to and copy the import URL for the HubConnect Server Instance.

3. Click Import located near the top-right of the page.

4. Paste the URL that was copied in step 2.

5. Click Import

6. Click oAuth

7. Click Update in the dialog window.

8. Click Save.

3. Install the HubConnect Remote Hub driver:

1. In the left menu, click Drivers Code.

2. Visit the hubconnect.to and copy the import URL for the Remote Hub driver.

3. Click Import located near the top-right of the page.

4. Paste the URL that was copied in step 2.

5. Click Import

6. Click Save.

Required; install all drivers:

All of the drivers have been upgraded with HubConnect 2.0. Follow the steps outlined in section #2 “Install the HubConnect Remote Hub driver” above.
All of the drivers can be found in the download section at hubconnect.to and GitHub

Install HubConnect Remote Client code. (SmartThings)...

Install the HubConnect Remote Client for SmartThings (remote) app:

1. Log into the SmartThings IDE.

2. Click the + New SmartAPP at the far right and click From Code tab.

3. Visit the hubconnect.to and download the HubConnect Remote Client for SmartThings.

4. Open the code into an editor of your choice, then select all and copy the text.

5. Paste the text into the SmartThings IDE.

6. Click App Settings then Click oAuth

7. Click Update in the dialog window.

8. Click Save.

9. Click Publish, For Me.

Required; update all drivers:

All of the drivers have been upgraded with HubConnect 2.0. Follow the steps outlined in section #2 “Install the HubConnect Remote Hub driver” above.
All of the drivers can be found in the download section at hubconnect.to 

Not all Device Types are currently supported in SmartThings with the tiles UI. For those that do not appear in the SmartThings driver list, use the drivers located in the Universal Drivers download section instead. These will not have a user interface, but they will work for automations.

Once all of the HubConnect Server and Remote Client code has been imported on all of the hubs, move on to installing the server app on the Server Hub.

Complete the Install

1. On each Remote hub, go to the Apps tab.

2. Select Add User App and select HubConnect Remote Client from the list.

3. Select HubConnect Remote Client.

4. Switch to the Server hub, go to the Apps tab.

5. Select Add User App and select HubConnect Server for Hubitat from the list.

6. Select HubConnect Server for Hubitat

7. HubConnect will alert that an upgrade has been installed. Click Done when prompted to do so. HubConnect will trigger all connected hubs to process the updated code.

8. If no errors are reported, the upgrade was successful.

9. If using the Hubitat websocket, please check to see that all of the Remote Hub Devices are showing a connected status.

It’s important that the Hubs are Connected prior to Selecting devices to be ‘mirrored’.

Create a Connection.

1. On the Server hub, go to the Apps tab.

2. Select HubConnect Server for Hubitat

3. Select Connect a Hub

4. Enter your Private LAN IP Address of Client Hub

5. Select Type of Hub from the drop down.

6. Some options offer: Local Connection Type. Select the Type.

7. Copy Connection Key.

8. On the Remote Hub Select Connect to Server Hub

9. Paste the Connection Key from Server and click Done.

10. Switch to the Server hub and click Verify.

11. Click Done.

Connecting Local Devices to Server or Remote

1. On the hub with the devices you want to connect, go to the Apps tab.

2. Select Select devices to synchronize to Server Hub or Connect local devices to

   Remote Hub

3. Use Quick Select or Device Categories to pick one or more devices.

4. Carefully examine and verify that you’ve installed the list of Required Drivers found at

   the bottom of the initial Selection page. The drivers named in the list will need to be

   available on the other hub prior to the next step.

5. Click Done and Done again. A list of the devices will be sent to the connected hub

   and ‘mirrored devices’ will be created there.

Enjoy HubConnect!