README.md

Venstar Go library

Venstar is a Thermostat manufacturer which provides a snappy http API that can be used to interact and retreive stats about your thermostat.

go-venstar aims to provide a clean library for interacting with this api through Go.

Note: This library has only been tested on the ColorTouch T8900 however it should work on all Venstar thermostats which support the Local API and follows the restful docs.

venstar-tstat

venstar-tstats requires the ip of the thermostat to be provided.

The default action of venstar-tstat is to print all information available over the venstar api.

If you pass any additional arguments, the command will process the updates, followed by printing all information available over the api.

$ venstar-tstat -help
Usage of venstar-tstat:
  -controls.cool int
      Update Cool to temp (default -1)
  -controls.fan string
      Update Fan auto/on
  -controls.heat int
      Update Heat to temp (default -1)
  -controls.mode string
      Update Mode off/heat/cool/auto
  -settings.away string
      Update Away yes/no
  -settings.dehumidify-setpoint int
      Update Dehumidify SetPoint (25-99) (default -1)
  -settings.humidify-setpoint int
      Update Humidify SetPoint (0-60) (default -1)
  -settings.schedule string
      Update Schedule off/on
  -settings.tempunits string
      Update temperature units f/c fahrenheit/celsius

$ venstar-tstat 192.168.1.105
API Info:
  Type     : commercial
  Model    : COLORTOUCH
  Version  : 7
  Firmware : 5.10
Query Info:
  Name               : Thermostat
  Mode               : auto (3)
  State              : idle (0)
  Fan                : on (1)
  FanState           : off (0)
  ActiveStage        : 0
  TempUnits          : fahrenheit (0)
  Schedule           : inactive (0)
  SchedulePart       : inactive (255)
  Away               : home (0)
  Holiday            : not observing (0)
  Override           : off (0)
  OverrideRemaining  : 0s (0)
  ForceUnoccupied    : off (0)
  SpaceTemp          : 74.0
  HeatTemp           : 70.0
  CoolTemp           : 74.0
  CoolTempMin        : 35.0
  CoolTempMax        : 99.0
  HeatTempMin        : 35.0
  HeatTempMax        : 99.0
  HumidityEnabled    : disabled (0)
  Humidity           : 48%
  HumidifySetPoint   : 0%
  DehumidifySetPoint : 99%
  SetPointDelta      : 4.0
  AvailableModes     : all (0)
Query Sensors:
  Thermostat = 74.0
  Space Temp = 74.0
Query Runtimes:
  +-------------------------+--------+--------+----------+--------+-------+-------+--------------+----------+
  | Timestamp               | Heat 1 | Heat 2 | Cool 1   | Cool 2 | Aux 1 | Aux 2 | Free Cooling | Override |
  +-------------------------+--------+--------+----------+--------+-------+-------+--------------+----------+
  | 2015-09-15 00:00:00 UTC | 0s     | 0s     | 3h43m0s  | 1m0s   | 0s    | 0s    | 0s           | 0s       |
  | 2015-09-16 00:00:00 UTC | 0s     | 0s     | 7h6m0s   | 0s     | 0s    | 0s    | 0s           | 0s       |
  | 2015-09-17 00:00:00 UTC | 0s     | 0s     | 9h44m0s  | 0s     | 0s    | 0s    | 0s           | 0s       |
  | 2015-09-18 00:00:00 UTC | 0s     | 0s     | 9h19m0s  | 0s     | 0s    | 0s    | 0s           | 0s       |
  | 2015-09-19 00:00:00 UTC | 0s     | 0s     | 10h38m0s | 0s     | 0s    | 0s    | 0s           | 0s       |
  | 2015-09-19 10:16:10 UTC | 0s     | 0s     | 2h31m0s  | 0s     | 0s    | 0s    | 0s           | 0s       |
  +-------------------------+--------+--------+----------+--------+-------+-------+--------------+----------+
Query Alerts:
  Air Filter: Active = false
     UV Lamp: Active = false
     Service: Active = false

$ venstar-tstat/main.go -controls.mode auto -controls.heat 72 -controls.cool 76 192.168.1.105
Controls updated!
API Info:
  Type     : commercial
  Model    : COLORTOUCH
  Version  : 7
  Firmware : 5.10
Query Info:
...
  SpaceTemp          : 76.0
  HeatTemp           : 72.0
  CoolTemp           : 76.0
...