yracine/keenhome.device-type

Keen Home Smart Vents - device handler

keenhome.device-type.smartvents

Authors: Keen Home, Yves Racine

linkedIn profile: ca.linkedin.com/pub/yves-racine-m-sc-a/0/406/4b/

Date: 2015-11-04

Advanced zoning smartapps at my store:

www.ecomatiqhomes.com/store

If you like the device handler, please support the developer.

---

PREREQUISITES

• Your Keen Home vent(s) fully operational (not connected to the Keen Home Hub, but to the ST hub)
• Developer access to SmartThings (http://graph.api.smartthings.com/)
• Determine your shard, please consult this thread:

https://community.smartthings.com/t/faq-how-to-find-out-what-shard-cloud-slice-ide-url-your-account-location-is-on/53923

Or the SmartThings documentation here for more details:

http://docs.smartthings.com/en/latest/publishing/index.html#ensure-proper-location

If you are on the different shard, you need to change the links below for your right shard.

As an example, in the North America,

replace https://graph.api.smartthings.com/ide/devices by https://graph-na02-useast1.api.smartthings.com

The device type's configure tile changes the pressure and temp's refresh rate to be 5-10 minutes instead of 1 minute (set by default) in order to avoid excessive battery usage.

Setup time: about 2-5 minutes depending on your ST skills

INSTALLATION STEPS

1) Create the device type (Keen Home Smart Vent)

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 Type" at the top right corner

c) Hit the "From Code" tab on the left corner

d) Copy and paste the code from

https://github.com/yracine/keenhome.device-type/blob/master/devicetypes/keensmartvent.src/keensmartvent.groovy

e) Hit the create button at the bottom

f) Hit the "publish/for me" button at the top right corner (in the code window)

2) Assign your devices to the new device type (should be at the end of your device list)

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 your device(s), and then edit at the bottom

c) Choose the new device type (v1.0.1) from the list using the type field

d) Hit the save button at the bottom

3) Configure the new device settings in the smartThing classic app or call the configure method() using WebCore or Sharptools

a) Go to the Home tab, click on Things, and the right device

b) Hit the configure tile to set the new 'refresh rate' settings.

You need to press the configure tile for each device that you have.

Hitting the configure button will no do anything in the UI, but it will change the polling rate (5-10 minutes instead of 1 minute polling) in the list of events.

keenhome.device-type's Issues

configure tile does not do anything

Like the reduced polling, however clicking the configure tile does not bring up any setting pane, I am on Iphone 6s with latest smartthings app. In any cae, the polling interval is changed to 5 minutes, which is great win. Thanks

Consider using changing the abbreviation for number to be 'num' instead of 'no'

I found this to be very confusing when setting up the rules.

'no' normally something you don't want or exclude.

Unable to configure vent polling interval

Hey @yracine, it doesn't seem like its possible to follow these steps of the installation process any longer because the SmartThings Classic app has been retired and is completely unusable (for me at least):

3) Configure the new device settings in the smartThing classic app

a) Go to the Home tab, click on Things, and the right device
b) Hit the configure tile to set the new 'refresh rate' settings.
You need to press the configure tile for each device that you have.
Hitting the configure button will no do anything in the UI, but it will change the polling rate (5-10 minutes instead of 1 minute polling) in the list of events.

Is there any other way to configure the vents' polling interval?

Can default status have different colors or level setting?

When looking at the smart things app (Things) the icon for the vent open at 100% or 10% is the same color. It would be nice to be able to tell the current level setting via a color change like temperature or ever better, the actual level setting.

inconsistent level reporting

There is published on ST device driver "Keen Home Smart Vent", which kind of work, but goes in offline after a while and cannot be waken up. Do you know the author of that code? Is there a way to get the code? So, I looked for alternatives and fond your driver here. Thank you for developing it.

I am new to ST and can hardly understand the code. However, as a user I can say that it seems to work when you set the "Dimmer", but after a while when you come back to take a look at what position your vent is at, the Dimmer always shows 0. I tried to find where in the code it maybe happening, but search for "Dimmer" returns no hits :)

So, I would really appreciate, if someone can teach me what could possibly cause this, so that we can fix it.

Also, what if I move the vent's fins manually, is this change supposed to show up in the device view? It does not currently.