[RELEASE] Home Assistant Device Bridge (HADB)

The truth about home automation is, there isn't a perfect hub.

Shocked? You shouldn't be.

Build something from parts designed by committee and you have the indecisive IoT industry. It's not the fault of companies like Hubitat or open source efforts like Home Assistant that have been trying to assemble these disparate bits into one cohesive solution. It's a noble goal to bring it all under a single platform, but industry fragmentation, combined with the rapid Build > Promote > Decommission cycle have continued to make it very difficult for any one company or group to completely get ahead of the curve. The Hubitat team have added an incredible number of compatible devices in just 3 years, but there are still some cloud integrations and Zigbee devices that are not yet compatible with Hubitat Elevation, or the necessary apps and drivers to make them compatible have yet to be created.

Home Assistant has been around for 7 years and in this time, the open source community has built a fairly large list of cloud integrations and support for low cost Zigbee devices like Xiaomi Aqara and Mijia devices. There's no reason not to combine this capacity for cloud integrations and low cost Zigbee devices with Hubitat Elevation’s powerful and easy to use automations. Best of all, you never have to touch YAML :nauseated_face:

Table of contents

  1. Building Bridges
  2. Requirements
  3. Installation
  4. Setup
    a. HA Long-Lived Access Token
  5. Advanced options
  6. Troubleshooting
  7. Submitting new device support requests

Building Bridges

Fortune smiled upon us all when @ymerj took the initiative and built a fantastic foundation for @ogiewon, @tomw, and @stephack to add their excellent contributions to create Home Assistant Device Bridge. With this driver and optional app combination, Hubitat Elevation owners can now take advantage of the available device integrations from Home Assistant, and combine them with the easier to use automation and powerful capabilities found in Hubitat Elevation.

  • No virtual devices required

  • No Home Assistant automations needed :grinning:

  • No MQTT broker needed

  • No individual device setup needed

  • No custom firmware flashing

  • Devices from Home Assistant appear in Hubitat Elevation, fully functional and ready for use in automations.


  1. Hubitat Elevation hub :grin:

  2. Home Assistant (This isn't difficult to get setup for our goal of simply importing devices).

  3. The Home Assistant Device Bridge App (Optional)

  4. The Home Assistant Device Bridge Driver

  5. Generic Component Illuminance Sensor

  6. Generic Component Pressure Sensor

  7. If you prefer, you can also get the Home Assistant Device Bridge driver and the optional app from the community built Hubitat Package Manager.

NOTE: This driver uses the Generic Component Drivers built into Hubitat Elevation. If the Generic Component Drivers do not exist on Hubitat, you may request a custom driver, but there are no guarantees this will be possible. We therefor must emphasize that specialized or complicated devices may require more direct of an integration than this integration was ever intended for.


If you've never installed an app, then you're obviously not currently using Hubitat Package Manager. You can either learn to do that first, or you can simply install the Home Assistant Device Bridge Driver and App.

NOTE: The Home Assistant Device Bridge app isn't required, but it offers many benefits that make the simple process of adding the app very worthwhile.

How to install a custom driver in Hubitat Elevation

How to install a custom app in Hubitat Elevation


    Step 1 - Enter the IP address of Home Assistant and the Long-Lived Access Token (see instruction below)

* How to create a Long-Lived Access Token in Home Assistant

  1. Press on your user account in Home Assistant
    Screen Shot 2021-03-03 at 6.51.37 PM

  2. Scroll down to the bottom and select CREATE TOKEN
    Screen Shot 2021-03-03 at 6.52.15 PM

  3. Name your token (This can be any name you want.) and then press OK.
    Screen Shot 2021-03-03 at 7.48.13 PM

  4. Copy the token. It isn't accessible after creating it, so if you forget to record it somewhere and need it again later, just delete the old one and create a new token for use in Home Assistant Device Bridge.
    Screen Shot 2021-03-03 at 7.48.49 PM

    Step 2 - Press Discover and select devices to poll Home Assistant for installed devices.

    Step 3 - If you want to select all devices and then just de-select a few that you don't want to have on Hubitat Elevation, then it's easiest to enable the Select all devices option. The switch will turn on and then back off. This is normal and all the devices available will be selected for import to Hubitat. If you decide that's not what you want, then just enable the De-select all devices option.
  • NOTE: The app will only deselect devices in the list, it will not delete created child devices. You have to delete each manually if needed.

    Step 4 - Confirm and adjust which devices should be imported. You can adjust this later if you make a mistake or change your mind.

    Step 5 - Press Done. In your list of Hubitat drivers, you will see the Home Assistant Device Bridge parent device (or the custom name you set in the app) and all the compatible devices from Home Assistant will begin to populate with child devices in Hubitat, upon each device update.

IMPORTANT: Devices will appear automatically when a change occurs the first time after selecting them for import to Hubitat. A device will not be added to the list of child devices under the Home Assistant Device Bridge parent driver until a change occurs on the device.

  • NOTE: Only devices that currently have a Generic Component device driver in Hubitat Elevation, and are also listed in the table below as compatible with Home Assistant Device Bridge will be imported to Hubitat Elevation. The current exceptions are Generic Component Illumination and Generic Component Pressure. These will appear in Hubitat if you added the additional child device driver code linked above in the requirements section.

Example of imported child devices (each will appear on first activity after selecting them for Import to Hubitat)
Screen Shot 2021-03-03 at 8.41.35 PM

Device types that can be imported by Home Assistant Device Bridge
NOTE: Color adjustments for RGB bulbs are not available.


    Device Type Generic Component Driver
    Curtain Generic Component Window Shade
    Garage Door Generic Component Garage Door Control
    Shade Generic Component Window Shade


    Device Type Generic Component Driver
    Climate Generic Component Thermostat
    Device Tracker Generic Component Contact Sensor
    Fan Generic Component Fan Control
    Input Boolean Generic Component Switch
    Light Generic Component Dimmer
    Lock Generic Component Lock
    Switch Generic Component Switch


    Device Type Generic Component Driver
    Battery Generic Component Battery
    Energy Generic Component Energy Meter
    Humidity Generic Component Humidity Sensor
    Illuminance Generic Component Illuminance Sensor
    Power Generic Component Power Meter
    Pressure Generic Component Pressure Sensor
    Temperature Generic Component Temperature Sensor
    Voltage Generic Component Voltage Sensor

Binary Sensors

    Device Type Generic Component Driver
    Door Generic Component Contact Sensor
    Garage Door Generic Component Contact Sensor
    Lock Generic Component Contact Sensor
    Moisture Generic Component Water Sensor
    Motion Generic Component Motion Sensor
    Moving Generic Component Acceleration Sensor
    Opening Generic Component Contact Sensor
    Presence Generic Component Presence Sensor
    Smoke Generic Component Smoke Detector
    Vibration Generic Component Acceleration Sensor
    Window Generic Component Contact Sensor
    After import, devices joined to Home Assistant will be available for control from Hubitat Elevation, and can be used in Hubitat apps and Rule Machine rules, just as you would any other locally joined device.
  • NOTE: This integration adds devices from Home Assistant using their Entity ID. Button devices do not create Entities in Home Assistant and cannot be imported to Hubitat Elevation. If you want to use a button device that cannot be joined directly to Hubitat, you should check out the Hubitat Integration from @jason0x43. It does the opposite of this integration and imports Hubitat devices to Home Assistant. With Jason's integration, you can create Hubitat virtual switches and share them with HA. Next, you would create an automation for each button in HA, so when a button on the device joined to HA is pressed, that will activate the virtual switch in Hubitat.

Advanced Options

Configure advanced options

  • Only pass through user-selected and manually-added entities?

This option disables all filtering of entities, thus passing through all Home Assistant entity updates and is a good way to disable all filtering, either permanently or temporarily for testing. Keep in mind that this will create new child devices for any events from supported entity types.

  • Manually add an entity to be included

This section allows you to manually add (or remove) an entity to be filtered by its Entity ID. This may be a quicker option for expert users, compared with scrolling and checking boxes on the main configuration page. You can use either method of adding devices and they have the same end result.

  • Remove all child devices that are not currently either user-selected or manually-added

This is a cleanup method. Please use it carefully, as it will remove all child devices that Do Not appear in the filtered lists (The checkboxes on the main configuration page and the manually-added list on the Advanced options page). It will remove child devices regardless of the state of the Only pass through... switch described above.


IMPORTANT: Devices will appear automatically when a change occurs the first time after selecting them for import to Hubitat. A device will not be added to the list of child devices under the Home Assistant Device Bridge parent driver, until a change occurs on the device.

Example: A motion sensor will not appear in the list of devices on Hubitat until it is triggered for the first time after selecting it from the list of available devices from Home Assistant.

If you've added a new device to Home Assistant, but you're having trouble setting it up in Home Assistant Device Bridge, the following steps may help.

  1. If you know the device Entity ID from Home Assistant, enter it manually.

  2. If you do not know what the device's Entity ID is, then you should disable the Only pass through... switch. This will result in creation of new child devices, and hopefully it will include the one you want.

NOTE: Please keep in mind that enabling the Only pass through option... may also result in the inclusion of devices you do not necessarily want.

  1. Once you confirm it is working, add the new one you want to one of the filtered lists, either by using the checkbox method on the main device discovery page, or by manually adding it from the advanced options page.

  2. Once your lists of devices to pass through us correct, re-enable the Only pass through... switch, and then execute the Remove all child devices that are not... step.

Submitting new device support requests

IMPORTANT: Home Assistant Device Bridge is intended to support very simple devices and sensors. Locks and thermostats have been really painful to get working reliably. We therefor must emphasize that specialized or complicated devices may require more direct of an integration than this integration was ever intended for.

  1. Please enable logging on the parent virtual device
  2. Actuate your device (i.e. Open and Close, or Turn ON and Turn OFF, etc.).
  3. Include these debug logs with your request so we can analyze the information sent by Home Assistant through the Home Assistant Device Bridge driver (This information is essential in determining if your requested device can be added to Home Assistant Device Bridge).
Home Assistant & Hubitat?
Hubitat Compatibility
Work around for Tuya/Smartlife switch integration for Z-wave sensors
Local control for sonoff zigbee sensors
Can Hubitat Control Devices via Google Home?
Bringing In Odd Devices
Aeon Labs HEM won't work for me
Known Ecosystems, Hubs, and Integrations that work with Hubitat (not ZigBee or Z-wave)
ConBee 2 at rare discount both Canada and US
Aqara fp1
Wallbox pulsar plus integration?
YoLink Integration
New Aqara Zigbee 3.0 occupancy sensor (FP1) looks interesting
[AS-IS] Insteon web socket driver
Request for Hubitat to Create a IKEA 5 Button Remote Device Driver
Networx NX-8E Alarm Panel Integration
Hubitat and Verisure alarms
Good Door/Window Sensor - ZIGBEE
[RELEASE] Tuya Smart Siren Zigbee driver
Yale Connect Wi-Fi Bridge & Yale Access
Integrating globe smart plugs
Third Reality Hub, possible Ikea control
[AS-IS] Insteon web socket driver
Cheap contact sensor
Aqara FP1 and P1 motion sensors
Aqara FP1 and P1 motion sensors
HE - HA, HS HA-HA, how, why walla-walla bing bang!
Insteon is out of business
2022 - State of In-Wall Switches
iHome Cloud Terminates service
[EOL] SimpliSafe Alarm Integration
USB Stick
Which affordable sensors (door/motion) are most stable on Hubitat?
Is this an ad for Home Assistant or Hubitat?
Integration success story
Noob to HE
Contact Sensors
Mi Air Fryer
Mi Air Fryer
State of Tuya / Smartlife Wi-Fi Integration
What will Elevate your setup in 2022
[SPECIAL EDITION] Most Popular devices elevated by Community Efforts
SwitchBotAPI Driver for SwitchBot Bot
What will Elevate your setup in 2022
Most Popular Contact Sensor elevated by Hubitat in 2021
Somfy rts & hubitat
Xiaomi & Aqara Devices - Pairing & Keeping them connected
Using Abode sensors
Most Popular Motion Sensors elevated by Hubitat in 2021
Most Popular Contact Sensor elevated by Hubitat in 2021
Using Abode sensors
Automated Test Suite or Stable Channel
How is that not a commercial hub?
Look away - I'm just frustrated
NEW TO HUBITAT... Question on locks and Carrier Infinity System
Sisyphus Table
Home Assistant & Hubitat?
[RELEASE] HubConnect - Share Devices across Multiple Hubs (no longer SmartThings!)
Raspberry pi project
Newish to DIY and Want to Do It Right
HubConnect question
Local Control Options for MyQ Garage Door Openers
Giving up on Hubitat, change my mind
Local Automation / Alexa Compatibility
What could we do with this for $10?
Mi Connector and Xiaomi
Mi Connector and Xiaomi
Home assistant
Schlage FE599 wont pair
Outdoor zigbee/zwave RGBW Patio string lights
So I’ve decided to build my zigbee network through the hue hub
Severe CPU Load?
Sonoff , Aquara questions
Homebridge - Hubitat - Why?
HOOBS Accessory to Hubitat HUB
Bad experience with IKEA
Question: Homebridge to HE data flow as of 2021
New Xiaomi Mijia Multimode Smart Gateway
Dyson Pure Cool Driver?
Xiaomi Aqara temperature sensors, is there better?
HomeKit device sync w/ Hubitat Elevation (No Apple devices or Node-Red required)
Advice on Motion Sensors
New Xiaomi Mijia Multimode Smart Gateway
Would I be able to use a smart light switch here?
New Xiaomi Mijia Multimode Smart Gateway
Control Hyperion with Hubitat
Before I throw money in the pit - Can you let me know if my many devices are compatible before I purchase a hubitat please?
The Hubitat C-8 just hit fccid.io
Echo to HE Virtual Switch, Check status, to Maker API, to HA Question
Two Zigbee radios in the same house
Controlling Unsupported Devices on Hubitat via Homeassistant with Apple HomeKit Controller
Everything Presence One
Device Type: Generic Component Window Shade cannot set state?
Migrating Home Assistant drivers to Hubitat
Lutron Motion and telnet
Everything Smart Home has released the EP1 for preorder
[RELEASE] Homebridge Hubitat v2.0
Presence HA / HE
How to/Should I use an Aeotec Z-Wave Stick Gen5+ with HE
Lutron RadioRa3 announced / Integration with LEAP
Years later.. Are Ikea FYRTUR Up/Down buttons supported?
Driver for Aqara Smart Curtain Motor E1?
Fire TV 4K - Is it possible to be integrated to Hubitat?
Idea - Automating Locking Cars

Very nice write-up! Thank you for doing this!!


This is an awesome write up and app and set of drivers.

I had started using this (just) then I had the unfortunate happen, it was fast once all devices I wanted were added, and nice and smooth.

The ConBee on my deCONZ went some sort of mental :crazy_face: (lost its channel and all my lights, maybe I just overworked it), so I have had to ditch it :cry:

So I've had to move all lights to my C7 (I got so fed up with the Hue bridge). Once I replace the dead stick, I'll be back here to try it again. :+1:


So I've had to move all lights to my C7 (I got so fed up with the Hue bridge)

I thought this was not recommended as HUE does not conform fully to Zigbee and causes issue on the mesh. If it works it would be nice to lose the hub.

1 Like

If you have only Hue lights, no problem. They repeat for themselves just fine. So with a second controller that has all your other Zigbee devices, and this driver bringing them back into HE, you'd have no conflicts.

I didn't want to mess with having to run deCONZ on a Pi or PC, so I went with the built in ZHA integration that @stephack is also using and that works great. I've no need to import devices to anywhere but an HE hub, and I can do that on multiple hubs by either installing the driver on each hub, or using Hub Mesh.


You can run it from within HA, no need for another PI :smiley:
Its in the Add on store, and then you add Integration as per normal.
You can browse to Phoscon, and also VNC to deCONZ.

This is how I had it set up, and was working really well. Until said Conbee took a nose dive :cry:
It was also much easier to deal with Groups rather than that bloody yaml!!

I didn't have much choice, as I needed lights and wasn't reinstalling the Hue if I could get away with it.

I have all my ZHA devices on Hub 1, and ZLL on my C7, even a few Xiaomi wireless switches, all working quite well.

That said, I haven't migrated all my Z-wave to the C7 yet, so anything could (and probably) will happen. I'm holding off pulling the trigger on a Conbee II for now, I'll see how this continues. The only downside is, my Osram bulbs will have nothing of the C7, they aren't picked up at all. Luckily, I had some spare INNR bulbs, and they connected with zero issues.

1 Like

Yes, I read that, but also read advice that it's not as stable as having it on a separate computer. :man_shrugging:

Are you sure it's the ConBee that is pooched or is it deCONZ?
Groups on HA mean nothing to me personally and YAML can bite me. I'm literally using this as a Zigbee coordinator and not much else. I do have a few simple HA automations so I can sync my Lutron Connected Bulb Remotes back to HE using @jason0x43 's integration, and I've moved my Sonos over because my Symfonisk knob kept dropping off HE and doesn't drop off the ConBee 2. Other than that, I'm not using HA for anything else at this time.

I tried my hand a YAML and it SUCKS. No bloody way I'm dealing with maintaining that. So far, nothing I've done needs it.

1 Like

I'm not finding the YAML too bad, and hopefully a one time thing (unless they break things).

I'm fairly sure it was the stick at fault, it changed channel all on its own, and wouldn't be changed either, even after a full reset. I did consider using one of my HE sticks, but it recommended flashing it first. At that point I went back to the C7 to add the bulbs lol.

My Bruv has a Conbee 2, and that's working great in the manner mine was, that said he only has a handful of devices, as he's just started.

And no one needs any knob to be dropping off!! :smiley:

1 Like

Hang on to your knobs, for sure.

1 Like

Ouch. I just migrated all my devices from my Nortek stick to Conbee2 during the Christmas break. Very happy with it (using ZHA btw). However, if I was starting over I would have definitely considered one of the 2 coordinators that Tube is offering:

I did buy the Tube router and it's working very well and allowed me to remove 3 of my Iris outlets that were there only to stabilize my mesh. I plan to remove a few more Irus devices but I'm doing it slowly so I don't destabilize my existing mesh.

The Tube coordinators connect directly to the network (z2m) so it can be placed in a prime location away from other noisy devices. Worth a look if you might be starting over.

Edit: I edited the line to remove "connect via USB option" I mentioned above as I believe that was inaccurate.


Oh wow now that's a gorgeous little box!! Wonder if he ships to UK :slight_smile: (if and when he gets more!).

I considered taking one of my Xbee 3's off HE and sticking that on HA, still might yet as I've been more than happy with them repeating on HE. They don't look as nice as those, but they aren't too bad, if I say so myself :smiley:

1 Like

He does..someone asked just the other day.

1 Like

@ogiewon (accidentally :joy:) pointed me to this. Not that he was holding out or anything. :wink:
Only thing that stopped me from returning my ConBee 2 and switching to it (other than being out of stock and under high demand) there's no real benefit for me personally. Small house, so range issues are easily overcome with Trådfri outlets or repeaters. Already using my Xbee for the distant devices in my backyard. And there's only anecdotal evidence that the Tube coordinator works with Xiaomi, which is the primary value of any of this for me.

But the router does sound great. I'm torn between recommending this vs @iharyadi 's devices for repeating. His devices do indeed work great with Xiaomi. An antenna added to them would give as much or more value than the Tube router in my opinion (although I don't know how many devices are supported off hand). Iman's devices are also proven with HE and although there's technically no reason the Tube router wouldn't work well on HE, it's unproven. For sure anything other than a coordinator specifically to work with HA for using this driver needs to be compatible with HE and Xiaomi for me personally.

Having said all that, for HA repeating, that looks like a great option if you're in the US. If you're outside the US like I am, the cost and possible duty make that too close in cost to an Xbee to really benefit from a purchase of the router. The coordinator and people's results I'll be watching closely though. :wink:

1 Like

:joy: Put an Xbee in a round 3D printed container and close the lid. You'll never be able to tell.


I need it in a bigger box :joy:

1 Like

That looks like the same size (distance from antenna to micro USB. Just not round.

1 Like

Lol...yeah he replied to the wrong PM. The post was meant for me.

It works perfectly with my Aqara leak sensors.

Can't say that but I know someone that might be able to test the theory at some point down the line :wink:

I definitely will be watching. If I ever decide to move from my Conbee2 (which is unlikely any time soon...like I said, I'm very happy with it atm) that's likely my next move. Mainly because I'm interested in zigbee2mqtt...I like the concept of decoupling zigbee radio from a hub. Opens up so many options.

1 Like

Now accepting orders locally in the UK? :rofl:
Royski router


Download the Hubitat app