¶ Drivers Code
Hubitat Elevation continually adds to its list of included drivers. However, the generous Hubitat community continues to create drivers for devices we haven't integrated yet or to expose features differently (and any user can do the same with Groovy-language programming). When you find one you want for your device, you will need to install it on your system.
¶ Installing custom drivers
- The developer of the driver will normally post a link to their driver code. Follow their directions to get to the source code.
- Often, developers will use GitHub to host code. When copying the code, select the Raw button so that you are getting the “raw” text of the code, with no HTML formatting.
- Select All the raw code, and then Copy the code.
- From your Hubitat Elevation® Web Interface, select Drivers Code in the side bar. (Expand the Developer tools section if you do not see this.)
- Select the +New Driver button in the upper right corner.
- In the blank text field, simply paste the driver code. Alternatively, you can select the Import button and past a URL to the developers code in raw text format.
- Select the Save button in the top right of the page. When the modified goes away, your driver is saved.
Note: You may experience an error in this step. If you do, your driver will not save and it will not work. Please contact the developer of the driver in the forum. It is usually best if you take a screen shot to help them diagnose the problem. Once the code is fixed, come back and try again.
¶ Loading your custom driver
Once your driver has successfully saved, you will need to update your device(s) with the new driver.
-
From the home page of your hub, select Devices in the side bar.
-
Select the device for which you want to change the driver type (if the device is already added to the hub). This opens the Device Detail page. Scroll down to find the Type field. The name of a driver will be listed there. (Alternatively, you can also choose the driver if creating a new virtual device. The developer may provide instructions.)
-
Select the drop-down menu for Type and then choose the new device driver that you want to use.
- NOTE: Custom drivers, including the one you just added, will appear at the bottom of the list under the heading User.
- NOTE: Custom drivers, including the one you just added, will appear at the bottom of the list under the heading User.
-
Select the Save Device button to save the driver changes.
Your driver is now installed and will used by that device.