Adding New Hubs
To view and control things on your panel, you must authenticate your smart hub. Multiple hubs are supported. To open the authentication page, select “HubAuth” from the main menu, or press the “H” key. If you have a controller tile on your panel, you can also select “Hub Auth” from the list of options. The HousePanel authentication page will be displayed where you provide hub credentials. The page will look as follows for adding Hubitat hubs:
For Hubitat hubs the authentication information (Access Token, App ID, Hub Name, and Hub ID) can be auto-populated by the HousePanel groovy app. For this to happen you must have provided the correct IP of your server in the groovy app during installation and the server must be running when you install or re-save the groovy application. The information can also be entered manually. The Hub Host can be your local IP address or you can use the Hubitat provided cloud end point.
If you are adding an ISY hub the authorization page will look as follows:
These fields must be provided by the user. The Hub Host for ISY hubs uses the secure https protocol on port 8443.
Re-Authorizing Existing Hubs
If you already have one or more authenticated hubs and then enter the hub authorization page, the list of hubs available will be in the drop down list. Pick whichever hub you want to re-authorize from the dropdown list. The page will look as follows:
In the above example I selected Hub #2, my main Hubitat hub. Once that is selected you can either refresh all devices by pressing the Refresh Hub button, or you can re-authenticate the hub by the Authorize Hub button. To remove the hub from your panel select Remove Hub. Note that this will delete all devices associated with this hub from your panel.
HousePanel Authentication Input Fields
Hub Type:
Two hub types are available:
- Hubitat
- ISY (Universal Devices)
The appropriate values to enter for the following parameters will depend upon which hub type you are authorizing.
Hub Host:
This is the IP address of the hub in local mode, or the cloud access point in cloud mode. For ISY hubs it is always the IP address with a secure https reference and port 8443.
Access Token:
This field is used for Hubitat hubs. You can get this value from the logs of your HousePanel groovy app, or let the app fill this in for you.
Username:
For ISY hubs a username is provided instead of an Access Token. The username is the same username you use to log into your ISY console.
App ID:
This is set to the application ID for Hubitat hubs, which can be obtained from your HousePanel groovy app logs. Again, the groovy app can fill this in for you.
Password:
ISY hubs require a password. This should be the same password used to log into your ISY console.
Hub Name
The Hub Name field is optional and will be filled in automatically if left blank. If you provide a name here that name will be used instead of the name provided by your hub. ISY hubs will assign a random name here so I recommend providing a name for ISY hubs.
Hub ID
Each Hubitat hub has a unique ID that will be determined automatically by the app. You should leave this field set to Hubitat_new for Hubitat hubs and ISY_new for ISY hubs. ISY hubs do not use ID’s so a random ID will be assigned.
Refresh Timer
The final parameter, Refresh Timer, is the number of milliseconds to wait before all data is refreshed by reading the hub. The default value is 0 which means the hub is never refreshed. This value can be left set at 0 for Hubitat and ISY hubs because devices are updated automatically on the panel when they change on the server. It may be useful to set this value for the built-in “None” hub for hubless devices so that images, frames, and videos are periodically updated. Clocks are automatically updated every second.
Return to Housepanel
When you are done authorizing hubs, click on the “Return to HousePanel” button at the bottom of the screen. When HousePanel loads after authorizing a new hub, it is ready for you to add devices associated with that hub to your panel. You can do this using the Edit or Devices options described in other sections.