Add Device

From Hubitat Documentation
Revision as of 03:17, 2 April 2020 by Doug (talk | contribs) (Updated Discover Devices access on Home Page)
Jump to: navigation, search

Discovering Devices is the process for pairing your Zigbee and Z-Wave mesh devices. Other devices, such as Lutron and Philips Hue Bridge, are connected using integration apps which can be found in the Apps section of your Web Interface. Remember that as you connect Zigbee and Z-Wave devices, they will have a limited range, and If they are too far from your hub, you will need to add repeating devices (devices that plug in to the wall or are AC mains powered) to make the connection.

Here's how to Discover your devices:

  1. Put your device in pairing mode (See the manufacturer’s instructions, but it probably involves pressing a small, inconvenient button a couple times).
  2. Choose the Discover Devices link in your Hubitat Web Interface home page or from the kabob menu at the top right.
    Hubitat Elevation Home - Device Discovery v2.png
  3. Select which type of device you want to pair, Zigbee, Z-Wave, Iris v1 Zigbee.
    New device Discovery.png

For Zigbee and Iris v1 Zigbee devices, the hub will go into "Pairing" or "Join" mode after you click either button. You can restart it by clicking the restart button, stop it at any time as well.

For Z-Wave Devices, you have two options:

Z-Wave options.png

You can "Start Z-Wave Pairing" and this will put the hub into "Inclusion Mode" for 60 seconds. However, it is good practice to Exclude a Z-Wave device before trying to add it to Hubitat Elevation®. After each Z-Wave device is found, you need to start Z-Wave pairing again.

To Exclude a Device:

Click the "Start Z-Wave Exclusion" button. Press the appropriate button or button combination on the device (see manufacturer's instructions). and you should see a message "Unknown Z-Wave Device was excluded". This means this device no longer is associated with a previous Z-Wave network and can now be paired with Hubitat Elevation®.

Z-wave exclude start.png
Z-wave excluded.png

Naming a Device

After Hubitat Elevation® discovers your device, you can give it a "Label" or a friendly name that you can use to identify the device.

Found device.png

TROUBLESHOOTING

If your device does not pair, here are some potential culprits:

  1. Is your device compatible? Hubitat Elevation® includes Z-Wave and Zigbee radios that work with a wide variety of Zigbee and Z-Wave devices. Check this list of known compatible devices. Devices running on different protocols, such as Lutron and Philips Hue Bridge, require a bridge that must be paired using an integration app. Lutron and the Hue Bridge have discovery processes their own. The Lutron and Hue bridges are not added to Hubitat Elevation® via the discovery process.
  2. Is your device out of range? Z-wave and Zigbee radios have a limited range that is further reduced by obstructions, included metal, wood, concrete, plaster and drywall. It is important to build out a mesh network that includes plugged-in or AC mains powered devices that act as repeaters and boost the range and signal strength of your hub. Battery operated devices do not function as signal repeaters. Note: You should not use Zigbee lightbulbs to repeat signals, since their performance for that task is poor among anything but another lightbulb, which will result in an unstable Zigbee radio mesh for your other Zigbee devices. See the How to Build a Solid Zigbee Mesh and How to Build a Solid Z-Wave Mesh documents for further details.
  3. Is this a Z-Wave device from another hub? Unless it is a new device, Z-Wave devices must be excluded from their previous hub before they can be joined with a new hub. Ideally you should perform a device exclusion and a factory reset before attempting to join it to the new Z-Wave network. If the procedure to factory reset is not available, then you should at least perform device exclusion. To do this, go the Settings in the Hubitat Elevation® Web Interface and choose Z-Wave Details. Choose Z-Wave Exclude and follow the manufacturer instructions that were included with you Z-Wave device.
  4. Is your device in pairing mode? All devices are different. Check the device manual to make you have followed the proper procedure to put it in pairing mode.
  5. Did your Z-Wave device fail to be included properly? Run a general Z-Wave Exclusion (see Step 3 above), then try joining it again.
  6. Is the device battery dead? Try pairing with a fresh battery.
  7. Are there Zigbee bulbs interfering? Certain Zigbee bulbs may interfere with the routing of the Zigbee network traffic. If you're having trouble with Zigbee device discovery, try temporarily removing nearby bulbs to see if this alleviates the issue. Be sure to add AC powered Zigbee repeaters. Do not rely on Zigbee lightbulbs to repeat signals, since their performance for that task is poor among anything but another lightbulb, which will result in an unstable Zigbee radio mesh for your other Zigbee devices. Sengled is the only known manufacturer that make Zigbee lightbulbs which do not attempt to repeat signals to other devices. Therefor they are the only known Zigbee smart bulbs that do not require special attention. See the How to Build a Solid Zigbee Mesh and How to Build a Solid Z-Wave Mesh documents for further details.