*** The devices can be created using the Samsung connect app ****
My Flair Devices
Author: Yves Racine
linkedIn profile: www.linkedin.com/in/yracine
Date: 2017-04-25
For SmartTHings users, you can now download the code at
http://www.ecomatiqhomes.com/storeFor Hubitat users, you can now download the code at
http://www.ecomatiqhomes.com/hubitatstoreP.S. Technical support packages are also available.
Setup time: about 10-20 minutes depending on your ST skills.
-
a) Puck gateway operational & connected to Flair via the internet.
-
b) Flair device (vent or hvac unit) operational & connected to Flair via the Puck gateway.
-
c) Flair Setup completed: basic information about your home & rooms entered via the Flair Mobile App or the Flair portal- Developer access to SmartThings (http://graph.api.smartthings.com/). The Flair app should be set to manual mode in order to be controlled by SmartThings.
-
(d) Determine your shard, please consult this thread:
Or the SmartThings documentation here fore more details:
http://docs.smartthings.com/en/latest/publishing/index.html#ensure-proper-location
If you are on a different shard, you need to change the links below for your right shard. As an example, in North America,
replace https://graph.api.smartthings.com/ide/devices by https://graph-na02-useast1.api.smartthings.com
Or use https://account.smartthings.com to point to the right shard (automatically).
1) Depending on your contribution, create one or multiple Device Handler Type(s) - DTH for My Flair Vent, My Puck Device, My Flair HVAC Unit, My Flair Tstat
For each device (My Flair Vent, My Puck Device, My Flair Tstat, My Flair Hvac Unit),
a) Go to https://graph.api.smartthings.com/ide/devices (or whatever your shard is and click on My Device Handlers in the IDE's top menu)
b) Hit the "+New Device Handler" at the top right corner
c) Hit the "From Code" tab on the left corner
d) Copy and paste the code from the corresponding txt file in the zip
The code has been sent to you via your paypal verified email address.
e) Hit the create button at the bottom
f) Hit the "publish/for me" button at the top right corner (in the code window)
a) Go to https://graph.api.smartthings.com/ide/apps (or whatever your shard is and click on My Smartapps in the IDE's top menu)
b) Hit the "+New SmartApp" at the top right corner
c) Hit the "From Code" tab on the left corner
d) Copy and paste the code from the corresponding txt file in the zip
The code has been sent to you via your paypal verified email address.
e) Hit the create button at the bottom
f) Make sure that "enable OAuth" in Smartapp is active
- Goto app settings (top right corner, click on it)
- Click on Oauth (middle of the page), and enable OAuth in "Apps Code"
- Hit "Update" at the bottom
g) Go back to the code window, and hit the "publish/for me" button at the top right corner
If the instructions above are not clear enough, you can refer to the troubleshooting section below with some pictures:
3) Under the new Samsung connect app, execute MyFlairServiceMgr (under the Automation bottom menu, under '+' in the upper right corner/Add Routine/Discover at the bottom)
Click on the Smartapp name (MyFlairServiceMgr) in the list of smartapps under Discover
You should already have a Flair username and password, if not go to https://my.flair.co/
To start the Authentication with Flair, press Next on the first page.
Go through the authentication process using MyFlairServiceMgr smartapp. To do so, please press on the "Flair Connect> Required" button in the middle of the screen.
After being connected, click 'Next' and select your location, your Flair Devices -Puck(s), Vents(s), Tstat(s), and HVAC Unit(s)- that you want to control from Smartthings and, then press 'Next' for the 'Other Settings &Notification' page, and then 'Done' or 'Save' when finished.
N.B. If you have any errors:
If you get a blank screen after pressing 'Next or you get the following error: "Error - bad state' or 'Java.lang.NullPointerException: Cannot get property 'accessToken' on null object" in the IDE', you'd need to enable oAuth as specified in step 2f) above.
At the end of the authorization flow, if you have the following error message: "Unexpected error" even if you press several times, this probably means that you have not "saved & published" one of the Device Handler Types (MyPuckDevice,MyFlairVent,MyHvacUnit) under the right shard. Refer to the prerequisites & step 1 for more details.
Also, depending on the ST platform status, you may have to press "Save" several times if you have the following error message: "Error processing your request - please try again". This is due to some ST platform timeouts due to rate limiting.
After about 1 minute, You should see your newly Flair devices instantiated under:
a) https://graph.api.smartthings.com/device/list (or whatever your shard is and click on My Devices in the IDE's top menu)
And also
b) Under the ST mobile app, under MyHome/Things (main menu at the bottom of the screen).
You may have to hit your Flair device's 'refresh' button several times as the smartThings app is not always responsive.
a) Go to https://graph.api.smartthings.com/device/list (or whatever your shard is and click on My Devices in the IDE's top menu)
b) Click on the Flair Devices that you just created
c) Click on Preferences (edit)
You only need to edit the following parameters
(a) <trace> when needed, set to true to get more tracing (no spaces)
(b) <logFilter:1..5> Values=[Level 1=ERROR only,2=<Level 1+WARNING>,3=<2+INFO>,4=<3+DEBUG>,5=<4+TRACE>]
For My Puck Device, you can also change the offset values for the temperature and humidity UI fields.
(c) humOffset - Humidity offset (+/-)
(d) tempOffset - Temperature offset (+/-)
P.S. Don't enter any values for the appKey, privateKey and any serial Id numbers as the values are populated by the
Service Manager by default during the authentification flow.
The following zoned Heating/cooling smartapps have many safeguards built-in to protect your HVAC.
- The smartapps can check the static HVAC pressure using your Puck and Flair vent devices by comparing the room's pressure and the associated vent's pressure located in the same room.
- The smartapps will check the vent's internal temperature to make sure it's not too hot or too cold
- The smartapps will not close more than 50% of the smart vents inputted in the smartapp
- You can define some minimum open threshold (by default 10% in zone, 20% outside the zone) to avoid closing the vents too tight.
/****************************************************
a) ScheduleTstatZones
/****************************************************
For more details:
http://thingsthataresmart.wiki/index.php?title=ScheduleTstatZones
The smartapp that enables Multi Zoned Heating/Cooling Solutions based on any ST connected thermostats/sensors- - coupled with smart vents (optional, can be any Flair, Keen Home, EcoVent, EcoNet smart vents) for better temp settings control throughout your home".
The smartapp can reproduce the Flair eveness and eveness active modes based on the thermostat's setpoints.
The smartapp can also control multiple Minisplit/Windows unit and portable heaters/coolers inside your scheduled zones (based on the Flair HVACUnit device, see http://thingsthataresmart.wiki/index.php?title=My_Flair_HVac_Unit).
/****************************************************
b) ecobeeSetZoneWithSchedule
/****************************************************
For more details:
http://thingsthataresmart.wiki/index.php?title=EcobeeSetZoneWithSchedule
The smartapp that enables Multi Zoned Heating/Cooling Solutions based on your ecobee thermostats (using comfort settings) and any ST connected sensors- coupled with smart vents (optional, can be any Flair, Keen Home, EcoVent, EcoNet smart vents) for better temp settings control throughout your home".
The smartapp can reproduce the Flair eveness and eveness active setpoint modes based on the thermostat's climate settings.
The smartapp can also control multiple Minisplit/Windows unit and portable heaters/coolers inside your scheduled zones (based on the Flair HVACUnit device, see http://thingsthataresmart.wiki/index.php?title=My_Flair_HVac_Unit )
/****************************************************
c) ScheduleRoomTempControl
/****************************************************
For more details:
http://thingsthataresmart.wiki/index.php?title=ScheduleRoomTempControl
The smartapp that enables Multi Zoned Heating/Cooling Solutions based on your Flair devices and any ST connected thermostats/sensors.
The smartapp can reproduce the Flair DeferToRooms' setpoint mode using or not your ST thermostat (optional). You can also choose or not to set your thermostat's setpoints in the smartapp.