Home Assistant Integration

Answered

Comments

66 comments

  • Avatar
    Steve Stratoti

    HOLY CRAP. I was just searching through the forum and realized they released a REST API 2 year ago, and upon further searching found this! Robert Drinovac, this is amazing. I've been having to manually (through the app) open and close the vent in my daughters room when the temp gets too hot. She's right by the main blower, so if its open, her room gets very cold very quickly, and the rest of the house gets little air. I've already got alerts on my phone to tell me when her room gets too hot, but now I can automate it all! This is awesome.

    I can't wait to get my API credentials!

    0
    Comment actions Permalink
  • Avatar
    Shane Starcher

    Anyone know with the rest API if you can feed it temperature data from different sensors or is it just open/closing of the vents and modifying room temps? 

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Steve Stratoti I'm glad you're getting good use out of the integration! You are correct regarding the API having been out for a while. I used to use a flow in Node-Red that I created with the API. However, I saw that there was a demand for an integration and I happened to have some spare time so I decided to write up an integration.

     

    Shane Starcher the rest API can only pull in temp data from sensors that are supported through the Flair app. For example, if you have an Ecobee with remote sensors and they are assigned to rooms, the "current temp" for a room that is fetched through the API corresponds to the temp reading from the sensor assigned to that room. The Home Assistant integration follows the same structure- the current room temp that you see corresponds to what temp the sensor is reading in the room and setting the temp of a room is the same as if you were setting the temp of a room through the Flair app.

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Shane Starcher Just wanted to add to my last reply. If you're wanting to use sensors that aren't supported naturally through Flair, this can be done with the Home Assistant integration. What you would do is just use the temp data from your sensor in an automation to determine when to open/close a vent. You can still use the flair room entity to set the desired temp of the room. For now it doesn't seem like you can set the current temp of a flair room in Home Assistant to the state of another sensor- technically you can with a python script, but I won't get into that as the "current_temp" attribute value will get overwritten as soon as an update comes in from the Flair API.

    0
    Comment actions Permalink
  • Avatar
    Shane Starcher

    Robert Drinovac that's excellent to know.  If I did it via Home Assistant would Flair still take into account the total system pressure and how many vents are open and closed or would I need to do that myself?  Can I go into say Home Assitant and tell it to close all vents and would flair comply even though that could damage my HVAC? 

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Shane Starcher I edited my post above as it seems the customize option in HA doesn't seem to support grabbing sensor values from other entities. However, you can still use temp readings from unsupported temp sensors to determine what vents you want to manually close via automation(s) in Home Assistant. Regarding your question about closing all vents- If your controls are set to "Manual" mode in the flair app, I don't see why you wouldn't be able to close all vents. Now, whether the vents would open up due to pressure, that is a question someone from Flair would need to address- I'm not sure what safety measures are still enabled when control of the Flair Vents is set to manual. 

     

    Daniel Myers could you chime in regarding what safety measures are still present when control of Flair Vents is set to "manual"?

    0
    Comment actions Permalink
  • Avatar
    Shane Starcher

    Robert Drinovac thanks for the info.  It would be great to understand from Flair what happens with safety in Manual mode.

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Shane Starcher Until Daniel chimes in on the manual mode question, Flair states that they won't close more than 1/3 of the vents in a zone. So if you have 1 zone in your home with a total of 15 vents, Flair won't close more than 5 vents max. If this safety feature is disabled when in manual mode, you could keep track of how many vents are closed in HA and make sure that the number doesn't exceed 1/3 of the total amount of vents that you have in a zone. 

    0
    Comment actions Permalink
  • Avatar
    Daniel Myers

    Robert Drinovac - I believe manual mode does not impose limits on vent closure currently, instead, its more like manually closing non-smart vents where we assume the user knows what they are doing/want.  That said, I just filed a ticket to improve this both in the UI and via the API.  I'm thinking for the API, users should have to set a force-bpp-override=true or similar and for the UI, I'm thinking we should at least put up a popup with a warning when the 1/3 rule is being requested to be overridden, seems like a nice improvement for safety and awareness.  We have some new SW devs joining in the next few weeks and these seem like great items for them to cut their teeth on!

    Separately, on feeding the system temp data - I believe that you can feed sensor data from any source as long as you instantiate a remote-sensor object and then generate remote sensor sensor reading objects for that remote sensor at least once every X minutes (I believe X must be at least every 15 minutes to not get marked as offline).  Hope that helps clarify, if need be I can ask engineering for more specifics on that.

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Daniel Myers, John Bartlet responded in this thread stating that the back pressure protection algorithm is still there even in Manual mode. However, this was two years ago and changes happen (like when the 50% open/close option went away, but then made a return) so it would be good to know for sure. 

    Regarding feeding the system temp data, I haven't come across any references in the API docs about feeding current temps from a non-native remote-sensor. When it comes to the Home Assistant integration, it would be a nightmare to try and code something like that natively into the integration with how much variation there is in HA setups from user to user, so, I wouldn't waste your time tracking down an answer from engineering. 

    As a side note, I want to say thanks for taking the time out of your day to answer all of these questions. 

    0
    Comment actions Permalink
  • Avatar
    Steve Stratoti

    Robert Drinovac - The integration is working flawlessly! I no longer have to manually adjust these vents with the app. I can even trigger my Z-wave ceiling fan to start running (if it wasn't already) when I open the vents to help circulate the air.

    Now if Flair could come out with 12x12 vents, I'd be in heaven. :D

    Thank you again!

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Steve Stratoti automation rabbit hole! I'm hoping to see some sort of sale since I need a lot more vents. I don't know if you've seen this, but I'd contact support just to show you're interested in that size. If this is a floor register and you have access to a 3D printer, you could opt for the 6x12 and then 3D print a face plate to accommodate the 12x12 vent size.

    Also, thank you for the buy me coffee donation!

    0
    Comment actions Permalink
  • Avatar
    Shane Starcher

    Looks like 10% off for memorial day.

    0
    Comment actions Permalink
  • Avatar
    Shane Starcher

    If the Flair API supports it I might be interested in writing a separate application that can be run constantly to feed it data for some of my other smart sensors.  I'm not overly apt to pay $119 bucks per Flair puck personally.  Sensors that expose the same data or more minus the remote and screen can be had for half the price.

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Shane Starcher as of now, the API documentation doesn't mention being able to feed current room temps to flair rooms from sensors that aren't natively added via the Flair app. Perhaps the API does already posses this function, but it hasn't been exposed by the devs. If that ends up being the case, it wouldn't require coding a whole application. You'd be able to interact with the API using Node-Red or creating a script in HA to call REST commands with data from your sensors. You're correct about the pucks being very pricey. I only use 1 and have ecobee sensors acting as my remote sensors.  

    0
    Comment actions Permalink
  • Avatar
    Shane Starcher

    Robert Drinovac I was just going off what Daniel Myers said earlier in the thread.  I have no verification if he is correct, but he did say you could feed in temp sensor data, or at least that's what I thought he said.

    1
    Comment actions Permalink
  • Avatar
    Curtis Roos

    I was initially not having success with Robert Drinovac's Flair HA integration.  After adding his repository in HACS and installing and rebooting HA (the files are added to the custom_components directory).  After adding the integration, the Fill in your Flair API Credentials  screen pops up and filling in my Client ID and Secret, I got a red error message: Flair authentication failed.  Are your credentials correct? 

    I had Flair support check my credentials on their side and they were ok.  My problem was I created my Flair account as soon as my puck arrived so that I could get temp data from the puck.  While I only had the puck, I didn't get access to the API through HA.  Today I added six vents and I now have access to those entities as well as the puck.

     

    0
    Comment actions Permalink
  • Avatar
    Sonny Cano

    Hello all! Finally getting vents, and trying to decide which ones to get. I read some long threads prior about wanting local control, and now this API.

    Can anyone clarify if this = full local control or are we just leveraging API to talk to the cloud still?

    0
    Comment actions Permalink
  • Avatar
    Mishael Rosenthal

    Hi, I just bought a few vents, and am an home assistant user

    0
    Comment actions Permalink
  • Avatar
    Bobmalecki Wa

    I just completed Roberts integration via HACS and now can control any of the vents independently. Much needed since Flair's control panel is pretty lame. I can now have a single vent opening at 8 am and closing at 8 pm via HA. All 4 other vents are controlled by Flair

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Sonny Cano sorry for the late reply. The API isn't local and all API calls are being made to Flair's servers. Having full local control will require Flair to build & run a local REST API on the pucks themselves. 

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Bobmalecki Wa in order to control the vents, the mode (within the flair app) will need to be set to "Manual". Within this mode you will be able to control the vents on your own.

    If you don't currently have it in manual mode: Although you're able to change if a vent is open or closed at 8AM, that change will only persist for some time until Flair takes over control again. The only way to ensure that this change sticks is to have the mode set to "Manual".

    If you do have it set to manual mode: It is my understanding that in this mode you are in full control of the vents. What I mean by that is I don't believe that Flair is controlling the 4 other vents which are not part of your 8AM and 8PM automation. 

    0
    Comment actions Permalink
  • Avatar
    Daniel Myers

    I'm not entirely sure if this would work (but somewhat confident)  to have some vents manually controlled and some vents left on the automation is to set up some rooms with no temperature feed devices and only a vent or vents.  For the rooms that have been a temperature feed (Puck, remote sensor, or thermostat) and a vent, the vents will continue to operate automatically according to algorithms and the rooms that have a vent/vents but no temperature feed, the vents should stay where you them.  Might need to verify that and there might be a few other tweaks related to room/zone assignment to ensure that the manually controlled vents don't interfere with the auto ones from a close limit standpoint but perhaps that strategy could be helpful.

    0
    Comment actions Permalink
  • Avatar
    Bobmalecki Wa

    Actually the vent I'm controlling is not in the Room group "downstairs" which is in auto mode. So it seems that there is no override by Flair, so far the vent open/close schedule seems to be working. 

    Attached is a screen shot of my setup

    0
    Comment actions Permalink
  • Avatar
    Bobmalecki Wa

    Fyi, I was told by Flair's Director of Support that I needed to add a puck to that single room to control the open/close times. This was a very lame solution, and after about 5 email exchanges, I gave up with her and just implemented Robert's integration and got the results I needed. Trying to upsell me for one simple issue was quite distasteful. 

    0
    Comment actions Permalink
  • Avatar
    Daniel Myers

    We generally don't offer open/close scheduling as a feature, instead opting for thermostatic control + setpoint scheduling so that the vents operate in a more set it and forget it automation for the average user that just wants X degrees in a room.  For some users, esp. power users or users with a very specific strategy/situation, explicit vent open/close scheduling might be a nice feature to bolt on. Glad to hear you have a solution that works for you, sounds like Robert built a nice integration.

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Bobmalecki Wa I stand corrected. I didn't realize that placing vents in rooms without some sort of temperature sensor causes them to not be part of the Auto mode. I assumed the auto mode was global and affected every room regardless if there is a temp sensor or not. This design choice works great for the Flair integration.

    Daniel Myers I don't quite see the need for open/close scheduling since the whole point of using Flair vents is to have them follow the temperature trends within rooms. I'll be honest, I don't actually manually control my Flair vents since Flair already does a great job handling the opening and closing using temps from my Ecobee sensors. I'm glad others are getting good use out of the Flair Home Assistant integration though!

    I do seem to be having a problem with one of my Flair vents though.....One of my vents, ever since I bought it, has been eating through batteries like crazy. This particular vent I've had for about 1.5-2ish years and it has gone through about 4 battery (4 sets) changes per year. It is located in the same room as the puck. The other vents (including the ones further away) haven't had this problem. 

    1
    Comment actions Permalink
  • Avatar
    Bobmalecki Wa

    Daniel Myers referencing the screenshot below, why does the Flair app not show the temp and humidity for Suzannes Room vent? I have this excluded from the main group but I would think the Flair platform should be able to report those items?

    0
    Comment actions Permalink
  • Avatar
    Daniel Myers

    Robert Drinovac - mind shooting a note to support@flair.co about the vent?  We're happy to take care of that.  

    Bobmalecki Wa - That's an example what Robert and myself are talking about when we say a room without some sort of temperature sensor turning into a manually controlled room.  The vent itself has a temperature sensor (no humidity) but we use that temperature sensor for diagnostic and other use cases as its measuring the duct temperature rather than the room's ambient.  Without either a Puck, a smart thermostat or a remote sensor assigned to the room (in this case 'Suzannes'), we don't actually have this data.  

    0
    Comment actions Permalink
  • Avatar
    Robert Drinovac

    Ryan Linick I just released 0.0.5.0 of the HA Flair integration which adds mini split support. Have fun automating!

    0
    Comment actions Permalink

Please sign in to leave a comment.