The Device Detail page is accessed by navigating to Devices (in the sidebar of the hub UI) and then selecting a particular device from the list.
This page allows you to view the current device state; manually send commands to the device; edit device information; and view or edit the device name, preferences, and other details about the device. This page may look slightly different for different devices, depending on the device and driver.
- 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 (usually found on switches, dimmers, bulbs, etc.)
- 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 or setting preferences chosen in the UI. This normally happens automatically whenever a device is initially paired with the hub, but it is generally a good idea to run if you manually change drivers.
- Refresh: polls the device to retrieve new current states (see below). Note that battery-powered devices, especially Z-Wave ones, may need to be “woken up” before they will report back.
- Current States (B) shows the current status of the device and can be as simple as one state showing "on" or "off", but it may also include other status readings such as battery level and temperature, etc. Technically, these states are composed of an attribute (or event name) and value. For example, in the screenshot above, the
switch attribute has a value of
- Events (C) takes you to a page showing a recent history of events (generally changes under "Current States") and commands sent to the device, which can be helpful for troubleshooting. See device events for more details.
- Logs (D) is a shortcut to the Past Logs page filtered to entries for this device.
- State Variables (E) are generally intended only for internal use by the driver and are not of concern for regular use of the device (they can be helpful to consult if you are developing a driver or working with a developer to troubleshoot). Different drivers/devices may put different information here or, as in the example above, none at all.
- Preferences (F) is where you can configure device or driver behavior. Most drivers offer options to enable or disable debug logging (which may be helpful for troubleshooting driver behavior or working with the developer) or event description logging (which can be helpful to see event history in Logs if that is helpful for app or other troubleshooting). 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. Select Save Preferences to save any changes made in this section.
- Device Information (G) is where you specify the device name or label and other properties of the device. The Type dropdown shows the current driver and allows you to change it if needed (e.g., if the proper driver was not automatically selected on pairing). You may also add your device to Hub Mesh by simply turning on the Hub Mesh Enabled option, though that can also be done via Settings > Hub Mesh. (Note that this option refers to the Hub Mesh feature, not to Z-Wave or Zigbee mesh behavior.)
Device Name vs. Device Label: The “Device Name” is used as the display name if no “Device Label” is specified; otherwise, the “Device Label” is used. The display name affects how devices appear in device lists inside apps, in logs, and other places throughout the interface. Most devices let you edit either or both to your liking. Some "child devices" may allow editing only the label, which is how you can change the display name for these devices if you do not like the default name.
- Device Details (H) 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 (J) 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 (K) allows you to remove the device from Hubitat. Be sure to remove the device from any apps using the device before removing it; apps using the device will be shown under the In Use By section. 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. The manual for your device should have specific exclusion or removal instructions.