Device Detail

From Hubitat Documentation
Revision as of 03:28, 22 April 2022 by RobertM (talk | contribs) (Updates for 2.3.1)
Jump to: navigation, search
Go to the top of the page

The Device Detail page contains detailed information about the device, allows you to edit device information and manually change the device state. This page s where you will find the current state of your device, and it may look different for different devices, depending on the device and driver.

The "Device Details" page contains [A] "Commands" at the top-left, [B] "Current Status" at the top-right, [C] "State Variables" below the commands, [D] "Preferences" below the state variables, and [E] "Device Information", where you can change the device label; change the driver your device is using; and enable, or disable Hub Mesh for the device if you want.
  • Commands (A) are buttons that allow you to manually change the state of the device or send parameters and driver specific data to the device. While many commands are device specific, there are some common ones
    • On and Off: turns the device on or off.
    • Configure: Pressing this button causes the driver to execute its configure() function. This function usually sends configuration commands to the Zigbee or Z-Wave device, instructing those devices on how to report status updates back to the Hubitat hub. This normally happens automatically whenever a device is initially paired with the hub.
    • Refresh: polls the device to assure the current status (see below) is accurate.
  • Current Status (B) shows the current status of the device and can be as simple as "on" or "off", but it may also include other status readings such as battery level and temperature, etc.
  • Events (C) takes you to a page showing all the event history (generally a history of things that have changed under “Current States") the hub has for this device. This can be useful for troubleshooting—or if you're just curious.
  • State Variables (D) shows you the current stored values of the driver attributes. For example, the last stored activity or value from a variable such as temperature offset.
  • Preferences (E) is where you can disable or enable logging to help troubleshoot issues. This can be especially helpful to developers of custom code. Devices may also have some settings that you can configure here. Consult the device user manual or the custom driver developer for specifics on how to adjust these preferences. If you make adjustments to any details, be sure to click save to store the new settings.
  • Device Information (F) is where you specify the device name, and device label. If you are adding a virtual device, this is where you will choose the driver type or adjust it for a device that didn't automatically select the correct device driver when added to your hub. You may also add your device to Hub Mesh by simply turning on the Hub Mesh Enabled option.
  • Device Details (G) allows you to view metadata about the device, including when it was created on Hubitat and device-specific data the platform or driver adds to this section, as well as what apps are using this device--the "In use by" section, which can be particularly handy when removing or swapping devices.
  • Scheduled Jobs (H) shows any jobs the driver has scheduled for itself. Note that this does not reflect anything that an app (automation) may have scheduled for that device; that information would be found in App Status, generally as configured in the app's regular interface.
  • Remove Device (J) allows you to remove the device from Hubitat. Be sure to check "In use by" before removing. If this device is a Z-Wave device, be sure to put the device in exclusion mode (check the manufacturer's instructions) when using this option. Most Zigbee devices do not require this, though you may still reset the device manually if necessary.