Difference between revisions of "Add Device"

From Hubitat Documentation
Jump to: navigation, search
Line 9: Line 9:
 
#<big>Select which type of device you want to pair, Zigbee, Z-Wave, Iris v1 Zigbee.</big>[[File:New device Discovery.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/5/57/New_device_Discovery.png |alt=Press the button for the device radio type you want to join to your hub]]
 
#<big>Select which type of device you want to pair, Zigbee, Z-Wave, Iris v1 Zigbee.</big>[[File:New device Discovery.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/5/57/New_device_Discovery.png |alt=Press the button for the device radio type you want to join to your hub]]
  
<big>For Zigbee, and for Iris v1 Zigbee devices, the hub will present a "Start Pairing" button after you press one of the two Zigbee type buttons.  You can stop it at any, or press the button again to restart Zigbee paring mode.</big>
+
<big>For Zigbee, and for Iris v1 Zigbee devices, the hub will present a '''Start Pairing''' button after you press one of the two Zigbee type buttons.  You can stop it at any, or press the button again to restart Zigbee paring mode.</big>
  
<big>For Z-Wave Devices, you have two options:</big>
+
<big>For Z-Wave Devices, you have two button options: '''Start Z-Wave Inclusion''' (join your device to the Z-Wave radio) or '''Start Z-Wave Exclusion''' (remove your device from the Z-Wave radio).</big>
 
[[File:Start Z-Wave Inclusion or Exclusion 3.0.png|none|thumb|600x600px|alt=Pressing the Zigbee button, or the Iris version one Zigbee button will present a "Start Pairing" button. Pressing the Z-Wave button will present two buttons. One button for Inclusion, to join your Z-Wave device to the hub, and a button Exclusion, to remove your Z-Wave device from the hub.]]
 
[[File:Start Z-Wave Inclusion or Exclusion 3.0.png|none|thumb|600x600px|alt=Pressing the Zigbee button, or the Iris version one Zigbee button will present a "Start Pairing" button. Pressing the Z-Wave button will present two buttons. One button for Inclusion, to join your Z-Wave device to the hub, and a button Exclusion, to remove your Z-Wave device from the hub.]]
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<sup>®</sup>.  After each Z-Wave device is found, you need to start Z-Wave pairing again.
+
<big>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.</big>
  
 
===<big>To Exclude a Z-Wave Device:</big>===
 
===<big>To Exclude a Z-Wave Device:</big>===
<big>Select 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<sup>®</sup>.</big>
+
<big>Select 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.</big>
 
[[File:Start Z-Wave Exclusion 3.0.png|none|thumb|600x600px]]
 
[[File:Start Z-Wave Exclusion 3.0.png|none|thumb|600x600px]]
 
[[File:Z-Wave device Excluded 3.0.png|none|thumb|600x600px]]
 
[[File:Z-Wave device Excluded 3.0.png|none|thumb|600x600px]]
Line 27: Line 27:
 
<big>If your device does not pair, here are some potential culprits:</big>
 
<big>If your device does not pair, here are some potential culprits:</big>
  
#<big>'''Is your device compatible?''' Hubitat Elevation<sup>®</sup> 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.</big>
+
#<big>'''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.</big>
 
#<big>'''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.''</big>
 
#<big>'''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.''</big>
 
#<big>'''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 hub user interface and choose '''Z-Wave Details'''. Choose Z-Wave Exclude and follow the manufacturer instructions that were included with you Z-Wave device.</big>
 
#<big>'''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 hub user interface and choose '''Z-Wave Details'''. Choose Z-Wave Exclude and follow the manufacturer instructions that were included with you Z-Wave device.</big>

Revision as of 19:43, 1 April 2021

Go to the top of the page

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 hub. 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 hub's home page or from the kabob menu at the top right.
    Use either the kuhbob menu at the top right or from the home page of your hub, select the discover devices card.
  3. Select which type of device you want to pair, Zigbee, Z-Wave, Iris v1 Zigbee.
    Press the button for the device radio type you want to join to your hub

For Zigbee, and for Iris v1 Zigbee devices, the hub will present a Start Pairing button after you press one of the two Zigbee type buttons. You can stop it at any, or press the button again to restart Zigbee paring mode.

For Z-Wave Devices, you have two button options: Start Z-Wave Inclusion (join your device to the Z-Wave radio) or Start Z-Wave Exclusion (remove your device from the Z-Wave radio).

Pressing the Zigbee button, or the Iris version one Zigbee button will present a "Start Pairing" button. Pressing the Z-Wave button will present two buttons. One button for Inclusion, to join your Z-Wave device to the hub, and a button Exclusion, to remove your Z-Wave device from the hub.

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 Z-Wave Device:

Select 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.

Start Z-Wave Exclusion 3.0.png
Z-Wave device Excluded 3.0.png

Naming a Device

After the hub 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 hub user 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.