OpenHAB-Smartthings
This openHAB Binding is now part of openHAB. It is called "Samsung Smartthings" in the Add-ons tab. Click here
This is an openHAB binding for use with the Samsung Smartthings hub. On 9/19/20 it was submitted to openHAB for review and addition to openHAB bindings collection. Until it has been accepted and added to the openHAB platform you can install it from here.
Requires Smartthings App
Previously this binding only worked with the Smartthings Classic app for your phone. Now it can work with either app
Installation instructions
- Shutdown openHAB. On openhabian the command is: sudo systemctl stop openhab2.service
- The org.openhab.binding.smartthings-2.5.9-SNAPSHOT.jar file which is located at org.openhab.binding.smartthings/target has to be copied to the addons folder in your openHAB installation. If you are using Openhabian this will be in the Samba share: openHAB/addons. Make sure there is only one smartthings jar file in the addons directory.
- Start openHAB. On openhabian the command is: sudo systemctl start openhab2.service
- Then follow the setup instructions in the README.md file in the org.openhab.binding.smartthing directory. Make sure to perform the Smartthings Configuration steps described in that file.
If you see any strange or unexpected behaviour after upgrading the Smartthings binding it is recommended that you Clear the Cache.
Also, make sure the code running on your Smartthings hub is the saame as in the contrib directory. This has been updated recently.
How to report issues
If you discover one of your devices doesn't work as expected please follow the instructions in the Troubleshooting file and raise an issue on my Github Repo BobRak
4/4/2019 Release Notes
- This update requires that you redeploy the smartthings code as described in the Smartthings Installation document. The location of the smartthings code has changed. It is now here
- The RGB bulb wasn't previously working. I recently purchased a Sengled bulb just to test this. I discovered that Samrtthings defines the hue as 0-100 and openHAB defines hue in the industry standard range of 0-360. The code has been updated. The README file has been updated with an example configuration for the Sengled RGB bulb.
- Since I started development of this binding Samsung has added capabilties for many of their appliances. I have had some requests to add that to this binding. I will do that but not until I complete code changes requested bu openHAB and it has been added to the base openHAB system. One reason for this delay is because I don't own any of these appliances and will have to build simulators first. So overall this will be a considerable amount of work.
4/5/2019 Release notes
Right after the 4/5 release I had reports that Discovery was no longer working. I retested discovery in my development environment and found it working. I also discovered some files that should have been deleted were still present so I removed them.
4/7/2020 Release notes
Added support for some of the proposed capabilities in the Samsung Smartthings Capabilities document. In particular support was added for the DryerOperatingState and DryerMode capabilitles. Sample config files can be found in my repo: Smartthings-SimulatedDryer. This addition included changes to the Smartthings Hub code so make sure you reinstall the SmartApp.
4/10/2020
Added support the following capabilities:
- Air Conditioner Mode
- Temperature Measurement
- Thermostat Cooling Setpoint - Note: I created a Simulated Air Conditioner Device Handler to test the capabilities 1 - 3. I could not make this one work in the simulator but I do beleive the code is correct. The openHAB code creates the correct message to the ST hub. The hub processes the message and calls the correct function to set the coolongSeptpoint but the attribute is not updated. I have given up on that after almost 2 days.
- Lock Only - I updated the code for this. I can confirm it will go to locked status. But, beacuse I don't have a way to set it to unlocked there is not as much testing as I would like.
4/20/2020
Added additional states to the following capabilities And additional testing of those capabilities
- Air Conditioner Mode
- Temperature Measurement
- Thermostat Cooling Setpoint
- Thermostat Fan Mode
- Thermostat Heating Setpoint
- Thermostat Mode
- Thermostat Operating State
- Thermostat
6/6/2020
Added support the following capabilities:
- Washer Operating State (with attributes machineState and washerJobState)
- Washer Mode
6/26/2020
Many uopdates based on feedback for the openHAB review. Things that you might notice include:
- Many of the debug logging messages have been removed and other changed.
- The exception
The setThingHandlerFactory method has thrown an exception java.lang.ClassCastException
has been fixed.
7/4/2020
Updates based on a second code review. No functional changes were requested.
7/15/2020
Minor code changes to logging
- Reduced logging done by DiscoveryService as it was 90% of the logging and not that useful.
- Changed log level from TRACE to DEBUG for state messages from Smartthings.
These are useful to confirm the hub is sending data
Removed timing code from Smartthings code since it was eariler removed from openHAB code.
9/18/2020
Hopefully final code review changes as requested by openHAB. Also, a timeout can be set for each thing. See the README.md for details.
9/11/2020
This has been added to the openHAB distribution. It is called "Samsung Smartthings" in the Add-ons tab. Click here
1/20/2021
This version requires OH 3.1. It fixes a bug that caused the Discovery service to not find any devices connected
to the Smartthings hub. This has been submitted to openHAB but is being posted here for anone that wants quicker access to the changes.