Difference between revisions of "Network Setup"

From Hubitat Documentation
Jump to: navigation, search
m
(Added procedure to return to Ethernet from WiFi setup)
Line 13: Line 13:
 
#Enter the desired non-routable IP address for your hub to use. The first three octets must match the other devices on your network, but the fourth octet can be any available number on your network. Use the '''Command shell''' tool on Windows (Type '''cmd''' into Windows search), or the '''Terminal''' app on MacOS (Located in the ''Applications'' > ''Utilities'' folder) to ping the IP address you wish to use, ensuring that there is no response from another device on your network before setting your hub to that IP address.[[File:Static IP address entry.jpg|none|thumb|614x614px]]
 
#Enter the desired non-routable IP address for your hub to use. The first three octets must match the other devices on your network, but the fourth octet can be any available number on your network. Use the '''Command shell''' tool on Windows (Type '''cmd''' into Windows search), or the '''Terminal''' app on MacOS (Located in the ''Applications'' > ''Utilities'' folder) to ping the IP address you wish to use, ensuring that there is no response from another device on your network before setting your hub to that IP address.[[File:Static IP address entry.jpg|none|thumb|614x614px]]
 
#Press '''Save and switch to static IP'''. Ensure the first three octets are the same for the '''IP address''' and '''Default gateway''' in accordance with your router IP address settings (i.e. 192.168.0.x).[[File:Static IP values entered.jpg|none|thumb|604x604px]]
 
#Press '''Save and switch to static IP'''. Ensure the first three octets are the same for the '''IP address''' and '''Default gateway''' in accordance with your router IP address settings (i.e. 192.168.0.x).[[File:Static IP values entered.jpg|none|thumb|604x604px]]
#'''You must Reboot the Hub for the setting to take effect.'''[[File:Reboot after changing static-DHCP.jpg|none|thumb|628x628px]]
+
#'''You must [[Settings|Reboot]] the Hub for the setting to take effect.'''[[File:Reboot after changing static-DHCP.jpg|none|thumb|628x628px]]
  
 
====DCHP address====
 
====DCHP address====
  
#To change back to DHCP and let the router assign an IP address to your hub via its MAC Address, press the '''Switch to DHCP now''' button and reboot the hub.
+
#To change back to DHCP and let the router assign an IP address to your hub via its MAC Address, press the '''Switch to DHCP now''' button and [[Settings|reboot]] the hub.
#*'''NOTE''': Any time you switch between '''Static IP''' and '''DHCP''', you must reboot the hub or the setting will not take effect.[[File:Switch back to DHCP.jpg|none|thumb|600x600px]]
+
#*'''NOTE''': Any time you switch between '''Static IP''' and '''DHCP''', you must [[Settings|reboot]] the hub or the setting will not take effect.[[File:Switch back to DHCP.jpg|none|thumb|600x600px]]
 
#If you are accidentally blocked from accessing your hub due to an incorrect or unknown IP address setting, turn the hub over and use the point of a pen to press the small button just beneath the surface of the hub casing for at least '''7 seconds'''.[[File:Hub DHCP reset button.png|none|thumb|255x255px]]
 
#If you are accidentally blocked from accessing your hub due to an incorrect or unknown IP address setting, turn the hub over and use the point of a pen to press the small button just beneath the surface of the hub casing for at least '''7 seconds'''.[[File:Hub DHCP reset button.png|none|thumb|255x255px]]
 
#*
 
#*
Line 27: Line 27:
 
#Press the Install WiFI driver button and ensure the installation succeeded before continuing.[[File:WiFi adapter setup.png|none|thumb|600x600px]]
 
#Press the Install WiFI driver button and ensure the installation succeeded before continuing.[[File:WiFi adapter setup.png|none|thumb|600x600px]]
 
#Enter the network name (SSID) of the WiFi network you want your hub to join and then enter the WiFi password.
 
#Enter the network name (SSID) of the WiFi network you want your hub to join and then enter the WiFi password.
#Press the '''Save WiFi configuration''' button and reboot the hub.[[File:Enter WiFi username and password.jpg|none|thumb|644x644px]]
+
#Press the '''Save WiFi configuration''' button and [[Settings|reboot]] the hub.[[File:Enter WiFi username and password.jpg|none|thumb|644x644px]]
#You must reboot the hub to activate your WiFi adapter and connect it to your WiFi network.
+
#You must [[Settings|reboot]] the hub to activate your WiFi adapter and connect it to your WiFi network.
  
 
'''<span style="color: red;;">IMPORTANT !</span>'''
 
'''<span style="color: red;;">IMPORTANT !</span>'''
  
*You must reboot the hub or the setting will not take effect.
+
*You must [[Settings|reboot]] the hub or the setting will not take effect.
 
*WiFi dongles are '''not included''' with Hubitat Elevation<sup>®</sup>. For maximum reliability, connect Hubitat Elevation<sup>®</sup> to your network with an Ethernet cable whenever possible.
 
*WiFi dongles are '''not included''' with Hubitat Elevation<sup>®</sup>. For maximum reliability, connect Hubitat Elevation<sup>®</sup> to your network with an Ethernet cable whenever possible.
 
*'''Static IP/DHCP''' configuration is for use with the built in Ethernet port only. '''WiFi USB adapters always use DHCP'''.
 
*'''Static IP/DHCP''' configuration is for use with the built in Ethernet port only. '''WiFi USB adapters always use DHCP'''.
 
*'''WiFi USB adapter''' configuration is not available for hubs prior to '''Model C-7'''.
 
*'''WiFi USB adapter''' configuration is not available for hubs prior to '''Model C-7'''.
 +
 +
=== Changing connection from WiFi to Ethernet ===
 +
If you have configured a WiFi adapter and want to restore hub connection via Ethernet, do not simply pull the WiFi adapter from your hub.
 +
 +
# [[Settings|Shutdown]] the hub.
 +
# Disconnect your WiFi adapter (and the special OTG + power cable if desired).
 +
# Plug in an Ethernet cable, connecting the hub to your router or network switch.
 +
# Unplug your hub from its power source for a '''minimum of 30 seconds''' before plugging it back in.
 +
#* '''NOTE''': To avoid stressing the micro USB connection, it is recommended that power be removed from the hub by unplugging the power adapter from the outlet instead of the hub.
  
 
__NOINDEX__
 
__NOINDEX__

Revision as of 17:54, 29 January 2021

The Networking settings allow you to switch between DHCP (Dynamic Host Configuration Protocol) for automatic setting of your hub IP address, or Static IP where you can define the IP address for your hub when connected by Ethernet cable. You can also add a compatible WiFi dongle to allow your hub to join a WiFi network without the need to attach an Ethernet cable.

NOTE:

  • WiFi dongles are not included with Hubitat Elevation®. For maximum reliability, connect Hubitat Elevation® to your network with an Ethernet cable whenever possible.
  • Static IP/DHCP configuration is for use with the built-in Ethernet port only. WiFi USB adapters will always use DHCP.
  • Setting a Static IP address and configuring a WiFi USB adapter is not available for hubs prior to Model C-5.

Static IP/DHCP configuration

Static IP address

  1. Enter the desired non-routable IP address for your hub to use. The first three octets must match the other devices on your network, but the fourth octet can be any available number on your network. Use the Command shell tool on Windows (Type cmd into Windows search), or the Terminal app on MacOS (Located in the Applications > Utilities folder) to ping the IP address you wish to use, ensuring that there is no response from another device on your network before setting your hub to that IP address.
    Static IP address entry.jpg
  2. Press Save and switch to static IP. Ensure the first three octets are the same for the IP address and Default gateway in accordance with your router IP address settings (i.e. 192.168.0.x).
    Static IP values entered.jpg
  3. You must Reboot the Hub for the setting to take effect.
    Reboot after changing static-DHCP.jpg

DCHP address

  1. To change back to DHCP and let the router assign an IP address to your hub via its MAC Address, press the Switch to DHCP now button and reboot the hub.
    • NOTE: Any time you switch between Static IP and DHCP, you must reboot the hub or the setting will not take effect.
      Switch back to DHCP.jpg
  2. If you are accidentally blocked from accessing your hub due to an incorrect or unknown IP address setting, turn the hub over and use the point of a pen to press the small button just beneath the surface of the hub casing for at least 7 seconds.
    Hub DHCP reset button.png

WiFi Adapter setup

  1. Follow the instructions to add a compatible WiFi adapter to your hub. Connecting a USB device to your Hubitat hub requires a special OTG + power cable. This type of adapter cable feeds power to the hub while simultaneously providing a USB data connection for USB devices.
    OTG + power cable.png
  2. Press the Install WiFI driver button and ensure the installation succeeded before continuing.
    WiFi adapter setup.png
  3. Enter the network name (SSID) of the WiFi network you want your hub to join and then enter the WiFi password.
  4. Press the Save WiFi configuration button and reboot the hub.
    Enter WiFi username and password.jpg
  5. You must reboot the hub to activate your WiFi adapter and connect it to your WiFi network.

IMPORTANT !

  • You must reboot the hub or the setting will not take effect.
  • WiFi dongles are not included with Hubitat Elevation®. For maximum reliability, connect Hubitat Elevation® to your network with an Ethernet cable whenever possible.
  • Static IP/DHCP configuration is for use with the built in Ethernet port only. WiFi USB adapters always use DHCP.
  • WiFi USB adapter configuration is not available for hubs prior to Model C-7.

Changing connection from WiFi to Ethernet

If you have configured a WiFi adapter and want to restore hub connection via Ethernet, do not simply pull the WiFi adapter from your hub.

  1. Shutdown the hub.
  2. Disconnect your WiFi adapter (and the special OTG + power cable if desired).
  3. Plug in an Ethernet cable, connecting the hub to your router or network switch.
  4. Unplug your hub from its power source for a minimum of 30 seconds before plugging it back in.
    • NOTE: To avoid stressing the micro USB connection, it is recommended that power be removed from the hub by unplugging the power adapter from the outlet instead of the hub.