Difference between revisions of "Add Device"

From Hubitat Documentation
Jump to: navigation, search
(Corrections)
(Added detail and warnings for Zigbee bulb repeating)
Line 1: Line 1:
Discovering Devices is the process for pairing your Zigbee and Z-Wave mesh devices. Other devices, such as Lutron and Hue, 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, If they are too far from your hub you may need to add repeating devices (devices that plug in to the wall) to make the connection.
+
Discovering Devices is the process for pairing your Zigbee and Z-Wave mesh devices. Other devices, such as [[Lutron Integration|Lutron]] and [[Hue Bridge Integration|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:
 
Here's how to Discover your devices:
Line 5: Line 5:
 
#Put your device in pairing mode (See the manufacturer’s instructions, but it probably involves pressing a small, inconvenient button a couple times).
 
#Put your device in pairing mode (See the manufacturer’s instructions, but it probably involves pressing a small, inconvenient button a couple times).
 
#Choose the ''Discover Devices'' link in your Hubitat Web Interface home page or from the kabob menu at the top right.[[File:Discover Zigbee and Z-Wave Devices 2.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/File:Discover_Zigbee_and_Z-Wave_Devices_2.0.png]]
 
#Choose the ''Discover Devices'' link in your Hubitat Web Interface home page or from the kabob menu at the top right.[[File:Discover Zigbee and Z-Wave Devices 2.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/File:Discover_Zigbee_and_Z-Wave_Devices_2.0.png]]
#Within a few seconds your Hubitat Elevation™ should discover your device[[File:Hubitat Elevaton device discovery 2.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/File:Hubitat_Elevaton_device_discovery_2.0.png]].
+
#Within a few seconds your Hubitat Elevation™ should discover your device
#Select ''Save''
+
#Select ''Save''[[File:Hubitat Elevaton device discovery 2.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/File:Hubitat_Elevaton_device_discovery_2.0.png]]
  
 
Your device is now added to your hub. Now you can manage your device, automate it or add it to your dashboard. The discovery process times out after 60 seconds if no devices are found. If your device did not pair in the time allotted, try putting your device in pairing mode again and refresh the browser page to attempt the discovery process again.
 
Your device is now added to your hub. Now you can manage your device, automate it or add it to your dashboard. The discovery process times out after 60 seconds if no devices are found. If your device did not pair in the time allotted, try putting your device in pairing mode again and refresh the browser page to attempt the discovery process again.
Line 12: Line 12:
 
'''TROUBLE SHOOTING''' If your device does not pair, here are some potential culprits:
 
'''TROUBLE SHOOTING''' If your device does not pair, here are some potential culprits:
  
# '''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 Hue, require a bridge that must be paired using an integration app.
+
#'''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.
# '''Is your device out of range?''' Z-wave and Zigbee radios have a limited range that is further reduced by obstructions, included metal, wood and drywall. It is important to build out a mesh network that includes plugged-in devices that act as repeaters and boost the range and signal strength of your hub.
+
#'''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&action=edit&redlink=1|How to Build a Solid Zigbee Mesh]] and [[How to Build a Solid Z-Wave Mesh]] documents for further details.''
# '''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 you will need to open up your old hub UI and follow the Z-Wave exclude procedure. Anytime you want to remove a Z-Wave device it is important run a Z-Wave exclude first.
+
#'''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.
 
#'''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.
 
#'''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.
#'''Did your Z-Wave device fail to be included properly?''' Run a general Z-Wave exclusion, then try joining it again.
+
#'''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.
 
#'''Is the device battery dead?''' Try pairing with a fresh battery.
 
#'''Is the device battery dead?''' Try pairing with a fresh battery.
#'''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.
+
#'''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&action=edit&redlink=1|How to Build a Solid Zigbee Mesh]] and [[How to Build a Solid Z-Wave Mesh]] documents for further details.
  
 
#
 
#

Revision as of 19:07, 11 March 2019

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.
    Discover Zigbee and Z-Wave Devices 2.0.png
  3. Within a few seconds your Hubitat Elevation™ should discover your device
  4. Select Save
    Hubitat Elevaton device discovery 2.0.png

Your device is now added to your hub. Now you can manage your device, automate it or add it to your dashboard. The discovery process times out after 60 seconds if no devices are found. If your device did not pair in the time allotted, try putting your device in pairing mode again and refresh the browser page to attempt the discovery process again.

TROUBLE SHOOTING 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.