Nest Thermostat
This gem allows you to get and set the temperature of your Nest Thermostat. You can also get and set the away status and get the current temperature and target temperature time.
Installation
Add this line to your application's Gemfile:
gem 'nest_thermostat'
And then execute:
$ bundle
Or install it yourself as:
$ gem install nest_thermostat
Usage
Get some useful info:
nest = NestThermostat::Nest.new(email: ENV['NEST_EMAIL'], password: ENV['NEST_PASS'])
puts nest.current_temperature # => 75.00
puts nest.current_temp # => 75.00
puts nest.temperature # => 73.00
puts nest.temp # => 73.00
puts nest.temp_high # => 77.00
puts nest.temp_low # => 71.00
puts nest.temperature_high # => 77.00
puts nest.temperature_low # => 71.00
puts nest.target_temperature_at # => 2012-06-05 14:28:48 +0000 # Ruby date object or false
puts nest.target_temp_at # => 2012-06-05 14:28:48 +0000 # Ruby date object or false
puts nest.away # => false
puts nest.leaf # => true # May take a few seconds after a temp change
puts nest.humidity # => 54 # Relative humidity in percentChange the temperature or away status:
puts nest.temperature # => 73.0
puts nest.temperature = 74.0
puts nest.temperature # => 74.0
puts nest.temperature_high # => 75.0
puts nest.temperature_high = 74.0
puts nest.temperature_high # => 74.0
puts nest.temperature_low # => 65.0
puts nest.temperature_low = 67.0
puts nest.temperature_low # => 67.0
puts nest.away? # => false
puts nest.away = true
puts nest.away? # => trueBy default, temperatures are in :fahrenheit, but you can change this to :celsius or :kelvin:
nest = NestThermostat::Nest.new(..., temperature_scale: :celsius)
# -- OR --
nest.temperature_scale = :kelvinAnd of course if you want to get lots of other goodies, like scheduling and every diag piece of info you'd ever want:
p nest.status
# -- OR --
require 'yaml'
yaml nest.status
# -- OR my favorite --
require 'ap' # gem install awesome_print
ap nest.statusFeel free to implement anything you see useful and submit a pull request. I'd love to see other information like scheduling or multiple device/location support added.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Added some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request