Skip to content

Commit 8216fa4

Browse files
authored
Thermostat and onValue Support Added (#24)
* Lutron Support Support for non-Zwave lighting and switch devices. Allows override of default "on" = 255 value by using a user-selected "on" value. * Lutron / onValue Support Support for devices that have an "on" value other than 255. * Update index.js * Update README.md * Update index.js * Update HomeSeerUtilities.js * Update index.js * Add files via upload * Add files via upload * Update index.js * Add files via upload * Thermostat Dummy Code * Update index.js * Updates to Support A Thermostat * Add files via upload * Update README.md * Update index.js * Update README.md * Update index.js * Update HomeSeerUtilities.js * Update index.js * Update README.md * Update index.js * Update HomeSeerUtilities.js * Update index.js * Update README.md * Update HomeSeerUtilities.js * Update index.js * Separate out device setup into its own file * Modularize Code Separate out code used for initially setting up a HomeKit device into its own module to simplify readability. * Update HomeKitDeviceSetup.js * Update index.js * Update index.js * Add files via upload * Make More Modular * Add files via upload * Add files via upload * Update README.md
1 parent 51bb44f commit 8216fa4

File tree

6 files changed

+1547
-1180
lines changed

6 files changed

+1547
-1180
lines changed

README.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -11,45 +11,55 @@ If you have problems getting this to work, I will try to help, but please reveiw
1111

1212
## B. Overview of Recent Changes and Additions
1313

14-
## B.1 **New in 2.3.1 ** - Window Coverings
14+
## B.1 **New in 2.3.4** - Thermostat and onValue Support
15+
16+
Support has been added for Z-Wave Thermostats. This is still somewhat "untested" so post an issue if have any problems. See Section G of the Wiki page "Seting Up Your Config.json file" for more information on configuring thermostats. https://github.com/jvmahon/homebridge-homeseer/wiki/Setting-Up-Your-Config.json-file.
17+
18+
{"type":"Thermostat", "name":"Living Room", "ref":29, "setPointRef":28, "controlRef":27, "stateRef":26, "humidityRef":32, "humidityTargetRef":33, "temperatureUnit":"F"}
19+
20+
where "ref" is the current temperature device; "setPointRef" is the target temperature evice, "controlRef" is the device to select the heating mode (Off, Heat, Cool, Auto), and "stateRef" is the device that reports the working state of the system ("Off", "Heating", "Cooling"). The "temperatureUnit" setting is the unit used by your HomeSeer configuration. Your iPhone's temperature unit is determined by the iPhone's system settings. You may also specify an optional humidity sensor via "humidityRef" and optional device to control relative humidity using "humidityTargetRef".
21+
22+
This update also supports specification of an "onValue" parameter for lightbulb, outlet, fan, and switch accessories. This has been added to allow support of accessories which do not use the "default" Z-Wave value of 255 to turn on the accessory. For example, the Lutron plugin uses values 1-100 to turn on a Lutron bulb. May be also be used for Z-Wave dimmers to always turn the dimmer on to a set value when the accessory icon is tapped (e.g., "onValue":75 will always turn dimmer on to 75%). For Z-Wave, it is generally preferable to leave the onValue undefined which defaults to 255 (on-last-level). If specified for Z-Wave, onValue should be in the range 1-99 or 255.
23+
24+
## B.2 **New in 2.3.1 ** - Window Coverings
1525

1626
Control for simple window coverings has returned. To add a Window Covering, put a WindowCovering entry in the accessories section of your config.json file along the lines of:
1727

18-
{"type":"WindowCovering", "ref" 715, "binarySwitch":true, "obstructionRef":716 }
28+
{"type":"WindowCovering", "ref" 715, "binarySwitch":true, "obstructionRef":716 }
1929

2030
The "binarySwitch" parameter is optional and used only if your widow covering is controlled by a binary switch and is limited to fully open / fully closed operation. This "should" be detected automatically, but add parameter if needed. The "obstructinRef" parameter is optional.
2131

2232
See additional information in "Window Coverings" section of the Wiki entry [Setting Up Your Config.json file.](https://github.com/jvmahon/homebridge-homeseer/wiki/Setting-Up-Your-Config.json-file.)
2333

24-
## B.2 **New in Version 2.3 ** - Battery Detection, Bug Fixes
34+
## B.3 **New in Version 2.3 ** - Battery Detection, Bug Fixes
2535

2636
Automatically detects if a Z-Wave device has an associated battery and detects/corrects when a wrong battery reference is specified for a device in config.json.
2737

2838
Also bug fixes for Garage Door Opener.
2939

30-
## B.3 *New in Version 2.2.5 * - Easier Lighting Configuration
40+
## B.4 *New in Version 2.2.5 * - Easier Lighting Configuration
3141
Since lightbulbs are one of the most common accessories, the plugin has been updated to make it easier to specify lightbulb accessories. You no longer need to individually specify each as an accessory. Instead, you can specify the HomeSeer references for lightbulbs (both dimmable and binary-switched) as a group using the lightbulb group entry identifyer "lightbulbs" in your config.json file like so:
3242

3343
"lightbulbs": [308, 311, 314, 317, 400, 415],
3444

3545
See additional informatinon in "Lightbulbs Group" section of the Wiki entry [Setting Up Your Config.json file.](https://github.com/jvmahon/homebridge-homeseer/wiki/Setting-Up-Your-Config.json-file.)
3646

37-
## B.4. *New in Version 2.2 -* Garage Door Openers
47+
## B.5. *New in Version 2.2 -* Garage Door Openers
3848
Support for Garage Door Openers has returned. To add a garage door opener, put a GarageDoorOpener entry in the accessories section of your config.json file along the lines of:
3949

4050
{"type":"GarageDoorOpener", "name":"myGarageDoor", "ref":648, "obstructionRef":649 },
4151

4252
See additional information in "Garage Door Openers" section of the Wiki entry [Setting Up Your Config.json file.](https://github.com/jvmahon/homebridge-homeseer/wiki/Setting-Up-Your-Config.json-file.)
4353

4454

45-
## B.5. *New in Version 2.1 -* Instant Status Update Feature - Check it out!
55+
## B.6. *New in Version 2.1 -* Instant Status Update Feature - Check it out!
4656
In addition to the new polling mechanism, described below, this version can also retrieve "Instant" status updates without polling. To enable this feature, you must enable HomeSeer's "Enable Control using ASCII commands" feature which can be accessed from the HomeSeer browers interface at [Tools menu] -> [Setup] -> [Network tab]. Its recommened that you leave the control port at the default setting of "11000". The plugin will automatically attempt a connection to HomeSeer using the ASCII commands feature and, if that is not available, will then revert to using polling over the HTTP / JSON interface for status updates. Status messages displayed during startup will let you know if the Instant Status feature has been enabled.
4757

48-
When Instant Status is enbled, dimmer devices supporting the Last-Level feature (most Z-Wave Dimmers) will turn on to the last level they were at prior to being turned off rather than always turning on at 100%.
58+
When Instant Status is enbled, dimmer devices supporting the Last-Level feature (most Z-Wave Dimmers) will turn on to the last level they were at prior to being turned off rather than always turning on at 100%. You can specify the "onValue" parameter to override this default behavior.
4959

5060
If Instant Status is enabled, polling is also reduced to once per minute. This shouldn't really be needed at all, but an occasionall poll is done out of caution to ensure that HomeBridge / HomeSeer remain properly synchronized.
5161

52-
## B.6 Version 2.0 - What's Changed - New Features beyond jrhubott / Version 1.x plugin
62+
## B.7 Version 2.0 - What's Changed - New Features beyond jrhubott / Version 1.x plugin
5363
Version 2.0 of this plugin introduced a new polling mechanism in which all HomeSeer devices are polled in a single HTTP call rather than individual HTTP calls. This reduces the polling stress on HomeSeer and allows for much more frequent polling. A poll time of 5-10 seconds is recommended.
5464

5565
## C. Changes to config.json setup!

0 commit comments

Comments
 (0)