SmartThings_Pentair

Smarthings UI for use with the nodjs-PoolController

License

SmartThings_Pentair.
An application to control pool equipment from within Smartthings. Copyright (C) 2017-2018 Brad Sileo / bsileo / brad@sileo.name

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

What is the Smartthing Penatair Pool Controller

A collection of devices designed to interface with a nodejs-poolControlller instance which is talking on the RS-485 bus to allow viewing and setting pool control options. Includes devices to manage the Pool pump, lights and heater, the spa pump and heater, the chlorinator, and any installed additional "Features".

---

Installation Instructions

1. Install and configure Nodejs-Poolcontroller (version 4.x+) https://github.com/tagyoureit/nodejs-poolController

2. Update your Nodejs-Poolcontroller installation with the Smartthings interface

   Copy the outputToSmartThings.js into the integrations directory

   Update your configuration file to reference it:

        "socketISY": 0,
        "outputSocketToConsoleExample": 0,
        "outputToSmartThings":1
        }
        
       "outputToSmartThings": {
      "address": "<x.x.x.x>", (IP Address of Smartthings HUB on LAN)
      "port": "39500"
      }
       
   
   

3. Install the new Device Handlers into the Smartthings IDE (http://graph.api.smartthings.com/)

   • Pentair Pool Controller
   • Pentair Water Thermostat
   • Pentair Pool Control Switch
   • Pentair Chlorinator

   For each one,

   1. Go to [https://graph.api.smartthings.com/ide/devices]
   2. Hit the "+New Device Type" at the top right corner
   3. Hit the "From Code" tab on the left corner
   4. Copy and paste the code from https://github.com/bsileo/SmartThings_Pentair/tree/master/devicetypes/bsileo/
   5. Hit the create button at the bottom
   6. Hit the "publish/for me" button at the top right corner (in the code window)

4. Install a new device of type Pentair Pool Controller and configure it.

   • Go to https://graph.api.smartthings.com/device/list, click New Device, complete the form selecting "Pentair Pool Controller" for the type.
   • Be sure to fill in the correct Device Network ID - same as the Controller MAC Address below.
   • This will automatically create all the other devices types needed.
   • In the IDE (or Preferences in the SmartThings App) you can update all preferences for the Device:
     • Controller IP and Port - Set these to match the device where you have nodejs-PoolController running
     • Controller MAC Address - set this to the MAC address for that device. Use all uppercase, no colins to enter it
     • Autoname - optionally set this to true. The Device will do a one-time rename of all the Circuits to match the names set in your Controller

5. Manually adjust the circuit devices You will have 8 new devices created as Children to the main pool controller. You can access these in your things view and adjust them to improve the experience by changing their names as well as their icons. If you enabled Autoname in the initial configuration, the names indicate what they are for, but you can now change these as Autoname will not overright your labels.

6. Use all of the devices from the pool controller in any of your other Smartapps. You will have access to all Temperature readings, the ability to turn automated relay swicthes on and off, and control the pool and spa pumps.