Skip to content

dschoepel/NestOnOpenhab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

97 Commits
 
 
 
 
 
 

Repository files navigation

Nest On openHAB - Step By Step Guide

Google announced the availability of their Device Access Program (September 2020) that allows users to access, control, and manage Google Nest devices using the Smart Device Management (SDM) API. The SDM API is the replacement for the Works With Nest program that was "retired" August 31, 2019 and no longer supported by Google as part of their acquisition of Nest.

This guide is intended to document the steps needed to enable this API so that it can be connected to the NestDeviceAcces Binding.

Considerations: The Google SDM API with Nest Device Access Binding

1. In order to use the SDM API, you will need to enable access to each of your supported devices. If you are currently using the OpenHAB Nest Binding and "Works With Nest" to connect your devices to openHAB, you would need to leave that program and migrate your Nest account to a Google account (i.e. your devices to the Google account). Once you migrate accounts, this cannot be un-done!

Information on migrating your Nest account can be found here - FAQs about accounts for the Nest app. Look for the FAQ titled "Migrating your Nest Account to a Google Account" and expand the FAQ to find the sub-topic titled "How do I migrate my account?"

Supported Device List

Nest Thermostat Nest Cam Nest Hello Doorbell Nest Hub Max
Thermostat Camera Hello Hub
Read state and change thermostat modes and setpoints. Access camera livestreams and camera events Know when the doorbell is pressed and see the related camera snapshot. Access camera features of the display, such as livestreams and camera events.
Thermostat guide Camera guide Doorbell guide Display guide

Note: As of this writing, supported devices do not include Nest Protects.

2. The Nest Device Access binding is under development. It has been tested with thermostats; other API supported devices (camera and doorbell) are implemented but still require additional testing.

3. The good news is that this binding has been ported to OpenHAB 3 and updated to inlcude the SDM API. These instructions assume you will install the NestDeviceAccess binding in a V3 release of openHAB using the SDM configuration.

4. Finally some basic assumptions to be sure you are prepared to move forward:

  • Strongly recommend you have an environment you can test with
  • You will need to have a basic understanding of how to read the logs, debug and be willing help test/troubleshoot
  • Provide feedback about your experience on the openHab Community forum for this Topic
  • Basic understanding of Linux command line interface (CLI)
    • Access and ability to execute commands on your system
    • Setting up the SDM API requires you to execute commands to retrieve/refresh authorization keys and tokens
    • You may want to execute Curl commands to test access to your enabled devices and view their settings

Step-by-Step Instructions

Head on over to the Wiki for the detailed instructions.

My intent is to improve/keep this information up to-date. Constructive feedback is always welcome and can be provided on openHab's Community forum for this Topic.

About

My Experience on setting up Google Device Access (SDM) for My Home Nest Devices on Openhab

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors