homebridge-tonesto7-dev
v0.1.0
Published
Tonesto plugin for HomeBridge
Downloads
2
Readme
homebridge-smartthings-tonesto7
This is based off of @pdlove homebridge-smartthings
Current SmartApp version: 1.5.0
Change Log:
SmartThing App:
v1.0.0 - Overhauled JSON API app from Paul's SmartThings version.
v1.0.1 - SmartHomeMonitor Support is set to Off by Default.
v1.1.3 - App Cleanups. Added lot's of features.
v1.1.4 - Removed Hampton Fan input (No longer Necessary with My modified Device Handler).
v1.1.5 - Disabled Irrigation for now until i can make it work more consistent.
v1.1.6 - Command Tweaks to prevent errors.
v1.1.8 - Fixes for Mode Devices, added Routine Devices.
v1.2.0 - Added ability to selectively remove temp from Contact/Water Sensors, and lot's of Code Cleanup.
v1.2.0 - Update SmartApp to support new icon.
v1.3.0 - The SmartThings and Hubitat Apps now share 99.9% of the same code. With the exception being the hubaction declarations and a static variable defining the platform type
v1.4.0 - Add support for multiple HSM locations, and other Bugfixes mainly related to Hubitat Side
v1.4.1 - SHM/HSM fixes and added support for triggering intrusion alerts under HomeKit
v1.5.0 - Added support for the service to send commands directly to the hub locally (SmartThings ONLY) v1.5.0 - Added toggle to control whether local commands are allowed v1.5.0 - Added ability to trigger service restart when you exit the app (Will only restart on it's own if using process/service manager like PM2/systemd)
Homebridge Plugin:
v1.1.5 - Lot's of new capabilities supported in HomeKit
v1.1.7 - Updated the README
v1.1.8 - Cleanup of the Irrigation code
v1.1.9 - Forgot to remove some logging
v1.2.0 - Added in capability exclusion feature to match @pdlove plugin
v1.2.3 - Minor Cleanups
v1.3.0 - The SmartThings and Hubitat NPM package now share 99.9% the same code. All except 2 static variables defining the platform type
v1.3.1 - Bug fixes from code merge
v1.3.2 - More Bug fixes from code merge
v1.3.3 - Fixed Detection Issues in plugin
v1.4.0 - Fixed Hubitat support, working windows shades, allow multiple location SHM/HSM instances, lot's of cleanups and restructures. v1.4.0 - Warning: This will recreate a new Alarm device under Homekit. There is a possiblity it might also reset all of your Homekit Devices, rooms and options
v1.4.1 - SHM/HSM fixes and added support for triggering intrusion alerts under HomeKit
v1.5.0 - Added support for the service to send commands directly to the hub locally (SmartThings ONLY) v1.5.0 - Added toggle to control whether local commands are allowed v1.5.0 - Added ability to trigger service restart when you exit the app (Will only restart on it's own if using process/service manager like PM2/systemd)
This version is not compatible with prior versions of homebridge-smartthings Smartapp.
Direct Updates from SmartThings
- This method is nearly instant.
- This option allows the hub to send updates directly to your homebridge-smartthings installation.
- The hub must be able to send an http packet to your device so make sure to allow incoming traffic on the applicable port.
- The port used for this can be configured by the "direct_port" setting and defaults to 8000.
- The program will attempt to determine your IP address automatically, but that can be overridden by "direct_ip" which is useful if you have multiple addresses.
- As a note, the hub isn't actual doing any of the processing so if you lose Internet, updates will stop. I'm told it "doesn't currently" support it, so there is hope.
When properly setup, you should see something like this in your Homebridge startup immediately after the PIN:
[1/29/2017, 8:28:45 AM] Homebridge is running on port 51826.
[1/29/2017, 8:28:45 AM] [SmartThings] Direct Connect Is Listening On 10.0.0.70:8000
[1/29/2017, 8:28:45 AM] [SmartThings] SmartThings Hub Communication Established
Installation
Installation comes in two parts:
1. SmartApp Installation
- Log into your SmartThings account at SmartThings IDE
Note New SmartThings users: You must first enable github integration. (If you use github for work you will probably want to set up a new account as it will request access to your private repos). Only after enabling integration will you see the settings button
Click on
My SmartApps
Click on Settings and Add the New repository:
- Owner:
tonesto7
- Name:
homebridge-smartthings-tonesto7
- Branch:
master
- Click
Save
.
- Owner:
Click
Update From Repo
- Select
homebridge-smartthings-tonesto7
- Select
You should have homebridge-smartthings.groovy in the New section.
- Check the Box next to
homebridge-smartthings.groovy
- Check
Publish
at the bottom - Click
Execute Update
.
- Check the Box next to
Click on the
Homebridge-SmartThings
app in the list:- Click
App Settings
- Scroll down to the OAuth section and click
Enable OAuth in Smartapp
- Click
Update
at the bottom.
- Click
2. SmartApp Configuration
In the SmartThings Mobile App, goto
Marketplace
and selectSmartApps
.At the bottom of the list, select
My Apps
Select
Homebridge (SmartThings)
from the choices on thelist.Configuring the App:
There are 4 inputs at the top that can be used to force a device to be discovered as a specific type in HomeKit
Any other devices being added just Tap on the input next to an appropriate device group and then select each device you would like to use (The same devices can be in any of the Sensor, Switch, Other inputs)
- There are several categories because of the way SmartThings assigns capabilities. So you might not see your device in one, but might in another.
- Almost all devices contain the Refresh capability and are under the "Other Devices" group
- Some sensors don't have a refresh and are under the "Sensor Devices" group.
- Some devices, mainly Virtual Switches, only have the Switch Capability and are in the "Switch Devices".
Selecting the same device in multiple categories it will only be shown once in HomeKit, so you can safely check them all in all groups
Tap
Done
Tap
Done
You are finished with the App configuration!
3. Homebridge Plugin Installation:
- Install homebridge using:
npm i -g homebridge
(For Homebridge Install: Homebridge Instructions) - Install SmartThings plugin using:
npm i -g homebridge-smartthings-tonesto7
- Update your configuration file. See sample config.json snippet below.