HomeAssistant Rest API test Driver

[kfly]

Looks like Home Assistant Rest API works pretty good with CQC and should help those of use that need to add a few unsupported devices to CQC.

As everyone knows there is no other HA system out that compares to the configurability of the GUI interface you get from CQC. So why not just let HomeAssistant poll the device and CQC can lookup state/attributes from HA.

Here is a first cut of a test driver.
Driver install prompts:
1. HomeAssistant Long-lived access token (see below)
2. Polling Interval (default is 5 seconds)
3. HomeAssistant Hub IP address example: 192.168.1.1
4. List of HomeAssistant Entities to be polled (see format below)


  HomeAssistant_0.2.zip (Size: 31.44 KB / Downloads: 7)

Note:

• It polls the local HomeAssistant Hub.
  
• It does one small "state" poll for each device at poll time. (so keep it to a small number of devices not supported by CQC)
  
• Driver creates fields based on HomeAssistant entity names that are specified to poll  at driver configuration.
  
• HA can report locks in strange states(jammed,unkown,etc) in this case the lock will be set to false(unlocked) just like the HA app does.
  
• CQC has a 8 second HTTPost timer and HA seems to have a very rare 40 second timeout(when unplugging z-wave devices, HA seems to pend all post requests for up to 40 seconds until HA sets that status again). I have only seen it on sending commands to locks. guess HA pends on the lock to finish unlocking/locking,etc. In this case driver will increment the $LostConn field in the driver status screen. 
  

After a few weeks of testing. Seems to work well at 5 seconds poll times.

You need to Generate a Long-lived access token(Personal Access Token)
Home assistant -> "your profile" -> Long-lived access tokens
https://community.home-assistant.io/t/ho...cess-token


Devices to Poll:
Format is  Entity ID  in HomeAssistant (example below)
Home assistant -> Settings -> Devices & services -> Entities

example:
light.scene_capable_plug_in_dimmer,light.sengled_solar_light,switch.ktest_appliance_switch,lock.front_door_lock,sensor.workshop_flood_sensor_air_temperature,binary_sensor.workshop_flood_sensor_water_leak_detected


Please feel free to fix, enhance or change driver as needed.
    maybe:

• enhance Lights to do color light fields
  
• Add more device types as I only added light, lock, switch, and sensors.(or a more elegant lookup table of some kind)
  
• Sensor should work for any sensors and binary_sensors as they are just text fields.
  

Obviously the Rest API Driver is not intended for a bunch of devices/entities/sensors. The "http://{{hass_url}}/api/states/{entity ID}" poll  is pretty small and efficient. unlike the smartthings hub where you hand to pull a ton of capabilities and parse out.

One major change from smartthings api is all commands to HomeAssistant are done by calling a Service "http://{{hass_url}}/api/services/light/" instead of just calling the device(smartthings) or EntityID(HomeAssistant) and setting the attributes.


I see no reason someone couldn't write a cool websockets driver so we can migrate all our CQC devices to HomeAssistant and still use CQC as the GUI frontend.

https://developers.home-assistant.io/docs/api/websocket

Troubleshooting:
Make sure all the devices you are polling are online in HomeAssistant. Devices in offline/strange states may stop driver from connecting to HA because of the unexpected data returned from HA.

[znelbok]

Well Done

This is something I promoted a long time ago but I dont have time to give it a go so I thank you greatly for doing it.

I'll run this up soon and post my finding. My HA is running on a Pi and I have not logged into it for a long time so now's the time to get it going again.

I think that if we can get it going nicely, the HA community will probably jump on it and CQC will explode in popularity.