Spruce Controller has been published to “brands” in the new SmartThings app, this page is only for custom code applications.
See SmartThings 2020 Spruce Controller Gen1 for details and instructions about the SmartThings published device which requires no custom code and can be added from the app.
These Device Handlers and Schedule will work with the new Samsung SmartThings APP but are not officially supported and may stop functioning at anytime due to changes in Samsung SmartThings infrastructure.
The migration to the newest Samsung app has caused the Gen1 Spruce Controller device tile to break.
The Spruce Scheduler is also no longer visible for new installs in the app.
v3 Latest 5-18-2020
- MAJOR change to device handler
- Update Spruce Controller to ST published device, but with minor update to facilitate scheduler
- Update Spruce Scheduler to work with updated device
Importing this code into the SmartThings IDE will bring back functionality as listed below:
- The new Spruce Controller device looks and works like the version listed under the brand “Spruce Irrigation”-
- Schedules can be setup using the classic Spruce Scheduler
- Individual zones can be used in automations
Import the Device Handlers and SmartApp into your account
There are 2 options to import code into SmartThings. You may connect with Github, or may copy and paste the text into your account manually. Connecting to Github is the preferred method because it is very easy to update if there are any changes made to the software but also requires a free Github account.
If you are unsure of Github, you may find it simpler to copy and paste the code in place.
Import from GIT
Follow the instructions from the following link to import the Device Handlers and Smartapp into your SmartThings account. The instructions and video are from https://konnected.io, Spruce is in no way affiliated with Konnected
Substitute this PlaidSystems information below in place of the konnected information in the video and instructions listed below:
- Owner: PlaidSystems
- Name: Spruce_Gen1-SmartThings
- Branch: Master
Once complete, Update from Repo
- https://help.konnected.io/support/solutions/articles/32000022409-smartthings-enable-github-integration#
- Video: https://help.konnected.io/support/solutions/articles/32000022474-video-konnected-smartthings-installation-and-setup
Updating Device and SmartApp code
The steps outlined in the links above use Github to “pull” the code into your account. Your SmartThings account will keep track of changes in the code, but will need to be told to “update”. This is done by repeating the Update from Repo button in the Device Handler and SmartApps pages of the SmartThings IDE at graph.api.smartthings.com/
You may Update from Repo anytime to get the latest code.
Copy and Paste
Go to the SmartThings web IDE and copy and paste the code directly in.
- Go to https://graph.api.smartthings.com/
- Log in with your SmartThings app password
Delete old Spruce devices
- Go to My Device Handlers
- Select icon to the left of old devices to open and edit
- Select Delete (scroll down to bottom) to remove
Delete old Spruce SmartApps
- Go to My Smartapps
- Select icon to the left of old smartapps to open and edit
- Select Delete (scroll down to bottom) to remove
Add SmartApp
- Go to My SmartApps then +New SmartApp
- Select From Code
- Copy and Paste the text from https://raw.githubusercontent.com/PlaidSystems/Spruce_Gen1-SmartThings/master/devicetypes/plaidsystems/spruce-controller-sst.src/spruce-controller-sst.groovy
- Save and Publish
Add Device
- Go to My Device Handlers then +Create New Device Handler
- Select from Code
- Copy and Paste the text from https://raw.githubusercontent.com/PlaidSystems/Spruce_Gen1-SmartThings/master/devicetypes/plaidsystems/spruce-controller-sst.src/spruce-controller-sst.groovy
- Save and Publish
Completing Setup
Device Setup
- The device handler code Spruce Controller SST must be copied/imported into your IDE account and published following the instructions above.
- The smartapp code Spruce Scheduler SST must be copied/imported into your IDE account and published following the instructions above.
- Remove the Spruce Controller from the app, from the Spruce Device, go to Edit -> Delete Device
- Add a new device with Add Device -> Scan nearby and then start the search on the Spruce controller
- The app will find Spruce Controller
- Device setup instructions are now the same as the SmartThings released version and covered here: https://gen1.support.spruceirrigation.com/knowledge-base/smartthings2020-spruce-controller-gen1/
Schedule Setup
Remove any old Spruce Schedules, they are no longer compatible with the new device.
- Go to SmartApps menu in the app
- Delete all previous Spruce Scheduler installations
Create a new schedule:
- Go to SmartApps->+ menu in the new app
- Scroll down until you find Spruce Scheduler SST
- Proceed to setup the same as the Classic app version.